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
M-series RS232 Programmers Manual
7.7.3 Set Current Value
The Set Current Value message allows direct control over the attenuation at a single crosspoint. Set
Current Value cannot be used to set audio levels of a crosspoint that has been defined as part of an
A/V group (for grouped audio use the class 12 Route Video message).
To use this message as a control test, select a crosspoint to be set and encode it in the input output pair.
The example below sets the current value of the crosspoint at input 2 and output 5. The value to which the
current value is set is encoded in the current value parameter. This value can be any value from 0 (full off) to
255 (full on). The example below sets the crosspoint to 255. Since 255 is hex FF the value is escaped into
two bytes F0h, 0Fh. Sending this message consists of transmitting the following ten bytes: FAh, 00h, 05h,
02h, 0Dh, 02h, 05h, F0h, 0Fh, and 15h.
When this message is properly received by the matrix, the current value will be immediately affected, since
this command bypasses ramp time and slew rate. You should immediately hear the change in the level of the
crosspoint. Be sure that your audio source, amplifiers and speakers are all powered and working.
input
output
05h
00h 05h
02h 0Dh
current value (escaped)
F0h, 0Fh
02h
15h
7.7.4 Communication Recommendation
Because the Intelix RS232 is a simplex or half duplex bus protocol there are certain restrictions placed
on bus traffic. Any message sent from the controller to the matrix that generates a reply other than <AC-
KNOWLEDGE> must not be followed by another message until the reply is complete. To be safe, insert a
delay of 100 milliseconds after any message that generates a reply.
M-series RS232 Programmers Manual
31
AVM RS232 Programming Command Summary
12.0 RS232 Command Summaries
The following sections show all RS232 control messages that are used to control the AVM matrix at run
time.
Messages that allow setup and configuration are not listed in this manual. This is because all setup and
configuration is done through the supplied AVM GUI software. Intelix highly recommends that you use the
GUI for purposes of setup and configuration.
If for any reason you need documentation on the RS232 messages needed to perform these functions, an
AVM Master RS232 manual is available either directly from Intelixs customer service department or on the
Intelix Web site: www.intelix.com.
Class 0 (Matrix Mixer Messages) summary
Message Name ID Parameters Size Range
Are You There 0 none
I Am Here 1 none
Reset matrix mixer 13 clear memory 1 0-1
32
AVM RS232 Programming Command Summary
AVM RS232 Programming Command Summary
Class 1 (Audio Input/Output Messages) summary
Message Name ID Parameters Size Range
I/O Ramp to Target Value 7 i/o flag 1 0-1
i/o number 1 1-129
target 1 0-255
ramp time 2 0-30,000
I/O Slew to Target Value 8 i/o flag 1 0-1
i/o number 1 1-129
target 1 0-255
slew rate 2 1-32640
I/O Stop Slewing 17 i/o flag 1 0 -1
i/o number 1 1-129
I/O Goto Current Value 9 i/o flag 1 0-1
i/o number 1 1-129
current value 1 0-255
I/O Goto Multiple 18 i/o flag 1 0 -1
Current Values Same count 1 1-128
value 1 0-255
i/o #1 1 1-128
i/o #2 1 1-128
i/o # [count] 1 1-128
I/O Goto Mute 11 i/o flag 1 0-1
i/o number 1 1-129
mute status 1 0-1
I/O Goto Pan 14 i/o flag 1 0-1
i/o number 1 1-129
pan/balance 1 0-255
AVM RS232 Programming Command Summary
33
AVM RS232 Programming Command Summary
Class 2 (Crosspoint Messages) summary
Message Name ID Parameters Size Range
Crosspoint Ramp 5 input 1 1-128
to Target Value 5 output 1 1-128
target value 1 0-255
ramp time 2 0-30,000
Crosspoint Slew 6 input 1 1-128
to Target Value 6 output 1 1-128
target value 1 0-255
slew rate 2 1-32640
Crosspoint stop slewing 12 input 1 1-128
output 1 1-128
Crosspoint Goto 9 input 1 1-128
Current Value output 1 1-128
current value 1 0-255
Crosspoint Goto 13 input 1 1-128
Current Value Exclusive output 1 1-128
level 1 0-255
Crosspoint Goto 14 count 1 1-64
Multiple Current Values input 1 1 1-129
output 1 1 1-129
value 1 1 0-255
input 2 1 1-129
output 2 1 1-129
value 2 1 0-255
input n 1 1-129
output n 1 1-129
value n 1 0-255
AVM RS232 Programming Command Summary34
AVM RS232 Programming Command Summary
Class 2 summary, cont.
Message Name ID Parameters Size Range
Crosspoint Goto Multiple 15 count 1 1-64
Value Same value 1 0-255
input 1 1 1-129
output 1 1 1-129
input n 1 1-129
output n 1 1-129
Crosspoint Goto Mute 11 input 1 1-128
output 1 1-128
mute 1 0 -1
AVM RS232 Programming Command Summary
35
AVM RS232 Programming Command Summary
Class 3 (Audio Preset Messages) summary
Message Name ID Parameters Size Range
Set Audio preset ramp time 5 preset number 1 1-64
ramp time 2 0-30,000
Copy Preset to Preset 8 source preset number 1 0-64
destination preset number 1 0-64
Copy Live Values to Preset 13 destination preset number 1 1-64
preserve 1 0-1
Go to preset 9 preset number 1 1-64
36
AVM RS232 Programming Command Summary
AVM RS232 Programming Command Summary
Class 4 (DC Control Messages) summary
Message Name ID Parameters Size Range
DC Control Set 3 polling 1 0 -6
Reports On/Off
DC Control 8 value 1 0 -1
Single Input Report
DC Control 9 value 1 0 -2
Single Output Report
DC Control Goto 5 value 1 0 -2
Single Input
Dc Control Simulate 7 input 1 1 -8
Single Input new value 1 0-1
DC Control Get All I/O Status 10 none
DC Control All I/O Report 11 input values 8 0-1
output values 8 0-2
AVM RS232 Programming Command Summary
37
AVM RS232 Programming Command Summary
Class 11 (Mic/Line Messages) summary
Message Name ID Parameters Size Range
Mic/Line Set 3 input 1 1-128
Signal Level Polling polling speed 1 0; 50-255
Mic/Line Signal Levels Report 4 input 8 0-42
Mic/Line Goto Gain/Phantom 2 input 1 1-128
range 1 1-4
Phantom Power 1 0-1
38
AVM RS232 Programming Command Summary
AVM RS232 Programming Command Summary
Class 12 (Video Matrix Messages) summary
Message Name ID Parameters Size Range
Video Route 4 preview 1 1-32
target 1 1-32
target value 1 0-255
Video Route with Ramp 5 preview 1 0-48
target 1 0-48
ramp time 2 0-30,000
percent of ramp 1 0-100
target value 1 0-255
Get All Video Ramps 6 none
All Video Routes Report 7 output group 1 routing 1 0-32
output group 2 routing 1 0-32
...
output group 32 routing 1 0-32
AVM RS232 Programming Command Summary
39
MZP RS232 Progammers Manual Device Messages (Class 0)
Message Details
Class 0: Matrix Mixer Messages
Class 0 messages deal with generic Matrix Mixer information, i.e. information about the Matrix
mixer itself, rather than the audio matrix.
Are You There
Description: This message is used as a simple way to verify communication with a
Matrix Mixer. Please refer to Communication Recommendations section
11.8.
Message ID: 0
Source: external
Parameters: none
Reply: I Am Here
Notes: In the following example, the calculated checksum is 255. Since 255 is
greater than the RS232_ESCAPE value of 240, the checksum is escaped and
Example
transmitted in two bytes (F0h and 0Ch).
00h 02h 00h 0
I Am Here
Description:
Message ID: 1
Source: Matrix Mixer
Parameters: none
Reply: none
Notes: the checksum is escaped and transmitted in two bytes (F0h and 03h).
Example
This message is sent by the Matrix Mixer as a reply to an Are You There
message. It is also sent when the Matrix Mixer is powered up or reset.
F0h 0Ch
00h 02h
MZP RS232 Progammers Manual Device Messages (Class 0)40
00h
01h
F0h, 0Dh
00h
Get Matrix Configuration
MZP RS232 Progammers Manual Device Messages (Class 0)
Description:
Message ID: 2
Source: External
Parameters: none
Reply: Matrix Mixer Configuration Report
Notes: the checksum is escaped and transmitted in two bytes (F0h and 0Eh).
Example:
This message requests the Matric Mixer configuration information,
including matrix mixer description, hardware version and software
version. Please refer to Communication Recommendations section 11.8.
00h 02h
00h
02h
01h
F0h, 0Eh
MZP RS232 Progammers Manual Device Messages (Class 0)
41
MZP RS232 Progammers Manual Device Messages (Class 0)
Matrix Mixer Configuration Report
Description:
This message reports the Matric Mixer configuration information,
including matrix mixer description, hardware version and software
version.
Message ID: 3
Source: Matrix Mixer
Parameters:
emaNeziSnoitpircseD
ledomxirtam
rebmun
lairesxirtam
rebmun
emanecived23gnirtstxetIICSA
noitacilppa
noitpircsed
sutatsmmoC1
noisrevmmoC3
gifnoCmmoC1
noisreverawdrah1
noisreverawtfos3
42
8rebmunlairestinu
noisrevnoitacilppa1
02
xednielbattemoC14-1
noisrevsemit01
rebmun
,roniM,rojaM
noisiver
ledomxiletnI
rebmun
noisrevsemit01
rebmun
fonoitpircsedtxet
noitacilppamotsuc
,roniM,rojaM
noisreV
=1;nur=0
yrevocsid
Reply: none
Notes: The application version and hardware version fields are encoded as
10X the actual value. A value of 20 translates to a version number of 2.0.
Example:
03h
01h
Serial number
03h, 01h, 00h
??h
Device Name
32 spaces
Comm version
hardware version
0Ah
00h 61h
software version
03h, 01h, 00h
00h
model number
24 spaces 8 spaces
Application version Application description Comm Status
00h
MZP + 17 zeroes
Comm config Comet table index
00h 03h
MZP RS232 Progammers Manual Device Messages (Class 0)42
MZP RS232 Progammers Manual Device Messages (Class 0)
Set Matrix Mixer Configuration
Description:
This message sets the configuration of the Matrix Mixer.
Message ID: 4
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
xedni
emaNeciveD23552-0
gifnocmmoC1
elbaTtemoC
14-1
nur=0
yrevocsid=1
fonoitpircsedtxet
xirtam
noitacinummoC
noitarugifnoc
temocfoxedni
elbat
Reply: None
Notes: None
Example:
00h 24h
Device Name
Comm Config
Ballroom
00h
00h
Comet Table index
04h
01h
??h
MZP RS232 Progammers Manual Device Messages (Class 0)
43
Set Matrix Mixer Name
MZP RS232 Progammers Manual Device Messages (Class 0)
Description:
Message ID: 5
Source: Matrix Mixer
Parameters:
Reply: None
Notes: None
This message sets the name of the Matrix Mixer. The name is a 32 byte
field used to identify an individual Matrix. The name is provided for
convenience only and can be any 32 byte combination. The name has no
effect on Matrix operation.
emaNeziSegnaRnoitpircseD
emanreximxirtam23552-0
denifedrotcartnoc
txet
Example:
00h 22h
matrix mixer name
Emmanual Lutheran Church
00h
05h
??h
MZP RS232 Progammers Manual Device Messages (Class 0)44
MZP RS232 Progammers Manual Device Messages (Class 0)
Set Communication Configuration
Description:
This message sets the communication configuration of the Matrix
Mixer. The configuration parameter indicates whether the communication
CPU is polling the ReO remotes or passively listening for new
REO devices.
Message ID: 6
Source: external
Parameters:
Reply: None
Notes: None
emaNeziSegnaRnoitpircseD
lamron=0
noitarugifnoc11-0
edom
putes=1
edom
Example:
00h 03h
00h
06h
configuration
00h 03h
MZP RS232 Progammers Manual Device Messages (Class 0)
45
Get 8 X 8 Info
MZP RS232 Progammers Manual Device Messages (Class 0)
Description:
Message ID: 8
Source: 8 X 8 info report
Parameters:
This message requests the configuration of a single 8 X 8 audio matrix
board. The board can be specified by setting input and output to any
crosspoint on the desired board. Please refer to Communication Rec-
ommendations section 11.8.
emaNeziSegnaRnoitpircseD
tupni1821-1
tuptuo1821-1
rebmuntupni
8X8no
otnoitces
yreuq
tuptuo
8norebmun
noitces8X
yreuqot
Reply:
Notes: none
Example:
input
01h
Communication Status Report
00h 03h
00h
output
01h
MZP RS232 Progammers Manual Device Messages (Class 0)46
08h
08h
8 X 8 Info Report
MZP RS232 Progammers Manual Device Messages (Class 0)
Description:
This message reports the configuration of a single 8 X 8 audio matrix board
as requested by a Get 8 X 8 info message.
Message ID: 9
Source: Matrix Mixer
Parameters:
emaNeziSegnaRnoitpircseD
tupni1821-0
tuptuo1821-0
stsixe11-0stsixe=1
noisrev
sgnittes
sserddaBPI1552-0
erawdrah
noisreverawtfos3552-0
erawdrah
1552-01
1552-0
etanidrooctupni
tfelreppufo
forenroc
draobgnitroper
tuptuo
foetanidrooc
renroctfelreppu
gnitroperfo
draob
8X8fosserdda
draobgnitroper
,roniM,rojaM
noisreV
Reply: none
Notes: The hardware version is encoded as 10X its actual value, e.g. a
value of 20 translates to a version number of 2.0.
Example:
09h
IPB address
03h
exists
01h
2Dh
input
01h
hardware ver
15h
00h 0Bh
00h
output
01h 00h
software ver
hdwr settings
03h, 01h, 00h
MZP RS232 Progammers Manual Device Messages (Class 0)
47
Get Mic Line Information
MZP RS232 Progammers Manual Device Messages (Class 0)
Description:
Message ID: 10
Source: external
Parameters:
This message requests the configuration of a mic/line input card. The com-
mand specifies an input number, which is internally used to calculate the
appropriate number for the 8-input mic/line card; i.e. 1,9,17 etc, where the
card is defined by the lowest number input connected to it. Please refer to
Communication Recommendations section 11.8.
emaNeziSegnaRnoitpircseD
tupni1 821-1
fonoitacol
dracenil/cim
Reply: Mic Line information report
Notes: None
Example:
00h 03h
00h 0Ah
input
01h
08h
MZP RS232 Progammers Manual Device Messages (Class 0)48
Mic Line Information Report
MZP RS232 Progammers Manual Device Messages (Class 0)
Description:
This message reports the configuration of a mic/line input card. The report
returns anobject ID: input, which is the appropriate number for the 8-input
mic/line card; i.e. 1,9,17 etc, where the card is defined by the lowest number
input connected to it. This number is calculated from the input number in the
Get Mic Line Information command.
Message ID: 11
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni1 821-1
stsixE1 1-0stsixe=1
fonoitacol
dracenil/cim
sserddaBPI1 61-0
erawdraH
noisrev
erawtfoS
noisrev
erawdrah
sgnittes
1552-0
3552-0
1552-0
Reply: Mic Line information report
Notes: None
Example:
00h 0Ah 00h 0Bh
exists
hardware
version
software
version
hardware
settings
01h 29h 00h 03h,01h,00h 16h
noisrevX01
rebmun
,ronim,rojam
noisiver
lanretnI
erawdraH
sgnitteS
input
01h 00h
IPB address
MZP RS232 Progammers Manual Device Messages (Class 0)
49
MZP RS232 Progammers Manual Device Messages (Class 0)
Application Message
Description: This message communicates with a custom application which may be coded
within the Matrix Mixer. This message is bi-directional; both the Matrix and
external devices use it to pass information. The Application Message has a
variable number of parameters, depending on the specific application and
value of the command ID parameter. The object ID may contain message
information. This message provides a back door similar to the MIDI
System Exclusive command.
Message ID: 12
Source: external and Matrix Mixer
Parameters:
emaNeziSegnaRnoitpircseD
DIdnammoc1 ynaepytegassem
Reply: none
Notes: none
Example:
Command ID
07h
rehto
sretemarap
00h 05h
00h 0Ch
parameter
0Fh 01h
elbairavelbairav
parameter
dnammoc
atadcificeps
01h
22h
MZP RS232 Progammers Manual Device Messages (Class 0)50
MZP RS232 Progammers Manual Device Messages (Class 0)
Reset Matrix Mixer
Description: This message resets the Intelix Matrix Mixer. If the value of the clear
memory parameter is 1, the internal RAM batteries will be bypassed and
the Matrix memory memory will be cleared. Warning: If the Matrix Mixer
memory is cleared, all programmed information will be lost: audio
levels, presets, names, and all ReO remote information!
Message ID: 13
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
evreserp=0
yromemraelc11-0
yromem
raelc=1
yromem
Reply: none
Notes: none
Example:
00h 03h 00h
0Dh
clear memory
01h
0Bh
MZP RS232 Progammers Manual Device Messages (Class 0)
51
MZP RS232 Progammers Manual Device Messages (Class 0)
Get Video Information
Description: This message requests information from an entire video board. Since there
may be several boars in the system, the board to be queried must be specified
by an i/o pair. The input and output parameters are the physical numbers
of any pair on the board to be queried. Please refer to Communication Rec
ommendations section 11.8.
Message ID: 14
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni184-1
tuptuo184-1
Reply: Video Info Report
Notes: none
Example:
00h 04h 00h
0Eh
input
01h
output
01h
otdraobnotupni
deireuqeb
otdraobnotuptuo
deireuqeb
0Eh
MZP RS232 Progammers Manual Device Messages (Class 0)52
MZP RS232 Progammers Manual Device Messages (Class 0)
Video Info Report
Description: This message returns information from an entire video board. The inputy
and output parameters are a mirror of the pair sent by the Get Video Info
message.
Message ID: 14
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni184-1
tuptuo184-1
sserdda1552-0sserddasubBIV
stsixe11-0stsixe=1
noisreverawdrah1552-0
noisreverawtfos3552-0
,sgnitteserawdrah
stupni
,sgnitteserawdrah
stuptuo
161,8
161,8
draobnotupni
deireuq
draobnotuptuo
deireuq
ehtsemit01
noisreverawdrah
rebmun
,roniM,rojaM
noisiveR
stupniforebmun
draobsihtno
stuptuoforebmun
draobsihtno
Reply: none
Notes: none
Example:
input
00h 04h 00h
MZP RS232 Progammers Manual Device Messages (Class 0)
0Eh
01h
output
01h
0Eh
53
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Message Details
Class 1: Audio Matrix Messages
The Audio Matrix messages deal with generic information about the audio signals which make
up the audio matrix. This information includes overall matrix size (the number of inputs and out-
puts). Further there is for each audio input/output there is a 20- byte name and a 1-byte level multi-
plier. The multiplier has a value of 0-255, corresponding to 0-100% of the input signal; i.e. it is an
attenuation only multiplier.
I/O flag:
If the i/o flag = 0, then the command is intended for an output.
If the i/o flag = 1. then the message is intended for an input.
The i/o num:
The i/o num specifies the number of the input or output targeted by the message. The i/o num
must be non zero and has a range of 1-129.
Wild Cards
If the i/o num is 129 then the message refers to all inputs or outputs. Not all commands support
the 129 parameter. Wild cards apply only to classes 1, 2, and isolated messages in other classes. An
example of the use of a wild card in a class 1 message is given in the Set I/O target Using Ramp
message details (message #5).
MZP RS232 Programmers Manual Matrix Messages (Class 1)54
Get Audio Matrix Size
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Description:
Message ID: 0
Source: external
Parameters: none
Reply: Audio Matrix Size Report
Notes: The checksum is escaped and transmitted as two bytes (F0h and 03h).
Example:
This message requests the size of the audio matrix (number of audio
inputs and audio outputs) within the Matrix Mixer. Please refer to
Communication Recommendations section 11.8.
00h 02h 01h 00h
F0h, 0Dh
MZP RS232 Programmers Manual Matrix Messages (Class 1)
55
Audio Matrix Size Report
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Description:
Message ID: 1
Source: Matrix Mixer
Parameters:
Reply: none
Notes: none
This message reports the size of the audio matrix (number of audio
inputs and audio outputs) within the Matrix Mixer.
emaNeziSegnaRnoitpircseD
stupni1 821-1
stuptuo1 821-1
forebmun
stupnioidua
forebmun
stuptuooidua
Example:
inputs
08h
00h 04h
01h
outputs
10h 18h
01h
MZP RS232 Programmers Manual Matrix Messages (Class 1)56
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Get Input/Output Parameters
Description: This message requests the parameters of a single specified virtual VCA. The
VCA to be queried is specified by the i/o flag and i/o number. Please refer to
Communication Recommendations section 11.8.
Message ID: 2
Source: Matrix Mixer
Parameters:
emaNeziSegnaRnoitpircseD
galfO/I11-0
rebmunO/I1821-1
Reply: Input/Output Parameter Report
Notes: none
Example:
00h 04h
01h
02h
i/o flag
00h
tuptuo=0
tupni=1
o/iforebmun
detceffa
i/o num
01h
02h
MZP RS232 Programmers Manual Matrix Messages (Class 1)
57
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Matrix Input/Output Configuration Report
Description: This message reports the parameters of a single specified virtual VCA. The
VCA to be reported is specified by the i/o flag and i/o number. This message
is a response to a Get Input/Output Parameters message. The i/o flag and
i/o num are the same as those sent in that message.
Message ID: 3
Source: Application CPU
Parameters:
emaNeziSegnaRnoitpircseD
galfo/i11-0
muno/i1821-1
tegrat1821-0eulavtegrat
emitpmar2000,03-0
etarwels204623-1
eulavtnerruc1552-0
xednievruc11-0
etum11-0
tnemerced1552-0
oerets
rentrap
1821-0onom=0
tuptuo=0
tupni=1
o/iforebmun
troperot
03ot0
sdnoces
1;raenil=0
gol=
0;detum=1
etumed=
eulav
otdettimbus
lla
stniopssorc
o/isihtrof
Reply: none
Notes: none
lennahctfelsi11-0sey=1
puorgVA123-1
naptuptuo1552-0
tuptuo
rotinom
eman02srahcyna
1821-0enon=0
resu
ylno
MZP RS232 Programmers Manual Matrix Messages (Class 1)58
552;tfel=0
thgir=
rofeman
ecneinevnoc
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Matrix Input/Output Configuration Report, cont.
Example:
00h 26h 01h
target value
FFh
decrement
00h 02h 00h
output monitor
00h
ramp time
09h C4h 4Eh 20h
stereo partner
slew rate current value curve index mute
name
20 ASCII chars
03h
F0h
is_left_channel
i/o flag
00
A/V group output pan
01h 80h
??h
i/o num
01
00h
00h
MZP RS232 Programmers Manual Matrix Messages (Class 1)
59
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set Input/Output Parameters
Description: This message sets all parameters of a specified input or output. Current value
is set as soon as the message is received; if target is different from current,
ramp to target will begin immediately.
Message ID: 4
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
galfo/i11-0
muno/i1821-1
eulavtegrat1552-0
emitpmar2000,03-0
etarwels204623-1
eulavtnerruc1552-0
xednievruc11-0
etum11-0
oerets
rentrap
lennahctfelsi11-0
puorgVA123-1
ecnalab/nap1552-0
1821-0
tuptuo=0
tupni=1
o/iforebmun
tesot
1;raenil=0
gol=
;etumed=0
etum=1
tuptuo
eman02
Reply: none
Notes: none
rotinom
1821-0ylnotuptuo
IICSAyna
sretcarahc
resu
ecneinevnoc
ylno
MZP RS232 Programmers Manual Matrix Messages (Class 1)60
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set Input/Output Parameters , cont.
Example:
target value
FFh
stereo partner
80h
output monitor
00h
00h 25h 01h
ramp time
09h C4h 4Eh 20h
is_left_channel A/V group
00h
slew rate
name
20 ASCII chars
04h
i/o flag
01h
current value
F0h
01h
??h
i/o num
01h
curve index mute
00h
pan/balance
00h
D0h
MZP RS232 Programmers Manual Matrix Messages (Class 1)
61
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set I/O Target using Ramp
Description: This message orders an input or output to ramp to a specified target, at the
existing ramp time. This commamnd supports wild cards.
Message ID: 5
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
galfo/i11-0
muno/i1921-1
tegrat1552-0
Reply: none
Notes: This example shows the use of a wild card in the i/o number parameter field.
By setting it to 128 (81h) all outputs have their target values set to 128 (80h).
Example:
tuptuo=0
tupni=1
o/iforebmun
retlaot
eulavtegrat
pmarfo
.noitarepo
i/o num
81h
00h 05h 01h 05h
target
80h
MZP RS232 Programmers Manual Matrix Messages (Class 1)62
i/o flag
00h
06h
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set I/O Target using Slew
Description: This message orders an input or output to slew to a specified target, at the
existing slew rate.
Message ID: 6
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Example:
00h 03h
galfo/i11-0
muno/i1921-1
tegrat1552-0
01h
06h
tuptuo=0
tupni=1
o/iforebmun
retlaot
eulavtegrat
welsfo
.noitarepo
i/o flag
01h
i/o num
01h
target
80h
88h
MZP RS232 Programmers Manual Matrix Messages (Class 1)
63
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set Input/Output Target and Ramp Time
Description: This message sets the target value and ramp time of an input or an output.
Message ID: 7
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Example:
galfo/i11-0
muno/i1921-1
eulavtegrat1552-0
emitpmar2000,03-0
00h 07h
01h
07h
tuptuo=0
tupni=1
o/iforebmun
retlaot
tegratwen
eulav
pmarwen
emit
i/o flag
01h
i/o num
0Ah
target value
ramp time
FAh 00h 05h
MZP RS232 Programmers Manual Matrix Messages (Class 1)64
13h
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set Input/Output Target and Slew Rate
Description: This message sets the target value and slew rate of an input or an output.
Message ID: 8
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Example:
galfo/i11-0
muno/i1921-1
eulavtegrat1552-0
etarwels204623-1
00h 07h
01h
08h
tuptuo=0
tupni=1
o/iforebmun
retlaot
tegratwen
eulav
welswen
etar
i/o flag
01h
i/o num
0Ah
target value
FAh
ramp time
7Fh 80h
MZP RS232 Programmers Manual Matrix Messages (Class 1)
0Eh
65
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set Input/Output Current Value
Description: This message sets the parameters of a single specified virtual VCA. The
VCA to be queried is specified by the i/o flag and i/o number. This message
controls the virtual VCAs on the input columns and output rows as described
on pages 15 and 17.
Message ID: 9
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Example:
galfo/i11-0
muno/i1921-1
eulavtnerruc1552-0
00h 05h
01h
09h
tuptuo=0
tupni=1
o/iforebmun
retlaot
tnerrucwen
eulav
i/o flag
00h
i/o num
03h
current value
F0h, 0Fh
0Bh
MZP RS232 Programmers Manual Matrix Messages (Class 1)66
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set Input/Output Curve Index
Description: This message sets the audio curve index of a crosspoint.
Message ID: 10
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Example:
galfo/i11-0
muno/i1921-1
xednievruc11-0
00h 05h
01h
0Ah
tuptuo=0
tupni=1
o/iforebmun
retlaot
1;raenil=0
gol=
i/o flag
00h
i/o num
05h
curve index
00h
MZP RS232 Programmers Manual Matrix Messages (Class 1)
0Fh
67
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set Input/Output Mute
Description: This message sets the mute switch of all crosspoints that are tied to the input
or output. The matrix remembers the value present at mute time, so a demute restores the value
current at the time of muting.
Message ID: 11
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Example:
galfo/i11-0
muno/i1921-1
sutatsetum11-0
00h 03h
01h 0Bh
tupni=1
retlaot
tuptuo=0
o/iforebmun
;etumed=0
;etum=1
i/o flag
01h
i/o num
03h 0Fh
mute status
00h
MZP RS232 Programmers Manual Matrix Messages (Class 1)68
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set Input/Output Stereo Pairs
Description: This message specifies that a pair of inputs or outputs are a stereo pair. The
first crosspoint is specified by the i/o flag and i/o num parameters. The second
crosspoint is specified by the i/o flag and the parameter stereo partner. This
command performs all mirroring and unlinking required by the command.
Message ID: 12
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Example:
galfo/i11-0
muno/i1821-1
oerets
rentrap
-nahc_tfel_si
len
00h 06h
1821-0onom=0
11-0tfel=1
01h
0Ch
tuptuo=0
tupni=1
forebmun
retlaoto/i
i/o flag
01h
i/o num
0Ah
stereo partner
0Bh 01h 24h
is_left_channel
MZP RS232 Programmers Manual Matrix Messages (Class 1)
69
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set Input/Output Video Group
Description: This message associates a specified input/output with an AV group. This
command must be sent after stereo pairs have been set up.
Message ID: 13
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Example:
galfo/i11-0
muno/i1821-1
puorgoediv123-0enon=0
00h 05h
01h
0Dh
tupni=1
retlaot
tuptuo=0
o/iforebmun
i/o flag
00h
i/o num
05h
video group
MZP RS232 Programmers Manual Matrix Messages (Class 1)70
01h
13h
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set input pan/output balance
Description: This message sets either input pan values or output balance.
For a complete explanation of the operation of stereo pan and balance see the
section Stereo I/O controljust before this section.
Message ID: 14
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Example:
galfo/i11-0
muno/i1821-1
ecnalab/nap1552-0
00h 05h
01h
0Eh
tupni=1
retlaot
;tfel=0
tuptuo=0
o/iforebmun
thgir=552
i/o flag
00h
i/o num
05h
pan/balance
80h
MZP RS232 Programmers Manual Matrix Messages (Class 1)
93h
71
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set Input/Output Name
Description: This message sets the name of an input or an output. The name is for user
convenience only; no use of it is made by the matrix.
Message ID: 16
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Reply: none
Notes: none
Example:
i/o num
01h
galfo/i11-0
muno/i1821-1
eman02552-0
00h 18h
01h 10h 01h
name
Mic 3
??h
tuptuo=0
tupni=1
o/iforebmun
retlaot
02yna
IICSA
sretcarahc
i/o flag
MZP RS232 Programmers Manual Matrix Messages (Class 1)72
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Stop Input/Output Slewing
Description: This message orders a specified input or output to stop slewing.
Message ID: 17
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Example:
galfo/i11-0
muno/i1921-1
00h 04h 01h
11h
i/o flag
01h 0Ah
i/o num
tuptuo=0
tupni=1
o/iforebmun
retlaot
25h
MZP RS232 Programmers Manual Matrix Messages (Class 1)
73
MZP RS232 Programmers Manual Matrix Messages (Class 1)
Set Input/Output Collection Values
Description: This message sets the audio levels of several input/outputs to the same level
with a single command. The number of i/os to change is specified in the
count variable. The new audio level is specified in the level parameter.
The number of each i/o to change is then listed.
Message ID: 18
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
galfo/i11-0
tnuoc1001-1
eulav1552-0
1#o/i1821-1
2#o/i1821-1
............
]tnuoc[#o/i1821-1
tuptuo=0
tupni=1
otso/iforebmun
egnahc
egnahcoteulav
.otso/ieseht
so/ifotsilnitsrif
egnahcot
so/ifotsilnidn2
egnahcot
ottsilnio/itsal
egnahc
Example:
08h
count i/o #1
03h
01h
level
0Ah
18h
04h
i/o #2 i/o #3
05h 06h
MZP RS232 Programmers Manual Matrix Messages (Class 1)74
i/o flag
01h
38h
AVM RS232 Programming Crosspoint Messages (Class 2)
Message Details
Class 2: Crosspoint Messages
The Matrix Mixer contains sophisticated audio crosspoints, in that each crosspoint contains a num-
ber of parameters (fields), which together define the behavior of the audio signal of the crosspoint.
The crosspoint messages process data associated with individual audio crosspoints within the audio
matrix. The coordinates of an individual audio crosspoint are of the form [audio input number,
audio output number]. The coordinate values are integral (1-128 inclusive).
Note: If the input AND output coordinates of a crosspoint are both part of a
video group, the command will be ignored! To control these crosspoints, use the
Route Video message (Class 11).
Audio Crosspoint Parameters
Each audio crosspoint contains six fields which can be viewed and modified (except as noted) by an
external device:
emaNeziSegnaRnoitpircseD
foeulav"laog"
eulav_tegrat1552-0
emit_pmar2000,03-0
etar_wels204623-1
eulav_tnerruc1552-0
xedni_evruc12-1
etum11-0
eulav_A/D1552-0
dnagnipmar
gniwels
forebmun
rofsdnocesillim
otegnahcoidua
ecalpekat
tniopssorcfoetar
821repegnahc
sdnocesillim
tniopssorc"depmar"
erofeb,eulav
evrucfostceffe
552-0aotxedni
noitcnufgnippam
=1;etumed=0
etum
yllautcaeulav
oiduaotnettirw
-daer(erawdrah
)ylno
AVM RS232 Programming Crosspoint Messages (Class 2)
75
AVM RS232 Programming Crosspoint Messages (Class 2)
Individual Audio Crosspoint Data Flow Path - determines D/A value for crosspoint VCA.
Ramp Times and Slew Rates
The matrix has control over the rate at which a crosspoint changes value. This rate is expressed in
two ways, as a time (ramp time), and as a rate of change (slew rate).
Ramp Time
Ramp time is expressed in units of milliseconds (1/1000 of a second). You can set ramp times
to any value from 0 -30,000. This corresponds to a range of ramp times from 0 to 30 seconds. The
ramping operation begins as soon as a target value is received. During the ramping time, the output
being ramped rises or falls steadily in volume at a fixed rate.
The rate is dependent on the distance being traversed by the ramp.
Calculating a ramp time:
The ramp time is a 2 byte hexadecimal number. To calculate a ramp time multiply the number
of seconds you want the ramp to take by 1000, and convert the result to hexadecimal. This number is
the value transmitted to the matrix.
Ramp time example: You wish audio to ramp between states in 5 seconds.
Multiply by 1000, 5 * 1000 = 5000. Convert the number to hexadecimal. 5000 -> 1388h. Use
the result 1388 in the ramp time command. The high byte is 13h and the low byte is 88h.
76
AVM RS232 Programming Crosspoint Messages (Class 2)
AVM RS232 Programming Crosspoint Messages (Class 2)
Slew Rate
The inverse of ramp time is slew rate which is expressed in units of steps/128
milliseconds. The slew rate determines how fast volume changes will take place. Regardless
of the current or target volume levels, any change in output volume will take place at the slew rate.
The advantage of using slew rate instead of ramp time, is that the volume of the output being slewed
rises at a steady rate that is independent of the distance traversed by the slew.
Calculating a slew rate:
The slew rate is a 2 byte hexadecimal number. You calculate a slew rate based on how fast in milli-
seconds (.001 second) you want the volume to go from full off to full on. This number (the FRC for
full range change) will be in the range 1-32,640. It sets the rate at which all audio changes (not just
full off to full on). The smaller the FRC time time, the faster the volumes will change. Typical FRC
times are in the neighborhood of 5000 (a full range change time of 5 seconds). For a fast rate of
change the FRC time should be small, e.g. in the range of 1000. For a slow rate of change the FRC
time should be around 10,000. Your chosen FRC time is then used to calculate the actual slew rate
value as follows:
Slew Rate = 32,640 ÷ FRC time
Slew rate examples:
1) You want audio to slew at a rate set by an FRC time of 6000 (a full range change of 6
seconds). Use the formula above with 6000 in place of FRC: 32640 ÷ 6000 = 5.44. The slew
rate to program is 5. This number must be transmitted as a 2 byte hex number. The high byte
is 00h and the low byte is 05h. When these two bytes are transmitted as slew rate parameters,
the outputs will slew at the desired rate.
2) You want a fast slew. Select a full range change value of 2 seconds (FRC time =
2000). 32640 ÷ 2000 = 16. The two bytes of the slew rate are 00h and 10h.
3) A very fast slew is FRC time = 100 (.1 seconds). the two bytes are 01h and 46h.
This is useful for rounding off the corners of audio changes.
4) You want a slow slew rate. Select an FRC time of 12000 (a full range change of 12
seconds). Using the formula you obtain: 32640 ÷ 12000 = 2.72. Use 3. The high byte is 00h
and the low byte is 03h.
5) You want a very slow slew rate. Select a slew rate of 1. The two bytes are 00h and
01h. This corresponds to an FRC time of 32 seconds.
AVM RS232 Programming Crosspoint Messages (Class 2)
77
AVM RS232 Programming Crosspoint Messages (Class 2)
Conversions of ramp times and slew rates
Ramp times and slew rates are transmitted to and from the matrix mixer as a pair of
hexidecimal bytes. The following section shows how to convert to and from
transmission values and decimal numbers.
The pair of bytes is always transmitted and received most significant byte first.
Convert from a known decimal value to a hex transmission value:
To convert a desired decimal value (N) to a 2-byte value to transmit to the matrix mixer:
1) N ÷ 256
2) The integer part of the result from step 1 is the most significant byte of the 2-byte result.
3) The remainder from step 1 is the least significant byte.
4) Convert the two bytes to hexidecimal.
5) The most significant byte is transmitted first.
Example1:
You wish to transmit the slew rate 7:
7 ÷ 256 = 0 with a remainder of 7. The two hexidecimal bytes to transmit are 00h and 07h.
Example 2: You wish to transmit the ramp time 20,000:
20,000 ÷ 256 = 78 with a remainder of 32. Converting 78 and 32 to dexidecimal gives: 4Eh and
20h.
Convert from a two byte transmission value to a decimal value:
1) Convert the most significant byte from hex to decimal and multiply by 256.
2) Convert the least significant byte from hex to decimal and add it to the result of step 1.
Example 1:
You receive the two hex bytes 00h and 09h:
00 * 256 = 0. 0 + 9 = 9. The value represented is 9.
Example 2: You receive the bytes 41h and 21h:
41h => 65d; 65 *256 = 16640.
21h => 33d; 16640 +33 = 16673. The transmitted value was 16673.
78
AVM RS232 Programming Crosspoint Messages (Class 2)
AVM RS232 Programming Crosspoint Messages (Class 2)
Crosspoint Get All Parameters
Description: This message requests all the parameters of a single crosspoint. Please refer to
Communication Recommendations section 11.8.
Message ID: 0
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni
tupni1 821-1
tuptuo
tuptuo1 821-1
foetanidrooc
tniopssorc
foetanidrooc
tniopssorc
Reply: Crosspoint All Parameters Report
Notes: none
Example:
00h 04h
02h
00h
input
output
01h 0Ah
0Bh
AVM RS232 Programming Crosspoint Messages (Class 2)
79
AVM RS232 Programming Crosspoint Messages (Class 2)
Crosspoint All Parameters Report
Description: This message reports all parameters of a single crosspoint as requested by a
Crosspoint Get All Parameters message.
Message ID: 1
Source: Matrix
Parameters:
emaNeziSegnaRnoitpircseD
tupni1821-1tupni
tuptuo1821-1tuptuo
eulavtegrat1552-0
Reply: none
Notes: none
Example:
output
target value
emitpmar2000,03-0
etarwels204623-1
eulavtnerruc1552-0
xednievruc11-0
etum11-0detum=1
eulavCAD1552-0
00h 0Dh
02h
ramp time
01h
slew rate
03-0
sdnoces
1;raenil=0
gol=
input
01h
current value
curve index
80
01h
mute
00h
00h
00h 03h
DAC value
7Fh 80h
00h 01h
0Fh
00h
AVM RS232 Programming Crosspoint Messages (Class 2)
AVM RS232 Programming Crosspoint Messages (Class 2)
Crosspoint Set All Parameters
Description: This message sets all accessible parameters of a specified crosspoint.
Message ID: 2
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni1821-1tupni
tuptuo1821-1tuptuo
eulavtegrat1552-0
Reply: none
Notes: none
Example:
output
0Ah
emitpmar2000,03-0
etarwels204623-1
eulavtnerruc1552-0
xednievruc11-0
etum11-0detum=1
input
00h 0Ch
target value
04h
02h
02h
ramp time
00h 25h
01h
slew rate
00h 04h
03-0
sdnoces
1;raenil=0
gol=
current value
D5h
curve index
mute
00h 00h
AVM RS232 Programming Crosspoint Messages (Class 2)
17h
81
AVM RS232 Programming Crosspoint Messages (Class 2)
Ramp To Target Value
Description: This message sets the target value of an audio crosspoint and tells the Matrix
Mixer to use the crosspoints existing ramp time to reach the target value. The
crosspoint is defined by the input and output parameters.
Message ID: 3
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni1921-1
tuptuo1921-1
eulavtegrat1552-0
etanidrooctupni
tniopssorcfo
etanidrooctuptuo
tniopssorcfo
tegrattniopssorc
eulav
Reply: none
Notes: In the following example, because it is greater than 240 the the data value of
241 is escaped into two bytes (F0h and 01h).
Example:
input
00h 05h
02h
03h
01h
82
output
0Ah
target value (escaped)
F0h 01h
checksum
10h
AVM RS232 Programming Crosspoint Messages (Class 2)
AVM RS232 Programming Crosspoint Messages (Class 2)
Slew to target value
Description: This message sets the target value of an audio crosspoint and tells the Matrix
Mixer to use the crosspoints existing slew rate to reach the new target value.
Message ID: 4
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni1921-1
tuptuo1921-1
eulavtegrat1552-0
etanidrooctupni
tniopssorcfo
etanidrooctuptuo
tniopssorcfo
tegrattniopssorc
eulav
Reply: none
Notes: In the following example, a target value of 255 is shown. Since 255 is
greater than the RS232_ESCAPE value of 240, the target value is escaped and
transmitted as two bytes.
Example:
input
00h 05h
02h
04h
01h
output
0Ah
target value (escaped)
F0h 15h
AVM RS232 Programming Crosspoint Messages (Class 2)
checksum
25h
83
AVM RS232 Programming Crosspoint Messages (Class 2)
Set Target Value and Ramp Time
Description: This message sets the target value and ramp time of an audio crosspoint and
tells the Matrix Mixer to use the crosspoints new ramp time to reach the new
target value. The coordinates of the audio crosspoint are transmitted in the
input and output parameters.
Message ID: 5
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni1 921-1
tuptuo1 921-1
eulavtegrat1 552-0
emitpmar2 000,03-0emitpmarwen
etanidrooctupni
tniopssorcfo
etanidrooctuptuo
tniopssorcfo
tegrattniopssorc
eulav
Reply: none
Notes: In the following example, a ramp time of 5000 milliseconds (5 seconds) is
shown. The value 5000 is transmitted as two unsigned bytes (13h and 88h):
5000 = (19 X 256) + 136
Example:
Also the target value of 240 is escaped into two bytes ( F0h and 00h).
input
00h 06h
02h
05h
01h
84
output
0Ah
target value
F0h
ramp time
13h 88h
checksum
9Dh
AVM RS232 Programming Crosspoint Messages (Class 2)
AVM RS232 Programming Crosspoint Messages (Class 2)
Set Target Value and Slew Rate
Description: This message sets the target value and slew rate of an audio crosspoint and
tells the Matrix Mixer to use the crosspoints new slew rate to reach the new
target value. For a full explanation of ramp time and slew rate see the section
Ramp Times and Slew Rates at the beginning of Class 2.
Message ID: 6
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni1921-1
tuptuo1921-1
eulavtegrat1552-0
etarwels204623-1
etanidrooctupni
tniopssorcfo
etanidrooctuptuo
tniopssorcfo
tegrattniopssorc
eulav
welstniopssorc
etar
Reply: none
Notes: In the following example, a slew rate of 6 is shown. This corresponds to a full
range (255 steps) ramp time of:
255(128) / 6 = 5440 milliseconds = 5.44 seconds.
The target value of 240 is escaped into two bytes (F0h and 00h).
Example:
input
00h 06h
02h
06h
01h
output
0Ah
target value(escaped)
F0h, 00h
ramp time
00h 06h
AVM RS232 Programming Crosspoint Messages (Class 2)
09h
85
AVM RS232 Programming Crosspoint Messages (Class 2)
Set Ramp Time
Description: This message sets the ramp time of an audio crosspoint.
Message ID: 7
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni
tupni1 821-1
tniopssorc
tuptuo
tuptuo1 821-1
tniopssorc
foetanidrooc
foetanidrooc
emitpmar2 000,03-0
Reply: none
Notes: In the following example, a ramp time of 5000 milliseconds (5 seconds) is
shown. The value 5000 is transmitted as two unsigned bytes:
5000 = (19 X256) + 136
Example:
00h 06h
output
0Ah
02h
ramp time
13h 88h
07h
tniopssorc
emitpmar
input
01h
checksum
AFh
86
AVM RS232 Programming Crosspoint Messages (Class 2)
AVM RS232 Programming Crosspoint Messages (Class 2)
Set Slew Rate
Description: This message sets the slew rate of an audio crosspoint.
Message ID: 8
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni1821-1
tuptuo1821-1
etarwels204623-1
etanidrooctupni
tniopssorcfo
etanidrooctuptuo
tniopssorcfo
welstniopssorc
emit
Reply: none
Notes: In the following example, a slew rate of 6 is shown. This
corresponds to a full range (255 steps) ramp time of
(255 X 128) / 6 = 5440 milliseconds (5.44 seconds).
Example:
input
00h 06h
02h
08h
02h
output
0Ah
slew rate
00h 06h
AVM RS232 Programming Crosspoint Messages (Class 2)
checksum
1Ch
87
Set Current Value
Description:
This message sets the current value of an audio crosspoint. Using this message
to change the current value of an audio crosspoint will cause an immediate
change to the audio volume, since it bypasses the audio crosspoints ramp
time and slew rate.
Message ID: 9
Source: external
Parameters:
AVM RS232 Programming Crosspoint Messages (Class 2)
emaNeziSegnaRnoitpircseD
tupni1921-1
tuptuo1921-1
eulavtnerruc1552-0
etanidrooctupni
tniopssorcfo
etanidrooctuptuo
tniopssorcfo
tniopssorc
eulavtnerruc
Reply: none
Notes: This message is useful for show control applications.
Example:
input
00h 05h
output
0Ah
02h
09h
current value (escaped)
F0h 0Fh
01h
14h
88
AVM RS232 Programming Crosspoint Messages (Class 2)
AVM RS232 Programming Crosspoint Messages (Class 2)
Set Curve Index
Description: This message sets the curve index associated with an audio crosspoint.
Message ID: 10
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Reply: none
Notes: none
Example:
tupni1921-1
tuptuo1921-1
xednievruc11-0
00h 05h
02h
etanidrooctupni
tniopssorcfo
etanidrooctuptuo
tniopssorcfo
raenil=0
cimhtiragol=1
0Ah
input
01h
output
0Ah
curve index
01h
AVM RS232 Programming Crosspoint Messages (Class 2)
checksum
17h
89
AVM RS232 Programming Crosspoint Messages (Class 2)
Crosspoint Set Mute
Description: This message sets the mute value of a specified crosspoint. The coordinates of
the crosspoint are transmitted in the input and output parameters.
Message ID: 11
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni1 921-1
tuptuo1 921-1
etum1 1-0
Reply: none
Notes: none
Example: this example mutes crosspoint (3,3).
02h05h
tupni
etanidrooc
tuptuo
etanidrooc
etumnu=0
etum=1
input
0Bh 03h
90
output
05h
mute
01h
AVM RS232 Programming Crosspoint Messages (Class 2)
15h
AVM RS232 Programming Crosspoint Messages (Class 2)
Crosspoint Stop Slewing
Description: This message tells a specified crosspoint to stop the slewing process. After the
crosspoint stops slewing, the target value is set to the current value.
Message ID: 12
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni1 921-1tupni
Reply: none
Notes: none
Example:
tuptuo1 921-1tuptuo
00h 04h
02h
0Ch
input
01h
output
0Ah
17h
AVM RS232 Programming Crosspoint Messages (Class 2)
91
AVM RS232 Programming Crosspoint Messages (Class 2)
Crosspoint Set Value Exclusive
Description: This message turns on a specified crosspoint to a specified level and turns off
all other inputs to the specified output. The change takes place immediately.
No crosspoint that is part of a video group will be turned off by this message.
Message ID: 13
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni1 821-1tupni
tuptuo1 821-1tuptuo
eulav1 552-0
Reply: none
Notes: none
Example:
input
0Ah
00h 04h 02h
value
25h
0Dh
tniopssorc
eulav
input
01h
3Eh
92
AVM RS232 Programming Crosspoint Messages (Class 2)
AVM RS232 Programming Crosspoint Messages (Class 2)
Crosspoint Set N Values
Description: This message sets the audio levels of several crosspoints with a single mes
sage. Target values change to match current values. The number of crosspoints
to change is specified in the count varable. The actual length of this mes
sage varies with the number of crosspoints being set. Each crosspoint and its
new level are listed as parameters. Current values can also be
maninipulated with the Crosspoint Goto Current Value, Crosspoint Goto
Current Value Exclusive and Crosspoint Goto Multiple Current Value
Same messages.
Message ID: 14
Source: external
Parameters:
Example:
emaNeziSegnaRnoitpircseD
tnuoc1821-1
1tupni1921-1
1tuptuo1921-1
1eulav1552-0
2tupni1921-1
2tuptuo1921-1
2eulav1552-0
]tnuoc[tupni1921-1
]tnuoc[tuptuo1921-1
]tnuoc[eulav1552-0
otso/iforebmun
egnahc
foetanidrooc-x
ottniopxts1
egnahc
foetanidrooc-y
ottniopxts1
egnahc
ts1tesotlevel
tniopx
foetanidrooc-x
ottniopxdn2
egnahc
foetanidrooc-y
ottniopxdn2
egnahc
dn2tesotlevel
tniopx
foetanidrooc-x
ottniopxtsal
egnahc
foetanidrooc-y
ottniopxtsal
egnahc
tsaltesotlevel
tniopx
This example changes the values of crosspoints (3,6) and (8,3) to 08 and F0 respectively. The length
of 9 in this example is correct only for the example of 2 crosspoints!
input 1
03h
00h 09h
output 1
06h
02h
0Eh
value 1
08h
output 2 value 2
05h F0h, 00h
AVM RS232 Programming Crosspoint Messages (Class 2)
count
02h
input 2
03h
1Eh
93
AVM RS232 Programming Crosspoint Messages (Class 2)
Crosspoint Set N Values Same
Description: This message sets the audio levels of several crosspoints to a single value
with a single message. The number of crosspoints to change is specified in
the count variable. The new level is set by the value parameter. Each
crosspoint is defined as an input/output pair.
Current values can also be maninipulated with the Crosspoint Goto Current
Value, Crosspoint Goto Multiple Current Values and Crosspoint
Goto Current Value Exclusive messages.
Message ID: 15
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
eulavwen1552-0
tnuoc1001-1
1tupni1921-1
1tuptuo1921-1
2tupni1921-1
2tuptuo1921-1
............
]tnuoc[tupni1921-1
]tnuoc[tuptuo1921-1
Example:
ylppaoteulavwen
detsilot
stniopssorc
detsilforebmun
stniopssorc
foetanidrooc-x
tniopssorcts1
foetanidrooc-y
tniopssorcts1
foetanidrooc-x
tniopssorcdn2
foetanidrooc-y
tniopssorcdn2
foetanidrooc-x
ottniopxtsal
egnahc
foetanidrooc-y
ottniopxtsal
egnahc
This example changes the values of crosspoints (3,6) and (8,3) to 08 and F0 respectively.
94
value
EEh
count
09h
input 1
06h
02h
0Fh
output 1
08h
input 2
02h
03h
output 2
19h
05h
AVM RS232 Programming Crosspoint Messages (Class 2)
AVM RS232 Programming Crosspoint Messages (Class 2)
Get 64 Live Crosspoint Values
Description: This message requests the current value of the 64 crosspoints of an audio
matrix board. The input and output parameters are the numbers of any
crosspoint in the target audio matrix. They need not be the first crosspoint in
the matrix but that is the recommended way to use the parameters. Please refer
to Communication Recommendations section 11.8.
Message ID: 16
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni1 921-1tupni
tuptuo1 921-1tuptuo
Reply: 64 Live Crosspoint Values Report
Notes: none
Example:
00h 04h
02h 10h
input output
01h 09h
1Ah
AVM RS232 Programming Crosspoint Messages (Class 2)
95
AVM RS232 Programming Crosspoint Messages (Class 2)
64 Live Crosspoint Values Report
Description: This message reports the live values of the 64 crosspoints of an audio matrix
board. The returned input and output numbers are the lowest value crosspoint
in the reported array, i.e. the upper left corner of the matrix reported.
Message ID: 17
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
tupni1 821-1
tuptuo1 821-1
seulav46552-0
Reply: Live Value Report
Notes: none
Example:
00h 44h
02h
11h
tupni
etanidrooc
tuptuo
etanidrooc
foseulav
hcae
tniopssorc
input
01h
96
output
01h
values
53h
64 bytes of 00h
AVM RS232 Programming Crosspoint Messages (Class 2)
AVM RS232 Programming Crosspoint Messages (Class 2)
Crosspoint Set 64 Values
Description: This message sets the current values of all 64 crosspoints on a single audio
matrix card. The card is identified by specifying any crosspoint on the card in
the input and output parameters. This command will not change audio
crosspoints that are part of an AV group.
Message ID: 18
Source: external
Parameters:
emaNeziSegnaRnoitpircseD
Reply: none
Notes: none
Example:
output
01h
tupni1 821-1
tuptuo1 821-1
seulav46552-0
44h
values
64 bytes of 00h
12h02h
54h
tupni
etanidrooc
tuptuo
etanidrooc
foseulav
hcae
tniopssorc
input
01h
AVM RS232 Programming Crosspoint Messages (Class 2)
97
AVM RS232 Programming Crosspoint Messages (Class 2)
Get 64 DAC values
Description: This message requests the current value of the 64 DACs of an audio
matrix board. The input and output parameters are the numbers of any
crosspoint in the target audio matrix. They need not be the first crosspoint in
the matrix but that is the recommended way to use the parameters. Please refer
to Communication Recommendations section 11.8.
Message ID: 19
Source: external
Parameters: none
emaNeziSegnaRnoitpircseD
tupni1821-1
dirgforenroc
detseuqer
potforebmun
tuptuo1821-1
Reply: 64 DAC values report
Notes: none
Example:
00h 04h
02h
13h
input
01h
output
01h
tfelforebmun
dirgforenroc
detseuqer
15h
98
AVM RS232 Programming Crosspoint Messages (Class 2)
AVM RS232 Programming Crosspoint Messages (Class 2)
64 DAC values report
Description: This message reports the values of a set of 64 DACs from a crosspoint
board. The input and output parameters show the translated range of
crosspoints being reported.
Message ID: 20
Source: application
Parameters: none
emaNeziSegnaRnoitpircseD
potforebmun
tupni1821-1
dirgforenroc
detseuqer
tuptuo1821-1
seulavCAD46552-0seulavCAD46
Reply: 64 DAC values report
Notes: none
Example:
02h
input
01h
44h
output
01h
DAC values
64 bytes of 00h
tfelforebmun
dirgforenroc
detseuqer
14h
56h
AVM RS232 Programming Crosspoint Messages (Class 2)
99
AVM RS232 Programming Preset Messages (Class 3)
Message Details
Class 3: Audio Preset Message Details
The preset messages deal with information about the characteristics of specified groups of audio
crosspoints called presets. The AVM supports 64 separate audio presets.
Input/Output Coordinates:
Presets are handled in 8X8 (64 byte) increments. The 8X8 section being manipulated is defined by
an input/output pair. Whatever 8X8 section contains the specified crosspoint is the section being
referenced. When a preset message is returned from the matrix, the i/o pair you sent will be trans-
lated into the upper left hand corner of the 8X8 section referenced. This calculation is carried out by
the matrix. For example if you send a Get Audio Preset message with the input output pair of 3,1,
the matrix translates this pair to 1,1 which is the beginning crosspoint on the 8X8 section containing
3,1. When the matrix sends you a Audio Preset report, the input/output pair will be reported as 1,1.
No-Change Mask:
Every preset includes a no-change mask. The mask is a bitmap that contains a single bit for every
crosspoint in the matrix. If the bit for a crosspoint 1 then that crosspoint is affected by the preset
when it is invoked. If the bit for a crosspoint is 0 then that crosspoint is not affected by the preset,
even though its corresponding value is non zero. This feature allows the creation of presets that
affect only certain crosspoints while leaving others untouched. The values of the no-change bitmap
can be changed by using the Set Preset Bitmap and Set Audio Preset Crosspoint messages.
Format: The format of the no-change mask is a group of 8 bytes (with 8 mask bits per byte), which
covers an 8X8 section defined by an input/output pair. Byte #1 represents inputs 8-1 at output1, byte
2 represents inputs 8-1 at output 2, etc. Refer to the pseudo-code below, which reads the bitmap from
the Audio Preset report message.
for output 1-8
bitmask = 1
for input = 1-8
no-change[input][output] = buffer[index] AND bitmask
bitmask = bitmask * 2
next input
index = index +1
next output
Preset Name:
The name of an audio preset is a 16 byte ASCII string. If the name is less than 16 characters it must
be padded out (typically with spaces) to be 16 charaters long.
Ramp Time:
Every preset has a ramp time associated with it. The ramp time is the amount of time the matrix
takes to ramp to the preset values when the preset is invoked. There is only one ramp time for all
crosspoints in a preset. The ramp time can range from 0 to 30 seconds and is transmitted as two
unsigned bytes representing the time in milliseconds.
100
AVM RS232 Programming Preset Messages (Class 3)
Loading...