Versions Compared

Key

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

Standard Items

...

 ModifierDescription
 GRAppend 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.
 HAppend 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.
 UAppend 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

...

ItemResult
 AI:1/1Returns the 2-byte signed AI value at card 1 point 1
 AI:1/1ULReturns the 4-byte unsigned AI value at card 1 point 1
 AI:1/1H or AI:1/1HUReturns the 2-byte unsigned AI value at card 1 point 1 converted to BCD
 AI:1/1GR or AI:1/1GRLUReturns the 4-byte unsigned AI value at card 1 point 1 converted to Grey Code
 AI:1/1L^4Returns the 4-byte signed AI value at card 1 point 1 in the selected byte order 4
 TK:1/1Returns the 4-byte unsigned AI value at card 1 point 1 converted to Grey Code
 DI:5/1Returns the boolean DI value at card 5, bit number 1
 SI:7/3.2Returns 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/2Will write a 1 or 0 to card 6, bit 2
 SP:4/1LWill write a four byte value to card 4 bit 1
AI:0/1/4Returns 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:

  1. ACM will shift the result 4 points to the right to get a value 0B 6B.
  2. 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:

  1. ACM will shift the result 4 points to the right to get a value of 0000 1011 0110 1011.
  2. 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:

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

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

...