Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

Type

...

Description

...

TLP TLP Data Type for user defined points

...

ASCII character string, length of 20
Data OptionDescription

<TBIN>

Binary<TAC>

<TACn>

ASCII 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>

...

Itemname<TFLP>{10:3}<AC><PRIMARY><I1>
Itemname<ac>{10:3}<TFLP><i1><primary>

Bit Access of Data

Bits of any Integer type items can be accessed individually. To access a single bit, use the normal DDE item name for the item and append a slash (/) followed by the bit number. Bit numbers start at zero (0) for the first bit. For example, to access the Low Low Alarm (bit 1) of Discrete Input point number 3, use the item name DI.ALARM_CODE:2/1. The slash and bit number must follow the item name and number and precede any optional specifications.