Conventions, Command structure, Appendix c: serial commands – ClearOne XAP TH2 User Manual
Page 32: Appendices ~ appendix c: serial commands, Example

Appendices
~ Appendix C: Serial Commands
28
Technical Services Group ~ 1-800-283-5936 (USA) ~ 1-801-974-3760
The XAP TH2 accepts serial commands through the serial port or the expansion bus. The commands in this manual
pertain only to the XAP TH2. RS-232 serial port protocol is 9,600, 19,200, 38,400 (default), or 57,600 baud; 8
bits, 1 stop bit, no parity. The Flow Control setting for the RS-232 port is on by default.
Conventions
The following typographic conventions are used in this document to describe the different serial commands. use the
Command structure section and the examples as a guide when creating your serial commands.
Convention
Description
Parameters enclosed in < > indicate a mandatory parameter.
[X]
Parameters enclosed in [ ] indicate an optional parameter.
1-8
Parameters separated by a - indicate a range between the values.
4,7,9
Parameters separated by a , indicate a list of available values.
MREF
Words in uppercase bold indicate command text.
DEVICE
Indicates the device type and device number on the expansion bus network. It is composed of a
device type character and a device number. The device type for the XAP TH2 is always 6 and the
device ID will always be 0–15, or * (to select all TH2 units).
Command structure
Commands can be either UPPER CASE or lower case. Also, extra spaces or tabs between arguments in text commands
is allowed. Return values are always in upper case. In order for a command to be recognized by the serial port, the
command must be terminated by a carriage return.
The structure of serial commands is as follows: #DEVICE COMMAND[X ][X]
#
indicates the start of a command line
DEVICE
represents the device type and device number
COMMAND
is the command text
[X] [X]
represents any additional options in the order that they appear in the command descriptions that
follow
Example
A command to enable auto-answer on the XAP TH2 device “0” would have the command line:
#60 AA 1 1. In this command line, 6=XAP TH2, 0=unit 0, AA=command, 1=Telco channel 1, 1=on state. If a
command calls for a “null” value, leave a blank in the command line. For example, #60 AA would return the current
auto-answer state on device 60.
Command responses will have a carriage return line feed. Example: #60 AA 1 1 CR (carriage return line feed).
Appendix C: Serial Commands