Alcorn Mcbride V+ series, User Manual

Page: 247 / 276

15-11 Appendix A
– Adding User-Defined Serial Protocols
Ap
p
end
ice
s
A
format
HH:MM:SS.FF
, and converts it to the format
HHMMSSFF
when
putting it into the compiler buffer. The function @string takes whatever is in
the buffer and puts it into the message to be sent out. This technique
successfully works for several DVD players. If an
@byte function was used by
mistake, only the tens place of the hours of the time
HH
would get put into the
message.
Here are all of the possible function types, and their descriptions.

@byte
– Takes the first byte of the compiler buffer and puts it into the
message.

@word – Takes the first two bytes of the compiler buffer and puts them
into the message.

@length
– Takes the length ( how many bytes there are ) in the compiler
buffer and puts the byte into the message.

@string – Takes however many bytes there are in the compiler buffer and
puts them all into the message.

@decstring
– Takes the first two bytes of the compiler buffer ( a word )
and puts them in the message as three decimal ASCII bytes. If the number
is less than three digits in size, the message has leading zeros.
For example, if the two bytes in the buffer are h9D h03, which yield the word
h039D, which is the number 925 in decimal, @decstring will put "925" ( or in
hex h39 h32 h35 ) in the message.
If the two bytes in the buffer are h62 h00 ( the word h0062 ), which is 98 in
decimal, "098" ( or h30 h39 h38 ) will be put in the buffer.

@hextring – Takes the first two bytes of the compiler buffer ( a word )
and puts them in the message as two hexadecimal ASCII bytes. If the
number is less than two digits in size, the message has leading zeros.
For example, if the two bytes in the buffer are hFA h00, which yield the word
h00FA, which is the number FA in hex, @hexstring will put "FA" ( or in hex
h46 h41 ) in the message.
If the two bytes in the buffer are h0D h00 ( the word h000D ), which is 0D in
hex, "0D" ( or h30 h0D ) will be put in the buffer.

@index – Takes the first byte of the compiler buffer, subtracts one from it,
and puts it into the message. This provides zero-indexed data to be entered.
In other words, when you want the user to put in a number, say 1 to 10, but
the device you're sending to requires 0 to 9, this function will allow that
without much effort.

@hour
– This function takes the first two bytes of the compiler buffer as
an ASCII representation of one byte ( the hour of a time ), and puts it in the
message as one byte. This function assumes you had a
param field of
timestring , which stores HHMMSSFF in the compiler buffer.

@minute
– This function takes the third and fourth bytes of the compiler
buffer as an ASCII representation of one byte ( the minute of a time ), and
puts it in the message as one byte. This function assumes you had a
param
field of timestring , which stores
HHMMSSFF
in the compiler buffer.