Range of values, Compound range of values – Comtrol AT Commands User Manual

Page 25

Advertising
background image

AT Commands for CX81801/CX06833/CX81300/CX06827 Modems Reference Manual

102184B

Conexant

2-11

Fax Modes. If a single value is to be reported, the form of the result code is:

<value> or (<value>)

2.7.3

+<name>: <compound_value>Information Text Formats for Test Commands

In general, the format of information text returned by extended syntax commands is
described in the definition of the command.

The modem may insert intermediate <CR> characters in very long information text
responses in order to avoid overrunning DTE receive buffers. If intermediate <CR>
characters are included, the modem does not include the character sequences "0 <CR>"or
"OK<CR>", so that DTE can avoid false detection of the end of these information text
responses.

Range of Values

When the action accepts a single numeric subparameter, or the parameter accepts only
one numeric value, the set of supported values may be presented in the information text
as an ordered list of values. The list is preceded by a left parenthesis (() , and is followed
by a right parenthesis ()). If only a single value is supported, it appears between the
parentheses. If more than one value is supported, then the values may be listed
individually, separated by comma characters, or, when a continuous range of values is
supported, by the first value in the range, followed by a hyphen character (-), followed by
the last value in the range. The specification of single values and ranges of values may be
intermixed within a single information text. In all cases, the supported values are
indicated in ascending order.

For example, the following are some examples of value range indications:

(0)

Only the value 0 is supported.

(1,2,3)

The values 1, 2, and 3 are supported.

(1-3)

The values 1 through 3 are supported.

(0,4,5,6,9,11,12) The

several

listed values are supported.

(0,4-6,9,11-12)

An alternative expression of the above list.

Compound Range of Values

When the action accepts more than one subparameter, or the parameter accepts more than
one value, the set of supported values is presented as a list of the parenthetically-enclosed
value range strings described above, separated by commas. For example, the information
text in response to testing an action that accepts three subparameters, and supports
various ranges for each of them, could appear as follows:

(0),(1-3),(0,4-6,9,11-12)

This indicates that the first subparameter accepts only the value 0, the second accepts any
value from 1 through 3 inclusive, and the third subparameter accepts any of the values 0,
4, 5, 6, 9, 11, or 12.

Advertising