Advent Communications
209298 - DVE5000 Technical Operation Handbook - CL140042
Page 68 of 110
8.6. COMMANDS, QUERIES AND RESPONSES
8.6.1 Definitions
A
command
is an instruction sent from the remote PC to the unit to change some
operating parameter or display mode.
A
query
is an instruction sent from the remote PC to the unit for the unit to report
one, or many, operating parameter.
A
response
is some data sent from the unit to the remote PC that gives the answer
to a query.
8.6.2
Response to valid commands
The response to a valid remote command is an echo back of the command (with
associated parameters). This indicates that the command has been accepted and the
unit will
attempt
to action the command.
Note:
Receiving a response of this type
does not
mean that the command has been
actioned. Generally, the action will occur after the response has been sent.
This is to ensure that all responses are returned quickly. (Average response
time <300ms). If you want confirmation that a change has taken place, you
must send a query and then look at the response.
Example
Command to set the transmit gain to -20.0dB.
The command is ‘GT’ and the valid range for the parameters is 000 to 400.
Command sent
GT200
Response from unit
GT200
Result – this response indicates that the unit will set the transmit gain to –20.0dB
Leading Zeros & Decimal Places
A command does not necessarily need to have the leading zeros set in the parameters
e.g. WVAUD767 will be accepted as valid in the same way that WVAUD0767 is.
The response, however, will be sent with the correct formatting with the leading zeros
set and similarly, with the correct number of decimal places sent.
Examples:
Command sent
WCARRx
Response
RCARRx
Command sent
WRGAIxxx.x
Response
RRGAIxxx.x
Data Send with a Read Command
If any parameters or extra characters are sent with a valid read command, they will be
ignored and the read command actioned as per this specification.