Versions Compared

Key

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


Type

Description

I1one-byte character
UI1unsigned one-byte value sent to the client as an I2
I2signed two-byte integer
UI2unsigned two-byte integer
I4signed four-byte integer
UI4unsigned four-byte integer
R4single precision IEEE floating point
BOOLBoolean (on/off) value
STRINGString
TLPA 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. 

TLP Data Type for user defined points

The TLP data type in the ROC RTU is a way to access data using indirect addressing. Instead of addressing the desired value directly, first an intermediate address is read that contains the desired value’s address. The ROC.dll can rebuild the message using this address to read the final desired value. After the address is read, the final value can also be changed by writing a new value to this item.

Example: The item USER_OPCODE.DATA_01 has a TLP data type.

The address of the final value can be read using this item’s name as is. If the final value is floating point, then the final value can be read by appending the data type option <TFLP> to the end of the item name (USER_OPCODE.DATA_01<TFLP>).

Other options are listed below.

Data OptionDescription

<TBIN>

Binary

<TAC>

ASCII character string, length defined in the ROC.dll

<TAC20>

ASCII character string, length of 20

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

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

This option can be combined with other options like the <TAC>, the {Gain:Offset}, the <C1> or <C2> and the <I#> options. The <Data Type> option, the {Gain:Offset} option and the <TAC> option can be written in any order but must precede the <C1>, <C2> and <I#> options. All options are case insensitive.

Example: Use USER_OPCODE.DATA_01<TFLP>{10:3}<TAC><C1><I2>