Get Watchdog Info
[cmdchars] = !U
Description
The Get Watchdog Info command returns all watchdog configuration information for the addressed FieldPoint module.
Each FieldPoint module can be configured to respond to or ignore watchdog timeouts. Also, each output channel can be configured to output a specified value in case of watchdog timeouts. If the watchdog is disabled for a module, none of the channels on the module respond to watchdog timeouts.
Syntax
!U
Success Response
A
A[moduleInfo][chnlEnable][chnlWdgData]
| [moduleInfo] | 10 ASCII-hex characters contain the following information: | ||||||||
| |||||||||
| [chnlEnable] | Four ASCII-hex characters specify the enabled or disabled status of the watchdog for all channels. A "1" in any bit means that the watchdog is enabled for the corresponding channel. A zero in any bit means that the watchdog is disabled for the corresponding channel, that the channel is not an output channel, or that the channel does not exist. If you send !o!U, [chnlEnable] contains eight ASCII-hex characters. | ||||||||
| [chnlWdgData] | Four ASCII-hex characters specify the watchdog output value for each channel. The first four characters correspond to the highest-numbered channel, and so on. If the channel is an output channel corresponding to a "1" bit in [chnlEnable], that channel will output the value of [chnlWdgData] in case of a watchdog timeout. The command returns a [chnlWdgData] for each channel on the module regardless of whether the channel is an output or an input, and regardless of whether watchdog data has been set or stored for the channel. |
Error Responses
| E_INV_LIMS_GOT | Specified limits invalid for the command. |
| E_ILLEGAL_DIGIT | One or more characters in the command could not be properly converted to a digit (hex or decimal). |
| E_NO_MODULE | There is no module at the specified address. |
Refer to FieldPoint Responses for other possible error responses, error numbers, and error descriptions.
Example
>33!U[checksum][cr]
A0100020002000101234567[checksum][cr]
This response indicates that the watchdog is enabled for the module and no timeout has occurred since the watchdog was enabled (0100); the watchdog timeout value is 5.12 s (0200); the module has two channels (02); the watchdog is enabled only for channel 0 (0001); the watchdog data for channel 1 is 0x0123 and the watchdog data for channel 0 is 0x4567.
The following command gets watchdog information from a 32-channel module:
>33!o!U[checksum][cr]
The response is as follows:
A0101031020FFFFFFFF000100000001000000010001000100000001000000000001000100000000000
00001000000010001000000000000000100010001000100010001000000000000[checksum][cr]
This response indicates that the watchdog is enabled for the module and a timeout has occurred since the watchdog was enabled (0101); the watchdog timeout value is 7.84 s (0310); the module has 32 channels (20); the watchdog is enabled for all channels (FFFFFFFF); the watchdog output value for channels 0, 1, 2, 9, 10, 11, 14, 16, 17, 18, 21, 22, 24, 28, and 30 is OFF; and the watchdog output value for channels 3, 4, 5, 6, 7, 8, 12, 13, 15, 19, 20, 23, 25, 26, 27, 29, and 31 is ON.