Seaward ClareHAL - Manual (Page 144)

143
5. System settings commands
The system settings may be read or modified using the commands
defined in this section. Each system setting is identified with the
‘item_id’, and where items are array based the ‘instance’ is used to
determine which array element is being addressed.
The tester is aware of the data type, the maximum array element
‘instance’ (which is zero if an item is not array based), and the value
range and/or string length for each ‘item_id’. The tester will respond
with the appropriate error code if the wrong command type is used, or
an item is otherwise incorrectly addressed.
See the following chapter for a list of the item identifiers, and their
associated data types etc.
SSSCMD_SS_GET_STRINGN (command code 0x20)
This command is used to read system settings that are based on
strings. Some settings are for a single string, some are for two ore
more strings. Where more than one string is returned, then the strings
are separated by a null terminator. There is no null terminator after the
final string.
SSSCMD_SS_SET_STRINGN (command code 0x21)
This command is used to update system settings that are based on
strings. Some settings are for a single string, some are for two ore
more strings. Where more than one string is supplied, then the strings
must be separated by a null terminator. There is no null terminator after
the final string.
SSSCMD_SS_GET_UINT (command code 0x22)
This command is used to read a system setting that is stored within the
tester as an integer. The tester will supply between 1 and 4 data bytes,
depending on the magnitude of the value being transmitted (rather than
the potential maximum magnitude of a particular setting). When more
than 1 byte is provided, the bytes are in big-endian order.
Your HAL tester