XMatrix interface · DMX512

XMatrix DMX512 Interface: a lighting console drives the motor

XMatrix is the software system of XMSP. This page is the DMX512 function, code DMX512. A console or a media server can add the motor to a fixture library so a fader drives position and speed. An MSP controller can also turn XMatrix run data into a DMX bus.

  • Slave / masterThree roles
  • P / PV / PPV / VChannel modes
  • Console directOn the whole range
  • Loss-of-signal behaviorDefault: return to 0 after 5 seconds
See the first runSee wiring and roles

What it does

The XMatrix DMX512 Interface moves, programs, and interacts with the motor, and it puts that control into a lighting workflow you already have. A lighting console, a media server, or timeline software can command motor position and speed the way it commands a fixture. The device receives DMX512 directly and turns channel values into homing, positioning, speed, and continuous run. You do not add a PLC, a motion card, or a pulse module.

It addresses the usual problem of putting a motor on a lighting system: poor console fit, a fixed feature set, heavy wiring, an extra controller, and a long commissioning chain. It fits stage machinery, architectural lighting, exhibitions, signage, kinetic matrices, interactive work, and special-purpose machines.

  • Channel modes cover position, position + speed, fine position + speed, and continuous forward/reverse.
  • Set direction, homing, maximum speed, and maximum travel in the commissioning software, then hand the axis to the console.
  • Several devices are placed by DMX start address, and they can share a console cue with the fixtures.
  • Stepper and servo paths use the same DMX logic and can be mixed on a project.
  • Limits, homing, loss-of-signal behavior, brake control, and online firmware maintenance are supported.
Signal boundary: The device receives a DMX512 signal cable. If the console has only a network output such as Art-Net, add a protocol converter. An ordinary Ethernet cable is not a substitute for the DMX cable.

Rotating flip-display mechanisms

Flip displays and rotating exhibit boards — many units grouped by channel address, with values combined into a page turn, a wave, or an array change — are one use of the roles and channel modes on this page. Treat each board as a slave and lay out channels by address. A real project is judged from the unit count and the move logic. This page does not expand on it.

Quick start

  1. Connect power, the motor, home, and the positive and negative limits. Jog and home in the commissioning software first.
  2. Set motor direction, homing method, maximum speed, and maximum travel. Confirm the mechanism stays inside a safe range.
  3. Choose a DMX channel mode: P, PV, PPV, or V, and set the slave start address.
  4. Switch the device to DMX slave mode. Connect DMX+, DMX−, and GND to the console bus in that order.
  5. Add it on the console as a fixture. The start channel is the software address plus 1. After homing at power-up, move the channel up slowly from a low value.
Channel modesHow the console drives itWhat it fits
PChannel 1 is position. 0–255 runs from the start of travel to full travel.Position from a single fader
PVChannel 1 is position. Channel 2 is move speed.Position and speed both need to be adjusted on site
PPVChannels 1 and 2 combine into a fine position. Channel 3 is speed.Long travel, or a finer position resolution
VChannel 1: 0 stop, 1 forward, 2 reverse. Channel 2 is speed.Continuous run, such as a turntable or a hoist

Console example: two channels, one motor

Assume software address 0 and channel mode PV. The console starts at channel 1:

  • Channel 1: Position. 0 is the start of travel, 255 is the maximum travel set in software, and 128 is about mid-travel.
  • Channel 2: Speed. A larger value moves the motor toward the target faster. Maximum speed is still limited by the device parameter.
  • First run: Keep both position and speed low. Wait for homing after power-up, then ease the position channel up. If direction or travel is wrong, change it in the commissioning software. Do not drive into a limit from the console.
Address conversion: Software addresses start at 0. Console channels start at 1. Software address 0 is therefore console start channel 1. The next device must start after the channels this unit occupies.

Detail

The rest of this page follows the usual DMX slave path: wiring, channel map, travel scaling, homing, and loss of signal. A DMX master is a project function and is summarized at the end.

Shared configuration, commissioning, and parameters

This software function shares the MSP device foundation with the other XMatrix entries. Configure groups, axes, and motion modules, check home, limits, direction, and homing, then set speed, acceleration, travel, and protection. Enter the software mode on this page only after that foundation is done.

XMatrix shared hardware configuration: groups, axes, and motion modules
Shared hardware configuration: create groups and axes, and add a motion module to each axis
XMatrix shared motion commissioning: home, limits, I/O, position, jog, homing, and stop
Shared motion commissioning: watch home, positive and negative limits, and I/O, jog slowly to confirm direction, then home
XMatrix shared parameters: direction, speed, acceleration, travel, torque, homing, and protection
Shared parameters: direction, speed, acceleration, travel, torque, homing, and protection in one place. Numbers in the figure are only a screen example.

Where it sits

The XMatrix DMX512 Interface puts motor motion control and the DMX512 protocol in the same MSP hardware. The console outputs channel values. The device homes, accelerates, scales position, applies limits, and handles errors, so the motor enters a lighting or media control system directly.

  • Simpler integration: No extra motion controller. A standard DMX512 signal runs the motor.
  • Keep the existing workflow: Address the axis like a fixture. Position and speed go straight into a console cue.
  • What you can configure for the site: Open-loop, closed-loop, brake, homing, limits, and loss-of-signal behavior are set for the site.
  • Room to extend: P, PV, PPV, and V are the general modes. A non-standard channel map can be defined for a project.

Wiring

MSP servo DMX512 minimum system: console bus, supply, encoder, and power cable
DMX minimum system
The DMX bus enters the RS485 / DMX port. Supply, power cable, and encoder cable follow the servo path. Limits and home connect to 24 V I/O.
  1. Connect power and the motor.
  2. Wire home and the positive and negative limits for the homing method you chose. Home on the first run.
  3. Connect the console DMX cable to the device RS485/DMX port: RS485+ ↔ DMX+, RS485− ↔ DMX−, GND ↔ DMX GND.
  4. Several units can daisy-chain over Ethernet for parameters and synchronization. Channel data still comes from the DMX cable.

Slave: follow the console faders

The device is a DMX slave. The console lines the start channel up with the device address, and faders run the motor. This fits lighting, multimedia, and stage-machinery teams who do not want a second host application just for the motors.

  • A fader is position, speed, or direction. Coarse position is 8-bit. Fine position is 16-bit.
  • Several units are patched by address, the same way fixtures are. Remember: software address starts at 0, console channels start at 1, and console start channel = software address + 1.
  • Commissioning order: set direction, travel, and homing in the commissioning software first (leave the mode on software control during commissioning). After that works, switch the mode to DMX slave and hand the axis to the console.
Slave parameters: Address, channel mode, homing channel, and error handling. Values follow the commissioning software currently on site.
DMX slave commissioning: jog, home, and limits
During commissioning: confirm direction, limits, and homing under software control, then switch to slave mode

Channel modes: P / PV / PPV / V

Choose the mode under DMX slave mode in the commissioning software. One axis uses 1 to 3 channels. Channels continue from this axis start address.

ModeChannels usedEach channelFits
P Position1Position 0–255A matrix or a simple lift, where the resolution does not have to be fine
PV Position + speed2Position 0–255 + speed 0–255Speed has to be adjusted on site
PPV Fine position + speed3Position high 8 bits + low 8 bits + speedLong travel, where the position has to land closely
V Run mode + speed20 stop / 1 forward / 2 reverse + speed 0–255A disc or hoist that keeps turning
The two channels in V mode: The first channel is not a 0–255 position fader. It is 0 = stop, 1 = forward, 2 = reverse. The second channel is speed. P / PV use 8-bit position. PP / PPV use 16-bit position (0 ↔ 65535).

How a fader value becomes travel

Full travel is set in the commissioning software by maximum motor revolutions and the low 3 digits of maximum position:

Full-travel pulses ≈ maximum revolutions × 1000 + low 3 digits
  • 8-bit position (P / PV): 0 is the start of travel, 255 is full travel.
  • 16-bit position (PP / PPV): 0 is the start, 65535 is full travel, and the values between are proportional.
  • Speed byte: 0 is almost no motion, 255 is maximum speed in rpm.

Example: maximum revolutions 10 and low 3 digits 0 give about 10000 pulses of full travel. In P mode, 128 is about halfway. Direction follows the motor-direction setting. Inverting the channel on the console is equivalent.

Power-up, loss of signal, and homing

Stepper DMX512 application
Application: the console adds a stepper axis to the fixture library
Servo DMX512 application
Application: a servo axis follows the console fader
Stepper DMX slave I/O wiring
I/O: limits, home, and outputs
Servo DMX slave I/O wiring
I/O: limits, home, and outputs

Power-up

After power-up a slave finds home from the homing parameters, then listens to the console, so the first fader move may wait a few seconds. If homing fails or the servo alarms, the device stays in the error state and no longer follows channels until that is cleared (or until automatic reset after an error is enabled).

Loss-of-signal behavior

“Move to 0 after 5 seconds without a valid DMX frame” is on by default. After about 5 seconds without a valid frame, P / PV / PPV / PP return to travel 0 at homing speed, and V stops. If the site should not return to 0, turn this item off.

Homing triggers

  • Home automatically at power-up (set by the homing mode).
  • Enable the homing channel and trigger it with that extra channel (default threshold 128).
  • A YC-style stage extension holds a function channel in a set range for about 3 seconds (enabled per project).

Matching hardware

On a DMX path the cable is not the only question. A slave and a master need different parts.

Your roleWhat to fitWhere it connects
Slave (follow the console)DMX cable + terminator; add a DMX converter if the console has only a network portRS485 / DMX port
Slave (home and limits)Slotted optical sensor ×1 for home + ×2 for limitsController HM, LIM+, LIM−
Slave (vertical axis)Brake motor + 24 V relay + brake cableController DO through a relay
Online / offline masterDMX master board + DMX cable; offline can also use a trigger button (optional)RS485 / DMX port, DI
Multi-axis daisy chainEthernet cable (for parameters and synchronization; channel data still travels on the DMX cable)Controller Ethernet port

The full map is in XMatrix Features × MSP Hardware. Accessory categories and models are in Accessories and matching parts.

Common questions

SymptomLook here first
The fader does nothingIs the mode slave? DMX wire order and terminator? Is the address beyond the channels the console is sending? Is the unit still homing after power-up?
Travel does not line upMaximum revolutions, 8-bit or 16-bit mode, and whether data invert is on
The speed fader does nothingP / PP have no speed channel. In V mode the first channel must be 0 / 1 / 2.
When the signal drops, the axis runs toward 0Turn off “move to 0 after 5 seconds with no signal”, or use a YC-style mode (loss of signal only stops)
The console has a network port and the device does not respondAdd a DMX converter in between. Do not expect an Ethernet cable to act as DMX.
Parameters or the background page will not openEnter the password the software on site asks for. Request the rule from technical support.

DMX512 master mode (project function)

Besides a console driving a slave, XMatrix can provide a DMX512 master mode for a project:

  • Online master: A PC runs XMatrix in real time. One MSP device turns that run data into a DMX512 bus. Devices further along execute as slaves.
  • Offline master: Moves are arranged in advance and written to the master device. The site can run without a PC, from power-up, an input, or a network trigger agreed for the project.

Master output mode, channel count, refresh rate, slave addressing, move capacity, and the trigger method are confirmed from the axis count, the mechanism, and the console on site. They are not applied as if they were the general slave function.

Need a DMX512 master? Use and send the axis count, the slave count, online or offline running, the trigger source, and the expected move. We confirm the master configuration and the documents for the project.