Erstellen eines Moduls mit OEM-Lizenzabfrage

Wofür eine eigene Lizenz an ein Modul koppeln?

Ist ein TwinCAT-Objekt, neben den TwinCAT-Lizenzen, auch an eine OEM-Lizenz gebunden, kann dadurch eine Bindung dieses TwinCAT-Objekts an eine Hardware realisiert werden, sodass die Anwendung vor Klonen geschützt ist. Außerdem können über diesen Weg Funktionalitäten einer Anwendung an Endkunden lizenziert werden.

Weitere Informationen finden Sie im Bereich Software Protection / Eigene OEM-Lizenzen.

Konfiguration in MATLAB®

Optional kann ein generiertes TcCOM oder ein Funktionsbaustein an eine OEM-Lizenz gebunden werden. Diese OEM-Lizenz wird beim Starten des Objekts (neben der Beckhoff Runtime-Lizenz TF1400, enthalten in TC1220 und TC1320) in TwinCAT 3 überprüft. Ist keine gültige Lizenz vorhanden startet das Modul nicht auf und es erscheint eine entsprechende Fehlermeldung.

Ihren OEM Lizenzcheck können Sie einfügen über Benennung Ihrer OEM ID und Ihrer abzufragenden Lizenz ID bzw. mehrerer Lizenz IDs. Ihre OEM ID finden Sie in der Security Management Konsole (Extended Info aktiviert), die Lizenz ID können Sie einsehen durch Doppelklick auf den entsprechenden Lizenzeintrag in TwinCAT unter System > License. Beide IDs sind ebenfalls im generierten License Request File enthalten, wenn ein Request File mit Ihrer OEM Lizenz generiert wird.

Erstellen eines Moduls mit OEM-Lizenzabfrage 1:

Verfügbares Beispiel in MATLAB®

Führen Sie folgendes in der MATLAB® Kommandozeile aus, um das Beispiel zu öffnen:
TwinCAT.ModuleGenerator.Samples.Start("OemLicense")

Beispiel OEM Lizenz:

OEM ID = '{ABBAABBA-AFFE-AFFE-AFFE-ABBABBAABBAA}';

OEM Lizenz ID = '{11111111-0000-FEFE-CCCC-BBBBBBBBBBBB}'

Entsprechender Eintrag in der Export-Konfiguration:

exportConfig.Project.OemId = '{ABBAABBA-AFFE-AFFE-AFFE-ABBABBAABBAA}';
exportConfig.Project.OemLicenses = '{11111111-0000-FEFE-CCCC-BBBBBBBBBBBB}';

Neben der Konfiguration über die Projekt-Parameter, kann jede umgewandelte MATLAB®-Funktion individuell über die Klassen-Parameter konfiguriert werden. Standardmäßig werden die Einträge aus dem Projekt-Parameter übernommen. Dies kann jedoch überschrieben werden:

exportConfig.ClassExportCfg{1}.TcCom.OemLicenses = '{22222222-0000-EFEF-DDDD-CCCCCCCCCCCC}'

Wird das Modul mit obigen Einstellungen erstellt und in TwinCAT instanziiert, muss neben einer gültigen TwinCAT-Lizenz (TC1220 oder TC1320) auch eine gültige OEM-Lizenz vorhanden sein, damit TwinCAT aktiviert werden kann.

Zu beachten bei Lizenz-Dongles

Folgendes ist zu beachten, wenn Sie die OEM-Lizenz für das Zielsystem auf einem Dongle nutzen:

Nutzen Sie eine Instanz eines TcCOM?
1. Stellen Sie die Init Sequence auf der Objekt-Instanz auf P.
Erstellen eines Moduls mit OEM-Lizenzabfrage 2:
2. Beachten Sie, dass Sie in diesem Fall keine aktiven Mappings benutzen können. Es wird dazu geraten, den TcCOM-Wrapper-FB zu nutzen, oder das Modul aus TwinCAT C++ aufzurufen.
3. Aktivieren Sie die Konfiguration.
4. Schalten Sie das TcCOM-Objekt -nachdem TwinCAT im Run-Mode ist- in den OP-State, z. B. über das XAE (siehe untenstehende Grafik), über den TcCOM-Wrapper-FB oder per ADS.
Erstellen eines Moduls mit OEM-Lizenzabfrage 3:
Die Lizenz wird beim Hochfahren in den OP-State geprüft und (wenn gültig) akzeptiert.
Nutzen Sie den TcCOM-Wrapper-FB aus der erstellten SPS-Bibliothek und referenzieren auf eine statische TcCOM-Instanz?
1. Stellen Sie die Init Sequence auf der Objekt-Instanz auf P (siehe oben).
2. Nutzen Sie den TcCOM-Wrapper-FB, um das referenzierte TcCOM in OP zu schalten.
Die Lizenz wird beim Hochfahren in den OP-State geprüft und (wenn gültig) akzeptiert.
Wann müssen Sie nichts weiter beachten?
1. Wenn Sie den PLC-FB aus der erstellten SPS-Bibliothek nutzen.
2. Wenn Sie mit dem TcCOM-Wrapper-FB dynamisch ein TcCOM erstellen.