XMatrix software · XR-Online

XMatrix Online: arrange multi-axis moves on the PC, without writing a program

XMatrix is the software system of XMSP. This page is the online function, code XR-Online. On the PC you map devices, commission motors, and build cues and sequences. A change can be run immediately. You do not write a separate motion-control program.

  • The PC schedules in real timeA change runs immediately
  • Cue → sequenceNo-code flow
  • Multi-axis networkOne place to map and commission
  • DI / UDPExternal trigger
Run the first moveSee the full procedure

What it does

XMatrix no-code multi-axis screen: cues, sequences, and parameters
The XMatrix screen: in one project, configure devices, commission each axis, and organize multi-axis moves with cues and sequences.

XMatrix Online is a general no-code multi-axis control system. Several motors can be networked, homed, positioned, and run together in one project. You set each axis position with the mouse, put those moves in an order, connect the devices, and run.

It addresses the usual multi-axis project, where the control program is written from scratch, axis addresses get mixed up, homing and collision checks are tuned over and over, and every move change waits on a programmer. Mechanical, electrical, and integration staff can build the moves and edit them while watching the machine.

  • Manage groups, axes, and motion modules in one project. Several devices daisy-chain over Ethernet.
  • Matrix mapping ties each cell on screen to the axis address on site.
  • A cue stores position, speed, and dwell for a group of axes.
  • A sequence lines cues up into a flow, with a count, a loop, and homing before the run.
  • Run by hand, from a DI, or from UDP. A move after startup can be configured as well.

XMatrix Online fits projects whose move logic is involved, changes often, or has to stay in step with business software on the PC, and where an industrial PC or a desktop computer is on site. Examples include positioning, multi-axis arrays, fixtures, lab prototypes, and special-purpose machines.

How to do it

  1. Install the network driver XMatrix needs. Connect the PC to the first MSP device with a wired network, and daisy-chain the rest.
  2. Create the hardware configuration, add axes and motion modules to match the site, and save the project.
  3. Finish matrix mapping so each cell address matches a motion-module number on site.
  4. Check limits, direction, homing, maximum travel, and multi-axis collision parameters, one axis at a time.
  5. Create cues, then add them to a sequence. After the devices connect, run once or run in a loop.
What “online” means: The PC running XMatrix schedules the move. After you edit a cue or a sequence you can run it again immediately. If the PC shuts down, XMatrix exits, or communication drops, the online run stops too. When the PC has to leave, use XMatrix Offline.

First example: several axes reach a target, then return

A four-axis move, not tied to one industry, shows the basic XMatrix Online logic. Finish the mechanical safety check, then create two cues:

ItemAxis 0Axis 1Axis 2Axis 3Purpose
Cue C0: start0%0%0%0%Every axis returns to the work start
Cue C1: target20%40%60%80%The four axes reach different targets
  1. In Hardware configuration, create 4 axes. In Matrix mapping, map 4 cells to motion modules 0–3 in order.
  2. Open Commissioning and, axis by axis, confirm LIM−, LIM+, motion direction, and HM homing, then set maximum travel.
  3. Create cues C0 and C1 and fill each axis with the percentages in the table. Start with a low speed, and leave a sensible dwell on the cue.
  4. Create sequence S0 and add C0, C1, C0 in that order. Set the run count to 1 first.
  5. Return to the main screen, connect the devices, and run once. After direction, travel, and spacing are safe, try a loop or adjust position and speed.
What the percentage assumes: 0% and 100% depend on each axis having been homed and given a maximum travel. Do not use full travel on the first run, and do not treat a software position as a mechanical safety check.

Full procedure

The sections below follow real use: install, map, commission, cues, sequences, run, and external triggers. Button positions can move between interface versions. The relationship of the steps does not.

Every software mode shares one device foundation: Whether you end on XMatrix Online, Offline, Command Interface, DMX512, or API-SDK, the device first goes through the same hardware configuration, the same motion commissioning, and the same parameters. The control entry differs. Direction, homing, limits, speed, travel, and protection are handled the same way.

Prepare, wire, and start

  1. On a Windows PC, install the WinPcap network driver from the release package first. One PC usually needs this only once.
  2. Use a wired network. The PC connects to the first device. Further devices daisy-chain as NET2 → next unit NET1 , and station addresses must not repeat.
  3. Start XMatrix. The online link uses raw frames on the network adapter. You do not enter a device IP. If connection fails, check WinPcap, the cable, and whether another program owns the adapter.
  4. If the software starts with no window, or exits at once, confirm that the system drive has C:\XKinetic , then start it again.
XMatrix Online main screen: project tree, cue shortcuts, device status, and the run log
Main screen: the project tree on the left opens hardware, matrix, cues, sequences, and release; the center holds the usual actions; the right shows device status

Create the project, then the shared configuration and mapping

Matrix mapping: rows, columns, and cell addresses
Matrix mapping: cell addresses line up with module numbers
XMatrix shared hardware configuration: groups, axes, and motion modules
Shared hardware configuration: create groups and axes, then add a motion module to each axis
XMatrix cue editor: group, speed, units, and the target of each axis
Cue editor: choose the group and the position unit, then enter the target of each axis
Save the project
Save the project: import the same project on another PC
  1. Hardware configuration: Create groups, axes, and motion modules to match the site. After a hardware change the software reconnects. Save the project when that finishes.
  2. Matrix mapping: Set rows and columns, and line cell addresses up with motion-module numbers. Module numbers start at 0. Cells usually display from 1. Do not shift one against the other.
  3. Save the project: The project file extension is .xmatrix. It holds hardware, mapping, cues, and sequences, and it should be backed up with the project.

Commission the motor: signals first, then motion

The shared commissioning screen shows connection, run state, home, positive and negative limits, inputs and outputs, current position, and alarms. On the first pass, watch the signals, then jog slowly and home.

XMatrix shared motion commissioning: home, limits, I/O, position, jog, homing, and stop
Shared motion commissioning: check home, positive and negative limits, and I/O on the left, jog slowly to confirm direction, then home and set the maximum position
  1. Watch the home and limit signals and confirm they follow the sensor.
  2. Jog slowly and confirm that software negative really moves toward the mechanical negative. If it is reversed, change the motor direction first.
  3. Home the axis. Confirm that after it finds home it leaves the sensor by the configured offset.
  4. Set maximum travel so the working position stays inside the positive limit. Positive and negative limits are for faults. They are not everyday stop points.
  5. If axes can collide, also set homing order, wait before and after homing, and start delay in the positive and negative directions.

Cues, sequences, and running

  • Cue: Stores position, speed, and dwell for a group of axes. Enter pulses or a percentage, or read the current motor position.
  • Sequence: Adds cues to a list in order, sets the run count, and sets whether homing is forced before the run.
  • Run: After the main screen connects, run once to verify. A loop should wait until direction, travel, limits, and spacing between axes are all confirmed.
XMatrix cue list: name, effect, synchronized speed, dwell, and loop count
Cue list: create C0, C1, and C2, then set speed, dwell, and loop count on each
XMatrix cue contents: percentage target of each axis
Cue contents: each column is one axis. A percentage is a common way to read travel that differs by axis
XMatrix sequence list: sequence name, cue list, and run count
Sequence list: different sequences can reuse cues, each with its own run count
XMatrix sequence editor: choose cues and place them in run order
Sequence editor: pick cues on the left, place them in run order on the right, and set a precondition and a result output

Triggers

An online move can be started from the main screen or from a signal on site. A trigger can be bound to home, stop, run every sequence, or run one sequence. Sequence numbers start at S0 .

TypeHow to use itCheck first
Input (DI)Choose the device and X0–X3, then a level, a rising edge, or a falling edgeWhether the input, the edge, and the trigger item are enabled
UDP valueBind a numeric trigger such as P0–P99 to one actionTurn on UDP receive on the commissioning page. The usual port is 6000
UDP custom commandAfter an agreed string arrives, run a chosen sequence, or home, or stopWhether the string matches exactly, and whether sequence numbers start at 0

When several triggers are active, software priority applies. A larger number wins. A DMX512 trigger is a different control path. Wiring and channels are in XMatrix DMX512 Interface.

XMatrix external-trigger setup: input, sequence, device, input port, edge, and priority
DI trigger example: choose the sequence, then the device, input, active edge, and priority
An online trigger still depends on the PC: The online system handles the signal and turns it into motion. If the PC is off, XMatrix has exited, or communication has dropped, both the DI and the UDP online trigger paths stop.

Key parameters and collision avoidance

Parameter names follow the current software screen. Items marked as needing a restart should be powered off and on after a change. Prove the move at a conservative speed, then adjust for load and cycle time. The full parameter notes are in XMatrix Technical Documents.

XMatrix shared parameters: direction, speed, acceleration, travel, torque, homing, and protection
Shared parameters: direction, speed, acceleration, maximum travel, torque limit, homing, and collision parameters in one place. Numbers in the screenshot only illustrate the screen. They are not site recommendations.
ParameterGuidance / defaultDescription
Homing speedKeep it slow. Notes often show 100–300 rpmDo not overshoot home, and do not shock the mechanism. Recheck it for each motor and mechanism.
Move speedNotes often show 200–500 rpmCue and sequence speed is still limited by the motor maximum speed
Accel / decel time100–10000 ms, default about 500 msA larger value starts more gently. Increase it if the mechanism shakes.
Maximum travelInside the positive limitThis is the full-scale reference for percentage positions. Do not ride the positive limit in normal running.
Torque limit0 means not evaluatedSet it when the axis needs anti-pinch or stop-on-obstruction protection
Homing order (module)A smaller number homes firstOpen-close versus rotate, or several carriages on one rail homed in batches. This is central to collision avoidance.
Wait before / after homingSet from the siteStagger the starts, together with the delay before positive and negative moves
Delay after startupDefault 1000 ms, range 0–100000 msLeave time for the device to connect, for signals to settle, and for homing
Module safety limit %Set as requiredPosition / deviation / center / RPM thresholds. Crossing a limit stops the axis.
Several motors on one rail: Set the homing batch, the wait before homing, and the delay before positive and negative moves together. Changing speed alone is not enough. Axes can meet while homing or while starting together.

Save the project and run on site

  • Project backup: Save the .xmatrix file. When you change PCs, reinstall the network driver and import the project. Do not rely on the only copy sitting on the site PC.
  • Startup settings: You can open XMatrix after Windows starts, open a named project, and home or run a sequence after a delay. Verify once by hand before production running.
  • Automatic action: Choose no action, run every sequence, loop every sequence, run one sequence, or loop one sequence.
  • Optional content: The software also has an idle screen and motion-synced media. Those are project-specific. They do not change the basic multi-axis flow.
Boundary of running on site: The PC and XMatrix remain part of the online system. If the machine must run after power-up without a Windows PC, switch to XMatrix Offline.

Matching hardware

No-code covers how the move is arranged. For the axis to move safely, the site still needs the items below.

What you need to doWhat to fitWhere it connects
Home / find the originSlotted optical sensor ×1Controller HM
Positive and negative limit protectionSlotted optical sensors ×2 (or software limits only)Controller LIM+, LIM−
Hold a vertical axis when power is removedBrake motor + 24 V relay + brake cableController DO through a relay
Multi-axis coordinationEthernet cable (daisy chain)Controller Ethernet port

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

Common questions

SymptomLook here first
Connection failsWinPcap, the cable, and adapter ownership. This is not an IP / ping problem.
Connected, but it will not moveHoming, limit state, direction, and whether maximum travel is 0
The whole layout jumps to the wrong placeDoes the matrix address match the module number? Is the cue in the wrong cell?
Axes on one rail collideHoming order, positive and negative delays, cue start delay
An external trigger does nothingIs the trigger enabled? Priority? DI edge? Is UDP receive open? Does the command match? Do sequence numbers start at 0?
After the PC is shut down, the device no longer runsThat is the normal boundary of the online version. To remove the PC, use XMatrix Offline and transfer the project to the device.
It does not home again after a runIs “home first” on the sequence enabled, is homing forced before the run, or is homing forced after N runs?
The first launch shows no windowCheck that WinPcap and the release package are complete, and that the system drive contains C:\XKinetic
Contact us with the project conditions: Send the axis count, the motor or drive model, the travel of each axis, the move order, whether collision avoidance is required, and whether you will use a button, UDP, or a manual run. From that we can judge whether the online version fits, and check the hardware. Contact