Execute Channel Command
[cmdchars] = !n
Description
Execute Channel Command executes commands specific to certain types of channels on some FieldPoint modules.
Syntax
!n[positions]{[command type][command] pairs}
| [positions] | Four ASCII-hex characters specify the targeted channels. A "1" in any bit means that the corresponding channel is targeted by a channel command. A zero in any bit means that the corresponding channel is not targeted. |
{[command type][command] pairs}
For each "1" bit in the [positions] field, there must be a [command type][command] pair. The first pair corresponds to the most significant "1" in the [positions] field, and so on. This command can contain up to 16 pairs, one for each channel represented by a "1" in the [positions] field.
| [command type] | Four ASCII-hex characters form a 16-bit mask. A "1" in any bit means that the corresponding channel command is to be executed. Setting this field to 0000 causes no command to be executed. |
| [command] | Two ASCII-hex characters form each command ID entry. This field must contain one such entry for each "1" bit in the preceding [command type] field. Each entry specifies the command of the corresponding typ to be executed. |
The following topics contain definitions of command types and command IDs for FieldPoint I/O modules that support commands:
| [c]FP-CTR-500 | [c]FP-CTR-502 | [c]FP-PG-522 | [c]FP-QUAD-510 |
Success Response
A
Error Responses
| E_INSUFF_CHARS | Data field error. An insufficient or incorrect number of characters were received for the command. |
| E_INV_CHNL | One or more channels specified in the command either do not exist or do not support the specified operation. |
| E_INV_ATTR | One or more [command type][command] pairs specified in the command either do not exist or are not valid for the targeted channels. |
Refer to FieldPoint Responses for other possible error responses, error numbers, and error descriptions.
Example
>01!n0008000102[checksum][cr]
In this example, the FieldPoint module at address 1 is an FP-CTR-500. The command executes the control command (0x0001) Increment Counter (0x02) on counter channel 3 (0x0008).