5 rs-232 protocol – FSR DV-MFSW-94 User Manual
Page 12
12
5 RS-232 Protocol
5.1 General
Notes
This document describes the protocol for interfacing with the DV-MFSW-94.
5.2 Request/Response
Format
All requests and responses will be entirely in ASCII. This will make the DV-MFSW-94 easy to use.
All commands and input parameters are in upper case only.
All
requests
are terminated with a carriage return (0Dh), which will be referred to in this document
as
represented in text below as
5.3 Command Request Syntax:
This document uses the following notation when describing the syntax of a command request:
BOLD
– identifies the command
lower case
– italicized identifies data to be entered which is described in the text following the
syntax description
“ “
- entry defined within double quotes is to be entered exactly as shown.
[ ]
- entry defined within these brackets is optional and may occur one or more times.
5.4 Acknowledging Receipt of Commands
Each request sent to the DV-MFSW-94 will have by default two possible responses, an
acknowledgment of a correct request or an error response. The acknowledge response will be:
Ok
5.5 Error
Response
It is perhaps inevitable that errors occur in the requests sent to the DV-MFSW-94. If an invalid
command
or text otherwise not representing a command is sent to the DV-MFSW-94, the unit will respond
with the message “ERR: unknown command“.
Example
:
A connect request with an incorrect output number, ie 5:
CON 01 1(2,3,5)
The error response would be:
ERR: unknown command
Note that in the protocol descriptions to follow, syntax that can be repeated multiple times is represented in
the notation X,,,,. This means entry of parameter X multiple times is entered as X, X, X, ie parameter X
separated by “,” character, as many times as necessary (up to the limit of the command).
Some commands allow configuration of multiple inputs or outputs without having to issue a separate
command. The ‘;’ character is used to delineate each additional configuration, eg CON, HAU and HEDID
commands.