Zektor Switch Serial Protocol, Version 0.16, 5/13/16
27
Command Syntax
Command Syntax
Command Syntax
The Zektor Switch serial command set uses an ASCII based protocol and a terminal emulator can be
used to test the serial port of the Zektor Switch. Here are some examples:
^SZ @1,4$
= Set audio zone 1 to source 4
^HSZ @1:3,5$
= Set HDMI zones 1-3 to source 5
^VPZ @8,+2$
= Turn up the volume 2% on zone 8
^SZ @1:32,3$
= Set analog audio zones 1-32 to source 3
^BAZ @16:32,-2
= Lower the bass on zones 16-32 by 1dB
Each serial command is formatted as:
^CMD param1,param2,...$
Where:
^
= All commands and responses start with the ‘^’ character.
CMD
= The name of the command.
param
= Any number of parameters can follow a command.
$
= All commands and responses end with the ‘$’ character.
For instance the name of the command to turn power on / off is ‘
P
’ (must be capitalized) therefore, to
turn on the Zektor Switch send:
^P 1$
->
Command sent to the A/V switch
^+$
<-
Acknowledgment indicating valid command
^=P 1$
<-
Response from the A/Vswitch for new setting
to turn off the Zektor Switch send:
^P 0$
->
Command sent to the A/V switch
^+$
<-
Acknowledgment indicating valid command
^=P 0$
<-
Response from the A/V switch for new setting
N
OTE
:
Only the characters between ‘^’ and ‘$’ are valid, any characters sent before the ‘^’ or after the ‘$’
will be ignored.
N
OTE
:
Space characters are optional. For instance “
^P 1$
” and “
^P1$
” are the same command.
N
OTE
:
Carriage Returns and Line Feeds are allowed, and are ignored.
N
OTE
:
By default, the Zektor Switch adds a carriage return and a line feed to the end of its responses, after
the ‘$’. This makes testing with terminal software easier. Since they are outside the ‘^’ and ‘$’ char-
acters, they should be ignored by software drivers. If desired, this behavior can be disabled. (See:
“‘XS’ Control Settings” on page 52)
Command Responses
Type of Responses and Timing Information
There are three different types of responses: Acknowledgements, Errors and Query Strings.
By default, the Zektor Switch will always respond to a command, there are no “time-out” modes, if
you send a command and don’t get a response within 100ms, something’s wrong with the connection.
