RECM

Description

This command can change settings regarding to the "Recovery Mode". Recovery Mode provides a way to capture modules over the network if they were misconfigured or some settings are forgotten. For this purpose, the module starts with default settings when powered on and remains there for a few seconds. While beeing in recovery mode, the module listens for certain UDP messages. If it receives one, it remains in recovery mode and can be re-configured over the network.

Parameters

The RECM command requires one argument which is one of the keywords ON, OFF or LISTEN:

ON
Recovery Mode is fully enabled. This means that the module switches to recovery mode on startup and sends recovery beacons that can be detected by a listener program to lock the module. The module also listens for UDP messages that can cause it to remain in recovery mode.

LISTEN
This is the listen-only recovery mode. The module doesn't send recovey beacons but is still sensitive to UDP messages.

OFF
For maximum security, recovery mode is completely switched off. The module starts directly with the stored settings.

Return Value

ERR_OK (0) if command was accepted
ERR_ARGUMENT (4) if argument was neither ON, OFF nor LISTEN

Example

RECM OFF 

No recovery mode.

Remarks

Switching off recovery mode might be risky because misonfigured module are locked out forever. On the otehr hand, the simplest way to prevent hijacking is to disable recovery mode. Also active recovery mode increases boot-up time. In the default configuration (factory settings), recovery mode is enabled.

RECM?

Description

The command RECM? can be used to query the actual Recovery Mode setting. The output is one of the keywords ON, LISTEN or OFF. Please see the description above.