Set Attributes

FieldPoint Optomux Programming

previous page next page

Set Attributes

[cmdchars] = !D

Description

The Set Attributes command sets the levels that channels of the addressed FieldPoint module will output if the watchdog timer expires. This command can be sent only to analog modules.

Syntax

!D[positions]{[attrMask][rangeMask][settings] triplets}

[positions]Four ASCII-hex characters specify the channels to be configured. A "1" in any bit means that attributes and/or range are to be set for the corresponding channel. A zero in any bit means that the corresponding channel is not targeted.

{[attrMask][rangeMask][settings] triplets}

For each "1" bit in the [positions] field, there must be an [attrMask][rangeMask][settings] triplet. The first triplet corresponds to the most significant "1" in the [positions] field, and so on. This command can contain up to 16 triplets, one for each channel represented by a "1" in the [positions] field.

[attrMask]Four ASCII-hex characters specify attributes to be set. The most significant bit corresponds to attribute 15, and the least significant bit corresponds to attribute 0. A "1" in any bit means that the corresponding attribute is targeted. A zero in any bit means that the corresponding attribute is not targeted. If an attribute is targeted, an entry for it must appear in the [settings] field of this triplet.
[rangeMask]One ASCII-hex character indicates whether or not the command sets a range. A "1" means that the range is targeted. A zero means that the range is not targeted. If the range is targeted, an entry for it must appear in the [settings] field of this triplet.
[settings]Two ASCII-hex characters correspond to each "1" in the preceding [attrMask] field. If the value in the [rangeMask] field is a "1," this field must contain an additional two-character entry for the range. The first (most significant) entry in this field corresponds to the first "1" in the [attrMask] field, and so on. If this field includes a range entry, the range entry is the last in the field.

Each two-character entry represents a setting ID for a channel attribute or range. The following topics contain definitions of attribute and range IDs for all FieldPoint I/O modules:

[c]FP-AI-100 [c]FP-AI-102 [c]FP-AI-110
[c]FP-AI-111 cFP-AI-112 cFP-AI-118
[c]FP-AIO-600 [c]FP-AIO-610 [c]FP-AO-200
[c]FP-AO-210 [c]FP-CTR-500 [c]FP-CTR-502
[c]FP-DI-300 [c]FP-DI-301 [c]FP-DI-304
[c]FP-DI-330 [c]FP-DIO-550 [c]FP-DO-400
[c]FP-DO-401 [c]FP-DO-403 [c]FP-DO-410
[c]FP-PG-522 [c]FP-PWM-520 [c]FP-QUAD-510
FP-RLY-420 cFP-RLY-421 FP-RLY-422
[c]FP-RTD-122 cFP-RLY-423 cFP-RLY-425
[c]FP-RTD-124 [c]FP-SG-140 [c]FP-TC-120

Success Response

A

Error Responses

E_INVALID_CMDUndefined command.
E_INSUFF_CHARSData field error. An insufficient or incorrect number of characters were received for the command.
E_ILLEGAL_DIGITOne or more characters in the command could not be properly converted to a digit (hex or decimal).
E_INV_CHNLOne or more channels specified in the command either do not exist or do not support the specified operation.
E_INV_ATTROne or more attributes specified in the command either do not exist or do not support the specified setting.
E_INV_RANGEOne or more ranges specified in the command either do not exist or do not support the specified setting.
E_NO_MODULEThere is no module at the specified address.

Refer to FieldPoint Responses for other possible error responses, error numbers, and error descriptions.

Example

>33!D0001000112244[checksum][cr]

This command sets attribute 0 and the range for channel 0 of the FieldPoint module at address 51 (0x33). Attribute 0 is set to 0x22 and the range is set to 0x44.

previous page start next page