User definable Protocol OPC Server Configuration Guide

Allow user to extract data from ASCII string sent by equipment and present them as "tags" in the OPC Server. Designed for use with equipment that uses an operator command sequence. Its uses a pattern matcher to match the incoming data and extract the required information. Output is constructed with using C-style output formatting.

Channel Configuration

Protocol Definition Syntax

<Group Definitions>:

    <Group Definition> ...

<Group Definition>:

    <Group Name>

        <Action Definition> ...   |

    <Group Name I>[fromI, toI]

        <Action Definition> ...   |

    <Group Name I>[fromI,toI]<Group Name J>[fromJ,toJ]

        <Action Definition> ...   |

    <Group Name I>[fromI,toI]<Group Name J>[fromJ,toJ]<Group Name K>[fromK,toK]

        <Action Definition> ...

<Action Definition>:

    Poll <Output Format>     |
    Read <Input Pattern>

        <Data Type> <Item Name> <Replacement Format> ...
        Output <Replacement Format> |

    Write <Output Format>

        <Data Type> <Item Name>

The Poll statement sends the output, it should be followed immediately by the Read statement which parse the expected response. The Poll statement is not required for unsolicited response. The Write statement is for issuing write request.

If no action is defined for a group, all matched input will be stripped from the input before other pattern matching, see StripVT100 in Vestas Wind Turbine example for stripping VT100 commands.

A line beginning with the '#' characters is treated as a comment line, the entire line is ignored. This comment line is used as the description for the next variable declared.

<Group Name>: Name of Group
    <Group Name>[First, Last]: Name of Indexed Group. First is the first index, and Last is the last index
    e.g.
        Turbine[1,9].Blade[1,16].Ring[1,4]
            Read %u\i: Blade %u\j Ring %u\k Speed (%d) RPM\n
                Word Speed $1

    Will match inputs such as
        1: Blade 1 Ring 2 Speed 456 RPM
        2: Blade 2 Ring 3 Speed 654 RPM

    and allow tags such as
        Device1.Turbine1.Blade1.Ring2.Speed
        Device2.Turbine3.Blade2.Ring3.Speed

<Data Type>: User requested data type
    Digital | Byte | Word | Long | Real | Double | String | Date

<Item Name>: Name of Item
    Name |
    Name[Length] Subnames |
    Name[FirstIndex, LastIndex] |
    Name[FirstIndex, LastIndex, ReadSize, WriteSize]

Length	The number of elements in this item. The FirstIndex is set to 0.
Subnames	A optional quoted string to define the sub name of elements in the array.  e.g. [6] "Motion=3,Metric=5" $1 will use bit 3 as the motion bit, and bit 5 as the metric bit
FirstIndex	Defines the first index.
LastIndex	Defines the last index. The number of elements is (LastIndex - FirstIndex) + 1
ReadSize	Defines the maximum number of elements that can be read in one request.
WriteSize	Defines the maximum number of elements that can be written to in one request.

    When defining array, Name may be omitted.

<Input Pattern>: A sequence of <Metacharacters>. Each <Metacharacter> may be followed by a <Quantifier> to specify the minimum number of matches. A trailing '\' will cause the definition to continue to the next line.

<Metacharacters>:

^	Match beginning of line
.	Match any character. .* or .+ is invalid
$	Match end of line. Must be the last character if used.
()	Grouping. Up to 200 groups can be defined.
[]	Character class. e.g. [a-z] for all lower case characters.
[^]	Not in character class. e.g. [^a-z] for all non lower case characters.
\	Quote the next metacharacter
\t	Tab
\n	New line
\r	Carriage Return
\x1B	Hex char. eg \x1A for ctr-z
\w	Match a "word" character (alphanumeric plus "_")
\W	Match a non-word character
\s	Match a whitespace character (space, tab, carriage return new line)
\S	Match a non-whitespace character
\d	Match a digit character
\D	Match a non-digit character
\o	Match an octal character (0-7)
\O	Match an non-octal character.
\h	Match a hexadecimal character (0-9,A-F)
\H	Match a non-hexadecimal character
%04d	Match four decimal digits, the first character can be +,- or a space.
%04u	Match four decimal digits
%04o	Match four octal digits
%u	Match all decimal digits
%f	Same as [-+\x20.0-9E]+
%04x	Match four hexadecimal digits
%c	Match any character
%1b	Match any 1 character
%2b	Match any 2 characters
%2s	Match any 2 characters
\a(0)	Match the device address to the previous pattern
\c(...)	See CRC/LRC/Checksum checking and generation
\i	Set the I index to the previous pattern.
\j	Set the J Index to the previous pattern.
\k	Set the K index to the previous pattern.
\l(width,offset)	Set the byte counter to the (previous pattern * width / 8) + offset
\L+	Match the number of bytes defined by \l
\p	Set StartAddress to previous pattern
\e	Set EndAddress to previous pattern
%4a	Match four non space characters

<Quantifiers>:

*	Match 0 or more times
+	Match 1 or more times

<Output Format>: Use to C-style format the output and transmit it

%[flags][width][.precision]type

flags	Flag Meaning Default - Left align Right align + Prefix output with + or - Prefix with - only for negative values 0 Prefix Pad with '0' No padding blank(' ') Prefix pad with blank No blank appears # Prefix non zero value with 0, 0x or 0X (for o, x or X format) No blank appears
width	Minimum number of characters in output.
precision	Maximum number of characters in output.
type	c Single byte character. d Signed decimal integer. i Signed decimal integer. o Unsigned octal integer. u Unsigned decimal integer. x Unsigned hexadecimal integer using "abcdef". X Unsigned hexadecimal integer using "ABCDEF". e Real of the form [-]d.dddde[+-]ddd. Precision is the number of digits after the decimal point. E Real of the form [-]d.ddddE[+-]ddd. Precision is the number of digits after the decimal point. f Real of the form [-]dddd.dddd. Precision is the number of digits after the decimal point. Default value is 6. g Use f or e format, whichever is more compact. G Use f or E format, whichever is more compact. s String. Precision is the maximum number of characters printed. b Multiple byte character. Low byte first. B Multiple byte character. High byte first. z Multiple byte character. Low byte first. Swap Words Z Multiple byte character. High byte first. Swap Words a ASCII using 0123456789:;<=>?@

    The % format may be followed by the following to use alternate output value. The default is to use the value supplied by the user (The OPC Client).

\a(0)	Device address
\c(...)	See CRC/LRC/Checksum checking and generation
\i	I index.
\j	J Index.
\k	K index.
\p(size,offset)	(StartAddress / size) + offset.
\e(size,offset)	((EndAddress + (size - 1))/ size) + offset
\l(size,offset)	((BitCount + (size - 1)) / size) + offset.
\v(mode)	Modifies how the value supplied by the user is to be used.
\q(0)	Sequence Number + 1

<Replacement Format>: The Replacement Format is used to construct the string value of this item. The string value is converted from the decimal string to the decimal value <Data Type> specified and stored in the <Group Name>.<Item Name>. If the $n string is prefixed by (0x, 0o, 0b or h) then (hexadecimal, octal,  binary or hexstring) conversion is used. The matched group are specified in the replacement format by $n, n starts from 1.

    The string may be prefix by the following characters to control how the input is to be interpreted.

b	Copy bytes.
B	Copy bytes. Swap each pair of bytes.
W	Copy Words. Swap each pair of words.
R	Copy Bytes. Reverse bit order. i.e. bit 0 becomes bit 7, bit 1 becomes bit 6 and etc.,
v	Expands 12 bits to 16 bits
h	The input are ASCII characters (0-9,A-Z)

    Simple string operation can be performed if group n have the following prefixes

$rn	Reverse string
$x(value,start,length)n	XOR each byte from start (decimal) to start + length (decimal) with value (hex). If length is zero, then perform operation on whole string.
$a(value,start,length)n	AND each byte from start (decimal) to start + length (decimal) with value (hex). If length is zero, then perform operation on whole string.
$o(value,start,length)n	OR each byte from start (decimal) to start + length (decimal) with value (hex). If length is zero, then perform operation on whole string.
$e(start,length)n	Extract start (decimal) to start +length (decimal) from string. If length is negative then shorten string by -length.
$t(pos,from,to,length)n	If the character at pos (decimal) at  is equal to from (hex) then change it to to (hex). If length is zero, then perform operation on whole string.
$+(length)n	Lengthen string by length (decimal).

    Simple arithmetic operation on single value can be performed if group n have the following suffixes.

+offset	Add offset to value
-offset	Subtract offset from value
*factor	Multiple value by factor
/factor	Divide value by factor

Timestamping Data

The Date data type will timestamp all subsequent tags with input string. See csvtime.def for an example of timestamping data from a csv file

Device Initialization Sequences

Groups defined before and including the group named "Begin" are automatically used as the device initialization sequences when the device is first opened.

Message Header and trailer

    See Modbus Master RTU for an example.

Device Configuration

Protocol Definition Files

Accuray 1180M

Avtron K936

Durant Ambassador Series Count Control Model 57601-400.

Modbus Master RTU

NEG Micon Wind Turbines

Symbol LS4071 Barcode Scanner

Red lion web server

VESTAS Wind Turbines

Weigh-Tronix Model WI-120 Indicator

ASCII Driver FAQ