This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Third Party Plugins

Third Party Plugins to use with MAXX CONTROL

All those plugins utilizing the REST-API to aceess a SINGLE device.

1 - Crestron Maxx Control

Getting started with Crestron Maxx Control Plug-In

Introduction:

The Module Provides Control of a single channel on the Innosonix MA32/D2 range of audio mixer via Ethernet. The driver relies on the REST-API via Port 80 (HTTP) to the Innosonix MA32/D2 Unit.

The Module has been designed to run on Crestron 3 & 4 series processors.

Known Limitations – Sometimes, the unit doesn’t respond or responds slowly to the first command post boot. So on boot sequence we recommend Polling a single channel and then call the INIT function to poll all the required data correctly.


Inputs:

Name Type Description
Init D Starts the module and polls initial settings. Pulse or Latch at the start of the program. Is designed to allow access to poll all channels so is delayed by channel ID to allow a smooth start up
Poll D Re-polls the channel for its current statis
Channel Amp On D Turns on the Power to the Channel Speaker Output
Channel Amp Off D Turns off the Power to the Channel Speaker Output
Channel Amp Off and Vol Reset D Turns off the Power to the Channel Speaker Output and reset the Volume to the default set in the paramters
On/Off/Toggle D Sets the mute status
Channel Volume IN# A Analog to set the output volume between 0-100% (For a slider)
Channel Volume Up/Down D Turns up or down the output volume
Channel Input Off D Clears the Input Channel
Channel Input Dante 1-32 D Quick Selection of the 32 Dante Inputs – with the Input Gain defined at the bottom
Channel Set Patch D Sets the Channel Patch (Input) to the analog values below
Channel Patch ID# A The Patch ID to set the Channel to (IE 1. MADI FIBRE 2. MADI COAX 1 3. MADI COAX 2 4. DANTE 5. AES 3 1 6. AES 3 2)
Channel Patch Source# A Sets the Source ID – Usually set to 1 unless mixing multiple inputs together
Channel Patch Channel A Sets the patch Interface Channel – IE on Patch ID 4 (Dante) each Dante input is a different Channel.
Channel Patch Gain A Gain for the Input Patch Range -72 to +24.

Outputs:

Name Type Description
Channel Name S Channel Name from the Mixer
Channel Amp On FB D High when the Amp Power for the Channel is On
Channel Amp Off FB D High when the Amp Power for the Channel is Off
Channel Mute On FB D High when the Channel is muted
Channel Mute Off FB D High when the Channel is not muted
Channel Volume# A Volume Feedback as an analog value. Range 0% - 100%
Channel dB Level S Text feedback for the current real Volume level of the Channel

Paramters:

Name Type Description
Channel A Channel Number to Control. 1 - 32
IP Address S IP Address of the Innosonix MA32 unit
Dante Gain S Input Channel Gain for the quick select Dante Inputs (-72.0 to 24.0)
Default Vol S - Selection Volume the channel will reset to when the Channel off and volume reset Digital is pulsed.

2 - Loxone Maxx Control

Getting started with Loxone Maxx Control Plug-In

Due to the fact that Loxone can only combine either Virtual Inputs or Virtual Outputs in a Template file, two different Templates have to be installed:

  • MAXX-CONTROL which allows to set parameters to the amplifier
  • MAXX-STATUS fetches Data from the Amplifier, mainly intended for Channel and Device Status

It’s totally valid to use only one, depending on your needs.

Installation

Download the corresponding .LxAddon Files and install it into your Loxone Config by double clicking or via the Import wizard like:


General

Both Plugins can be instantiated multiple times, as often as you want to control physical devices.


MAXX-CONTROL

Download the MAXX-CONTROL.Loxone example file from the Loxone Library

The Template basically provides the following predefined controls:

  • Channel Power
  • Channel Mute
  • Channel Volume
  • Device Identify
  • Device Master Mute
  • Device Master Volume

and some examples of how to create custom commands for improved performance.


Power / Mute

Simple digital outputs which can be grouped together in any desired combination.


Volume

Similar to Power / Mute Volume will send out any changes for each output as a single http request.

The interesting part here is how to map the common Loxone Analog Values in a range of 0-10 to a dB value for the amplifiers. That can be easily done with the Correction field of each output. The default configuration will map the values of 0-10 to -72dB - +10dB

This will give you almost the full dynamic range of the volume value:


Combined Commands

A basic understanding of the REST-API interface is recommended to create those combined commands.

As a starting point, have a look at the three included examples:

  • Multichannel Mute
  • Multichannel Power
  • Multichannel Volume

Those commands send the same value to multiple channels within a single HTTP request, significantly improving performance when many channels are involved in a call.

Multichannel Mute

Let’s have a look at the HTTP body which is sent out when the DIGITAL OUTPUT is set to ON by clicking on the edit button of that line:

You basically see a JSON payload file containing an ARRAY of single JSON objects for the corresponding channels, indicated by the channel_id tag:

[
  {
    "channel_id": 1,
    "dsp": {
      "mute": {
        "value": true
      }
    }
  },
  {
    "channel_id": 5,
    "dsp": {
      "mute": {
        "value": true
      }
    }
  },
  {
    "channel_id": 7,
    "dsp": {
      "mute": {
        "value": true
      }
    }
  },
  {
    "channel_id": 30,
    "dsp": {
      "mute": {
        "value": true
      }
    }
  }
]

To modify that, simply duplicate the entries:

{
   "channel_id": 1,
   "dsp": {
      "mute": {
         "value": true
      }
   }
},

for each channel, you want to control and change the channel_id to the desired channel number.


MAXX-STATUS

Download the MAXX-STATUS.Loxone example file from the Loxone Library

The MAXX-STATUS Template periodically polls the /rest-api/status URL of the amplifier and filters the response for each channel status/device status.

The raw CHxx STATUS value represents the default syslog severity levels like:

STATUS Level
0 EMERGENCY
1 ALERT
2 CRITICAL
3 ERROR
4 WARNING
5 NOTICE
6 INFORMATIONAL
7 DEBUG
8 OK

In combination with the provided STATUS component with the following settings:

An easy virtualization can be achieved.

Combining the Val output of each STATUS component with an OR Gate, a simple GLOBAL STATUS can be generated when any channels or device assert any state higher than NOTICE ( see STATUS settings, State value).

3 - Q-SYS Maxx Control

Getting started with Q-SYS Maxx Control Plug-In

Introduction:

Innosonix GmbH has developed a plug-in to integrate our web based control page for Maxx Series called Maxx Control with QSC Q-SYS Ecosystems.

Innosonix Devices can be added to the Q-SYS Ecosystem with Q-SYS Designer Software. You must be using Q SYS Designer 9.8 or above in order to use this plug-in

Innosonix Devices can then be controlled by Q-SYS Designer, Q-SYS compatible user-controlled interfaces and GPIO logic ports integrated into Q-SYS cores and peripherals.

Control features:

  • Ampenable
  • Ch Fault
  • Ch Name
  • Ch Status
  • Connection Status
  • Device Fault
  • Device Status
  • Disable
  • Device Fault
  • Input Meter Level
  • IP Address
  • Load Monitor Impedance
  • Mute
  • Output Meter Level
  • Output Meter Reduction
  • Volume

Innosonix devices must have firmware version V3.19.4 or above installed to be compatible with the Maxx Control Plug-in. If you are unsure what firmware you device is currently using, please download IDFM to help confirm and if need be install up to date firmware.

For further control and processing capabilties of your Maxx Device please download Maxx Remote

Getting Started:

  1. Download the Innosonix Maxx Control Plug-in from the Third Party Downloads section of the Downloads section of our website.

  2. Copy the insert name of plug-in here from into the My Documents/QSC/Q-Sys Designer/Plugins Folder

  3. Open Q-SYS Desinger, the Plug-in can be found in the Schematic Elements/Plugins section on the right-hand side of the page:

    Image of Plug-in file path

  4. Drag and drop the Plug-in into your design and select it by clicking once on the Plug-in icon.

  5. Control pins can be enabled by ticking the check-boxes in the “Control Pins” section as required:

    Image of the location of the Plug-in Control Pins

  6. Go “Online” with your Q-Sys project. If devices are not connected you can use the “Emulate” function under the “File” tab in the menu above.

  7. Double clicking the Plug-in icon brings up the device interface, select the “Global Tab”, and enter the amplifiers IP address. If you are having trouble find the IP address of your device it will appear on the front screen of your device Alternatively, use idfm to find the IP addressof your device:

    Image of Plug-ins global tab page

  8. The “Global Tab” notifies the user of important information on the Innosonix device including:

    • IP Address
    • Model
    • Software Version
    • Serial Number
    • Device Name
    • Device Location
    • Pole Counter
    • Device Status
  9. Select the “Channels Tab”:

Image of Plug-ins channel tab page

  1. Within the “Channels Tab” the user has the facility to adjust a number of the devices features including:
  • Mute
  • Enable or Disable Channel
  • Volume

Further Assistance:

For any more information please visit feel free to Contact us!