🎛️ Processor Integrations

AHM Protocol documentation:
​https://www.allen-heath.com/content/uploads/2023/11/AHM-TCP-Protocol-V1.4.pdf

AHM Control software download:
​https://www.allen-heath.com/hardware/ahm/ahm-32/resources/

Find the unit with control software. Under discovery, you will find out if the version is correct. It is important to use a compatible version here to avoid damaging the file.

We can either use group addresses or pure output numbers as addresses. For group addresses, we use the prefix GC before the group number. For example, 'GC1'.

MTX Commands: https://downloadspvsglobal.azureedge.net/downloads/audac/products/manuals/MTX_Commands_Manual.pdf

M2 Commands:
​https://downloadspvsglobal.azureedge.net/downloads/audac/products/manuals/M2_Commands_Manual.pdf

The object addresses are zone numbers 1-8. They will most likely match the zone numbers on the panels, if not, you will need to try different ones to find the correct one.

Designer software: https://support.biamp.com/Tesira/Software-Firmware

The address is the zone name and channel number.

Protocol: https://resources-boschsecurity-cdn.azureedge.net/public/documents/PLENA_matrix_API_Operation_Manual_enUS_66188793867.pdf

Bosch mixers feature predefined zones and gains, typically including two distinct gains per zone based on observed installations:

Due to this setup, each zone requires configuring a master/slave gain pair to facilitate proper control.

Object addresses are predetermined and are used for controlling source selection, mute, and gain simultaneously. A distinctive aspect of Bosch DSP systems is that gain, mute, and source selection are set using a single command. Thus, setting the gain automatically sets the source as well, making accurate setup of sources and selectors critical for correct functionality.

Protocol docs:

https://assets.bose.com/content/dam/Bose_DAM/Web/pro/global/products/software/ControlSpace_Designer_software/downloads/ControlSpace_Designer_5-9_Release/ControlSpace_SerialControlProtocol_5.9.pdf

Bose DSP systems (ControlSpace) utilize block names as object addresses for controlling gains and source selectors.

Block names serve as addresses for both gains and source selectors. These names typically correspond to display labels indicating the relevant zone. Older versions of ControlSpace Designer allow multiple blocks to share identical names, which will result in errors when reading or setting values. To avoid this issue, ensure all relevant block names are unique within the file.

Gain blocks within ControlSpace use their displayed names as addresses:

Source selector blocks in ControlSpace also use their displayed names as addresses:

ControlSpace allows grouping of similar objects, enabling combined control through panels or commands. This grouping feature is particularly beneficial in installations without a DSP, offering better gain management. Group addresses are automatically assigned indices by ControlSpace Designer, thus eliminating the risk of name duplication.

Soundweb London protocol docs

Designer software download page

BSS DSP devices utilize object addresses within Audio Architect software for controlling gains, mute states, and source selection.

Object addresses can be identified within Audio Architect by clicking on the relevant block and checking the lower window overview or navigating through the Venue Explorer.

Addresses for gains in Audio Architect follow this format:

Example of a 4-zone gain-n-input block:

To verify addresses or find new ones, use Venue Explorer in Audio Architect to locate exact parameter addresses. Single gain blocks typically have parameter address 0x0000.

Note: Older BSS processors configured with London Architect may have different addressing conventions.

Mute addresses for gain-n-input blocks typically follow this pattern, using the base address from the gain with an offset starting at 0x0020:

Single gain blocks have mute addresses set to 0x0001.

Note: Addressing in London Architect systems may differ.

Audio Architect uses "Source Selector" blocks for selecting input sources. Each selector can feed multiple zones, and its parameter value indicates the active source index.

Example source selector address:

Setup guidelines:

If input indexes vary between source selectors, a mapping method must be implemented to correlate input indexes to each specific selector.

Cloud protocol docs:
​https://www.cloud.co.uk/public-download/Q1YgQW1wbGlmaWVyIFNlcmlhbCBDb250cm9sIFByb3RvY29sIFYxLjAucGRm/ZmlsZXMvLzk5NGQ5MWNlNWU1N2FjNGY5NmQ5ZjczZmI0NTMxNjM3LnBkZg–

The Cloud network discovery tool is used to find the processor on the network. With this tool, you can view and change the IP address. You can also double-click the device to open a web app used for configuration. The default PIN code is: 1234

The dbx ZonePRO can be controlled via Ethernet or RS-232.

Note: The provided documentation references RS-232 communication, but the same guidelines apply for Ethernet control (refer to the Appendix section in the original documentation).

Object addressing in ZonePRO can initially appear complex. Addresses are identified using the ZonePRO GUI Designer software. For the 641m model, the GUI appears as follows:

This action will reveal the bytes: b0, b1, b2, b3.

Object addresses for use within the Waved app are constructed as follows:

The resulting object address becomes:

Ensure correct entry to avoid communication issues.

When you add a Genelec processor in the Waved installation view a new tab "Speakers" will appear.

Click "Add speakers".

When the speakers appear you can use "Blink" or "Mute" to identify the speakers and place them in the designated zone.

In Q-Sys Designer software, you can retrieve existing files from the network by selecting:

Within this file, gain blocks can be used for volume control.

Object addresses are derived from the names of the blocks you wish to control. In recent versions of Q-Sys Designer, labels alone are insufficient—you must set or read the "Code Name" from the right-hand column:

In older software versions, simply naming the block is enough.

In some scenarios, volume control is done using a 1x1 Matrix block. In such cases, the syntax used for addresses is slightly different, using:

For example, to control output gain:

The default range for gain in Q-Sys Designer is -100 dB to +20 dB. These can be customized, potentially limiting slider functionality. Special attention is required when controlling the master volume, as discrepancies between the app and real values could lead to endless compensation loops. A fix will be introduced if this becomes a frequent issue.

Q-Sys Designer uses "Router" instead of "Source Selector," though they function similarly despite appearing as a matrix visually.

Addresses follow this format:

For example, channel 1 of a router would have the following object address:

When you add a Sonos processor in the Waved installation view a new tab (Speakers) will appear.

Click "Add speakers".
​
When the speakers appear you can use "Blink" or "Mute" to identify the speakers and place them in the designated zone.

The Stoltzen Typhoon X88 DSP can be controlled and configured using the Flow software, accessible directly from the device through a web interface.

Default IP Address: 169.254.10.227
​Subnet Mask: 255.255.0.0

To connect to a device:

Addresses correspond to output numbers on the processor, starting at 0.

Outputs can be grouped using the following format:

This example groups outputs 1, 2, and 3 into one zone.

Currently, only source selection via matrix on the input row is supported for Stoltzen DSP.

This configuration specifically addresses needs like those at Paleet, where external wall panels are not used. This allows the integration to use sourcematrixsubscribe, reducing unnecessary polling and network requests.

Symetrix DSPs use two distinct protocols, Composer Control Protocol and Jupiter Protocol, depending on the DSP model:

Note: The IP address can be found using the connection wizard in Composer software or via the front panel of the DSP.

To extract the configuration file from the DSP using Composer:

Jupiter software uses a different approach. Control elements are associated with pre-assigned Controller Numbers:

The Remote Control Manager displays all controls assigned to external panels:

Source-selector blocks within Composer software use similar object addresses as volume controls. Addresses correspond directly to their assigned source indices.

Object addresses (Controller Numbers) for Jupiter DSPs can be found via:

Example: If a Symetrix panel is present, identify the targeted control element in the software to obtain the correct Controller Number.

Xilica DSPs use a TCP/IP protocol operating on port 10007.

Important: Xilica’s protocol requires manually naming the objects (gain, mute, source selectors) in the Designer software, meaning configuration updates are often required during installation.

To discover Xilica devices on a network:

Configuration can be accessed live through Network View for real-time adjustments or saved locally and viewed in Project View.

Xilica requires manually naming parameters to be controlled externally:

To review assigned object names:

After assigning names to all parameters, upload the updated configuration:

Mute parameters must be defined separately as they are dedicated components:

Source selection in Xilica uses a component called "Input Selector":

Matrix-based source selection is currently unsupported in Xilica. The recommended workaround is to replace matrices with input selectors in your design file.

As Xilica Designer software cannot link parameters internally, stereo signals with input selectors require manual address linking within the Waved app. Please refer to the dedicated section in the installation guide for detailed instructions on parameter linking.

Yamaha MTX and MRX DSP devices can be controlled using Yamaha’s Remote Control Protocol via Ethernet or serial connection. Communication with the processor occurs through TCP/IP on port 49280.

Setup and configuration are done through the MTX-MRX Editor software:

On the rear of the MTX/MRX device, DIP switch number 6 selects how IP addresses are determined:

To change the unit ID on an already synchronized DSP:

Ensure no alerts are displayed on the DSP and verify panel functionality.

Addresses follow this format:

Example addresses:

Yamaha MTX devices use general subscriptions rather than individual parameter subscriptions. Use terminal debugging in WavedHub to identify exact addresses by observing parameter changes.

The MRX-7D utilizes a designer-file system, allowing the selection of specific parameters for remote control:

Object addresses for MRX-7D follow a simpler format:

The WavedBox can be used to connect between a mixer and an amplifier to be able to automatically adjust volume on analog systems. You can also connect the source directly to the WavedBox. We recommend using balanced cables.

When the WavedBox is connected to the hub click "add processor" and select "Waved Box" type. You can check the box that automatically adds the three sources (balanced, RCA 1 and RCA 2) and the 6 zones (output 1-6).