Command length, Control commands, Argument separation – Polycom C16 User Manual

Page 353: Integer arguments

Advertising
background image

Command Protocol Reference Guide

A - 11

Command Length

All commands must be less than or equal to 2048 bytes in length, including the

terminator.

Control Commands

Most of the commands in the SoundStructure control protocol fall under the

category of control commands. All control commands have the following

syntax:

<action> [<arg> [<arg> [<arg> ... ]]]<term>

where <action> specifies the system-defined command action and the <term>

field is the command terminator.
The <arg> fields comprise the <data> portion of the command. They contain

zero or more arguments specific to the given command action. The [ and ]

characters are not present in the actual command, they are used here to

indicate that the <arg> parameters are optional, depending on the

requirements of the given command action.
General requirements for the syntax of the <arg> fields are given in the

following subsections. Specific requirements for the <arg> fields are given in

previous sections which describe the syntax of channel definition commands

and parameter commands, respectively.

Argument Separation

Control commands sent to SoundStructure must have all <arg> parameters

separated by one or more space (0020) or tab (0009) characters. Using a single

space is preferred, but SoundStructure supports multiple space and tab

characters.
Control commands generated by SoundStructure have all <arg> parameters

separated by exactly one space character.
All arguments of control commands will be one of the following types: integer

arguments, floating-point arguments, system-defined text arguments, or

user-defined text arguments.

Integer Arguments

Integer arguments represent an integer value. They are represented using a

string of digits (0030-0039) with an optional leading plus symbol (002B) or

minus symbol (002D). Examples of valid integer arguments are 5, -2, and +7.

Integer arguments must be less than or equal to 32 bytes in length.

Advertising
This manual is related to the following products:

C8, SR12, C12