Store Attributes

[cmdchars] = !f

Description

The Store Attributes command stores specified channel attribute and range settings in nonvolatile memory for use as powerup settings.

Syntax

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

[positions]

Four ASCII-hex characters specify the targeted channels. A "1" in any bit means that attributes and/or range are to be stored 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_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_INV_ATTR	One or more attributes specified in the command either do not exist or do not support the specified setting.
E_INV_RANGE	One or more ranges specified in the command either do not exist or do not support the specified setting.
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!f0001000110204[checksum][cr]

This command stores settings for attribute 0 and the range for channel 0 of the FieldPoint module at address 51 (0x33). Attribute 0 is set to 0x02 and the range is set to 0x04. Assuming that the module is an FP-AI-110, the settings are for noise rejection of 500 Hz and a range of 0–10.4 V.