R
12
RadioTouch
TM
RTA-RS232 Programming and Operation Guide
Command Set
General Command Structure
All commands are sent as ASCII characters.
Numerical data fields are the ASCII representation
of the decimal value.
There should be no spaces between characters.
Each command has a prefix, a limited number of
fields, and an end character. All commands from
the Host device will have a prefix of a colon, :, and
an end character of a carriage return, <CR>. All
responses from the RTA-RS232, except for the
prompt, will have a prefix of a tilde, ~, and end
with a carriage return, <CR>. Each field is
separated by a comma.
Command Format
:Command,[Parameters],{Extended Parameters}<CR>
:
Indicates start of command
,
Field Separator
Command
Command as shown
Parameters
Zone number or other parameters relevant to the command
Extended Parameters
Parameters that do not apply to all variations of a particular command
<CR>
Carriage Return, ASCII character 13d – indicates end of command
If your equipment does not support the transmission of ASCII characters, you will need to convert the messages
from ASCII to whatever form your equipment supports, i.e. hexadecimal. For example, to command the RS-232
Interface to set zone one to preset one, the ASCII text command :PS,1,1<CR> is issued:
ASCII
:
P
S
,
1
,
1
<CR>
Hexadecimal 3A
50
53
2C
31
2C
31
0D
See page 26 for an ASCII to hexadecimal conversion table.