Mirage Autonomic AMX v1.0 Operating instructions

amx DRIVER v1.0
for Mirage digital amplifier
programming guide 020615
©2006–2015 Autonomic Controls, Inc. All trademarks are property of their respective owners.
compatible with
m·400
m·800

AMX Driver v1.0 for Mirage Digital Ampliers |2 of 54
MirageAudioSystem.com
Overview
The Autonomic AMX version 1.0 driver for the Mirage digital amplier,
models M-800 and M-400, is compatible with all recent versions of AMX
and all versions of the Autonomic Mirage digital amplier rmware.
Autonomic Mirage digital ampliers offer scalable multi-zone amplication
with 100 watts per zone. Each zone is individually controllable from an AMX
system using the Autonomic AMX driver.
The M-400 and M-800 digital ampliers can be mixed in any congura-
tion and stacked up to 96 zones, providing an 8 source x 96 zone matrix
(M-800s) or a 6 source x 96 zone matrix (M-400s).The driver offers full
control over all aspects of a Mirage amp stack of any size.
This driver was developed and tested with Netlinx 4.1.1204 against
an NI-2100 running Netlinx v4.1.373 and TP4Design 3.3.0 against an
MXT-1000 running rmware v2.104.28 but is compatible with any NI series
processor and any G4 and G5 panel.
Features
Each zone of a Mirage amplier is individually controllable and has many
features.The Autonomic AMX v1.0 driver offers full control over the
complete feature set per zone, from basic control like volume & mute, power,
and source selection to advanced functionality like max volume, mono vs.
stereo, power on volume, bass, treble, balance, gain, and loudness.

AMX Driver v1.0 for Mirage Digital Ampliers |3 of 54
MirageAudioSystem.com
Downloading the Driver
All Mirage digital amplier control drivers are available on our Downloads page, found at
http://www.autonomic-controls.com/support_downloads.php.
To download the AMX v1.0 driver, simply click on the link labeled AMX Amp Driver v1.0
to start the download of the zip le.
Inside the download:
• Compressed sample program (Netlinx exported workspace)
• Standalone driver le
• Touch panel le (for MXT-1000)
• Autonomic Programming Guide: AMX driver v1.0 for Mirage Digital Amplier

AMX Driver v1.0 for Mirage Digital Ampliers |4 of 54
MirageAudioSystem.com
Conguration
The module supports a panel array. This allows multiple panels to control one instance of the
module.This conguration reduces resource utilization on the processor. A panel array is simply
a device array containing panel devices. If the main program contains three panel devices, dvTP1,
dvTP2, and dvTP3, the panel array to include all three would look like:
dev dvTP_Array = { dvTP1, dvTP2, dvTP3 }
To set the sample program up, make sure you have the latest versions of Netlinx Studio and
TP4Design. Both are available from the AMX website under Development Tools (http://www.amx.
com/products/categoryDevelopmentTools.asp).
Once those programs are installed, simply open the Netlinx workspace included in the download.
Start by setting the IP address of the amp stack by changing the value of AMP_IP_ADDRESS.
Congure the panel to match the device ID in the program.This is 10001:5:0 by default. It’s
important to note that channel 1 on the virtual device must be held on for the duration
control is required.
on[vdvAmp, 1]
Dening the module
To use this module in a full program, add a denition of our module to the main program.That
conguration looks like the below code snippet.
DEFINE_DEVICE
dvAmp = 0:FIRST_LOCAL_PORT:0
dvTP1 = 10001:5:0
dvTP2 = 10002:5:0
dvTP3 = 10003:5:0
vdvAmp = 33001:1:0 // the virtual device that represents the
connection of the amp stack
DEFINE_VARIABLE
char AMP_IP_ADDRESS[] = ‘192.168.1.54’ // for example, replace
with the IP of the amp stack
integer AMP_CONTROL_PORT = 17037
dev dvTP_Array[] = { dvTP1, dvTP2, dvTP3 }
DEFINE_MODULE ‘Autonomic Mirage Amp’ ACAMP (vdvAmp, dvAmp,
dvTP_Array, AMP_IP_ADDRESS, AMP_CONTROL_PORT)

AMX Driver v1.0 for Mirage Digital Ampliers |5 of 54
MirageAudioSystem.com
Programming
Due to the number of zones and the functionality offered per zone, the module has to
make use of channels well above the default maximum channel of 255. The program
should set virtual channel and level counts for the virtual device that is the amp.We recom-
mend a virtual channel count of 4000 and a virtual level count of 1000. Do this at program
start like the below code snippet.
SET_VIRTUAL_CHANNEL_COUNT(vdvAmp, 4000)
SET_VIRTUAL_LEVEL_COUNT(vdvAmp, 1000)
Calculating Channels for Zones
Each zone is identically programmed. See the appendix at the end of this document for an
explanation of the formula used to calculate the values and a table of the channel and level
values for all 96 zones.
Control Channels
Certain, more global, actions are controlled using channels on the virtual device itself.
Channel 1
• on = connect
on[vdvAmp, 1]
• off = disconnect
off[vdvAmp, 1]
Channel 2
• on = turn protocol communications logging on
on[vdvAmp, 2]
• off = turn protocol communications logging off
off[vdvAmp, 2]
Channel 3
• on = turn parsed (human readable) communications logging on
on[vdvAmp, 3]
• off = turn parsed (human readable) communications logging off
off[vdvAmp, 3]
Channel 4
• on = turn all zones off
on[vdvAmp, 4]
• This channel will turn itself off and should be pulsed.

AMX Driver v1.0 for Mirage Digital Ampliers |6 of 54
MirageAudioSystem.com
Technical Support
If you require further assistance with conguring the AMX driver v1.0 for the Mirage
Digital Amplier, please contact AutonomicTechnical Support at [phone]
option 2, or email [e-mail] can also visit the Autonomic
Knowledgbase (http://www.autonomic-controls.com/kb) for troubleshooting
information and access to submitting a support ticket.
Appendix: Channel and Level Values
All target channels are calculated using a ZONE_OFFSET value of 40 except for levels
that use a ZONE_LVL_OFFSET value of 10. Zone 1 shares its channels with the initial
channel values. A button programmed to toggle power on Zone 1 should use channel
10.The formula for calculating channels for other zones is
(initialChannel|initialLevel + (ZONE_OFFSET|ZONE_LVL_
OFFSET * (zone - 1)))
Therefore, a button programmed to toggle power on Zone 67 would use channel (10
+ (40 * (67 - 1))) or channel 2650. A bar graph attached to the volume level for Zone
1 would use level 1.The volume bar graph for Zone 67 would use level ((1 + (10 *
(67 - 1))) or 661.
For convenience, the following pages contain a table with all channel and level values
for zones 1–96.

AMX Driver v1.0 for Mirage Digital Ampliers |7 of 54
MirageAudioSystem.com
Function Channel/Level Function Channel/Level
Zone 1 Power Toggle 10 Zone 2 Power Toggle 50
Zone 1 Power On 38 Zone 2 Power On 78
Zone 1 Power Off 39 Zone 2 Power Off 79
Zone 1 Mute Toggle 11 Zone 2 Mute Toggle 51
Zone 1 Mute On 40 Zone 2 Mute On 80
Zone 1 Mute Off 41 Zone 2 Mute Off 81
Zone 1 Volume Up 12 Zone 2 Volume Up 52
Zone 1 Volume Down 13 Zone 2 Volume Down 53
Zone 1 Bass Up 23 Zone 2 Bass Up 63
Zone 1 Bass Down 24 Zone 2 Bass Down 64
Zone 1 Treble Up 25 Zone 2 Treble Up 65
Zone 1 Treble Down 26 Zone 2 Treble Down 66
Zone 1 Gain Up 27 Zone 2 Gain Up 67
Zone 1 Gain Down 28 Zone 2 Gain Down 68
Zone 1 Power On Volume Up 29 Zone 2 Power On Volume Up 69
Zone 1 Power On Volume Down 30 Zone 2 Power On Volume Down 70
Zone 1 Balance Left 31 Zone 2 Balance Left 71
Zone 1 Balance Right 32 Zone 2 Balance Right 72
Zone 1 Max Volume Up 33 Zone 2 Max Volume Up 73
Zone 1 Max Volume Down 34 Zone 2 Max Volume Down 74
Zone 1 Loudness Toggle 35 Zone 2 Loudness Toggle 75
Zone 1 Power On Volume Toggle 36 Zone 2 Power On Volume Toggle 76
Zone 1 Mono/Stereo Toggle 37 Zone 2 Mono/Stereo Toggle 77
Zone 1 Source 1 Select 15 Zone 2 Source 1 Select 55
Zone 1 Source 2 Select 16 Zone 2 Source 2 Select 56
Zone 1 Source 3 Select 17 Zone 2 Source 3 Select 57
Zone 1 Source 4 Select 18 Zone 2 Source 4 Select 58
Zone 1 Source 5 Select 19 Zone 2 Source 5 Select 59
Zone 1 Source 6 Select 20 Zone 2 Source 6 Select 60
Zone 1 Source 7 Select 21 Zone 2 Source 7 Select 61
Zone 1 Source 8 Select 22 Zone 2 Source 8 Select 62
Zone 1 Volume Level 1 Zone 2 Volume Level 11
Zone 1 Bass Level 2 Zone 2 Bass Level 12
Zone 1 Treble Level 3 Zone 2 Treble Level 13
Zone 1 Gain Level 4 Zone 2 Gain Level 14
Zone 1 Power On Volume Level 5 Zone 2 Power On Volume Level 15
Zone 1 Balance Level 6 Zone 2 Balance Level 16
Zone 1 Max Volume Level 7 Zone 2 Max Volume Level 17
Zone 1 Zone Name 14 Zone 2 Zone Name 54

AMX Driver v1.0 for Mirage Digital Ampliers |8 of 54
MirageAudioSystem.com
Function Channel/Level Function Channel/Level
Zone 3 Power Toggle 90 Zone 4 Power Toggle 130
Zone 3 Power On 118 Zone 4 Power On 158
Zone 3 Power Off 119 Zone 4 Power Off 159
Zone 3 Mute Toggle 91 Zone 4 Mute Toggle 131
Zone 3 Mute On 120 Zone 4 Mute On 160
Zone 3 Mute Off 121 Zone 4 Mute Off 161
Zone 3 Volume Up 92 Zone 4 Volume Up 132
Zone 3 Volume Down 93 Zone 4 Volume Down 133
Zone 3 Bass Up 103 Zone 4 Bass Up 143
Zone 3 Bass Down 104 Zone 4 Bass Down 144
Zone 3 Treble Up 105 Zone 4 Treble Up 145
Zone 3 Treble Down 106 Zone 4 Treble Down 146
Zone 3 Gain Up 107 Zone 4 Gain Up 147
Zone 3 Gain Down 108 Zone 4 Gain Down 148
Zone 3 Power On Volume Up 109 Zone 4 Power On Volume Up 149
Zone 3 Power On Volume Down 110 Zone 4 Power On Volume Down 150
Zone 3 Balance Left 111 Zone 4 Balance Left 151
Zone 3 Balance Right 112 Zone 4 Balance Right 152
Zone 3 Max Volume Up 113 Zone 4 Max Volume Up 153
Zone 3 Max Volume Down 114 Zone 4 Max Volume Down 154
Zone 3 Loudness Toggle 115 Zone 4 Loudness Toggle 155
Zone 3 Power On Volume Toggle 116 Zone 4 Power On Volume Toggle 156
Zone 3 Mono/Stereo Toggle 117 Zone 4 Mono/Stereo Toggle 157
Zone 3 Source 1 Select 95 Zone 4 Source 1 Select 135
Zone 3 Source 2 Select 96 Zone 4 Source 2 Select 136
Zone 3 Source 3 Select 97 Zone 4 Source 3 Select 137
Zone 3 Source 4 Select 98 Zone 4 Source 4 Select 138
Zone 3 Source 5 Select 99 Zone 4 Source 5 Select 139
Zone 3 Source 6 Select 100 Zone 4 Source 6 Select 140
Zone 3 Source 7 Select 101 Zone 4 Source 7 Select 141
Zone 3 Source 8 Select 102 Zone 4 Source 8 Select 142
Zone 3 Volume Level 21 Zone 4 Volume Level 31
Zone 3 Bass Level 22 Zone 4 Bass Level 32
Zone 3 Treble Level 23 Zone 4 Treble Level 33
Zone 3 Gain Level 24 Zone 4 Gain Level 34
Zone 3 Power On Volume Level 25 Zone 4 Power On Volume Level 35
Zone 3 Balance Level 26 Zone 4 Balance Level 36
Zone 3 Max Volume Level 27 Zone 4 Max Volume Level 37
Zone 3 Zone Name 94 Zone 4 Zone Name 134

AMX Driver v1.0 for Mirage Digital Ampliers |9 of 54
MirageAudioSystem.com
Function Channel/Level Function Channel/Level
Zone 5 Power Toggle 170 Zone 6 Power Toggle 210
Zone 5 Power On 198 Zone 6 Power On 238
Zone 5 Power Off 199 Zone 6 Power Off 239
Zone 5 Mute Toggle 171 Zone 6 Mute Toggle 211
Zone 5 Mute On 200 Zone 6 Mute On 240
Zone 5 Mute Off 201 Zone 6 Mute Off 241
Zone 5 Volume Up 172 Zone 6 Volume Up 212
Zone 5 Volume Down 173 Zone 6 Volume Down 213
Zone 5 Bass Up 183 Zone 6 Bass Up 223
Zone 5 Bass Down 184 Zone 6 Bass Down 224
Zone 5 Treble Up 185 Zone 6 Treble Up 225
Zone 5 Treble Down 186 Zone 6 Treble Down 226
Zone 5 Gain Up 187 Zone 6 Gain Up 227
Zone 5 Gain Down 188 Zone 6 Gain Down 228
Zone 5 Power On Volume Up 189 Zone 6 Power On Volume Up 229
Zone 5 Power On Volume Down 190 Zone 6 Power On Volume Down 230
Zone 5 Balance Left 191 Zone 6 Balance Left 231
Zone 5 Balance Right 192 Zone 6 Balance Right 232
Zone 5 Max Volume Up 193 Zone 6 Max Volume Up 233
Zone 5 Max Volume Down 194 Zone 6 Max Volume Down 234
Zone 5 Loudness Toggle 195 Zone 6 Loudness Toggle 235
Zone 5 Power On Volume Toggle 196 Zone 6 Power On Volume Toggle 236
Zone 5 Mono/Stereo Toggle 197 Zone 6 Mono/Stereo Toggle 237
Zone 5 Source 1 Select 175 Zone 6 Source 1 Select 215
Zone 5 Source 2 Select 176 Zone 6 Source 2 Select 216
Zone 5 Source 3 Select 177 Zone 6 Source 3 Select 217
Zone 5 Source 4 Select 178 Zone 6 Source 4 Select 218
Zone 5 Source 5 Select 179 Zone 6 Source 5 Select 219
Zone 5 Source 6 Select 180 Zone 6 Source 6 Select 220
Zone 5 Source 7 Select 181 Zone 6 Source 7 Select 221
Zone 5 Source 8 Select 182 Zone 6 Source 8 Select 222
Zone 5 Volume Level 41 Zone 6 Volume Level 51
Zone 5 Bass Level 42 Zone 6 Bass Level 52
Zone 5 Treble Level 43 Zone 6 Treble Level 53
Zone 5 Gain Level 44 Zone 6 Gain Level 54
Zone 5 Power On Volume Level 45 Zone 6 Power On Volume Level 55
Zone 5 Balance Level 46 Zone 6 Balance Level 56
Zone 5 Max Volume Level 47 Zone 6 Max Volume Level 57
Zone 5 Zone Name 174 Zone 6 Zone Name 214

AMX Driver v1.0 for Mirage Digital Ampliers |10 of 54
MirageAudioSystem.com
Function Channel/Level Function Channel/Level
Zone 7 Power Toggle 250 Zone 8 Power Toggle 290
Zone 7 Power On 278 Zone 8 Power On 318
Zone 7 Power Off 279 Zone 8 Power Off 319
Zone 7 Mute Toggle 251 Zone 8 Mute Toggle 291
Zone 7 Mute On 280 Zone 8 Mute On 320
Zone 7 Mute Off 281 Zone 8 Mute Off 321
Zone 7 Volume Up 252 Zone 8 Volume Up 292
Zone 7 Volume Down 253 Zone 8 Volume Down 293
Zone 7 Bass Up 263 Zone 8 Bass Up 303
Zone 7 Bass Down 264 Zone 8 Bass Down 304
Zone 7 Treble Up 265 Zone 8 Treble Up 305
Zone 7 Treble Down 266 Zone 8 Treble Down 306
Zone 7 Gain Up 267 Zone 8 Gain Up 307
Zone 7 Gain Down 268 Zone 8 Gain Down 308
Zone 7 Power On Volume Up 269 Zone 8 Power On Volume Up 309
Zone 7 Power On Volume Down 270 Zone 8 Power On Volume Down 310
Zone 7 Balance Left 271 Zone 8 Balance Left 311
Zone 7 Balance Right 272 Zone 8 Balance Right 312
Zone 7 Max Volume Up 273 Zone 8 Max Volume Up 313
Zone 7 Max Volume Down 274 Zone 8 Max Volume Down 314
Zone 7 Loudness Toggle 275 Zone 8 Loudness Toggle 315
Zone 7 Power On Volume Toggle 276 Zone 8 Power On Volume Toggle 316
Zone 7 Mono/Stereo Toggle 277 Zone 8 Mono/Stereo Toggle 317
Zone 7 Source 1 Select 255 Zone 8 Source 1 Select 295
Zone 7 Source 2 Select 256 Zone 8 Source 2 Select 296
Zone 7 Source 3 Select 257 Zone 8 Source 3 Select 297
Zone 7 Source 4 Select 258 Zone 8 Source 4 Select 298
Zone 7 Source 5 Select 259 Zone 8 Source 5 Select 299
Zone 7 Source 6 Select 260 Zone 8 Source 6 Select 300
Zone 7 Source 7 Select 261 Zone 8 Source 7 Select 301
Zone 7 Source 8 Select 262 Zone 8 Source 8 Select 302
Zone 7 Volume Level 61 Zone 8 Volume Level 71
Zone 7 Bass Level 62 Zone 8 Bass Level 72
Zone 7 Treble Level 63 Zone 8 Treble Level 73
Zone 7 Gain Level 64 Zone 8 Gain Level 74
Zone 7 Power On Volume Level 65 Zone 8 Power On Volume Level 75
Zone 7 Balance Level 66 Zone 8 Balance Level 76
Zone 7 Max Volume Level 67 Zone 8 Max Volume Level 77
Zone 7 Zone Name 254 Zone 8 Zone Name 294