beautypg.com

Conventions, Command structure, Appendix c: serial commands – ClearOne XAP TH2 User Manual

Page 32: Appendices ~ appendix c: serial commands, Example

background image

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