Program command / response protocol – Digital Audio Labs PowerShape 2.1 User Manual

Page 22

Advertising
background image

Program Command / Response Protocol

Both the serial and network ports use the same command/response protocol. All commands and responses are composed of 7-

bit ASCII characters. Both commands and responses start with an equals sign ('=') and end with an exclamation point ('!').

There are two commands, “get” and “set”.

The get command allows the client to inspect the configuration of the amplifier. The format of a get command is:

=gITEM!

Example: =gov!

GET ITEM

where ITEM is the name of the parameter being inspected. The amplifier will send a response that is in the same format as

the set command.

The set command allows the client to change the configuration of the amplifier. The format of a set command is:

=sITEM:VALUE!

Example: =sov:-20!

SET ITEM VALUE

where ITEM is the name of the parameter being changed and VALUE is the new value for the specified parameter.

ITEM specifies the name of one of the amplifier's parameters. A list of the available parameters follows below, under section

heading “Parameter Item Names”.

VALUE specifies the new value for the specified item. The allowable choices for VALUE are indicated in the description of

each ITEM.

For example, one of the items that can be changed the output volume level. This item is called “ov”. The value for the “ov”

command is specified in ½ dB steps, so to set the output volume -6 dB, the command would be:

=sov:-12!

To get the current output volume, the command would be:

=gov!

and the amplifier would respond with:

=sov:-12!

Characters received by the amplifier that do not occur between the “=” and the “!” are ignored. This allows for clients that

send line termination characters, such as CR and LF, at the end of each line.

!

!

!

!

!

!

!

!

!

!

!

!

22

Advertising