OWIS stage with ED7062 CSV and TR SSI encoder
This folder configures the OWIS linear stage with an ED7062 two-channel stepper drive in cyclic synchronous velocity (CSV) mode. ECMC closes the position loop using the TR-Electronic LT140-S absolute SSI linear encoder. The configured engineering unit is millimetres.
The configuration was derived from ../EL7062_CSV, but all drive declarations
and descriptions in this folder refer to the ED7062.
ED7062 declarations
| Setting | Configured value |
|---|---|
| Hardware description | HW_DESC=ED7062 |
| EtherCAT slave position | 10 |
| Used channel | Channel 1 |
| Unused channel | Channel 2, Generic-Ch-Not-Used |
| Axis mode | CSV |
| Drive setpoint | velocitySetpoint01 |
| Drive/control type | 1, DS402/advanced drive |
| Internal position | positionActual01 |
| Digital limit inputs | binaryInputs01.0 and .1 |
The declaration and PDO pattern follow PSI's ED7062 CSV example:
The copied EL7062-specific CSV firmware warning is intentionally not presented as an ED7062 fact. The files contain no evidence about the installed ED7062 firmware; its disable/re-enable behaviour must still be checked on hardware.
System configuration
| Function | Configured hardware or setting |
|---|---|
| ECMC | ecmccfg 11.0.8, engineering mode enabled, EC_RATE=500 Hz |
| Motion axis | Axis 1, EPICS name M1, description OWIS Stage ED7062 |
| Stepper drive | ED7062 at EtherCAT slave 10, channel 1, CSV mode |
| Motor | OWIS two-phase stepper; 0.8 A maximum, 0.5 A standby, 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 |
CSV drive scaling
The ED7062 CSV velocity setpoint uses a signed 32-bit range. With a stage travel of 1 mm/revolution and a 500 Hz EtherCAT rate:
drive.numerator = 1 mm/revolution * 500 cycles/second = 500
drive.denominator = 2^31 = 2147483648
raw velocity = commanded velocity * 2147483648 / 500
commanded velocity = raw velocity * 500 / 2147483648 mm/s
At the configured default velocity of 3 mm/s, the nominal raw command is about
12884902 counts. Confirm the live setpoint and actual velocity during reduced-
speed commissioning.
Encoder configuration
Primary SSI encoder
The EL5042 channel is 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 labelled as interferometer-calibrated in
cfg/axis.yaml. The files do not establish its calibration uncertainty or
confirm the current mechanical datum.
ED7062 internal counter
- Secondary encoder; the SSI encoder remains primary feedback
- Scale:
1 / 1048576 mm/countfor a 1 mm/revolution stage - Incremental, 32-bit counter
- Referenced to the primary SSI encoder at startup
- Position PDO:
positionActual01
Position controller
In CSV mode, ECMC generates the trajectory and closes the position loop using the SSI encoder. The ED7062 closes its internal velocity and current loops.
The configured ECMC controller gains are:
| Parameter | Value |
|---|---|
Kp |
14 |
Ki |
1.6 |
Kd |
0.5 |
Kff |
1 |
These values differ substantially from the copied EL7062 configuration and are treated as local tuning values. Their origin and stability are not established by the files. Validate them at reduced current and velocity before normal motion.
Motion and monitoring
| Characteristic | Configured value |
|---|---|
| Trajectory profile | Trapezoidal (type: 0) |
| Default velocity | 3 mm/s |
| Default acceleration/deceleration | 2 mm/s^2 |
| Emergency deceleration | 10 mm/s^2 |
| Jog velocity | 1 mm/s |
| Backward software limit | -1 mm |
| Forward software limit | 95 mm |
| Maximum monitored velocity | 10 mm/s |
| Following-error tolerance | 0.5 mm for 10 EtherCAT cycles |
| At-target tolerance | 0.002 mm for 50 EtherCAT cycles |
| Auto-enable timeout | 10 s |
| Automatic disable delay | 10 s idle |
The hardware limits use ED7062 channel 1 inputs:
- Backward limit:
binaryInputs01.0 - Forward limit:
binaryInputs01.1 - Limit-switch power: EL2008 channel 4
Home and external interlock are constant true because no corresponding sensors are assigned. Software limits and axis monitoring remain enabled.
Automatic FAT motion sequence
startup.cmd loads cfg/code_2.plc at a 500 ms PLC sample period. A rising edge
on doMotion starts the sequence.
- 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 each measurement point
- Intermediate dwell: 2 PLC scans, nominally 1 s
- Measurement dwell: 12 PLC scans, nominally 6 s
- Five forward/backward cycles
# Start
caput aik-motion-pc5:Set-M1-DoMtn-RB 1
# Stop
caput aik-motion-pc5:Set-M1-DoMtn-RB 0
Remaining commissioning issues
- The motor component declares
R_COIL_MOHM=7500, while the drive-controller component declaresR_COIL_MOHM=2471. Resolve this mismatch before enabling motion. Use motor measurements and ED7062 autotune results for the installed motor rather than assuming the copied values are valid. - Confirm that
HW_DESC=ED7062matches the installed device and the availableecmccfg 11.0.8hardware definition before starting the IOC. - Confirm the EL5042 output is 9.0 V and permitted by the exact encoder order code before connecting the encoder.
- Confirm motor direction and SSI direction before closing the position loop. A sign error can command immediate motion in the wrong direction.
- The PLC accepts busy-low plus
attargetas move completion without first latching that busy became high. Validate or correct this handshake before unattended operation. - Static review does not prove PDO compatibility, controller stability, limit polarity, or safe operation on the target hardware.
Relevant files
startup.cmd- EL5042 SDOs, ED7062 declaration, motor/controller components, axis loading, and PLC loadingcfg/axis.yaml- ED7062 CSV mapping, primary SSI feedback, trajectory, controller, limits, and monitoringcfg/enc_open_loop.yaml- secondary ED7062 internal countercfg/code_2.plc- active FAT motion sequencecfg/code.plc- alternate older sequence, not loaded bystartup.cmd
Commissioning sequence
- Confirm that the IOC loads
ECMC/ED7062_CSV/startup.cmd. - Verify that EtherCAT slave 10 is the installed ED7062 and that channel 1 is connected to the motor while channel 2 is unused.
- Resolve the motor-resistance mismatch and run the appropriate drive autotune.
- Confirm 9.0 V at the EL5042 connector before attaching the encoder.
- With motion disabled, verify SSI readiness, position, status bits, ED7062 counter, limit inputs, and limit-switch supply.
- Enable at reduced current and command a very low positive motion. Confirm
motor direction, SSI direction,
velocitySetpoint01, and actual velocity. - Verify the 500/2147483648 CSV scaling against live setpoint and velocity.
- Tune and validate the ECMC position controller, following error, settling, software limits, and stop behaviour.
- Test disable/re-enable counter continuity on the installed ED7062 firmware.
- Validate the PLC execute/busy handshake before running the complete FAT sequence.