Alcorn Mcbride V+ series, User Manual

Page: 244 / 276

15-8 Appendix A
– Adding User-Defined Serial Protocols
example, the string
"HELLO" 0xAA 50 0 "GOODBYE" h2E
is perfectly
valid. The compiler changes all the characters in quotes into ASCII bytes,
and puts the entire string into the compiler buffer.

“
literal
”
– Accepts a string which is exactly what is specified, non-case
sensitive. For example, if the user entered "bAnK1" for the parameter, and
the
param field is ParamX="bank1" the parameter will validate. The
compiler changes all the characters in quotes into ASCII bytes, and puts the
entire string into the compiler buffer.

datastring
– Must match the name of a data string in the
Configuration |
Data Strings window. The data string must conform to the same
restrictions as string. Puts the entire string into the compiler buffer.

lcdstring
– Must match the name of an LCD string in the
Configuration
| LCD Strings window. The LCD string must conform to the same
restrictions as string. Puts the entire string into the compiler buffer.

framestring
– Must be a number between 0 and 999999 inclusive. Puts
the entire string into the compiler buffer.

timestring – Must be a valid time in the form HH:MM:SS.FF . HH must
be a number between 0 and 23 inclusive. MM must be a number between 0
and 59 inclusive. SS must be a number between 0 and 59 inclusive. FF
must be a number between 0 and 29 inclusive. Puts the entire string without
the colons or period into the compiler buffer. If the hour, minute, second,
or frame values are less than 10, a leading zero is put into the message for
that byte. For example, a time of
2:04:16.09
would get put into the buffer
as 02041609 .

trackstring
– Must be a valid track and index in the form TT-II. TT must
be a number between 0 and 99 inclusive, and II must be a number between
0 and 99 inclusive. Puts the entire string without the hyphen into the
compiler buffer. If the track or index values are less than 10, a leading zero
is put into the message for that byte. For example, a track index of
1-3
would get put into the buffer as
0103
.

contains – This param has a required argument which is the byte that the
text must contain to be valid. For example,
paramX=contains(Q)
means
that the parameter must contain the letter 'Q' ( not case sensitive ) in order to
be valid. The compiler removes the argument from the parameter, and puts
the entire string without it into the compiler buffer. For example, the
parameter
equipment would result in the string equipment being put into the
compiler buffer.
The contains param has an optional argument, which is designed to replace the
found byte. The required argument and optional argument are separated by a
colon.
ParamX=contains(Q:h41)
In this example, the parameter is validated if a 'Q' was found in the parameter.
If it was, the compiler removes the 'Q', but since the optional argument is in