e-mail:
voice:
360.854.9559
fax:
866.783.1742
6
STI-II Installation and Operation Manual
DESCRIPTION
COMMAND MODE The STI-II defaults to command mode from power up. When
first entering command mode, all parameters are set to their User Default values.
PARAMETERS Three sets of parameters are: Factory (Firmware) Default; User
Default; and Current Value. All parameters may be viewed and setup from Program
Mode. Program Mode commands provide for restoring all parameters to Factory
(Firmware) Default values, and changing individual parameters. The values select-
ed at the time of exiting program mode are saved as the User Default values. User
Default parameters may be setup/changed from command mode using the appropri-
ate command(s) (See Commands section).
Because we cannot retain all session context across a reset event (relays will glitch
18ms minimum, for instance), we identify a subset of the parameters which main-
tain a Current Value, which may be different from the User Default value. For the
other parameters, the current value IS the user default value. Since the STI-II is
reloaded with user default values at reset time, the board returns to a “known good”
safe application context when a reset occurs. Typically the parameters with a current
value separate from the user default value are “session context” parameters that may
change during the normal computer/STI-II interaction, and the others are “environ-
ment context” parameters that (typically) are set up once and not changed after-
wards. Details about the parameters are found in the Command Table section.
Commands with possible R/W/S prefixes are Session Context parameters.
Commands with possible R/S prefixes are Environment Context parameters.
COMMANDS Command and response bytes never use the most significant bit,
thus supporting 7-bit data RS-232 formats. (Data sent from the STI-II to automation
equipment in response to DTMF macros may be 8-bit data). All commands sent to
the STI-II begin with the ASCII ampersand character ‘&’ (0x26) as a lead-in. One
of four command-type letters is expected immediately after the caret. (Lower case is
forced to upper case before being evaluated, so it is permitted.) The letters are (from
the point of view of the PC control program):
R for read; W for write; S for write and then Set the default value; and C for com-
mand. The command-type letter is immediately followed by 3 ASCII decimal dig-
its, which comprise the command number. One ASCII blank is sent immediately
after the command number.
After the command [and parameter] bytes are sent, the PC control program should
wait for the response: If the command is successful and isn’t required to respond
with data bytes, a single ASCII ‘@’ will be sent as an ACK character. If it fails, a
single ASCII ‘~’ character will be sent as a NAK character. If the command requires
a response but fails, the single ASCII ‘~’ NAK character will be sent. If the com-
mand requires a response and is able to send it, its form will be: An ASCII ‘%’ lead-
in character followed by the required data items. Following the %-initiated response
WEBSITE:
Visit our web site for
product updates and
additional information