Write 16-Bit Data
[cmdchars] = !H
Description
The Write 16-Bit Data command writes output values to targeted output channels of the addressed FieldPoint module.
Refer to How to Interpret Data for information about interpreting and converting data.
Syntax
!H[positions][data]
| [positions] | Four ASCII-hex characters specify the targeted channels. A "1" in any bit means that the command writes a value to the corresponding channel. A zero in any bit means that the corresponding channel is not targeted. |
| [data] | Four ASCII-hex characters specify the output value for each targeted channel. The first four characters specify the value for the channel corresponding to the most significant "1" in the [positions] field, and so on. Each set of four characters represents an unsigned 16-bit number. |
Success Response
A
Error Responses
| E_INVALID_CMD | Undefined command. |
| E_INSUFF_CHARS | Data field error. An insufficient or incorrect number of characters were received 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_INV_CHNL | One or more channels specified in the command either do not exist or do not support the specified operation. |
| 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!H000301234567[checksum][cr]
This command writes the output value 0x4567 to channel 0 and the output value 0x0123 to channel 1 of the FieldPoint module at address 51 (0x33).