For the complete documentation index, see llms.txt. This page is also available as Markdown.

Device Lock Feature

The purpose of locking a device is to disable most of the device’s functionality for use cases that need this extra layer of security. When a device is locked, it will reject all commands except for a few. Use of the device lock feature is optional. It is not required by PCI.

  • The device lock state can be either unlocked or locked. The device lock state can be retrieved by getting a property.

  • The device lock state can be changed by setting a secure property or it can be changed with a command that requires knowledge of the device lock passcode.

  • The device can be configured to always have the device lock state set to locked after a reset or power cycle by setting a property.

  • If the device has a display and the device is locked, the welcome screen will display “WELCOME” “Device is Locked”. This screen can be customized.

  • The device lock passcode can be changed by setting a secure property or it can be changed with a command that requires knowledge of the current device lock passcode.

Commands and properties to manage the device lock feature:

Only the following commands are allowed when the device lock state is set to locked:

Command 0x1F01 - Reset Device
Command 0x1F03 - Extend Session (Session Management Only)
Command 0x1F04 – Terminate Bluetooth® LE Connection (Bluetooth® LE Only)
Command 0xD101 - Get Property
Command 0xD112 - Set Property (Secured)
Command 0xDF01 - Echo
Command 0xE001 - Get Challenge
Command 0xEF06 – Change Device Lock State
Command 0xEF08 – Reset Device Lock Passcode (MAGTEK INTERNAL ONLY FOR NOW)
Command 0xEF09 – Encrypt User Data
Command 0xEEEE - Send Secured Command to Device

Last updated