Keep It Simple Serial™); The K.i.s.s.™ Command Structure; K.i.s.s.™ (Keep It Simple Serial™) - Zektor CVS4 User Manual

K.I.S.S.™ (Keep It Simple Serial™)
The K.I.S.S.™ Command Structure
The following conventions are used to describe the protocol:
<CR>
= An ASCII Carriage Return ('0D' hex)
<LF>
= Line Feed ('0A' hex)
<ESC> = An Escape character ('1B' hex)
CMD
= A command, consisting of only alpha characters (A-Z, a-z).
ERR
= An error code value, consisting of only decimal digits (0-9).
Device
Controller
Parameter
A K.I.S.S.™ command in its simplest form is a CMD following by a <CR> for instance:
V<CR>
This will return the version number of a Zektor device.
A command can have a variable number of parameters with optional whitespace(s) following the
command, for instance:
P1<CR>
or
P 1<CR>
will turn on the power of most Zektor devices. The spaces between the 'P' and '1' are optional.
Since commands consist of alpha characters only, there can never be a 'P1' command and 'P1'
will always be interpreted as 'P 1'.
When a command has more than one parameter, the parameters are separated by either
whitespace(s) or a comma, or both whitespace(s) and a comma, for instance:
LI 3 13<CR>
or
LI 3 , 13<CR>
will set the lower and upper LED front panel intensity levels of most Zektor devices. Once again
the space between the command and 1st parameter is optional. Space(s) may also appear
before and after the comma.
The comma is optional between parameters except when it is necessary to indicate a default
parameter, for instance:
LI ,13<CR>
would set the upper intensity level of the front panel LEDs without affecting the lower level. The
comma is used to indicate the 1st parameter is not supplied and the default value should be
used (in this case the value defaults to the current setting, leaving the value unchanged). The
2 CVS4 Component Video Switch
= The Zektor device being controlled.
= A PC or other system, used to control the Zektor device.
= A decimal value that may, in some cases, be prefixed with '+' or '-' (+,-,0-9).