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 |
---|---|
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 |
---|---|
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:
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:
|
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:
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.
|
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 |
For assistance, please submit a ticket via our Support Portal, email autosol.support@autosoln.com or call 281.286.6017 to speak to a support team member.