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).