Zektor CVS4 User Manual Supplement Download

Page: 7 / 17

CVS4 Component Video Switch

CVS4 Command Reference

The CVS4 K.I.S.S.™ Command Reference

This section defines the K.I.S.S.™ commands that are available to the users of the CVS4.
Note: The CVS4 has been designed as somewhat of a drop in replacement for one of our previ-

ous products, the HDS4.2. As such, some CVS4 commands exist for backwards compatibility

with the HDS4.2. In such cases it will be indicated that these commands are specifically for

HDS4.2 compatibility and an alternative command should be used for new controller implemen-

tations. In most cases the newer commands will have better support for multiple output devices

(such as matrix switches), and using the newer commands will make your drivers easier to

update as our new products are released. It is our intent to keep the command set between our

products as similar as possible, in an effort to make updating drivers as easy as possible.

Error Response Codes

The following are the Error Response codes that can be returned by the CVS4.

!1<CR><LF>

Unrecognized command.

!2<CR><LF>

A parameter was out of range.

!3<CR><LF>

Syntax error, badly formed command.

!4<CR><LF>

Checksum or CRC-8 error.

!5<CR><LF>

Too many or too few parameters.

!6<CR><LF>

System busy cannot process command.

!7<CR><LF>

Buffer overflow.

And some more detailed descriptions of their meanings:
Error 1: The command given was not recognized as a CVS4 command. Commands are case

sensitive and in the CVS4, all commands are upper case.
Error 2: One of the parameters given was too large, or too small, the command will be ignored.
Error 3: Something was wrong with the command's syntax. There was possibly extra data at the

end of the line, or non-decimal data as part of a parameter. There cannot be whitespace before

or after a checksum or CRC-8 checkcode, or this error will be returned.
Error 4: The ';' or ':' character was used to indicate a Checksum or CRC-8 Checkcode was

appended to the command string, but the Checksum or CRC-8 Checkcode did not match the

calculated one. The command will be ingnored.
Error 5: The number of parameters given does not match the number allowed by this command.
Error 6: To prevent conflicts between the front panel Setup Mode and the serial port settings,

when the CVS4 is in the Setup Mode, many parameters become read only and any attempt at

writing them will return Error 6. The “Front Panel Button Emulation” command with button code

‘0’ can be used to exit the Setup Mode, at which point the command can be re-issued without an

Error 6 response.

Error 7: An internal buffer has overflowed, for instance more than 16 button codes were sent as

part of the “Front Panel Button Emulation” command.

The CVS4 Command Set

Each command will be listed in all the different ways it can be issued. Usually each command

has two different ways of being issued. The first is used to set its value, the second as a query

command.
If the command has an associated response string, it will also be listed.
As described in the section on the K.I.S.S.™ protocol, whitespaces and commas are optional

in many cases. The format used here includes a single space after the command and com-

mas, with no spaces, between parameters. The format given here does not show the optional

checksum or CRC-8 checkcodes that may be appended to all commands, nor does it show the

required

<CR>

that terminates all commands.

The response strings are the actual strings returned from CVS4, which (except for the cases

of backward compatibility with the HDS4.2) return the same format as described above. The

format does not show the optional checksum or CRC-8 checkcodes that may be appended to

all response strings if enabled, nor does it show the

<CR><LF>

that terminates all Response