Skip to main content

Access Level

Select emDRIVE firmware version

< V1.15.0

Access Level is emDrive functionality that is used to limit read and write permissions for objects depending on user granted access.

Access Level functionality is available from firmware V1.11.0 and newer.

Each Parameter has attribute (Object's Attributes) for Read and Write access level. To be able to read or write to object Inverter must be unlocked to required level.

Access Levels
Level Name Description
1 End User Object is available to End User even when inverter is locked with "Customer Key"
2 Customer Object is available by default. Can be locked with "Customer Key"
3 Production Object is available only in production to write production related and calibration objects (only Emsiso)
4 Development Object is available only during development (only Emsiso)

Devices shipped from manufacturer are unlocked to "Customer" level. Customer has the option to lock the device and prevent additional changing of object values from 3rd parties.

Access Level CANopen Objects

Objects at index 0x2010 are used for Access Level functionality

Sub - index Name Description
0x01 Access_Level__Current Shows current access level that inverter is set to, objects with equal or lower access level can be accessed.
0x02 Access_Level_Key_input Write your key to unlock the device, depending on the key, specific level will be unlocked.
0x03 Access_Level_Customer_Key Writing value to this object will lock the device to "End User" (after reset). The same key must be used to unlock the device to "Customer" level. Remove locking by writing value "0".

Locking emDrive

Lock the emDrive inverter is intended to be used by Customer to prevent End User to make any changes of configuration. Objects with End User access level are mostly Read Only objects or only Read Access Level is set to End User.

To lock the emDrive follow the steps

  1. Chose the secret key that will be used to lock and unlock the inverter. Value can be from 1 - 4294967295 (32-bit unsigned integer).
  2. Write chosen key to object "Access_Level_Customer_Key"
  3. Save Device Parameters
  4. Reset the device
  5. After power up, device will have Current Access Level at 1 - End User. Check by reading object "Access_Level__Current"

Unlocking emDrive

If the emDrive is locked with Customer key and we want to change parameters that require Access Level 2, we have to unlock the emDrive after each power on. To verify that emDrive is locked, read object "Access_Level__Current" which should read "1".

To unlock the emDrive follow the steps

  1. Write correct Customer Key to object "Access_Level_Key_input".
  2. Read object "Access_Level__Current" which should change to "2" if the key was correct.

At this point Customer Level object can be read/written. But if the emDrive is reset, it will return to locked End User Access Level. To permanently unlock the emDrive and remove the key follow additional steps are needed.

  1. Write correct Customer Key to object "Access_Level_Key_input".
  2. Read object "Access_Level__Current" which should change to "2" if the key was correct.
  3. Write value "0" to "Access_Level_Customer_Key" to remove the key.
  4. Save Device Parameters
  5. Reset the device
  6. After power up, device will have Current Access Level at 2 - Customer. Check by reading object "Access_Level__Current"

 

V1.15.0

Access Level is a feature of emDrive functionality that is used to limitcontrols read and write permissions for various objects dependingbased on userthe user’s granted access.

Access Level functionality is available from firmware V1.11.0 and newer.

Each Parameterparameter in emDrive has attributeattributes (Object's Attributes) forthat define the required Read and Write accessAccess level.Level. To beinteract ablewith tothese readparameters, orthe write to object Inverterinverter must be unlocked to requiredthe corresponding access level. Higher access levels grant access to a greater number of objects.

Access Levels
Level Name Description
10 End User Object is availableAvailable to the End UserUser, even when the inverter is locked with the "CustomerService Key".
1ServiceAvailable to Service personnel. Can be locked using the "Service Key".
2 CustomerAdmin Object is availableAvailable by default. Can be locked withusing the "CustomerAdmin Key".
3 Production Object is availableAccessible only in production tofor writewriting production production-related and calibration objects (only Emsiso).
4 Development Object is availableAccessible only during development (only Emsiso).

Devices shipped from the manufacturer are unlocked to the "Customer"Admin" level. CustomerThe customer has the option to lock the devicedevice, andpreventing preventthird additionalparties from changing of object values from 3rd parties.values.

Access Level CANopen Objects

ObjectsThe following objects at index 0x2010  are used forto control Access Level functionality
functionality:

Sub - index Name Description
0x01 Access_Level__Current ShowsDisplays the current access level thatof inverterthe isinverter. set to, objectsObjects with equal or lower access levellevels can be accessed.
0x02 Access_Level_Key_inputAccess_Level__Key_input WriteEnter youra key to unlock the device,device. dependingThe onentered thekey key,will unlock a specific level will be unlocked.level.
0x03 Access_Level_Customer_Key
Access_Level__Admin_Key
WritingWrite a value to this object will lock the device to "EndAdmin" User"level (after reset).reset. TheUse the same key mustto beunlock. usedWrite "0" to unlockremove locking.
0x04
Access_Level__Service_Key
Write a value to lock the device to "Customer"Service" level.level Removeafter lockingreset. byUse writingthe valuesame key to unlock. Write "0". to remove locking.

Locking emDrive

LockLocking the emDrive inverter is intendedtypically to be usedperformed by Customerthe Admin or Service personnel to prevent End User to make any changes of configuration. Objects withthe End User accessfrom levelmaking configuration changes. Objects accessible to the End User are mostlyusually Read Only objectsread-only or have read-only Readpermissions Access Level is set to End User.set.

To lock the emDrive follow the steps

  1. ChoseChoose thea secret key that(an willinteger bebetween used to lock1 and unlock the inverter. Value can be from 1 - 4294967295 (32-bit unsigned integer)4,294,967,295).
  2. Write chosenthe selected key to objecteither the "Access_Level_Customer_Key"Access_Level__Service_Key" or "Access_Level__Admin_Key" depending on the desired lock level.
  3. Save Devicethe Parametersdevice parameters.
  4. Reset the device
  5. After powerpowering up, the device will havebe Currentlocked Accessone Levellevel atbelow 1the -set Endkey. User.Verify Checkthis by reading objectthe "Access_Level__Current" object.

Unlocking emDrive

IfTo modify parameters that require higher access levels (such as Admin or Service), the emDrive must be unlocked after every power cycle. To confirm that the emDrive is lockedlocked, with Customer key and we want to change parameters that require Access Level 2, we have to unlockcheck the emDrive after each power on. To verify that emDrive is locked, read object "Access_Level__Current" object, which should readdisplay "1".the correct locked level.

To unlock the emDrive follow the stepsemDrive:

  1. Write the correct Customer Keykey to objectthe "Access_Level_Key_input".Access_Level__Key_input" object.
  2. Read objectthe "Access_Level__Current" whichobject shouldto verify the change to "2" if the keycorresponding wasaccess correct.level.

AtOnce thisunlocked, pointobjects Customerat Levelthe objectunlocked level can be read/written.accessed. ButHowever, if the emDrive is reset, it will returnrevert to the locked End User Access Level.state. To permanently unlock the emDrive and remove the keyemDrive, follow these additional steps are needed.steps:

  1. Write the correct Customer Keykey to objectthe "Access_Level_Key_input"Access_Level__Key_input" object.
  2. Verify that the access level has changed by reading "Access_Level__Current".
  3. Read object "Access_Level__Current" which should change to "2" ifWrite the key was correct.
  4. Write value "0" to "Access_Level_Customer_Key"Access_Level__Admin_Key" or "Access_Level__Service_Key" to remove the respective key.
  5. Save Devicethe Parametersdevice parameters.
  6. Reset the devicedevice.

After powerthe up,reset, the device will haveno Currentlonger Accessrequire Levelthe atkey 2to -access Customer.the Checkprevious locked level. You can verify this by readingchecking objectthe "Access_Level__Current" object.