Type | Description |
|---|---|
| I1 | one-byte character |
| UI1 | unsigned one-byte value sent to the client as an I2 |
| I2 | signed two-byte integer |
| UI2 | unsigned two-byte integer |
| I4 | signed four-byte integer |
| UI4 | unsigned four-byte integer |
| R4 | single precision IEEE floating point |
| BOOL | Boolean (on/off) value |
| STRING | String |
| TLP | A special type, String (T, L, P) denotes the ROC items that do not contain data, but instead contain the definition of another item. See TLP Data Type notes below. |
...
| Data Option | Description | ||
|---|---|---|---|
<TBIN> | Binary<TAC> | ||
<TACn> | ASCII character string, length of 20ASCII character string, length defined in the ROC.dll | <TAC20> | . The exact length of the user defined point (n) is required when using TLP datatype. The length should match the length of the point being read from the device. You will replace the (n) with your length value. EX. <TAC12> |
<TINT8> | Signed 8-bit Integer | ||
<TINT16> | Signed 16-bit Integer | ||
<TINT32> | Signed 32-bit Integer | ||
<TUINT8> | Unsigned 8-bit Integer | ||
<TUINT16> | Unsigned 16-bit Integer | ||
<TUINT32> | Unsigned 32-bit Integer | ||
<TFLP> | Floating Point – IEEE Format | ||
<TTLP> | Type, Point or Logical Number, Parameter Number. Default type. | ||
<TSTR> | ASCII character string, length defined in the ROC.dll. Same as <TAC> | ||
<TSTR20> | ASCII character string, length of 20. Same as <TAC20><TSTRn> | Same as <TACn> | |
<TI1> | Signed 1-byte Integer. Same as <TINT8> | ||
<TI2> | Signed 2-byte Integer. Same as <TINT16> | ||
<TI4> | Signed 4-byte Integer. Same as <TINT32> | ||
| <TUI1> | Unsigned 1-byte Integer. Same as <TUINT8> | ||
<TUI2> | Unsigned 2-byte Integer. Same as <TUINT16> | ||
| <TUI4> | Unsigned 4-byte Integer. Same as <TUINT32> | ||
| <TR4> | 4-byte Floating Point – IEEE Format. Same as <TFLP> | ||
<TR8> | 8-byte Floating Point – IEEE Format | ||
| <TTIME> | Arithmetic time representing the number of seconds elapsed since 12:00AM Jan 1, 1970. Used for timestamps in ROC protocol. | ||
| <TJULIAN> | Arithmetic time representing the number of seconds elapsed since 12:00AM Jan 1, 1970. Used for timestamps in ROC Plus protocol. |
...
Examples: Itemname<TFLP>{10:3}<AC><PRIMARY><I1>Itemname<ac>{10:3}<TFLP><i1><primary>
Alarm Code Quality Flag
I/O points have an alarm code that can be read by the (PointType.ALARM_CODE) parameter. This alarm code can also be read simultaneously with the value of the point using the optional item format: Itemname<AC>. When the <AC> option is used, the Alarm Code for that point will be returned in the quality flag of the item. If the Alarm Code is zero and communication is good, the quality of the item will be Good. If the Alarm Code is non-zero and communication is good, then the quality will be Uncertain. If the communication is not good, then the quality will be Not Connected or Communications Failure. This option can be combined with other options like the <Data Type>, {GAIN:OFFSET}, <PRIMARY> or <SECONDARY> and <I#> options. The <Data Type> option, the {GAIN:OFFSET} option and the <AC> option can be written in any order but must precede the <PRIMARY>, <SECONDARY> and <I#> options. All options are case insensitive.
Examples:
Itemname<TFLP>{10:3}<AC><PRIMARY><I1>
Itemname<ac>{10:3}<TFLP><i1><primary>
Primary and Secondary Connections
Each item name can be followed by the optional <Primary> or <Secondary> specification. When one of these is included in the item name, the data will be retrieved using the primary or secondary connection (as specified) instead of the current connection. This option can be combined with other options like the <I#>, <AC>, and {GAIN:OFFSET} options. The <Primary> or <Secondary> option and the <I#> option can be written in any order but must follow the <Data Type>, <AC> and {GAIN:OFFSET} options. All options are case insensitive.
Examples:
Itemname<TFLP>{10:3}<AC><PRIMARY><I1>
Itemname<ac>{10:3}<TFLP><i1><primary>
...