Skip to main content
Firmware Stable

Lock

When locked, the LYNX's drive function is disabled. The LYNX can be locked either through GPIO or via the IOT protocol.

The lock feature is optional and not available in all mods of LYNX. To verify if your mod supports locking, check the terminal output after boot. Lock support is indicated by either - Lock or - Lock lite messages.

  • Lock lite indicates support for IOT-only locking with freewheeling mode
  • Lock indicates full support for both GPIO and IOT locking

GPIO Lock​

The controller can be locked using a connected button or switch. The lock input (in_lock) must be mapped to GPIO via input mapping.

Lock activation can be configured through the /lock/lockopts parameter to respond to short press, long press, or level (switch).

IOT Lock​

The controller supports locking through the IOT protocol via the lock command.

This method is compatible with the siliXcon VDS display.

tip

To use lock functionality with the display, enable lock at startup. Otherwise, the device will initialize in an unlocked state.

Parameters​

info

All parameters are located in the /lock folder.

Lock lite only includes the lockopts parameter. Additional parameters are available with full lock support.

lockopts​

This bitwise parameter configures lock behavior.

/lock/lockopts
ValueNameDescription
1Short pressActivate lock by short press
2Long pressActivate lock by long press
4Level (switch)Activate lock by level (switch)
8Lock at startupStart controller in locked state (lock device at startup)
tip

Enable lock at startup when using the display interface.

locktim [s]​

Sets automatic locking timeout. The timer only runs when accelerator and brake are inactive.

lock_lpf​

For non-freewheeling lockmode, lock activation uses the low-pass filter.

lockmode​

Sets the controller's behavior when locked. Default is freewheeling mode.

ValueDescription
0Freewheeling mode
4Voltage brake mode
8Brake mode
15Phase short brake mode
tip

lockmode corresponds to driver mode, but only the above values are permitted.