AVM RS232
Master
Manual
AVM RS232 Master Manual
2222 Pleasant View Road
Revision
2
ΑΑ
Α 0499
ΑΑ
Middleton, WI 53562
(608) 831-0880
fax: (608) 831-1833
e-mail: intelix@intelix.com
AVM RS232 Master Manual
AVM RS232 Master Manual Table of Contents
Contents
1.0 AVM Hardware Overview ................................................................................... 8
1.1 Audio Section ....................................................................................................................... 9
1.2 Video Switch Architecture .................................................................................................. 10
1.2.1 Video Section Overview ............................................................................................ 11
1.2.2 AV Groups ................................................................................................................ 11
2.0 Installing and starting the AVM software........................................................ 12
2.1 Installing the AVM software ................................................................................................ 12
2.2 Running the AVM software ................................................................................................. 12
3.0 Connecting the Control PC to the AVM .......................................................... 13
4.0 Presets ..................................................................................................................15
4.1 Remote Triggering of Presets............................................................................................... 15
5.0 Direct I/O Configuration ................................................................................... 16
5.1 Input Configuration ............................................................................................................. 16
5.2 Output Configuration .......................................................................................................... 16
6.0 Stereo I/O control ............................................................................................... 17
6.1 Input controls ..................................................................................................................... 17
6.2 Output controls ................................................................................................................... 17
6.3 Setting control values .......................................................................................................... 17
6.4 Input width control .............................................................................................................. 18
6.5 Input pan control ............................................................................................................... 19
6.6 Output control ................................................................................................................... 20
6.7 Stereo input to stereo output example ................................................................................. 21
6.8 Mono input to stereo output example ................................................................................. 22
6.9 Mono input to mono output example .................................................................................. 23
6.10 Stereo input to mono output example ............................................................................... 23
7.0 RS232 Message Protocol .................................................................................. 24
7.1 RS232 Message Fields ....................................................................................................... 24
7.2 RS232 Reserved Bytes ....................................................................................................... 25
7.3 Hexadecimal Transmission .................................................................................................. 26
7.3.1 Commercial controllers ............................................................................................. 26
7.3.2 ASCII values ............................................................................................................. 26
7.4 Decimal to Hex conversion table ......................................................................................... 27
7.5 Byte Escape Sequence ....................................................................................................... 28
7.6 DIP Switches ..................................................................................................................... 29
AVM RS232 Master Manual Table of Contents
3
AVM RS232 Master Manual Table of Contents
7.7 Introduction to using the RS232 Commands ........................................................................ 30
7.7.1 Are You There ........................................................................................................... 30
7.7.2 I Am Here ................................................................................................................30
7.7.3 Set Current Value ..................................................................................................... 31
7.7.4 Communication Recommendation .............................................................................. 31
12.0 RS232 Command Summaries ....................................................................... 32
Class 0: Matrix Mixer Messages ............................................................................ 40
Are You There .......................................................................................................................... 40
I Am Here ................................................................................................................................ 40
Get Matrix Configuration .......................................................................................................... 41
Matrix Mixer Configuration Report ........................................................................................... 42
Set Matrix Mixer Configuration ................................................................................................ 43
Set Matrix Mixer Name ............................................................................................................ 44
Set Communication Configuration ............................................................................................. 45
Get 8 X 8 Info .......................................................................................................................... 46
8 X 8 Info Report .................................................................................................................... 47
Get Mic Line Information .......................................................................................................... 48
Mic Line Information Report .................................................................................................... 49
Application Message ................................................................................................................ 50
Reset Matrix Mixer ................................................................................................................... 51
Get Video Information .............................................................................................................. 52
Video Info Report .................................................................................................................... 53
Class 1: Audio Matrix Messages............................................................................. 54
Get Audio Matrix Size .............................................................................................................. 55
Audio Matrix Size Report ........................................................................................................ 56
Get Input/Output Parameters ................................................................................................... 57
Matrix Input/Output Configuration Report ............................................................................... 58
Set Input/Output Parameters .................................................................................................... 60
Set I/O Target using Ramp ...................................................................................................... 62
Set I/O Target using Slew ........................................................................................................ 63
Set Input/Output Target and Ramp Time ................................................................................... 64
Set Input/Output Target and Slew Rate .................................................................................... 65
Set Input/Output Current Value ................................................................................................ 66
Set Input/Output Curve Index .................................................................................................. 67
Set Input/Output Mute ............................................................................................................. 68
Set Input/Output Stereo Pairs ..................................................................................................69
Set Input/Output Video Group ................................................................................................. 70
Set input pan/output balance ................................................................................................... 71
Set Input/Output Name ............................................................................................................ 72
Stop Input/Output Slewing ....................................................................................................... 73
Set Input/Output Collection Values ........................................................................................... 74
Audio Crosspoint Parameters ................................................................................................... 75
4
AVM RS232 Master Manual Table of Contents
AVM RS232 Master Manual Table of Contents
Class 2: Crosspoint Messages ................................................................................. 75
Ramp Times and Slew Rates .................................................................................................... 76
Crosspoint Get All Parameters ............................................................................................... 79
Crosspoint All Parameters Report ........................................................................................... 80
Crosspoint Set All Parameters ................................................................................................ 81
Ramp To Target Value ............................................................................................................ 82
Slew to target value .................................................................................................................. 83
Set Target Value and Ramp Time............................................................................................... 84
Set Target Value and Slew Rate ................................................................................................ 85
Set Ramp Time ......................................................................................................................... 86
Set Current Value ..................................................................................................................... 88
Set Curve Index ....................................................................................................................... 89
Crosspoint Set Mute ................................................................................................................. 90
Crosspoint Stop Slewing ......................................................................................................... 91
Crosspoint Set Value Exclusive ............................................................................................... 92
Crosspoint Set N Values .......................................................................................................... 93
Crosspoint Set N Values Same ................................................................................................. 94
Get 64 Live Crosspoint Values ................................................................................................. 95
64 Live Crosspoint Values Report ............................................................................................ 96
Crosspoint Set 64 Values .......................................................................................................... 97
Get 64 DAC values .................................................................................................................. 98
64 DAC values report ............................................................................................................. 99
Class 3: Audio Preset Message Details ................................................................100
Get Preset .............................................................................................................................. 101
Audio Preset Report .............................................................................................................. 102
Set Audio Preset ................................................................................................................... 103
Set Audio Preset Name .......................................................................................................... 105
Set Audio Preset Values .......................................................................................................... 106
Set Audio Preset Ramp Time ................................................................................................ 107
Set Audio Preset Bitmap ........................................................................................................ 108
Set Audio Preset Crosspoint .................................................................................................. 109
Copy Preset .......................................................................................................................... 110
Go To Preset ..........................................................................................................................111
Set Video Preset .................................................................................................................... 112
Get Video Preset ................................................................................................................... 114
Video Preset Report .............................................................................................................. 115
Copy Live Crosspoints to preset ............................................................................................. 116
AVM RS232 Master Manual Table of Contents
5
AVM RS232 Master Manual Table of Contents
Class 4: DC Control Messages ............................................................................. 117
Get DC Control Status ...........................................................................................................118
DC Control Status Report ..................................................................................................... 119
Set DC Control Status .......................................................................................................... 120
Set DC Control Polling ......................................................................................................... 121
Set DC Control input configuration ....................................................................................... 122
Set DC Control output .......................................................................................................... 123
Set DC Control output configuration ..................................................................................... 124
Simulate DC Control single input ............................................................................................ 125
DC Control single input report .............................................................................................. 126
DC Control single output report ............................................................................................ 127
DC Control Get All I/O Status ............................................................................................... 128
DC Control All I/O Report .................................................................................................... 1 29
Class 11: Mic/Line Card Messages ......................................................................130
Get Input Gain Range ............................................................................................................. 131
Input Gain Range Report ....................................................................................................... 132
Set Input Gain Range ............................................................................................................. 133
Get Mic Current Level ........................................................................................................... 134
Current Mic Values Report .................................................................................................... 135
Class 12: Video Matrix Messages ......................................................................... 137
Get Video Input/Output Group Parameters .............................................................................. 137
Video Input/Output Group Parameter Report ......................................................................... 138
Set Video Input/Output Group Parameters ............................................................................. 140
Set Input/Output Group Name ............................................................................................... 141
Route Video ........................................................................................................................... 142
Route Video with Ramp .......................................................................................................... 143
Get All Video Routes .............................................................................................................. 144
All Video Routes Report ......................................................................................................... 145
Index..........................................................................................................................146
6
AVM RS232 Master Manual Table of Contents
AVM RS232 Master Manual Table of Contents
Programmers Notes
AVM RS232 Master Manual Table of Contents
7
AVM RS232 Master Manual
Overview
1.0 AVM Hardware Overview
The AVM Audio/Video matrix contains two major components. The audio and the video switch are con-
trolled by multiple CPUs under the command of the application CPU as shown below.
1) The audio matrix is a fully controllable crosspoint matrix. At every crosspoint the user can independently
specify variables such as target value, ramp time, slew rate etc. AVM provides the following sizes of audio
matrices: 8 X 8, 16 X 8, 24 X 8, 32 X 8, 8 X 16, 16 X 16.
2) The video section is a completely transparent video switch capable of switching a wide range of popular
formats. With Intelixs supplied Windows® based setup software video sources are grouped with their
associated audio inputs, and the group can be rerouted with a single command. The video switch is available
in a wide range of standard sizes from 8 X 8 composite to 8 X 8 RGBHV.
The tight coupling of audio and video in the same chassis allows the very flexible and convenient grouping
and manipulation of complex AV sources. For instance a five signal (RGBHV) video source and its associ-
ated stereo audio can be grouped and manipulated as a single object.
Control of the AVM is accomplished either with the supplied Intelix software or via an external RS232
controller. Common RS232 commands and protocol are covered in later sections of this manual.
Fig. 1. This exploded
drawing shows the audio
(lower) and video (upper)
sections of a typical AVM.
Both sections are contained
in a single chassis.
8
AVM RS232 Master Manual
Overview
AVM RS232 Master Manual
Overview
1.1 Audio Section
The Intelix audio matrix mixer is a device which can route and mix audio signals from multiple sources to
multiple destinations. The matrix mixer is designed so that audio inputs can be independently mixed to any or
all outputs simultaneously. As shown below there is a VCA under software control at every I/O crosspoint.
The audio matrix can be controlled either by the supplied Windows® based software or by RS232 com-
mands.
AVM RS232 Master Manual
Overview
9
AVM RS232 Master Manual
Overview
1.2 Video Switch Architecture
The drawing below shows the architecture of an 8 X 8 section of a video switch. All crosspoints are switch-
able, but no more than one input can be switched to a given output at a time; i.e. only one closed switch per
column. An input can be sent to any number of outputs; i.e. any number of closed switches per row.
All video inputs are assigned to a video group. All video switching is accomplished by issuing a route video
group message. Even a single wire video input; e.g. composite is assigned to a video group. A video input
cannot be assigned to more than one group. This means that not all crosspoint switches are independently
controllable, since if an input is part of a group it cannot be switched to an output independently of its group.
This drawing (below) shows how 16 X 16 video switch cards can be combined to form larger video
switches. The smallest AVM product has only section #1. Other AVM models add sections #2 and/or #3 to
form larger switches (#3 cannot be added without adding #2). Note that this sparse matrix cannot be filled
in. A video group (such as an RGB input) can contain signals that span sections, but a single signal
cannot cross sections; e.g. input 2 cannot be routed to output 18 even if section #2 is present.
10
AVM RS232 Master Manual
Overview
AVM RS232 Master Manual
Overview
1.2.1 Video Section Overview
The AVM video switching section is entirely transparent; i.e. no processing or alteration of any kind takes
place when video signals pass through the AVM.
Different video input types require different numbers of I/O connectors; e.g. composite video uses a single
connector for all video and sync signals, while RGBHV video uses five connectors per source. The standard
AVM models can switch up to 8-16 video inputs of the following types:
tamroFoediV
etisopmoc161
C/Y261
BGR361
SBGR48
VHBGR58
repsrotcennoC
tuptuo/tupni
mumixam
stuptuo/stupni
detroppus
1.2.2 AV Groups
The AVM handles all video inputs and outputs as AV groups. This means that all components of a video
input or output are defined as members of an AV group. This enables the AVM to switch sources as a single
object with single commands. For example, a VCR might consist of a single composite video input, a left
audio source, and a right audio source. An RGBHV video source with stereo audio would have seven
signals in its group. Note that all video inputs will be assigned to a group; i.e. even a single composite input
with no audio will be assigned a group number.
There are 48 input groups and 48 output groups. Each contains the groups video type and an audio type
(mono, stereo, or none). To route an input group to an output group the two groups must have compatible
video and audio types; e.g. you cannot route an input group with video type RGB to an output group with
type composite, nor an input group with stereo audio to an output group with no audio.
All grouping is handled automatically by the AVM setup software when you configure your application. It is
not possible to define AV groups outside of the AVM setup software.
AVM RS232 Master Manual
Overview
11
AVM RS232 Master Manual Getting
Started
2.0 Installing and starting the AVM software
Regardless of where you obtained your AVM Designer software (CDROM, the Intelix web site, or
floppy disks) use these instructions to install and start the software.
2.1 Installing the AVM software
1) Run the file setup.exe
2) Follow the instructions on the screen.
2.2 Running the AVM software
Open the AVM software from the Program files option in the Windows Start menu (Intelix AVM).
You can run the AVM software as a stand-alone program; i.e. unattached to an AVM device. You can also
run it without an explicit file opened you can run the program, do setup operations, then save to file, or
discard your setup.
12
AVM RS232 Master Manual Getting
Started
AVM RS232 Master Manual Getting
Started
3.0 Connecting the Control PC to the AVM
Before you can program your AVM matrix mixer, you need to have a personal computer (desktop or
laptop) capable of running the AVM program. Your computer must meet these requirements:
√ PC computer with a CD ROM drive
√ Windows 95® or Windows 98®
√ Serial port connected to RS232 connector on Matrix Mixer
√ a null modem cable (included RS232CBL-10)
The connection between the AVM matrix mixer and your control PC is made with a null modem cable
with a DB-9 connector on the matrix end as shown below. The wiring diagram for a null modem cable is
at the bottom of the page. The drawing you use will depend on the connector on your PC. Most PCs
have either a DB-9 or a DB-25 on the serial port. The cable wiring for both connectors are shown.
Note: Some devices require that Clear to Send and Ready to send (pins 7 and 8) be tied together.
RS232 DB-9 to DB-9 connections for
a null modem cable.
Matrix
female DB-
9
The connections of the
AVMs DB-9 connector
for RS-232 communica-
tion.
AVM RS232 Master Manual Getting
Started
2
3
5
2
3
5
Controller
DB-9
Receive
Transmit
RS-232 DB-9 to DB-25 connections
for a null modem cable.
Matrix
female DB-
9
23 5
Ground
2
3
5
2
3
7
Controller
DB-25
13
AVM RS232 Master Manual Getting
Started
3.1 DIP Switches
There are eight DIP switches on the rear panel of the Matrix (see drawing below). For all DIP switches, the
up position indicates the on condition, and the down position the off condition. The function of these
switches is shown below.
DIP switches 5 and 6 allow the RS-232 baud rate to be fixed at one of three values: 9600, 19200 or
38400. The Windows AVM software does not support 38400 baud. But that speed can be used by AMX,
Crestron and custom controllers.
DIP switch 7 allows the RS-232 checksum and escape byte to be toggled on or off. These should be
turned off in installations which include a permanent RS-232 controller, such as AMX, Crestron or custom
PC program. The RS-232 checksum and escape byte should be turned on in installations where the RS-
232 communication may be hindered because of cable length (greater than 50 feet) or lack of shielding from
external electronic noise.
14
AVM RS232 Master Manual Getting
Started
AVM User Manual Presets
4.0 Presets
The Intelix AVM contains 64 presets. A preset is an entire setup of the AVM mixer stored in AVMs
memory. A preset specifies all crosspoint levels, I/O routing and grouping required to configure the AVM,
including both audio and video crosspoints and parameters. There are 64 presets in the AVM memory.
Each preset fully configures the AVM and can be modified in any way you wish.
4.1 Remote Triggering of Presets
Presets can be triggered by external devices by using the Direct I/O capabilities of the AVM. From the DB-
25 connector on the rear of the AVM chassis, there is access to 8 inputs and 8 outputs. The inputs can be
individually configured to trigger presets. The outputs can be individually configured to reflect the fact that a
particular preset has been invoked.
This allows you to switch the AVM to a preset with an external device (through a direct Input pin), and
drive an external indicator that a preset has become active (through a direct Output pin). The RS232
commands for this process are in Class 4 (see sec. 5.0).
AVM User Manual Presets
15
AVM User Manual Direct I/Os
5.0 Direct I/O Configuration
A direct I/O pins behavior can be configured with RS232 commands. The messages to configure
the pins are Class 4 RS232 messages.
5.1 Input Configuration
The input configuration parameter consists of four bytes ([1]-[4]):
Byte [1]: Input type. Currently the only supported input type is 10d. This value makes the input a preset
goto; i.e. when this input pin becomes active, the matrix switches to a preset. The number of the target is
contained in Byte [2].
Byte [2]: Preset number. When byte [1] is 10d then byte [2] contains the number of
the preset to goto when this pin becomes active. If byte [1] is anything other than 10d,
all other bytes of input configuration will be ignored.
Byte [3]: Reserved.
Byte [4]: Reserved.
5.2 Output Configuration
The output configuration parameter consists of four bytes ([1]-[4]):
Byte [1]: Input type. Currently the only supported input type is 10d. This value makes the output a preset
reflect. This means that whenever a specified preset is active (from any source) this output will become
active. This is particularly useful in driving an indicator of a preset select panel.
Byte [2]: Preset number. When byte [1] is 10d then byte [2] contains the number of the preset reflected by
this pin. If byte [1] is anything other than 10d, all other bytes of input configuration will be ignored.
Byte [3]: Reserved.
Byte [4]: Reserved.
16
AVM User Manual Direct I/Os
AVM User Manual Stereo
6.0 Stereo I/O control
Your Intelix matrix allows a great deal of flexibility when routing and controlling stereo audio. Both inputs
and outputs can be defined as mono or stereo. This gives four possible combinations of inputs and outputs:
1) Mono input to mono output
2) mono input to stereo output
3) stereo input to mono output
4) stereo input to stereo output
In cases 2 and 4, there are input and output controls that can be used to set balance, panning and width
of the audio signals. These controls are explained below.
6.1 Input controls
There are two types of input controls: an input width control, and an input pan control. The input width
control is used only for stereo inputs, and the input pan control is used only for mono inputs. Their
internal workings are explained on the following pages.
6.2 Output controls
There is one output control, the output balance control. It is used only with stereo outputs. The output
balance control distributes two inputs to two outputs, in proportion to the setting of the control value.
6.3 Setting control values
The control values for all stereo controls ( input pan control, input width control and output balance control
are set with multiple calls to a single RS232 command: I/O Goto Pan; this is a Class 1 RS-232 message. It
is explained in detail on page 89.
The I/O Goto Pan message has a single parameter pan/width/balance. The meaning of this parameter
changes depending on the nature of the target. The matrix examines the i/o flag and i/o number to determine
whether the target is an input/output and mono/stereo.
The meaning of the pan/width/balance parameter is determined as follows:
if target is a mono input the meaning is pan
if target is a stereo input the meaning is width
if target is any output the meaning is balance
AVM User Manual Stereo
17
AVM User Manual Stereo
6.4 Input width control
The stereo width control is used for narrowing or reversing a stereo input signal or between two stereo
outputs on the matrix. The control acts like a pair of linked potentiometers; e.g. any change to the pot on
one input causes a corresponding change to the other member of the stereo pair. The action of the control
allow full stereo separation of the two input signals, a summed mix of the two input signals to both outputs,
and a complete stereo reversal of the two inputs. The value of the pots can be set at any value between 0
and 255. The input width control is used with stereo input pairs only.
The table below shows the result of setting the input width control to a range of values. The default value of
the width control is 0.
lortnoc
eulav
0
821R+LR+Lonom
552
subtfel
tfel
tupni
thgir
tupni
thgir
sub
thgir
tupni
tfel
tupni
-ircsed
noitp
lamron
oerets
esrever
oerets
18
AVM User Manual Stereo
AVM User Manual Stereo
6.5 Input pan control
As the diagram below shows, the input pan control takes a single mono input and by use of a virtual potenti-
ometer, distributes the input to a pair of outputs. The input control pan is used only with monaural inputs.
A value of 0 on the control will send the input entirely to Tap A, and nothing to Tap B, while a value
of 255 will send the input entirely to Tap B and nothing to Tap A. A value of 127 (center) sends the input
equally to Taps A and B.
The table below shows the result of setting the input pan control to a range of values. The default value for
the control is 127 (centered).
eulavlortnocsubtfelsubthgir
0langislluflangison
)retnec(721Bd3-@langisBd3-@langis
552langisonlangislluf
AVM User Manual Stereo
19
AVM User Manual Stereo
6.6 Output control
There is one output control, the output balance control. It is used only with stereo outputs. Monaural
outputs have no separate output control. The output balance control takes two inputs and distributes them
to two outputs, in proportion to the setting of the control value. Typical control values and their results are
shown in the table below. The default value for the control is 127 (centered).
eulavlortnoctuptuotfeLtuptuothgiR
0subtfellluFgnihton
)retnec(721Bd3-@subtfeLBd3-@subthgiR
552gnihtonsubthgirlluF
20
AVM User Manual Stereo
AVM User Manual Stereo
6.7 Stereo input to stereo output example
This example shows a stereo input pair assigned to a stereo output pair. The input width control allows the
user to define the amount of each member of the input pair to the two output buses; while the output balance
control sets the amount of each bus sent to each member of the output pair.
L
R
This table shows the results of extreme control values of 0, 127 (center) and 255.
tupnI
lortnoc
lamron(0
)oerets
0
0
onom(721
)tupni
721721R+LR+LR+LR+L
721552R+LR+LgnihtonR+L
552
esrever(
)oerets
552721RLRL
552552RL gnihtonL
tuptuO
lortnoc
)tfellluf(0LRLgnihton
721
)retnec(
lluf(552
)thgir
0R+LR+LR+Lgnihton
0RLR gnihton
suBtfeLsuBthgiRtuotfeLtuothgiR
LRLR
LR gnihtonR
AVM User Manual Stereo
21
AVM User Manual Stereo
6.8 Mono input to stereo output example
This example shows a monaural input assigned to a stereo output pair. The input pan control allows the user
to define the amount of the input to the two output buses; while the output balance control sets the amount
of each bus sent to each member of the output pair.
This table shows the results of control values of 0, 127 (center) and 255, when applied to both the input
width control and the output balance control.
tupnI
lortnoc
tuptuO
lortnoc
suBtfeLsuBthgiRtuotfeLtuothgiR
00 tupnIgnihtontupnIgnihton
0721tupnIgnihtonBd3-tupnIgnihton
0552tupnIgnihtongnihtongnihton
7210 Bd3-tupnIBd3-tupnIBd3-tupnIgnihton
721721Bd3-tupnIBd3-tupnIbd6-tupnIBd6-tupnI
721552Bd3-tupnIBd3-tupnIgnihtonBd3-tupnI
5520 gnihtontupnIgnihtongnihton
552721gnihtontupnIgnihtonBd3-tupnI
552552gnihtontupnIgnihtontupnI
22
AVM User Manual Stereo
AVM User Manual Stereo
6.9 Mono input to mono output example
When assigning a monaural input to a monaural output, there are no input and output controls other than the
normal crosspoint controls. No pan or balance is possible. Note that the connection dot in the diagram is a
VCA in the Intelix matrix.
6.10 Stereo input to mono output example
When a stereo input pair is assigned to a mono output, no input or output controls are available, except the
normal crosspoint controls which control input and output levels. No panning or balance is possible. Note
that the connection dots in the diagram are VCAs in the Intelix matrix.
AVM User Manual Stereo
23
M-series RS232 Programmers Manual
y
7.0 RS232 Message Protocol
7.1 RS232 Message Fields
All RS232 messages, whether they are transmitted to or from the Matrix Mixer, use the same message
format. Each RS232 message contains five fields. All values are transmitted in hexadecimal format
e.g. 0Ah. For an explanation of transmitting in hexadecimal, please refer to section 7.3.
RS232_START length (2 bytes, MSB first) data (1 - n b
RS232 Message Fields
The first field of a message is always the RS232_START byte (FAh).
The second field is a 2-byte length, transmitted most significant byte first. The value of the length field is the
number of bytes in the third field, the data field e.g. (00h, 07h).
The third field, the data field, holds the parameters of the message e.g.
(02h, 03h, 02h, 05h, F2h, 13h, 88h).
The fourth field is a one-byte checksum. The value of the checksum is the additive sum of the bytes in the
first three fields, modulo 256 (the least significant byte).
For example, if the data portion (3rd field) of a message is (2, 3, 2, 5, 239, 19, 136), the length field is (0,
7). The additive sum of the first three fields is (250 + 0 + 7 + 2 + 3 + 2 + 5 + 239 + 19 + 136) = 663 =
297h. The checksum is 663 modulo 256 = 151= 97h.
The checksum feature can be turned off when necessary by setting DIP switch #7 to the down position.
This is recommended to simplify programming when using Crestron or AMX controllers. See section 3.1.
The fifth field is a one-byte acknowledgment field, which is sent by the device which receives the message.
The value of this field is either RS232_ACK (FCh), RS232_BUSY (FDh), or RS232_ERROR (FEh).
24
M-series RS232 Programmers Manual
M-series RS232 Programmers Manual
7.2 RS232 Reserved Bytes
The following table lists the bytes which have special meaning in the Intelix Matrix Mixer RS232 protocol.
emaNeulaVgninaeM
EPACSE_232SRh0F
devreserh9F-h1F
3V_TRATS_232SRhAF
devreserhBFdevreser
KCA_232SRhCF
YSUB_232SRhDF
RORRE_232SRhEF
desunuhFF
atadtimsnartotdesu
552-042seulav
erutufrofdevreser
sdeen232SR
llafoetybtsrif
.3noisrevnisegassem
dnadevieceregassem
dessecorp
tubdevieceregassem
dessecorpton
,tcerrocnimuskcehc
derongiegassem
reven,eulavdesunu
dettimsnart
M-series RS232 Programmers Manual
25
M-series RS232 Programmers Manual
7.3 Hexadecimal Transmission
The Intelix Matrix Mixer must receive all message in hexadecimal number code. If messages are trans-
mitted in decimal or ASCII codes, they will fail to work.
Hexadecimal is a base 16 number code that uses numerals 0-10 and letters A, B, C, D, E, F. On the next
page is a conversion table from decimal numbers to hexadecimal. In this document hex numbers are repre-
sented in the form xxh, where xx are the two hex characters.
7.3.1 Commercial controllers
Most commercial controllers require the use of special codes to represent hex numbers for transmission.
For example, Crestron controllers require the sequence \xnn where nn is the hex byte to be sent.
7.3.2 ASCII values
Because computers deal only with numbers, letters must be assigned a numeric code. This code is
called ASCII. When you send commands to the Intelix Matrix Mixer, there is one and only one case when
you use ASCII codes. That case is when you send names. Whenever a name field appears in an example in
this manual, the example is enclosed in quotation marks. Any other use of ASCII values will cause the
command to fail.
For example the command Set Matrix Mixer Name uses as an example name field
Emmanual Lutheran Church. The quotes indicate that this data should be sent as ASCII values.
To do this use an ASCII table to obtain the hex value for each character, and transmit these values.
Never transmit the quotation marks.
A7.3.2.1 ASCII values of capital characters.
To obtain lower case values, add hex 20 to each value below, e.g. lower case a is hex 41 + hex 20 = 61h.
A complete ASCII table contains codes for punctuation and special characters as well.
A-41h
B-42h
C-43h
D-44h
E-45h
F-46h
G-47h
H-48h
I-49h
J-4Ah
K-4Bh
L-4Ch
M-4Dh
O-4Eh
P-4Fh
Q-50h
R-51h
S-52h
T-53h
U-54h
V-55h
W-56h
X-57h
Y-58h
Z-59h
26
M-series RS232 Programmers Manual
M-series RS232 Programmers Manual
7.4 Decimal to Hex conversion table
The table below shows the hex equivalent of decimal numbers from 0-255. Starting with Windows 95, the
calculator has a hex conversion function.
00-00h
01-01h
02-02h
03-03h
04-04h
05-05h
06-06h
07-07h
08-08h
09-09h
10-0Ah
11-0Bh
12-0Ch
13-0Dh
14-0Eh
15-0Fh
16-10h
17-11h
18-12h
29-13h
20-14h
21-15h
22-16h
23-17h
24-18h
25-19h
26-1Ah
27-1Bh
28-1Ch
29-1Dh
30-1Eh
31-1Fh
32-20h
33-21h
34-22h
35-23h
36-24h
37-25h
38-26h
39-27h
40-28h
41-29h
42-2Ah
43-2Bh
44-2Ch
45-2Dh
46-2Eh
47-2Fh
48-30h
49-31h
50-32h
51-33h
52-34h
53-35h
54-36h
55-37h
56-38h
57-39h
58-3Ah
59-3Bh
60-3Ch
61-3Dh
62-3Eh
63-3Fh
64-40h
65-41h
66-42h
67-43h
68-44h
69-45h
70-46h
71-47h
72-48h
73-49h
74-4Ah
75-4Bh
76-4Ch
77-4Dh
78-4Eh
79-4Fh
80-50h
81-51h
82-52h
83-53h
84-54h
85-55h
86-56h
87-57h
88-58h
89-59h
90-6Ah
91-6Bh
92-6Ch
93-6Dh
94-6Eh
95-6Fh
96-70h
97-61h
98-62h
99-63h
100-64h
101-65h
102-66h
103-67h
104-68h
105-69h
106-6Ah
107-6Bh
108-6Ch
109-6Dh
110-6Eh
111-6Fh
112-70h
113-71h
114-72h
115-73h
116-74h
117-75h
118-76h
119-77h
120-78h
121-79h
122-7Ah
123-7Bh
124-7Ch
125-7Dh
126-7Eh
127-7Fh
128-80h
129-81h
130-82h
131-83h
132-84h
133-85h
134-86h
135-87h
136-88h
137-89h
138-8Ah
139-8Bh
140-8Ch
141-8Dh
142-8Eh
143-8Fh
144-90
145-91h
146-92h
147-93h
148-94h
149-95h
150-96h
151-97h
152-98h
153-99h
154-9Ah
155-9Bh
156-9Ch
157-9Dh
158-9Eh
159-9Fh
160-A0h
161-A1h
162-A2h
163-A3h
164-A4h
165-A5h
166-A6h
167-A7
168-A8h
169-A9h
170-AAh
171-ABh
172-ACh
173-ADh
174-AEh
175-AFh
176-B0h
177-B1h
178-B2h
179-B3h
180-B4h
181-B5h
182-B6h
183-B7h
184-B8h
185-B9h
186-BAh
187-BBh
188-BCh
189-BDh
190-BEh
191-BFh
192-C0h
193-C1h
194-C2h
195-C3h
196-C4h
197-C5h
198-C6h
199-C7h
200-C8h
201-C9h
202-CAh
203-CBh
204-CCh
205-CDh
206-CEh
207-CFh
208-D0h
209-D1h
210-D2h
211-D3h
212-D4h
213-D5h
214-D6h
215-D7h
216-D8h
217-D9h
218-DAh
219-DBh
220-DCh
221-DDh
222-DEh
223-DFh
224-E0h
225-E1h
226-E2h
227-E3h
228-E4h
229-E5h
230-E6h
231-E7h
232-E8h
233-E9h
234-EAh
235-EBh
236-ECh
237-EDh
238-EEh
239-EFh
240-F0h
241-F1h
242-F2h
243-F3h
244-F4h
245-F5h
246-F6h
247-F7h
248-F8h
249-F9h
250-FAh
251-FBh
252-FCh
253-FDh
254-FEh
255-FFh
M-series RS232 Programmers Manual
27
M-series RS232 Programmers Manual
7.5 Byte Escape Sequence
If a byte in the length, data, or checksum fields falls within the range 240h through 255h inclusive, an
escape sequence is used to transmit the value, since those single byte values are reserved. The value is
translated by the sending device into two bytes: the RS232_ESCAPE byte (240) itself, followed by the
difference between the value and the RS232_ESCAPE byte.
value => RS232_ESCAPE, (value - RS232_ESCAPE)
These two bytes are transmitted instead of the single, large-value byte. The receiving device converts the
two bytes back into the original single byte value through simple addition. These operations do not affect
the values of the length or checksum fields.
Note: The escape sequence feature can be disabled if necessary, by putting DIP switch #7 in the
down position. This is recommended when using Crestron or AMX controllers, since it simplifies program-
ming. See section 7.6.
In the following example, the data field of a message is (2, 3, 3, 6, 255). The byte 255 must be escaped
into the RS232_ESCAPE byte (240) followed by the difference between 255 and RS232_ESCAPE (255
- 240 = 15 = 0Fh). The bytes actually transmitted are:
-232SR
TRATS_
hAFh50h00h20h30h30h60
Since the second byte of an escape sequence must fall within the range 0 through 15 inclusive, any second
byte outside of that range indicates that a transmission error has occurred, and the message should be
acknowledged by the receiver with RS232_ERROR and ignored.
htgneL
ssalc
atad
egassem
atadDI
tupnituptuo
tegrat
eulav
atad
,h0F
hF0
muskcehc
hC0
28
M-series RS232 Programmers Manual
M-series RS232 Programmers Manual
7.6 DIP Switches
There are eight DIP switches on the rear panel of the Matrix (see drawing below). For all DIP
switches, the up position indicates the on condition, and the down position the off condition. The
function of these switches is shown below.
DIP switches 5 and 6 allow the RS-232 baud rate to be fixed at one of three values: 9600, 19200 or
38400. The AVM supports 38400 at the embedded level and that speed can be used for Crestron and
AMX programming, but since Windows® does not support that rate, the AVM GUI cannot be run at
38400.
DIP switch 7 allows the RS-232 checksum and escape byte to be toggled on or off. These should be
turned off in installations which include a permanent RS-232 controller, such as AMX, Crestron or custom
PC program. This greatly simplifies coding (and decoding) the RS-232 messages. The RS-232 checksum
and escape byte should be turned on in installations where the RS-232 communication may be hindered
because of cable length (greater than 50 feet) or shielding from external electronic noise.
M-series RS232 Programmers Manual
29
M-series RS232 Programmers Manual
7.7 Introduction to using the RS232 Commands
This section introduces three RS232 commands that are needed to begin programing the AVM. The com-
mands are chosen to get you started programming the Intelix matrix. Two of the three commands establish
communication, and the third exerts control over a chosen audio crosspoint. After these three commands
are usable you should be able to use the rest of this manual to implement your application.
1) Are You There: This command is sent by the controller to check for the existence of a matrix. If the
matrix receives this message it replies with an I Am Here message.
2) I Am Here: This message is sent by the matrix as a response to the receipt of an Are You There
message. The matrix sends an I Am Here message whenever it is powered up or reset. This fact can be
used as a diagnostic tool when troubleshooting communication, since the matrix can be relied upon to send
the I Am Here message when reset.
3) Set Current Value: This message sets the attenuation level of an audio crosspoint, and demonstrates
control over the audio matrix after communication has been established.
7.7.1 Are You There
Shown below is the contents of the Are You There message. The format of the message is explained in
section 7.1. The message has no parameters, the length is 2 bytes (1 byte for class, 1 byte for message ID).
The checksum is the sum of all fields: FAh + 2h = FCh.
Since FCh is greater than the RS232 _ESCAPE value of 240, the checksum is escaped into
2 bytes (F0h, 0Ch). The escape byte does not effect the length field. The escape process is explained in
section 7.5. Transmitting this message consists of sending the following string of 7 bytes: FAh, 00h, 02h,
00h, 00h, F0h, 0Ch.
00h 02h
00h
00h
F0h 0Ch
7.7.2 I Am Here
Shown below is the contents of the I Am Here message. This message is also sent by the matrix in
response to an Are You There message. This message is sent whenever the matrix is powered up or reset.
The format of the message is explained in section 7.1. The message has no parameters, the length is
2 bytes (1 byte for class, 1 byte for message ID). The checksum is the sum of all fields: FAh + 2h + 1h =
FDh. The checksum will be escaped when transmitted by the matrix. Receiving this message consists of
recognizing the following string of 6 bytes: FAh, 00h, 02h, 00h, 01h, F0h, 0Dh.
30
00h 02h
00h 01h
M-series RS232 Programmers Manual
F0h, 0Dh
Loading...