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

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