XERYON XD-M Controller Instruction Manual

Xeryon-LOGO

XERYON XD-M Controller

XERYON-XD-M-Controller-PRODUCT

Specifications
  • 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:

  1. Plug the stage connector into the XD-M.
  2. Connect the XD-M to a computer using the provided USB cable.
  3. Open the Windows GUI software.
  4. 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.

XERYON-XD-M-Controller-FIG- (9)

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: 

  1. Connect the correct COM port.
  2. Load settings_default.txt from USB stick.
  3. Press “Find Index”.
    The stage will start moving and look for the encoder index.
  4. You can start controlling the stage:
    • SCAN: move with continuous speed.
    • STEP: move with specified step size.
    • 0: move to home position.

XERYON-XD-M-Controller-FIG- (2)

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.

  1. Format for instructions
  2. List of commands
  3. 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:

  1. Motion
  2. Settings handling
  3. Communication
  4. Tuning
  5. Signal (advanced)
  6. Directional settings (advanced)
  7. 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. 1 character defining the axis, followed by a colon.
  2. Tag: Four characters describing the type of information
  3. ‘=’ sign separating the command from the corresponding value
  4. 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.

  1. Control the position of the stage using pulses. Each pulse does a step (size) in a certain direction.
  2. Control the position of the stage using an encoder-like signal.
  3. Control the speed of the stage using a PWM input signal.
  4. 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

XERYON-XD-M-Controller-FIG- (1)

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 

XERYON-XD-M-Controller-FIG- (3)

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 

XERYON-XD-M-Controller-FIG- (4)

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 

XERYON-XD-M-Controller-FIG- (5)

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:

XERYON-XD-M-Controller-FIG- (6)

  • 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

XERYON-XD-M-Controller-FIG- (7)

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.
    1. Save to file: save the settings to a file you select
    2. Connect to port: when the port is selected, connect to the port and select settings file
    3. Port: Choose COM port of XD-M controller.
    4. Connected to driver: successfully connected to the controller.
    5. Communication error: communication error between the computer and controller.
    6. Recover: recover the controller after a fault/error.
    7. Reset encoder: reset encoder count. Index will need to be found again.
    8. Find index: start indexing procedure.
    9. Amplifier fault: overcurrent, undervoltage or short-circuit error.
    10. Position error: position couldn’t be reached within set timeout.
    11. Encoder error: encoder not working or damaged. (commonly caused by short-circuit)
    12. Position reached: desired position reached.
    13. Index found: index or home position found.
    14. Stop: stop the motor.
    15. Reset: reset the settings back to settings_default.txt and stop the motor
    16. Start program: start the program selected below
    17. Demo.txt: select the demo program
    18. Blue slider: use the slider to change the desired position.
    19. Scan + X: the stage will continuously move in the + X direction.
    20. Step + X: the stage will take a step in the + X direction.
    21. 0 button: move to the middle/index position.
    22. Actual position: current position of the stage. (can’t be changed here)
    23. Desired position: change the position of the stage here.
    24. Step size: choose the size of the steps.
    25. 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.

XERYON-XD-M-Controller-FIG- (8)

Support

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

PDF thumbnailXD-M Controller
Instruction Manual · XD-M Controller, XD-M, Controller

Ask a Question

Use this section to ask about setup, compatibility, troubleshooting, or anything missing from this manual.

Ask a Question

Ask about setup, compatibility, troubleshooting, or anything missing from this manual. Name and email are optional.