Third Party Plugins

• 1: Loxone Maxx Control plugin
• 2: Q-SYS Maxx Control plugin

1 - Loxone Maxx Control plugin

Loxone integrators can control one Innosonix amplifier via Maxx Control using the Loxone Library plugins and example templates. Install the add-ons into Loxone Config, point each instance at the amp IP (or hostname.local), and drive mute, volume, and status over the device REST API.

What is the Loxone Maxx Control plugin?

The Loxone Maxx Control integration is a set of .LxAddon plugins from the Loxone Library that talk to a single amplifier’s Maxx Control REST API. Instantiate a plugin once per physical device.

Which Loxone templates do I need?

Because 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:

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).

2 - Q-SYS Maxx Control plugin

Q-SYS integrators can control one Innosonix amplifier via Maxx Control using the Innosonix Maxx Control plug-in for Q-SYS Designer. Add the plug-in to your design, enter the amp IP, and expose mute, volume, meters, and status to Q-SYS UCIs and logic.

What is the Q-SYS Maxx Control plugin?

Innosonix provides a plug-in that integrates Maxx Series amplifiers (Maxx Control) with the QSC Q-SYS ecosystem. Devices can then be controlled from Q-SYS Designer, Q-SYS compatible user-control interfaces, and GPIO logic on Q-SYS cores and peripherals.

You must be using Q-SYS Designer 9.8 or above.

Control features

• Ampenable
• Ch Fault
• Ch Name
• Ch Status
• Connection Status
• Device Fault
• Device Status
• Disable
• 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

How do I install it in Q-SYS Designer?

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

2. Copy the downloaded plug-in file into the My Documents/QSC/Q-Sys Designer/Plugins folder (exact filename is in the download package from the Innosonix website).

3. Open Q-SYS Designer; the plug-in appears under Schematic Elements → Plugins:

   

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:

   

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-click the plug-in icon, open the Global tab, and enter the amplifier IP address. The IP is shown on the device front panel, or use IDFM to discover it:

   

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”:

   

10. 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!