Protected version

1.3. Protected version

The EC-Simulator software is available in different protected versions:

Dongled: Binary with dongle protection (Linux x64, x86, Windows only)
Protected: Binary with MAC protection. Requires a physical network adapter for license check (HiL/SiL).
Unrestricted:: Binary without MAC protection

The protected version is limited to 5 SubDevices and will automatically stop after about 10 minutes of continuous operation. In order to remove this restriction a valid runtime license key or a dongle is required. The runtime license protection with license key is based on the MAC address of the Ethernet controller used for the EtherCAT® protocol. With a valid license key and Protected version the purchased features are automatically unlocked. The Dongled version needs the Dongle and WIBU service to be installed and running. The purchased features stored on the Dongle are automatically unlocked.

1.3.1. Licensing procedure for Development Licenses

Installation of EC-Simulator Protected or Dongled version accordingly
In case of EC-Simulator Protected: Determine the MAC Address by calling esGetSrcMacAddress(0, &oSrcMacAddress)/ecatGetSrcMacAddress(&oSrcMacAddress) or from a sticker applied on the hardware near the Ethernet controller.
Send an Email with the subject “Development License Key Request, Commission your commission number” with the MAC address to sales@acontis.com

Acontis will create the license keys and return them in a License Key Text File (CSV format).

Number;MAC Address;License Key
1;00-00-5A-11-77-FE;DA1099F2-15C249E9-54327FBC-3BA579B2-318AB2B6-CD13B221
2;64-31-50-80-20-4E;A2B4C98D-00185EF9-22134567-DA1099F2-15C249E9-54327FBC

Activate the License Key by calling esSetLicenseKey() or EC_T_LINK_PARMS_SIMULATOR (SiL) with the license key that corresponds to the MAC address on the hardware and check the return code. The license key is 53 characters long. For HiL the API esSetLicenseKey() must be called after esInitSimulator() and before esConfigureNetwork(). For SiL the license key must be set at EC_T_SIMULATOR_INIT_PARMS::szLicenseKey .

Example HiL:
```
esSetLicenseKey(0, "A2B4C98D-00185EF9-22134567-DA1099F2-15C249E9-54327FBC");
```
Example SiL:
```
$ EcMasterDemo -simulator 1 1 eni.xml --lic A2B4C98D-00185EF9-22134567-DA1099F2-15C249E9-54327FBC --link -intelgbe 1 1
```

1.3.2. Licensing procedure for Runtime Licenses

Installation of EC-Simulator Protected or Dongled version accordingly
In case of EC-Simulator Protected: Determine the MAC Address by calling esGetSrcMacAddress(0, &oSrcMacAddress)/ecatGetSrcMacAddress(&oSrcMacAddress) or from a sticker applied on the hardware near the Ethernet controller.
Provide the MAC Addresses and numbers from previously ordered and unused runtime license stickers in a text file to acontis as described in the example below. Please use a separate line for each runtime license sticker number and MAC Address.
```
100-105-1-1/1603310001;00-00-5A-11-77-FE
100-105-1-1/1603310002;64-31-50-80-20-4E
```
Send an Email with the subject “Runtime License Key Request, Commission your commission number” with the MAC address to sales@acontis.com