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 to0.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: 1selects 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 declaresR_COIL_MOHM=2471. Confirm which resistance belongs to the installed motor before commissioning or retuning the drive. - The controller gains and
L_COIL_UH=3080are 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
attargetis 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_CSPand the axis mode isCSP.
Relevant files
startup.cmd- EtherCAT slave setup, EL5042 SDOs, motor/controller components, axis loading, and PLC loadingcfg/axis.yaml- axis, primary encoder, limits, trajectory, controller, and monitoring configurationcfg/enc_open_loop.yaml- EL7062 secondary/open-loop encoder configurationcfg/code_2.plc- active multi-position FAT sequencecfg/code.plc- alternate older position sequence; not loaded bystartup.cmd
Checks required before operation
- Verify the loaded IOC working directory and confirm that this
startup.cmdandcfg/code_2.plcare the active files. - Verify EL7062 channel assignment, motor phase wiring, phase resistance, phase inductance, configured currents, and controller tuning.
- Confirm the EL5042 output voltage is 9.0 V before connecting the encoder, and verify the encoder's permitted supply voltage from its documentation.
- Confirm that the encoder is ready and has no warning or error bits.
- Confirm that positive motor motion produces positive SSI position motion.
- Verify the encoder scale and absolute offset against a traceable displacement reference if the encoder or stage datum has changed.
- Exercise both hardware limit switches at low velocity and confirm their raw input states and configured directions.
- Validate following error, settling, software limits, and the PLC move handshake at reduced speed before running the complete automatic sequence.