Real Time Automation, Inc.
25
1-800-249-1612
ASCII Configuration
– ASCII Parsing
The ASCII Parsing feature allows you to break apart an incoming ASCII string by delimiter or character
offset into multiple data fields. You can then apply a data type to the fields and deliver them to user
defined locations in the mating protocol. Click the
ASCII Parsing (Optional)
button at the bottom of the
ASCII Configuration page to access the ASCII Parsing Configuration page for this device.
1)
Max Number of Fields:
This indicates the max number of fields the ASCII data will be parsed into
(up to 50 values per message).
2)
Min Number of Fields:
This indicates the min number of fields that must be present in an ASCII
string for the message to be considered valid. An error will be flagged if the actual number of
fields is less than this value.
3)
Parsing Delimiter:
This defines the delimiter that will be used to parse an ASCII message. If
delimiters are not present, select UNUSED and use the length fields to parse the message.
4)
Start Location & Length:
a.
If a Parsing Delimiter is used, the
Start Location
will be the first character of the data
field. The
Length
will be the number of characters from the Start Location. If the
Length
is 0, the gateway will read the entire field.
b.
If the Parsing Delimiter is unused, then the
Start Location
will be the first character of
the string. The
Length
will be the number of characters from the Start Location. If the
Length
is 0, the gateway will read the entire message from the
Start Location
to the end
of the ASCII string.
5)
Data Type:
Select the data type of the parsed value.
6)
Internal Tag Name:
Enter a name to reference this tag within the gateway’s display and
mapping pages.