XERYON XD-M Controller

- Compatible products: Various driving forces
- Number of axes: Up to 6
- Configurations: OEM and scientific applications
- Power supply: Included power adapter
- Temperature range: Standard operating range
- Dimensions: As per product specifications
- Connector to stage: Provided
- Control types: Multi-axis control supported
- Key communication options: USB, RS232
- Software support: Windows GUI
- Motion profile: Customizable
- Encoder compatibility: Supported
- Supported resolutions: High precision
- Error detection: Included for accurate operation
Product Usage Instructions
Getting Started
All controllers come with a power adapter, USB cable, and software on a USB stick for easy setup. Follow these steps to begin using the XD-M:
- Plug the stage connector into the XD-M.
- Connect the XD-M to a computer using the provided USB cable.
- Open the Windows GUI software.
- Press SCAN or MOVE in the GUI to start moving the stage.
Control of a Stage
The controllers can be controlled using various methods as outlined in the manual:
- Refer to section 5 for one method.
- Refer to section 6 for another method.
- Refer to section 7 for additional control options.
Communication using USB / RS232
The XD-M can communicate with a host computer or controller via USB configured as a virtual COM port. Follow the specified format for instructions when communicating with the device.
Format for Instructions
A command line consists of a maximum of 16 characters and follows a specific format as detailed in the manual.
XD-M Controller manual – 3.0
The XD-M is an advanced, user-friendly multi-axis ultrasonic piezo controller, supporting up to 6 devices simultaneously. Designed for OEM and scientific applications, easy multi-axis use is supported. A Windows GUI is included for plug-and-play testing.

Key specifications
| Compatible products | XLS series, XVS series, XRT-U series, XVP series |
| Compatible driving forces | 1N, 3N (for 5N: XD-OEM is recommended) |
| Number of axes | 1 to 6 |
| Configurations | XD-M-1 (1 axis), XD-M-2 (2 axes), … , XD-M-6 (6 axes) |
| Power supply | 48 VDC (5W per axis) |
| Temperature range | -30°C to 70°C |
| Dimensions | 195 x 165 x 70 mm (tabletop version) |
| Connector to stage | 15-pin D-Sub HD female |
| Control types | Closed loop, open loop, hybrid |
| Key communication options | USB, UART, RS232, GPIO, I2C, SPI, … |
| Software support | Windows GUI, C++, Python, LabVIEW, … |
| Motion profile | Point-to-point trapezoidal |
| Encoder compatibility | Optical, incremental |
| Supported resolutions | Up to 5 nm (linear), up to 3 µrad (rotary) |
| Error detection | Overcurrent, thermal, short-circuit, … |
Getting started
All controllers are delivered with a power adapter, USB cable and USB stick with software to control stages for easy plug-and-play use. To get started, plug the stage connector into the XD-M. Connect the XD-M to a computer with the provided USB cable and open up the Windows GUI, press SCAN or MOVE and the stage will start moving.
A quick overview of the Windows GUI:
To control a stage:
- Connect the correct COM port.
- Load settings_default.txt from USB stick.
- Press “Find Index”.
The stage will start moving and look for the encoder index. - You can start controlling the stage:
- SCAN: move with continuous speed.
- STEP: move with specified step size.
- 0: move to home position.

Using the XD-M controller, a Xeryon stage can be used to create a wide variety of motion patterns:
- Short- or long-range motion, high- or low-speed motion
- Repetitive or dynamic motion, smooth continuous motion
- Set-and-forget applications, controlled damping (soft landing) motion
- A combination of the above, and more
Tuning
Xeryon stages work based on ultrasonic piezo technology. This technology is frequency-based, and differs from both a) electromagnetic motors and b) other piezo systems. As a result, motion characteristics may differ from conventional motion systems. Several parameters can be used for finetuning motion behavior. Motion trajectory is split into two zones: bulk move (or ‘scanning’) and final positioning. When experiencing unexpected behavior, the following simple tuning procedures can be followed (Settings -> Edit). In-depth tuning info can be found in chapter 9.
| Behaviour | Final positioning (zone 1) | Bulk move / scanning (zone 2) |
| Vibration | Lower proportional factor
Increase frequency |
Lower proportional factor
Increase frequency |
| Noise | Increase frequency | Increase frequency |
| Overshoot | Lower deacceleration
Lower speed |
Lower deacceleration
Lower speed |
| Force too low | – | Lower frequency |
| Inaccurate landing | Lower positioning tolerance | – |
| Slow landing | Adjust proportional factor
Increase frequency |
– |
Note: for vertical or inclined use with higher payloads, advanced tuning may be necessary. For assistance, please contact support@xeryon.com. More information about the Windows GUI: ch. 10.
Control of a stage
The controllers can be controlled using various methods:
- Using USB / RS232 see section 5
- Using GPIO see section 6
- Using I2C / SPI see section 7
Communication using USB / RS232
A host computer or controller can communicate with the XD-M via the USB configured as a virtual COM port. The baud rate is automatically detected by the controller and can be up to 115200. The protocol uses 8 data bits, 1 stop bit, no parity bit, no handshaking. This section consists of three parts: Fout! Verwijzingsbron niet gevonden.
- Format for instructions
- List of commands
- Feedback from controller
Format for instructions
A command line consists of maximum 16 characters followed by a ‘new line’ character (ASCII code 10). The command has the following fixed format: X:DPOS=-12345678
- 1 character defining the axis, followed by a colon (:) (e.g. X:, Y:, Z:, A:, B:, C:)
- 4 characters for the command.
- ‘=’ sign separating the command from the corresponding value.
- Optional sign.
- Decimal value up to 8 decimal places (9 if the sign is omitted).
- Maximum total of 16 characters.
The characters have to be sent from left to right, in the example above starting with ‘X’ and ending with ‘8’. The command tags are in upper case. The instruction should be terminated with a ‘new line’ character (ASCII code 10). The driver processes the instruction immediately after receiving this ‘new line’ character. Some instructions such as ‘ZERO’ and ‘RSET’ require no value. In that case, it is sufficient to send only the command itself, e.g. ‘ZERO’ followed by the ‘new line’ character.
Value range
There are 9 characters reserved for the value including its sign. For signed values 8 decimal places are available, giving a range from -99 999 999 to +99 999 999. For positive numbers, the ‘+’ sign can be omitted, increasing the positive range to 999 999 999. No spaces, commas or periods should be added to the numbers. Only integers are allowed.
- X:DPOS=-99999999
- X:DPOS=+99999999
- X:DPOS=999999999
Request a value
To request the value of a certain setting, put ‘=?’ after the parameter for which you want to know the value, e.g. X:EPOS=? gives the controller a request for the encoder position. X:FREQ=? asks the controller for the current excitation frequency. This works best with INFO=0, otherwise the reply disappears in the constant flood of feedback data.
Units are as follows:
| Type | XLS / XVP series | XRT series | Resolution |
| Time, delays | ms | 1 ms | |
| Target position, step size | encoder units | 1 encoder increment | |
| Speed | µm/s | deg/s (*) | 1 µm/s or 0.01 deg/s |
| Frequency | Hz | 1 Hz | |
(*) Conversion factor of 100 required: e.g. enter X:SSPD=10000 for 100 deg/s.
List of commands
This is a list of all possible commands that can be sent and their use. This part is divided into:
- Motion
- Settings handling
- Communication
- Tuning
- Signal (advanced)
- Directional settings (advanced)
- Trigger outputs (advanced)
Motion commands
| Command | Range | Explanation |
| X:INDX | 0, 1 | Find the index. A value of 0 or 1 indicates the initial search direction. The controller sets off in the specified direction to search. When a mechanical limit is reached (detected by position error > ILIM) it reverses the search direction. After finding index, stage is positioned at the index position. |
| X:INDA | 1 bit | Automatic detection of encoder index. |
| X:HOME | – | Go to the home position. This equals DPOS=0. |
| X:DPOS | 26 bits | Set target position. Closed-loop control is used to reach and maintain the new position. The position is expressed in encoder units. Positive and negative values are allowed within the range of the stage. |
| X:STEP | 26 bits | Move relative to the current position, over a specified distance. When already in closed loop, the current desired position is used as a reference. When before in open loop, the actual position (encoder value) is used as a reference. The command value specifies the step size in encoder increments. Positive values send the stage towards higher encoder values, negative values send the stage towards lower encoder values. Closed-loop control is used to reach and maintain the new position. |
| X:SCAN | -1,0,1 | Continuously move with fixed speed. The speed is maintained by closed-loop control. A positive number sends the stage towards increasing encoder values, a negative number sends the stage towards decreasing encoder values. A zero value stops the stage. |
| X:SSPD | 24 bits | Set speed. Used as scanning speed (SCAN command) and as target speed towards the next target position (DPOS and STEP). Unit is 1 µm/s or 0.01 deg/s. Default: 10000 (10 mm/s or 100 deg/s). |
| X:ISPD | 24 bits | Set the speed which is used while searching the index. Unit is 1 µm/s or 0.01 deg/s. |
| X:ACCE | 16 bits | Set acceleration for speed profile. Expressed in m/s2. Default value: 255. |
| X:DECE | 16 bits | Set deceleration for speed profile, when approaching target position. Default / maximum value: 255. |
| X:LLIM | 26 bits | Set low-side soft end stop. Expressed in encoder units. |
| X:HLIM | 26 bits | Set high-side soft end stop. Expressed in encoder units. |
| X:MOVE | -1,0,1 | Continuously move in open loop. Phase and amplitude influence the speed, but speed is not controlled. A positive number sends the stage towards increasing encoder values, a negative number sends the stage towards decreasing encoder values. A zero value stops the stage. |
| X:PHAS | 16 bits | Set the phase offset between the excitation signals. Can be used to control the speed in open loop. Input values 0-65535 correspond to a phase shift of 0-360°. Around 16384 the phase corresponds with a MOVE=1 direction, around 49152 (=-16384) it corresponds to a MOVE=-1 direction. |
| X:AMPL | 16 bits | Set amplitude for open-loop piezo excitation signals. |
| X:STOP | – | Stop the stage. |
| X:CONT | – | Continue movement after a stop command. |
| ENBL | 1 bit | Enable drive. Or: If an actuator is in error mode, you can recover from that
by sending “ENBL=1”. This enables the actuator again. |
| ENBR | 1 bit | Enable drive on power-up automatically. |
| X:FILE | Filters fast variations from the encoder values (noise). Default value: 0, sets filter to a minimum. | |
| X:FILG | Extracts the spikes from the raw encoder inputs. Defines the minimum pulse width that may be responded to. Default value: 0 | |
| X:INTF | Controller integration factor. Default value: 1. Minimum = 1 | |
| X:DTIM | Determines how long (in ms) the motor must be turned off before it can be turned on again. Ensures that the tage is not over-excited when landing by switching it on and off too quickly. Default value: 0 |
Manage settings
| Command | Range | Explanation |
| RSET | – | Reset the driver. All piezo signals go to zero and settings are reset to their saved value. Necessary after each power cycle to initialize controller. |
| LOAD | – | Load settings from memory. |
| SAVE | – | Save settings to memory. |
| BLCK | 0-1 | Blocked mode. When blocking mode is enabled (1), the ENBL command should be send to the controller if an error occurs. If blocking mode is disabled (0), the controllers executes the next command even when an error occurs. |
| TEST | 0-1 | Test LED indicators. TEST=1 switches all indicators on. TEST=0 brings them back to their function. |
Communication
| Command | Range | Explanation | |||
| INFO | 4 bits | Select type of info to be transmitted from the controller to the master (PC).
0: Stop broadcasting info automatically. 1: SRNO, SOFT, MODEL, STAT, SYNC 2: SRNO, SOFT, MODEL, STAT, FREQ, SYNC, EPOS, DPOS, REQUESTED PARAMETER*, TIME 3: EPOS, DPOS, STAT 4: EPOS, STAT, DPOS, TIME 5: STAT, FREQ, EPOS, DPOS, REQUESTED PARAMETER*, TIME 6: REQUESTED PARAMETER* 7: EPOS, STAT Default: 2 e.g. INFO=7 will alternatingly send EPOS & STAT values. * REQUESTED VALUE, when a parameter value is requested (e.g. by sending FREQ=?) the value for the parameter will be returned here. |
|||
| UART | 0-
76800 |
Set UART baud rate. To switch UART off: UART=0.To set the baud rate to 9600: UART=9600. The maximum baud rate is 76800. When UART is off, the UART can only be restarted by sending the UART command via USB. | |||
| GPIO | 0-13 | Select the preferred input mode using the GPIO command. More info: ch. 5. | |||
| GPIO=0 | Control via IO pins switched off. The controller will only react to text commands sent through USB or UART. | ||||
| GPIO=2 | Pulse and direction mode, with direction & enable pins. | ||||
| GPIO=3 | Pulse and direction mode, with forward & backward pins. | ||||
| GPIO=4 | A quad B input mode. | ||||
| GPIO=8 | PWM control, with direction & enable pins. | ||||
| GPIO=9 | PWM control, with forward & backward pins. | ||||
| GPIO=12 | Analog control, with direction & enable pins. | ||||
| GPIO=13 | Analog control, with forward & backward pins. | ||||
| X:STPS | 16 bits | Select the step size for each STEP pulse. The step size is expressed in encoder units. Default: 1 encoder unit. |
| (X:)POLI | 1-
65535 |
Set polling interval. Specifies the time between data updates. Also defines the polling interval of the analog IO. The interval is expressed in milliseconds. The default value is 97 (97 ms). Both a controller and an axis command. |
| X:DLAY | 16 bit | Sets the delay between the moment the stage reaches its target position and the moment the ‘position reached’ flag is raised. Expressed in milliseconds. Default: 1 (ms). |
Tuning
| Command | Range | Explanation |
| X:FREQ | 24 bits | Set the frequency of the excitation signals for zone 1. Unit is Hz. |
| X:FRQ2 | 24 bits | Set the frequency of the excitation signals for zone 2. Unit is Hz. Also used for scanning. |
| X:PROP | 16 bits | Proportional control factor for zone 1. |
| X:PRO2 | 16 bits | Proportional control factor for zone 2. |
| X:ZON1 | 26 bits | Width of zone 1: Expressed in mm. |
| X:ZON2 | 26 bits | Width of zone 2: Expressed in mm. |
| X:DUCO | 1 bit | Amplitude is used in closed loop if set to 1. If set to 0, a fixed amplitude of 50% is used. Default: 1. |
| X:ELIM | 20 bits | ELIM (error limit) sets the maximum following error. When the following error exceeds the value set bij ELIM, then the controller goes in safe mode and the motor signals are switched off. Recovery: RSET or ENBL=1.
This error may be triggered when trying to move beyond the physical limits of the stages, or by setting too high a speed. Do not forget to first find the index position (INDX command) to avoid that the stages travels beyond the end stops and triggers this error. Default: 10000. |
| X:ILIM | 26 bits | Sets the following error at which the index search algorithm reverses direction. This influences the time the tage stalls at the end position during an index search. |
| X:SLIM | 26 bits | Error saturation limit |
| X:PTOL | 16 bits | Position tolerance. When the stage is within +/- position tolerance of the desired position, the control is switched off and the ‘position reached’ flag is raised.
Values are expressed in encoder units and should be in the range 0 – 65535. The range is applied symmetrically with respect to positive and negative position errors. e.g. PTOL=2 allows s errors between -2 and +2 encoder units. Default: 2. See also TOUT and PTO2. |
| X:PTO2 | 16 bits | Second position tolerance, similar to PTOL. Comes into action if first position tolerance PTOL fails within a timeout time TOUT. The default value is 10. |
| X:TOUT | 16 bits | Set timeout time. To avoid that the stage keeps vibrating indefinitely around the desired position without ‘landing’, a timeout time can be set. The timer starts when the stage is near the desired position, within a distance of +/- PTO2. After passing the timeout time, PTO2 becomes the new position tolerance.
The time is expressed in milliseconds. The default value is 1000 (ms). |
| X:TOU2 | 16 bits | This defines a safety timeout. When the motor is on for a time longer that the value set by TOU2, then the controller goes in safe mode and the motor signals are switched off. Recovery: RSET or ENBL=1 depending on BLCK.
Status bit #18 goes up when this timeout is triggered. TOU2=0 disables this timeout. Any other value sets the timeout time in seconds. Minimum value: 1 second. Maximum value: 65535 seconds. |
| X:TOU3 | 16 bits | This defines another safety timeout. When the stage is trying to “land” to a specific position for longer than the value set by TOU3, then the controller goes in safe mode. The motor signals are switched off. Value in milliseconds. |
| X:ENCR | 1 bit | Reset the encoder by sending “ENCR=1”. |
Signal shaping (advanced use)
| Command | Range | Explanation |
| X:ZERO | – | Force the piezo signals to zero volt. |
| X:MAMP | 16 bits | Set maximum amplitude. The piezo excitation signals are limited to the corresponding voltages. MAMP=65535 sets them to the maximum voltage of 45 V. MAMP=36400 sets the maximum to 25 V. The relation is linear. |
| X:MIMP | 16 bits | Set minimum amplitude for piezo excitation signals. See MAMP for values. |
| X:PHAC | 16 bit | Phase correction. Corrects an imbalance in the motor. Such imbalance may cause a rattling or scratching noise when the stage moves at low speed. Practical values are in the range of a few 1000, positive or negative.
Default: 0 (no correction) |
| X:OFSA | 12 bits | Offset on the piezo signals on piezo phase 1. OFSA=4095 corresponds to full scale (45 V), OFSA=0 produces no offset. The relation is linear. |
| X:OFSB | 12 bits | Similar to OFSB, but for piezo phase 2. |
| X:FILP | 8 bits | Filter speed for phase of piezo excitation signals. Default value: 1. Max. value: 255. |
| X:FILA | 8 bits | Filter speed for amplitude of piezo excitation signals. Default value: 1. Max. value: 255. |
Directional settings (advanced use)
| Command | Range | Explanation |
| X:ENCD | 1 bit | Set the encoder direction. Set the counting direction with respect to the A/B signals or sin/cos signals of the encoder. Flip this bit to swap left and right, or clockwise and counter-clockwise. Default value is 0. |
| X:ENCO | 32 bits | Sets the encoder offset: distance between the index position and the desired zero position. In encoder units. Default value is 0. |
| X:ACTD | 1 bit | Set the actuation direction. If not set correctly, the stage will move away from the desired position. Default value is 0. |
| X:PATH | 1 bit | For rotation stages only. Selects whether the stage will follow the shortest path (PATH=1) to the target position or follow a linear approach, respecting high to low or low to high (PATH=0). Default: 1 for rotation stages, 0 for linear stages. |
Trigger outputs (advanced use)
| Command | Range | Explanation |
| X:TRGS | 26 bits | Start of the trigger pulses, expressed in encoder units. |
| X:TRGW | 26 bits | Width of the trigger pulses, expressed in encoder units. This (positive) value should be lower than the pitch (TRGP). |
| X:TRGP | 26 bits | Pitch of the trigger pulses, expressed in encoder units. The pitch can’t be negative. To trigger pulses in the negative direction: set the TRGS at the most negative point and use a positive pitch. |
| X:TRGN | 26 bits | Number of trigger pulses. |
Feedback from controller
| Status LEDs | |
| Error | Indicates if a position or amplifier error occurred. |
| Limit + | Indicates that the positive limit has been reached. See HLIM. |
| Limit – | Indicates that the negative limit has been reached. See LLIM. |
| Index found | Indicates that the axis has indexed. |
| Position reached | Indicates that the axis has reached the target position. |
| Motor on | Indicates that the axis is currently moving. |
| Power | Indicates that the axis is powered. |
Information is sent back from the Xeryon controller to the master in ASCII format. The format is as follows:
- 1 character defining the axis, followed by a colon.
- Tag: Four characters describing the type of information
- ‘=’ sign separating the command from the corresponding value
- Signed value associated with that information (sign + 8 decimal places). The message is terminated with a ‘new line’ character (ASCII code 10).
e.g. X:EPOS=12345678
Different types of information:
The command INFO determines which information is sent back. See the example below (INFO=2).
| Tag | Explanation |
| SRNO | Serial number of the driver (hardware) |
| SOFT | Software version installed on the driver. e.g. 20103 → 2.1.3 |
| [TYPE] | Type of motion device (XLS, XRT, XVP) and its resolution e.g. XLS1=312 |
| STAT | Status (see below) |
| FREQ | Excitation frequency currently in use |
| SYNC | Fixed value “12345678”. Can be used for debugging communication issues. |
| EPOS | Encoder position |
| DPOS | Desired position |
| TIME | Time stamp: resolution 0,1 ms |
Meaning of STAT(US): The Status contains 24 bits:
| Status bit | Name | Explanation |
| 0 | [Reserved] | [Not applicable] |
| 1 | End stop | Stage stopped by end stop |
| 2 | Thermal protection 1 | Amplifier for phase 1 or 3 in thermal protection. |
| 3 | Thermal protection 2 | Amplifier for phase 2 or 4 in thermal protection. |
| 4 | Force zero | Motor signals are currently forced to zero. |
| 5 | Motor on | The piezo motor is on. |
| 6 | Closed loop | The stage is currently in closed loop control. |
| 7 | Encoder at index | Indicates whether the stage is positioned exactly at the encoder index. |
| 8 | Encoder valid | Indicates whether the encoder index has been passed and therefore the encoder value reflects the absolute position, not the relative position with respect to the startup position. |
| 9 | Searching index | Indicates whether the stage is currently searching the index position. |
| 10 | Position reached | Indicates whether the target position is reached (within tolerance limits). |
| 11 | Error compensation | Error compensation is on. |
| 12 | Encoder error | Indicates an error produced by the encoder. |
| 13 | Scanning | Indicates whether the stage is in a scanning mode. |
| 14 | Left end stop | Indicates that the left end stop is passed. |
| 15 | Right end stop | Indicates that the right end stop is passed. |
| 16 | Error limit | Indicates that the position error has reached the limit set by ELIM. This can indicate a collision or mechanical limit (end of stroke). |
| 17 | Searching optimal frequency | The driver is searching for the optimal excitation frequency of the piezo motor. |
| 18 | Safety timeout triggered | If this is set to “1”, then the safety timeout was triggered. See the explanation of the command “TOU2” several pages back. |
| 19 | EtherCAT acknowledge | Only used when control via EtherCAT. |
| 20 | Emergency stop | Not used. |
| 21 | Position fail | If this is set to “1”, then the safety timeout TOU3 was triggered. |
Communication using GPIO
There are 4 different configurations for the use of the digital and analog IO pins.
- Control the position of the stage using pulses. Each pulse does a step (size) in a certain direction.
- Control the position of the stage using an encoder-like signal.
- Control the speed of the stage using a PWM input signal.
- Control the speed of the stage using an analog input.
All of these methods are described more in detail below. To select a method, the command “GPIO” is used. This can be found in section. This command can be sent over USB or UART. Corresponding pins can be found in section 6.
The GPIO settings can be stored in memory using the “SAVE” command. That way, the GPIO mode will become active at power-up without having to first send the GPIO command via USB, UART or any other method.
The GPIO input and commands can be used together: the controller will react to both GPIO inputs and text commands. You don’t have to go back to GPIO=0 to send text commands. You can send text commands also in the GPIO=2, 3, 4, … modes. But when going from GPIO input to text commands, first send a STOP command. Recommended maximum pulsing frequency: 20 kHz.
Pulse and direction mode
This mode is activated by the command GPIO=2 or 3.
X:GPIO=2 enables the input signals: I/O bank 1 – ground (pin 4), pulse (1), direction (2), enable (3). X:GPIO=3 enables the input signals: I/O bank 1 – ground (pin 4), pulse (1), forward (2), backward (3).
On each positive edge of the PULSE signal, the target position is incremented or decremented with a particular step size. The default step size is 1 (1 encoder unit). This step size can be changed with the command STPS, e.g. STPS=10.
The DIRECTION signal determines the direction: incrementing or decrementing the target position. The ENABLE signal enables the input, it has to be high in order to start moving.
An alternative to the DIRECTION and ENABLE signal is the FORWARD and BACKWARD signal. By setting one of them high, it’s possible to select the direction of moving.
The INDEX signal is an analog input used as digital input. When going high (positive edge) the controller searches the index (3.3 V is sufficient, max. 10 V).
PWM control
This mode is activated by the command GPIO=8 or 9.
GPIO=8 enables the input signals: I/O bank 1 – ground (pin 4, PWM (1), direction (2), enable (3). GPIO=9 enables the input signals: ground (pin 4), PWM (1), forward (2), backward (3).
The frequency of the PWM signal can be set by the command XPWMF. X:PWMF=1000 sets the PWM frequency to 1000 Hz. Default = 1000.
The speed is proportional to the pulse width. When the pulse width is 50 %, speed is set to 50 % of the speed set by the X:SSPD command. When the signal is all the time high, then 100 % of X:SSPD is selected. Speed can be controlled from 0 to 100 %.
The use of the direction, enable, forward and backward signals is the same as in pulse and direction mode.
Analog controls
This mode is activated by the command GPIO=12 or 13
GPIO=12 enables the input signals:
- Analog I/O bank 1 – ground (pin 7), speed (1)
- Digital I/O bank 1 – direction (2), enable (3)
- GPIO=13 enables the input signals:
- Analog I/O bank 1 – ground (pin 7), speed (1)
- Digital I/O bank 1 – forward (2), backward (3)
The speed input is proportional to the voltage applied to the speed input pin. 10 V corresponds to 100 % of the speed set by the X:SSPD command.
The use of direction, enable, forward and backward signals is the same as in pulse and direction mode.
Communication using I2C / SPI
This controller supports both I²C (Inter-Integrated Circuit) and SPI (Serial Peripheral Interface) communication protocols for flexible integration with external devices.
I²C: A two-wire communication protocol (SCL and SDA) suitable for connecting multiple devices using a shared bus. Ensure proper pull-up resistors are included for reliable operation.
SPI: A high-speed, four-wire protocol (SCK, MOSI, MISO, CS) designed for point-to-point or master-slave configurations. Multiple slave devices can be managed using independent Chip Select (CS) lines.
Refer to the pinout diagram and specifications for wiring details and compatible voltage levels.
Connections/pin layouts
Connection to stage

Stage connector: 15-pin D-Sub HD Female
Pin 1 is engraved.
| Pin | Signal | Function | In/Out | Pin | Signal | Function | In/Out |
| 1 | NC | Not Connected | – | 9 | CLK+/E+ | Clock / Encoder + | OUT |
| 2 | ENC PWR | Encoder Power | OUT | 10 | GND P1 / GND P2 / P3 | Phase / Ground | OUT |
| 3 | ENC GND | Encoder Ground | OUT | 11 | ENC- | Encoder Index – | IN |
| 4 | P2 | Piezo Phase 2 | OUT | 12 | ENC A- | Encoder A- | IN |
| 5 | P1 | Piezo Phase 1 | OUT | 13 | ENC B- | Encoder B- | IN |
| 6 | ENC+ | Encoder Index + | IN | 14 | NC | Not Connected | – |
| 7 | ENC A+ | Encoder A+ | IN | 15 | P4 | Piezo Phase 4 | OUT |
| 8 | ENC B+ | Encoder B+ | IN |
Connection to GPIO banks (analog + 2x digital)
- Analog I/O: D-Sub 15
- Digital I/O – Axes 1-3: D-Sub 25
- Digital I/O – Axes 4-6: D-Sub 25
Analog I/O bank

| Pin | Symbol | Function | V | Pin | Symbol | Function | V |
| 1 | AI1 | Analog speed input stage 1 | 0-10V | 9 | FI1 | Find index stage 1 | 3,3V |
| 2 | AI2 | Analog speed input stage 2 | 0-10V | 10 | FI2 | Find index stage 2 | 3,3V |
| 3 | AI3 | Analog speed input stage 3 | 0-10V | 11 | FI3 | Find index stage 3 | 3,3V |
| 4 | AI4 | Analog speed input stage 4 | 0-10V | 12 | FI4 | Find index stage 4 | 3,3V |
| 5 | AI5 | Analog speed input stage 5 | 0-10V | 13 | FI5 | Find index stage 5 | 3,3V |
| 6 | AI6 | Analog speed input stage 6 | 0-10V | 14 | FI6 | Find index stage 6 | 3,3V |
| 7 | GND | Ground | – | 15 | 5V | 5V out | 5V |
| 8 | 3,3V | 3,3V out | 3,3V |
Digital I/O bank 1

| Pin | Symbol | Function – IN | V | Pin | Symbol | Function – OUT | V |
| 1 | DI1-1 | Pulse / A / PWM stage 1 | 5V | 14 | DI4-1 | Trigger pulse* stage 1 | 5V |
| 2 | DI2-1 | Direction / forward
/ B stage 1 |
5V | 15 | DI5-1 | Encoder valid signal stage 1 | 5V |
| 3 | DI3-1 | Enable / backward stage 1 | 5V | 16 | DI6-1 | Position reached signal stage 1 | 5V |
| 4 | GND | Ground | – | 17 | GND | Ground | – |
| 5 | DI1-2 | Pulse / A / PWM stage 2 | 5V | 18 | DI4-2 | Trigger pulse* stage 2 | 5V |
| 6 | DI2-2 | Direction / forward
/ B stage 2 |
5V | 19 | DI5-2 | Encoder valid signal stage 2 | 5V |
| 7 | DI3-2 | Enable / backward stage 2 | 5V | 20 | DI6-2 | Position reached sisgnal stage 2 | 5V |
| 8 | GND | Ground | – | 21 | GND | Ground | – |
| 9 | DI1-3 | Pulse / A / PWM stage 3 | 5V | 22 | DI4-3 | Trigger pulse* stage 3 | 5V |
| 10 | DI2-3 | Direction / forward
/ B stage 3 |
5V | 23 | DI5-3 | Encoder valid signal stage 3 | 5V |
| 11 | DI3-3 | Enable / backward stage 3 | 5V | 24 | DI6-3 | Position reached signal stage 3 | 5V |
| 12 | GND | Ground | – | 25 | 5V | 5V out | 5V |
| 13 | 3,3V | 3,3V out | 3.3V |
Digital I/O bank 2

| Pin | Symbol | Function – IN | V | Pin | Symbol | Function – OUT | V |
| 1 | DI1-4 | Pulse / A / PWM stage 4 | 5V | 14 | DI4-4 | Trigger pulse* stage 4 | 5V |
| 2 | DI2-4 | Direction / forward
/ B stage 4 |
5V | 15 | DI5-4 | Encoder valid signal stage 4 | 5V |
| 3 | DI3-4 | Enable / backward stage 4 | 5V | 16 | DI6-4 | Position reached signal stage 4 | 5V |
| 4 | GND | Ground | – | 17 | GND | Ground | – |
| 5 | DI1-5 | Pulse / A / PWM stage 5 | 5V | 18 | DI4-5 | Trigger pulse* stage 5 | 5V |
| 6 | DI2-5 | Direction / forward
/ B stage 5 |
5V | 19 | DI5-5 | Encoder valid signal stage 5 | 5V |
| 7 | DI3-5 | Enable / backward stage 5 | 5V | 20 | DI6-5 | Position reached sisgnal stage 5 | 5V |
| 8 | GND | Ground | – | 21 | GND | Ground | – |
| 9 | DI1-6 | Pulse / A / PWM stage 6 | 5V | 22 | DI4-6 | Trigger pulse* stage 6 | 5V |
| 10 | DI2-6 | Direction / forward
/ B stage 6 |
5V | 23 | DI5-6 | Encoder valid signal stage 6 | 5V |
| 11 | DI3-6 | Enable / backward stage 6 | 5V | 24 | DI6-6 | Position reached signal stage 6 | 5V |
| 12 | GND | Ground | – | 25 | 5V | 5V out | 5V |
| 13 | 3,3V | 3,3V out | 3.3V |
Tuning
Xeryon’s stages are primarily intended for closed-loop control and for this reason already have a position sensor integrated. A control algorithm is implemented on our controller and this algorithm uses multiple control parameters. These control parameters have to be set according to the type of stage, load and customer-specific motion requirement. These parameters are pre-set by Xeryon upon delivery of the stage and controller. In most cases, you don’t need to adapt the settings right out of the box. Nevertheless, it may be required that the user modifies these parameters for optimal performance.
Below you can find the corresponding commands for the most common settings:

- Reverse encoder/reverse stage: stage specific, don’t change.
- Shortest path: X:PATH
- Zone size, zone 1: X:ZON1 Zone size, zone 2: X:ZON2
- Frequency, zone 1: X:FREQ Frequency, zone 2: X:FRQ2
- Proportional factor, zone 1: X:PROP Proportional factor, zone 2: X:PRO2
- Position tolerance: X:PTOL Speed: X:SSPD
- Position tolerance 2: X:PTO2 Acceleration/deceleration: X:ACCE/X:DECE
- Timeout time: X:TOUT Mass: X:MASS
- Amplitude control: X:DUCO Left soft limit: X:LLIM
- Min/max amplitude: X:MIMP/X:MAMP Right soft limit: X:HLIM
- Phase correction: X:PHAS Error limit: X:ELIM
Frequencies/proportional values:
Typically, in zone 1 (closest to the target position), the frequency and proportional factor are both chosen higher. This gives a better ‘landing’ on the target position. For zone 2 (further away from the target position) the frequency is chosen lower to increase speed. At the same time the proportional factor for zone 2 typically has to be chosen lower to avoid instability. Be aware that outside a certain frequency range, the motor will have very limited force (frequency too high) or feature unstable behaviour (frequency too low). A typical frequency difference between FREQ and FRQ2 is between 1 and 3 kHz for a 1N motor and between 0.5 and kHz for a 3N, 5N or 10N motor. The proportional factors in zone 1 (PROP) are typically 2-3 times the value of the proportional factors in zone 2.
When the stage does not want to land on the target position, despite optimizing frequency and proportional factor for zone 1, try to increase the positioning tolerances PTOL and PTO2. See the instruction set for more information.
To obtain the maximum power out of the stage, the frequency in zone 2 (FRQ2) should be set as low as possible without drawing too much current, which results an amplifier fault (status bit 2 & 3)
Adding mass to the stage
As soon as adding a mass of 100g or more, the MASS parameter can be adapted. For every 100g of mass you add, increase the MASS parameter with 100. Finding the optimal MASS parameters is usually obtained by trial-and-error. This parameter is mostly used for heavy payloads on horizontal stages.
Changing the dynamics
Would you like your stage to react faster or slower, the following parameters can be adapted to achieve this.
- SSPD is used to set the maximum speed the stage. Please note, if the frequency in zone 2 is set too low, the speed can’t always be reached.
- ACCE defines the acceleration of the stage to the set speed in SSPD. The default value of 65500 means no acceleration limitation is taking into account (i.e. full acceleration).
- DECE defines the deceleration of the stage upon reaching its target. The default value of 65500 means no deceleration limitation is taken into account (i.e. full deceleration).
- PROP & PRO2 are proportional factors used for the closed feedback loop. Both parameters are used for the two different zones (ZON1 and ZON2). Typically PROP is higher than PRO2. Increase them to get faster positioning times.
When the stage needs to move with less overshoot, decrease the above mentioned parameters. Higher proportional factors let the controller react stronger and reduce positioning errors, but can also lead to instability or noisy operation when chosen too high.
Windows GUI
To provide the user with a quick way to interact with the controlled and the connected stage, a Windows GUI is supplied with every controller. The use is simple and self-explanatory. It can be used for manual input and to run simple scripts.
Required files
The Windows GUI makes use of the following files:
- The executable of the Windows GUI: Xeryon_Dialog.exe
- A configuration file named “config.txt”. This file should not be edited by the user.
- A default settings file named “settings_default.txt”. The GUI reads this file for initial settings at start-up. Replace or modify this file to alter the default settings. After saving, these values are stored on the driver.
- A settings file named “settings_user.txt”. This file will be created by the program after pressing the “save to file” button.
- A demo program. The file dialog window presents “demo.txt” as default filename.
Remark: config.txt has to be in the same folder as Xeryon_Dialog.exe.
Commands for the Windows GUI demo program
| Command | Explanation |
| BAUD | Set the baud rate for communication. |
| DPOL | Delay used when polling for a ‘position reached’ signal after a new target position is set. When DPOL is too small, the Windows GUI may trigger on the ‘position reached’ status flag of the previous target position due to communication delay. In that case, a succeeding WAIT command will start the timer at the start of the movement instead of after the target has been reached. |
| HELP | Switch help on or off. HELP=1 switches the info tips on. HELP=0 switches the info tips off. |
| HALT | Stop the program. (Not to be confused by the STOP command for the driver.) |
| LABL | Label in the program used by REPT. |
| LOG | Start or stop logging of data. LOG=1 switches logging on. LOG=0 switched logging off. Data is stored in datalog.csv. When datalog.csv already exists, new data is appended. |
| MASS | Specifies the mass/inertia of the load on the stage. The Windows GUI calculates the optimal control parameters to obtain stable operation. |
| MMAS | Maximum mass that can be selected in the Windows GUI. |
| MPRO | Maximum proportional factor that can be selected in the Windows GUI. |
| MSPD | Maximum speed that can be selected in the Windows GUI. |
| PORT | Default port number to appear in the Windows GUI. |
| REPT | Repeat the above program a specified number of times. The first argument specifies the number of loops. The second argument specifies the label to jump to (label range 0 – 99). If the label does not exist, then the program jumps back to the first line. The REPT command should be placed at the end of the block to be repeated. Nesting of REPT blocks is allowed. Example: REPT=10 2 does 10 loops starting from label 2. |
| WAIT | Wait a specified time before proceeding to the next command. Time expressed in milliseconds. When WAIT follows a STEP or DPOS command, the timer is started when reaching the target position. |
Example program file (demo.txt)
- X:SSPD=100 % Set speed to 100 mm/s or 100 degrees/s
- X:DPOS=0 % Go to position 0
- X:WAIT=100 % Wait 100 ms after arrival at position
- X:LABL=2 % Set label 2
- X:DPOS=60 % Go to position 60 mm or 60 degrees
- X:WAIT=100 % Wait 100 ms after arrival at position
- X:SSPD=10 % Set speed to 10 mm/s or 10 degrees/s
- X:SCAN=1 % Move with constant speed in positive direction
- X:WAIT=2000 % Wait for 2s (while scan goes on)
- X:REPT=3 2 % Repeat 3 times the code above, starting from label 2
- X:STOP % Stop stage
- X:DPOS=0 % Finish in the center

Function of buttons and status displays:
Settings button:
- Load from file: select a file to load your own user settings.
- Edit: open the settings window (see below).
- Save to file: save the current settings to a new file.
- Save on driver: save the current to the controller.
- Save to file: save the settings to a file you select
- Connect to port: when the port is selected, connect to the port and select settings file
- Port: Choose COM port of XD-M controller.
- Connected to driver: successfully connected to the controller.
- Communication error: communication error between the computer and controller.
- Recover: recover the controller after a fault/error.
- Reset encoder: reset encoder count. Index will need to be found again.
- Find index: start indexing procedure.
- Amplifier fault: overcurrent, undervoltage or short-circuit error.
- Position error: position couldn’t be reached within set timeout.
- Encoder error: encoder not working or damaged. (commonly caused by short-circuit)
- Position reached: desired position reached.
- Index found: index or home position found.
- Stop: stop the motor.
- Reset: reset the settings back to settings_default.txt and stop the motor
- Start program: start the program selected below
- Demo.txt: select the demo program
- Blue slider: use the slider to change the desired position.
- Scan + X: the stage will continuously move in the + X direction.
- Step + X: the stage will take a step in the + X direction.
- 0 button: move to the middle/index position.
- Actual position: current position of the stage. (can’t be changed here)
- Desired position: change the position of the stage here.
- Step size: choose the size of the steps.
- Actual speed: calculated speed of the stage. (will always be lower than actual speed due to polling delay)
Python, MATLAB,C++ and LabVIEW
Interaction with the XD-M controller and connected stage is also possible through Python, MATLAB, LabVIEW, C++ or any other programming language that supports sending ASCII commands over a (virtual) COM port. Demo programs available for the programming languages mentioned above. The demo’s include functions for advanced motion commands, error statuses, settings control and more.
All libraries are available from our website under Downloads.

Support
- Contact: support@xeryon.com
- Address: Diestsesteenweg 692, 3010 Leuven, Belgium
- Phone: +32 (0)16 903 904
- Website: xeryon.com
Frequently Asked Questions
Q: Do I need advanced tuning for vertical or inclined use with higher payloads?
A: Yes, for such scenarios, advanced tuning may be necessary.
Contact support@xeryon.com for assistance.
Q: How do I control a stage using the Windows GUI?
A: Connect the correct COM port, load settings_default.txt from the USB stick, press Find Index, and then you can control the stage using SCAN, STEP, or moving to the home position.
Q: What is the baud rate supported for communication?
A: The baud rate can be up to 115200 for communication with the XD-M.
Q: What are the key specifications of the XD-M controller?
A: The XD-M supports up to 6 devices simultaneously, has multi-axis control, and includes a Windows GUI for easy testing.
Documents / Resources
![]() | XD-M Controller |
References
- 0.to is almost here!0.to
- mailto:support@xeryon.comxeryon.com
- Xeryon: Piezo Stages & Actuatorsxeryon.com
- Xeryon: Piezo Stages & Actuatorsxeryon.com
- Downloads – Manuals, Specs & Software Resources | Xeryonxeryon.com
- xeryon.com/software/xeryon.com
- User Manualmanual.tools

