Wombat Command Processor:
The Serial Wombat supports ASCII commands, meant to be easy to use and sent from a terminal, and binary commands, meant to be efficient and sent by a program.
However, it is often desirable to send a binary command using the
terminal for debugging purposes. Because many binary characters can't be typed,
the Wombat supports a command which allows a number of ascii commands to be
combined into a single binary equivalent command.
(See the protocol page for details of this command).
Converting binary commands to their ASCII equivalents is a tedious and error prone task. However, it's easily done by a computer. This script does that conversion. Any of the examples in the Serial Wombat documentation can be copied into this form and converted into strings which can then by sent by a terminal such as Hyperterminal. Simply copy in the commands, press the submit button, then cut and paste the generated string into Hyperterminal.
Commands are entered one per line. Each command must be made up of 8 bytes. All bytes must be separated by a space.
A byte can be declared in one of three ways:
Decimal: A number between 0 and 255. Any number with no other markings will be interpreted as decimal.
Hex: A hex number between 0 and 255, expressed with leading 0x, for example 0x55. Upper or lower case may be used for letters.
Character: A single ascii character can be entered between single quotes. For example, 'U' equates to 0x55, or decimal 85.
A 16 bit word can be entered in hex. This word will be broken into two bytes.
For example, 0x0000 will be broken into 0x00 0x00, and 0x1234 will be broken into 0x12 0x34.
An unsigned 16 bit word can be entered in decimal by adding _u16 to its end. For instance, 10000 can be entered as a two-byte value by typing
10000_u16.
Comments may be added to the end of a line. Comments start with a semicolon (;) and extend to the end of the line.
A quote character cannot immediately follow a semicolon in a comment, as this will confuse the parser.