Files
2026-11-15 15:24:08 +01:00
..
up
2026-11-15 15:24:08 +01:00
up
2026-11-15 15:24:08 +01:00
up
2026-11-15 15:24:08 +01:00

OWIS stage with EL7062 and TR SSI encoder

This folder contains the ECMC configuration used for the OWIS linear stage with an EL7062 stepper terminal and a TR-Electronic LT140-S absolute linear encoder. The configured engineering unit is millimetres.

System configuration

Function Configured hardware or setting
ECMC ecmccfg 11.0.8, engineering mode enabled, EC_RATE=500
Motion axis Axis 1, EPICS name M1, description OWIS Stage EL7062
Stepper terminal EL7062 at EtherCAT slave 10, configured for CSP
Motor OWIS two-phase stepper; 0.8 A maximum current, 0.5 A standby current, 48 V nominal, 7.5 ohm/phase, 3080 uH, 400 full steps/revolution
Primary feedback TR-Electronic LT140-S on EL5042 slave 2, channel 1
Limit-switch supply EL2008 slave 5, channel 4 switched output
Position unit mm

startup.cmd currently applies motor and controller components to EL7062 channels 1 and 2. Axis M1 uses channel 1 EtherCAT entries; no axis is loaded for channel 2 in this folder.

Encoder and motion scaling

Primary SSI encoder

The EL5042 channel is explicitly configured by SDO before the axis is loaded:

  • SSI mode, binary coding
  • 24 position bits, no multiturn or offset bits
  • Status bits disabled and CRC inversion enabled
  • 1 MHz clock
  • 9.0 V encoder supply
  • Scale: 1 / 10000 mm/count, equivalent to 0.1 um/count
  • Absolute offset: -11.826 mm
  • Counter overflow/wraparound disabled

The 10000 counts/mm value is documented in cfg/axis.yaml as the interferometer-calibrated scale. The README does not independently validate that calibration or the current mechanical datum.

EL7062 position interface and open-loop counter

  • Stage travel used for scaling: 1 mm/revolution
  • EL7062 CSP scale: 1048576 counts/revolution
  • Open-loop position width: 32 bits
  • The open-loop encoder is secondary; the SSI encoder is primary feedback.
  • At startup, the open-loop encoder references encoder ID 1.
  • useAsCSPDrvEnc: 1 selects it as the CSP drive encoder.

Axis behaviour

Characteristic Configured value
Default velocity 3 mm/s
Default acceleration/deceleration 1 mm/s^2
Emergency deceleration 10 mm/s^2
S-curve jerk 10 mm/s^3
Jog velocity 1 mm/s
Backward software limit -1 mm
Forward software limit 95 mm
Maximum monitored velocity 6 mm/s
Following-error tolerance 0.05 mm for 10 EtherCAT cycles
At-target tolerance 0.0015 mm for 50 EtherCAT cycles
Auto-enable timeout 10 s
Automatic disable delay 60 s idle

The trajectory generator is configured for an S-curve profile. The external interlock and home inputs are constant true in this configuration because no external interlock or home sensor is assigned.

The hardware limits use EL7062 channel 1 digital inputs:

  • Backward limit: binaryInputs01.0
  • Forward limit: binaryInputs01.1
  • Limit-switch power: EL2008 channel 4

Automatic FAT motion sequence

startup.cmd loads cfg/code_2.plc at a 500 ms PLC sample period. A rising edge on the doMotion variable starts the sequence.

The active sequence uses:

  • Move velocity: 2 mm/s
  • Acceleration and deceleration: 3 mm/s^2
  • Ten measurement positions from 1.0000 mm to 90.0000 mm
  • A preliminary position 0.2 mm below every measurement position so the final approach is always in the positive direction
  • Intermediate dwell: 2 PLC scans, nominally 1 s
  • Measurement dwell: 12 PLC scans, nominally 6 s
  • Five forward/backward cycles

The ten (preliminary -> measurement) position pairs are:

0.8000  ->  1.0000 mm
10.6900 -> 10.8900 mm
20.5775 -> 20.7775 mm
30.4675 -> 30.6675 mm
40.3550 -> 40.5550 mm
50.2450 -> 50.4450 mm
60.1325 -> 60.3325 mm
70.0225 -> 70.2225 mm
79.9100 -> 80.1100 mm
89.8000 -> 90.0000 mm

The PLC powers off the axis and disables itself if either limit becomes invalid or mc_move_abs() returns an error.

Start and stop commands documented by startup.cmd are:

caput aik-motion-pc5:Set-M1-DoMtn-RB 1
caput aik-motion-pc5:Set-M1-DoMtn-RB 0

Configuration caveats

  • The motor component declares R_COIL_MOHM=7500, while the controller component declares R_COIL_MOHM=2471. Confirm which resistance belongs to the installed motor before commissioning or retuning the drive.
  • The controller gains and L_COIL_UH=3080 are configuration values only. The files do not provide evidence that they were measured, autotuned, or validated on the currently connected hardware.
  • The PLC considers a move complete whenever drive busy is low and attarget is true; it does not first latch that drive busy became high. Confirm this execute/busy behaviour with the installed ECMC helper before relying on the unattended sequence.
  • Comments in the source contain a few stale labels (for example, CSV wording beside the CSP slave configuration). The executable setting is HW_DESC=EL7062_CSP and the axis mode is CSP.

Relevant files

  • startup.cmd - EtherCAT slave setup, EL5042 SDOs, motor/controller components, axis loading, and PLC loading
  • cfg/axis.yaml - axis, primary encoder, limits, trajectory, controller, and monitoring configuration
  • cfg/enc_open_loop.yaml - EL7062 secondary/open-loop encoder configuration
  • cfg/code_2.plc - active multi-position FAT sequence
  • cfg/code.plc - alternate older position sequence; not loaded by startup.cmd

Checks required before operation

  1. Verify the loaded IOC working directory and confirm that this startup.cmd and cfg/code_2.plc are the active files.
  2. Verify EL7062 channel assignment, motor phase wiring, phase resistance, phase inductance, configured currents, and controller tuning.
  3. Confirm the EL5042 output voltage is 9.0 V before connecting the encoder, and verify the encoder's permitted supply voltage from its documentation.
  4. Confirm that the encoder is ready and has no warning or error bits.
  5. Confirm that positive motor motion produces positive SSI position motion.
  6. Verify the encoder scale and absolute offset against a traceable displacement reference if the encoder or stage datum has changed.
  7. Exercise both hardware limit switches at low velocity and confirm their raw input states and configured directions.
  8. Validate following error, settling, software limits, and the PLC move handshake at reduced speed before running the complete automatic sequence.