Teledyne CA OPC Items

Standard Items

Protocol Items

Digital Item Format:

Digital items (functions SI and DI) for the Teledyne CA Protocol require the following pattern, with Function Code, Card Number and Bit Address as required parameters. The function code is two characters, the Card and Bit Address are numeric.

{FunctionCode}:{CardNumber}/{BitAddress}

Bit Width and modifiers are optional.

Bit width is a numeric value preceded by a period (.) or an ampersand (&).
- When a period (.) is used before the bit width, ACM will both shift and mask the result.
- When an ampersand (&) is used before the bit width, ACM will only mask the result.
Modifiers are used at the end of the item. See the section labeled "Item Modifiers Supported" for more information.

{FunctionCode}:{CardNumber}/{BitAddress}.{BitWidth}
OR
{FunctionCode}:{CardNumber}/{BitAddress}&{BitWidth}
OR 
{FunctionCode}:{CardNumber}/{BitAddress}{Modifiers}
OR 
{FunctionCode}:{CardNumber}/{BitAddress}.{BitWidth}{Modifiers}
OR 
{FunctionCode}:{CardNumber}/{BitAddress}&{BitWidth}{Modifiers}

Analog Item Format:

Analog items (functions AI and TK) for the Teledyne CA Protocol require the following pattern, with Function Code, Card Number and Analog Point as required parameters. The Function Code is two characters, the Card and Analog Point are numeric.

{FunctionCode}:{CardNumber}/{AnalogPoint}

The Bit Address, Bit Width and modifiers are optional.

The bit address is a number value preceded by a slash ( / ).
Bit width is a numeric value preceded by a period (.) or an ampersand (&).
- When a period (.) is used before the bit width, ACM will both shift and mask the result.
- When an ampersand (&) is used before the bit width, ACM will only mask the result.
Modifiers are used at the end of the item. See the section labeled "Item Modifiers Supported" for more information.

{FunctionCode}:{CardNumber}/{AnalogPoint/{BitAddress}.{BitWidth}
OR
{FunctionCode}:{CardNumber}/{AnalogPoint/{BitAddress}&{BitWidth}
OR 
{FunctionCode}:{CardNumber}/{AnalogPoint/{BitAddress}{Modifiers}
OR 
{FunctionCode}:{CardNumber}/{AnalogPoint/{BitAddress}.{BitWidth}{Modifiers}
OR 
{FunctionCode}:{CardNumber}/{AnalogPoint/{BitAddress}&{BitWidth}{Modifiers}

Function Codes Supported

Function	Two-character code
Analogs	AI
Control Output	CO or DO
Discretes	DI or SI
Momentary Control Output	MCO or MDO
Set Point	AO or SP
Tank	TK (will request 4 analog bytes and convert the response to grey code)

Item Modifiers Supported

Modifier	Description

Modifier	Description
GR	Append a 'GR' to analog item to request four bytes of data and have the response converted to Grey Code. *Optionally use the TK function code without modifiers.
H	Append an 'H' to an analog item to convert the response to BCD.
L	Append an 'L' to an analog item to request 4 bytes of data or append an 'L' to a set point item to write 4-bytes of data.
U	Append a 'U' to to an analog item to process the response as an unsigned value.
^	Append a '^' and a byte order code number to an analog or set point item to apply a specific byte order to the incoming or outgoing values. *See below for Byte Order Code Numbers.
;	Append a ';' and a second card and point number to MCO items

Example Items:

Item	Result

Item	Result
AI:1/1	Returns the 2-byte signed AI value at card 1 point 1
AI:1/1UL	Returns the 4-byte unsigned AI value at card 1 point 1
AI:1/1H or AI:1/1HU	Returns the 2-byte unsigned AI value at card 1 point 1 converted to BCD
AI:1/1GR or AI:1/1GRLU	Returns the 4-byte unsigned AI value at card 1 point 1 converted to Grey Code
AI:1/1L^4	Returns the 4-byte signed AI value at card 1 point 1 in the selected byte order 4
TK:1/1	Returns the 4-byte unsigned AI value at card 1 point 1 converted to Grey Code
DI:5/1	Returns the boolean DI value at card 5, bit number 1
SI:7/3.2	Returns the signed SI value of the first two bits from card 7 bit 3
MCO: 15/15;12/15	If writing a 1, will write to the first card and point (15 and 15). If writing a 0, will write to the second card and point (12 and 15)
CO:6/2	Will write a 1 or 0 to card 6, bit 2
SP:4/1L	Will write a four byte value to card 4 bit 1
AI:0/1/4	Returns the boolean value of the 4th bit on card 0 point 1.
AI:0/1/4.4	Returns the integer value of the 4 bits beginning with the 4th bit on card 0 point 1, masked and shifted to the least important position. Examples: Given the hex result of AI:0/1 of "B6 B9", the value of the 4 bits beginning at the 4th bit is determined as follows: ACM will shift the result 4 points to the right to get a value 0B 6B. ACM will then apply a mask (00 0F) to that result to retrieve the value of the first four points which would be 00 0B, or integer value 11. Given the binary result of AI:0/1 of 1011 0110 1011 1001, the value of the 4 bits beginning at the 4th bit is determined as follows: ACM will shift the result 4 points to the right to get a value of 0000 1011 0110 1011. ACM will then apply a mask (0000 0000 0000 1111) to that result retrieve the value of the first four points which would be 0000 0000 0000 1011, or integer value 11.
AI:0/1/4&4	Returns the integer value of the 4 bits beginning with the 4th bit on card 0 point 1, masked only. Examples: Given the hex result of AI:0/1 of "B6 B9", the value of the 4 bits beginning at the 4th bit is determined as follows: ACM will apply a mask (00 F0 ) to that result to retrieve the value of the first four points which would be 00 B0, or integer value 176. Given the binary result of AI:0/1 of 1011 0110 1011 1001, the value of the 4bits beginning at the 4th bit is determined as follows. ACM will then apply a mask (0000 0000 1111 0000) to that result retrieve the value of the first four points which would be 0000 0000 1011 0000, or integer value 176.

Byte Order Code Numbers

Code Number	Message Bytes	Assembled Order	Notes
1	1234	1234	No Change
2	1234	2143	Change byte order
3	1234	3412	Change word order
4	1234	4321	Change both