Error List
When a command fails, the device responds with:
>RER<CODE>:<COMMAND_ECHO><
Example:
>RER07:SAM2<
→ Error code 07 on command SAM2 (invalid parameter: value 2 is not 0 or 1).
Error Codes
| Code | Name | Description |
|---|---|---|
00 | ERROR_UNRECOGNIZED_COMMAND | The command type is unknown |
02 | ERROR_INCORRECT_DELIMITER | Message not properly delimited by > and < |
04 | ERROR_LOCKED_BY_KEY | Command blocked by the key mechanism (see XAKY) |
07 | ERROR_INCORRECT_PARAMETER | A parameter is missing, out of range, or invalid |
08 | ERROR_RESTRICTED_COMMAND | Command is restricted in the current context |
11 | ERROR_WRONG_ACT_XCT_DEF | Wrong ACT or XCT alias definition |
17 | ERROR_CONN_NOT_AVAILABLE | No connection available for the requested operation |
19 | ERROR_INDEX_OUT_OF_BOUNDS | Index exceeds the allowed range |
26 | ERROR_INVALID_CHECKSUM | Message checksum is invalid |
36 | ERROR_MISSING_EVENT_SENSE | Event sense character (+ or -) is missing |
37 | ERROR_NON_EXISTENT_SIGNAL | Referenced signal does not exist |
40 | ERROR_INVALID_SET_SIGNAL | This signal cannot be set by the user |
43 | ERROR_INTERFACE_NOT_READY | Interface (serial, modem) is not ready |
51 | ERROR_ALREADY_IN_PROGRESS | Operation already running (e.g., firmware update) |
59 | ERROR_INVALID_RANGE_OR_VALUE | Value is outside the valid range |
69 | ERROR_EXCEEDED_LENGTH | Command exceeds maximum length (1024 bytes) |
76 | ERROR_DEFINITION_NOT_FOUND | Referenced definition does not exist |
77 | ERROR_FILE_NOT_FOUND | Required file could not be opened |
78 | ERROR_OPERATION_FAILED | Operation failed; retry later |
80 | ERROR_OPERATION_NOT_ALLOWED | Operation not permitted in current state |
95 | ERROR_INSUFFICIENT_MEMORY | Not enough memory to complete the operation |
96 | ERROR_DB_OPERATION_FAILED | Database read/write operation failed |
Success Behavior
When a Set command succeeds, the device reply with the command echo, like this:
>S<COMMAND>;<DATA><
>R<COMMAND>;<DATA><
When a Query command succeeds, it returns the requested data:
>Q<COMMAND><
>R<COMMAND>;<DATA><
Common Errors and Fixes
| Scenario | Error | Fix |
|---|---|---|
| Wrong parameter value | 07 | Check parameter range in the command documentation |
| Unknown command | 00 | Verify command spelling and firmware version |
| Index too large | 19 | Use a valid index within the documented range |
| Signal not found | 37 | Verify the signal name exists in the Signal List |