Yamaha MTX Control Driver v1.11

Smart Home Programming

david@smarthomeprogramming.com.au

This driver controls the Yamaha MTX3 and MTX5-D Matrix Processors via the SCP protocol. Supports both TCP/IP network and RS-232 serial connections.

!!! Use one driver instance per MTX device !!!

Key Features

TCP/IP or RS-232 serial connection to the MTX processor

Simple configuration — just pick a Type and Channel for each control point

Real-time feedback via SCP NOTIFY push updates

24 Zone outputs (Volume + Mute + Priority Ducking)

8 Source/Input controls (Level + Mute + Matrix routing)

16 Output controls (Level only)

10 Preset/Snapshot recalls

Exclusive source selection (one-touch input switching per zone)

Matrix crosspoint control (on/off + level per zone/input pair)

Per-zone Min/Max volume limits for safe slider ranges

Command queue prevents device overload

Auto-reconnect on disconnection

Debug console for live troubleshooting

Connection Settings

Connection — Select between TCP/IP (network) or RS-232 Serial. The appropriate settings will appear based on your selection.

TCP/IP Settings

IP Address — The IP address assigned to the Yamaha MTX Processor.

Port — TCP port for SCP communication. Default is 49280.

RS-232 Serial Settings

Serial Port — Select the serial port on the RTI processor connected to the MTX. The dropdown automatically shows available ports for your processor model.

Baud Rate — Serial baud rate. Yamaha default is 38400. Options: 9600, 38400, 115200.

Serial connection uses 8 data bits, 1 stop bit, no parity, no flow control (8N1). This matches the Yamaha MTX default serial configuration.

Model — Select MTX3 or MTX5-D. This determines channel ranges and available input counts. The number of zones available in Integration Designer adjusts automatically based on model selection (MTX3 = 8 zones, MTX5-D = 16 zones).

Zone Configuration

Zones are room volume/mute outputs. Each zone provides Volume, Mute, 1st Priority, and 2nd Priority control.

Zone Count — Number of zones to configure (0–24). Only configured zones appear in the function list and consume resources.

For each zone:

Name — Display name for this zone (e.g. "Living Room", "Restaurant Floor")

Type — The MTX output type:

– Zone Output — MTX Zone output with Volume, Mute, and Priority Ducker support

– Mixer Output — Mixer output bus with Volume and Mute

Channel — The channel number (1–16) matching the output in MTX Editor

Min Volume — Minimum volume level for the slider (0–1000). Use this to prevent the volume from being set too low.

Max Volume — Maximum volume level for the slider (0–1000). Use this to cap the maximum volume for safety.

Input Configuration

Inputs represent the audio sources feeding into the MTX mixer. Each input provides Level and Mute control, plus matrix routing to zones.

Input Count — Number of inputs to configure (0–8).

For each input:

Name — Display name for this input (e.g. "Microphone", "Background Music", "DJ Mixer")

Input Channel — The mixer input channel. Options change based on model:

– Mono channels: Ch1–Ch8 (MTX3) or Ch1–Ch16 (MTX5-D)

– Stereo pairs: ST1–ST6 (both models)

Always On — When enabled, the "Select Input (Exclusive)" function will not turn off this input's matrix point. Useful for inputs like background music that should always be routed.

Min Level — Minimum input level (0–1000)

Max Level — Maximum input level (0–1000)

Output Configuration

Outputs are for direct output-level control (amplifier outputs, monitor feeds, etc.).

Output Count — Number of outputs to configure (0–16).

For each output:

Name — Display name for this output

Channel — Output channel number (1–16)

Min Level — Minimum output level (0–1000)

Max Level — Maximum output level (0–1000)

Preset Configuration

Presets recall MTX Editor snapshots. Up to 10 presets can be configured.

Preset Count — Number of presets to configure (0–10).

For each preset:

Preset Name — Display name shown in the function list (e.g. "Day Mode", "Night Mode")

Preset Number — The snapshot number in MTX Editor (1–50)

Source Selection & Matrix Routing

The driver provides powerful matrix routing between inputs and zones:

Select Input (Exclusive) — Selects one input for a zone by turning on its matrix crosspoint and turning off all others (except inputs marked "Always On"). This is ideal for source selection on a touchpanel — tap "Microphone" and it becomes the active source for that zone.

Set Matrix Point — Manually turn an individual crosspoint on, off, or toggle it. Use this for mixing scenarios where multiple inputs need to be active simultaneously.

Set Matrix Point Level — Set the crosspoint level (0–1000) for a specific zone/input pair.

Adjust Matrix Point Level — Increment or decrement a crosspoint level by a configurable step size. Useful for button-held ramping.

Priority Ducking

Zone outputs with "Zone Output" type support Yamaha's priority ducking feature. This allows high-priority audio (paging, emergency announcements) to automatically reduce the volume of lower-priority sources.

Zone 1st Priority — Controls the 1st (highest) priority ducker. When activated, this source takes priority over all other audio in the zone.

Zone 2nd Priority — Controls the 2nd priority ducker. Lower priority than 1st but still ducks normal audio.

Each priority function supports On, Off, and Toggle commands.

Events fire when priority states change (e.g. "Zone 1 1st Priority On", "Zone 1 2nd Priority Off"), allowing macros to respond to ducking events.

Available Functions

Zone Control

Zone Set Volume — Set zone volume to an absolute level (0–1000)

Zone Adjust Volume — Increase or decrease volume by steps (repeatable for button hold)

Zone Mute — Mute, Unmute, or Toggle mute state

Zone 1st Priority — 1st priority ducker On/Off/Toggle

Zone 2nd Priority — 2nd priority ducker On/Off/Toggle

Select Input (Exclusive) — Switch active input for a zone

Set Matrix Point — Individual crosspoint On/Off/Toggle

Set Matrix Point Level — Set crosspoint level

Adjust Matrix Point Level — Ramp crosspoint level up/down

Output Control

Output Set Level — Set output level (0–1000)

Output Adjust Level — Ramp output level up/down by steps

Preset Control

Recall Preset — Select and recall a configured preset

Preset 1–10 shortcuts — Direct recall for each preset slot

Query Functions

Query All — Re-query all settings from the MTX

Query Zones, Query Sources, Query Crosspoints, Query Faders, Query Outputs, Query Toggles — Query specific subsystems

Advanced

Raw Command — Send a raw SCP protocol command string directly to the MTX

System Variables

System

Connected (boolean) — True when connected to the MTX

Initialized (boolean) — True when all initial queries are complete

Per Zone

Zone Name (string) — Configured display name

Volume (integer, 0–1000) — Current volume level

Volume dB (string) — Current volume in dB (e.g. "-12.5 dB")

Min Volume, Max Volume (integer) — Configured range limits

Mute (boolean) — Current mute state

1st Priority, 2nd Priority (boolean) — Priority ducker states

Active Input (string) — Name of the currently selected input

Active Input Number (integer) — Number of the currently selected input

Matrix (boolean per input) — Whether each input crosspoint is on

Matrix Level (integer per input) — Crosspoint level for each input

Per Output

Output Name (string)

Level (integer, 0–1000)

Level dB (string)

Min Level, Max Level (integer)

Presets

Active Preset (string) — Name of the last recalled preset

Active Preset Number (integer)

Events

System Events

Connected — Fires when connection to MTX is established

Disconnected — Fires when connection is lost

Initialized — Fires when all initial queries complete

Per Zone Events

Zone N Muted / Zone N Unmuted

Zone N Source Changed — Active input changed

Zone N 1st Priority On / Zone N 1st Priority Off

Zone N 2nd Priority On / Zone N 2nd Priority Off

Per Input Events

Input N Muted / Input N Unmuted

Preset Events

Preset N Recalled — Fires when a preset is activated

Channel Reference

MTX3:

Zone Outputs: 1–4

Mixer Outputs: 1–8

I/O Inputs: 1–8

I/O Outputs: 1–8

Mixer Input Mono: Ch1–Ch8

Mixer Input Stereo Pairs: ST1–ST6

FX Return Pairs: 1–2

Matrix: 16 inputs x 8 outputs

MTX5-D:

Zone Outputs: 1–4

Mixer Outputs: 1–16

I/O Inputs: 1–16

I/O Outputs: 1–16

Mixer Input Mono: Ch1–Ch16

Mixer Input Stereo Pairs: ST1–ST6

FX Return Pairs: 1–2

Matrix: 22 inputs x 16 outputs

Volume Scaling

All volume and level values use a normalized 0–1000 scale:

0 = minimum (typically -infinity dB)

1000 = maximum (0 dB or +10 dB depending on output type)

The dB value is reported in the corresponding "dB" system variable for display purposes. The RTI room volume source uses this 0–1000 range natively, so zone volumes map directly to RTI's standard volume control.

Debug Console

When Debug Level is set to Basic, Verbose, or Protocol, a TCP debug console listens on the configured Debug Port (default 12510). Connect with any TCP/telnet client to see live status and issue diagnostic commands.

Available commands:

help — List all available commands

status — Connection state, initialization, transport type, run mode, queue depth

zones — Zone names, volumes, mute states, priority states

sources — Source/input names and matrix input mappings

outputs — Output names, levels, and types

faders — Fader names and levels

toggles — Toggle names and states

presets — Preset names and numbers

map — Device map showing all registered SCP addresses

queue — Command queue state and pending messages

eval <expression> — Evaluate a JavaScript expression (e.g. "eval g_connected")

raw <command> — Send a raw SCP command to the MTX device

Advanced Settings

Debug Level — Controls logging verbosity:

Off — No debug output, debug console disabled

Basic — Connection events and errors only

Verbose — All state changes and commands

Protocol — Full SCP protocol trace (TX and RX messages)

Debug Port — TCP port for the debug console. Default is 12510. Change this if running multiple driver instances to avoid port conflicts.

Licensing

Licence keys can be purchased from the Smart Home Programming Driver Store:

Store: https://shpdrivers.services/store/

Email: david@smarthomeprogramming.com.au

A 120-minute trial is included for testing before purchase.

Support & Feature Requests

For bug reports, technical support, or new feature requests, please use the ticket system available in your account after logging in at the Driver Store.

Support Tickets: Log in at https://shpdrivers.services/store/ and submit a ticket from your account

Email: david@smarthomeprogramming.com.au

Terms of Service

All drivers are provided "as is" without warranty of any kind. You use this software entirely at your own risk. A free trial is included so you can verify compatibility with your system before purchasing. Do not purchase a licence if you have not tested the driver on your hardware. For full terms including warranty disclaimer, limitation of liability, and refund policy, visit:

https://smarthomeprogramming.com.au/store/terms.html

Copyright 2026 Smart Home Programming. All rights reserved.