Write 16-Bit Data with Status
[cmdchars] = !I
Description
The Write 16-Bit Data with Status command writes output values to targeted analog output channels of the addressed FieldPoint module. The command also returns the status of targeted channels to enable error checking.
Use the Read Module Status (!N) command or the Read Channel Status (!O) command for details about an error condition of a bad channel.
Refer to How to Interpret Data for information about interpreting and converting data.
Syntax
!I[positions][data]
 |
Note The command character is an uppercase I, not a lowercase L. |
| [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[status]
| [status] | Four ASCII-hex characters specify the status of all targeted channels. The most significant bit represents channel 15 and the least significant bit represents channel 0. A "1" in any bit means that the status of the corresponding channel is bad, and a zero in any bit means either that the status of the corresponding channel is good or that the corresponding channel was not targeted by the command. |
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!I000301234567[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). The command also requests the status of the channels. The response is as follows:
A0003[checksum][cr]
The response indicates that both channels have bad status.