up
No files matched your search
@@ -0,0 +1,6 @@
|
||||
# Regenerable Python and uv state for the direct report builder.
|
||||
Report/unused/workflow/__pycache__/
|
||||
Report/unused/workflow/builds/
|
||||
Report/unused/workflow/uv-cache/
|
||||
Report/*.base.pdf
|
||||
Report/*.pdf.pending
|
||||
@@ -0,0 +1,47 @@
|
||||
# Linear-stage report project guidance
|
||||
|
||||
This repository is the reusable baseline for future linear-stage FAT or
|
||||
characterization projects. The active Characterization workflow is the Python
|
||||
generator at `Report/python_script/build_characterization_report.py`, launched
|
||||
by `Build_Characterization_Report.bat`. Before report work, read
|
||||
`Report/AGENTS.md` completely.
|
||||
|
||||
## Boundaries and evidence
|
||||
|
||||
- During report generation in a derived project, write only inside `Report/`. Treat `Measurements`,
|
||||
`Media`, `Motor`, `Encoder`, `ECMC` and other evidence folders as read-only.
|
||||
- Do not execute ECMC example commands or operate hardware to prepare a report.
|
||||
- Preserve original filenames, photographs, raw data and measurement PDFs.
|
||||
- Preserve `Report/python_script/PSI_Logo.png`; the Python generator displays this logo on
|
||||
page 1.
|
||||
- Transfer the workbook's repository URL to page 1 under the exact label `Repository`.
|
||||
- A template, configuration or successful build is not proof of FAT acceptance.
|
||||
- Never fabricate identities, limits, measurements, calibration or uncertainty.
|
||||
- For motor report data, inspect `Motor/Motor.xlsx` first when present, then
|
||||
use other `Motor/` documents only to resolve fields not supplied by that
|
||||
workbook. Keep each reported value traceable to its Motor-folder source.
|
||||
|
||||
## Privacy
|
||||
|
||||
Keep confidential/customer evidence within the authorized working environment.
|
||||
Do not put secrets in reports, skill assets or workflow state. Do not send
|
||||
protected source material to external services without authorization; if the
|
||||
requested workflow requires such disclosure, pause that disclosure and obtain
|
||||
specific user direction. This does not require approval for ordinary local
|
||||
inspection of the evidence already provided for the report.
|
||||
|
||||
## Efficient continuation
|
||||
|
||||
The batch launcher uses `uv run --script` and stores its regenerable cache under
|
||||
`Report/python_script/uv-cache/`. Keep source code and report-only workflow
|
||||
state under `Report/python_script/`; do not add that cache to version control.
|
||||
The historical LaTeX assets are archived in `OLD/` and are not active inputs.
|
||||
|
||||
## Agent boundary
|
||||
|
||||
An agent may inspect project evidence and update only
|
||||
`Report/Agent_Report_Data.json` using the source rules in
|
||||
`Report/Report_Input_Manifest.json`. Agent work stops there: do not run the
|
||||
batch launcher, build, inspect, or validate a PDF, and do not state that a
|
||||
report is complete, issued, accepted, or visually correct. The user runs the
|
||||
batch file and reviews the PDF.
|
||||
@@ -0,0 +1,38 @@
|
||||
@echo off
|
||||
setlocal EnableExtensions
|
||||
|
||||
rem Build the evidence-bounded Characterization working draft without LaTeX.
|
||||
rem This file must remain in the repository root.
|
||||
pushd "%~dp0" || (
|
||||
echo ERROR: Cannot open the report repository folder.
|
||||
exit /b 1
|
||||
)
|
||||
|
||||
where uv >nul 2>&1
|
||||
if errorlevel 1 (
|
||||
echo ERROR: uv was not found on PATH.
|
||||
echo Install uv from https://docs.astral.sh/uv/ and open a new Command Prompt.
|
||||
popd
|
||||
exit /b 1
|
||||
)
|
||||
|
||||
rem Keep uv's cache within the authorized report-workflow folder.
|
||||
set "UV_CACHE_DIR=%CD%\Report\python_script\uv-cache"
|
||||
|
||||
echo Building the Characterization working draft with uv...
|
||||
uv run --script "Report\python_script\build_characterization_report.py" --workbook "FAT_Checklist.xlsx" --agent-data "Report\python_script\Agent_Report_Data.json" --manifest "Report\python_script\Report_Input_Manifest.json" --output "Report\Linear_Stage_Characterization_Working_Draft.pdf"
|
||||
if errorlevel 1 (
|
||||
echo.
|
||||
echo ERROR: Report build failed. Read the message above; do not use a partial PDF.
|
||||
set "BUILD_EXIT_CODE=1"
|
||||
) else (
|
||||
echo.
|
||||
echo PDF created: Report\Linear_Stage_Characterization_Working_Draft.pdf
|
||||
set "BUILD_EXIT_CODE=0"
|
||||
)
|
||||
|
||||
echo.
|
||||
echo This window will remain open. Close it when you have finished reviewing the output.
|
||||
popd
|
||||
cmd /k
|
||||
endlocal & exit /b %BUILD_EXIT_CODE%
|
||||
@@ -0,0 +1,200 @@
|
||||
# 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:
|
||||
|
||||
- [PSI EX7062/ED7062 CSV example](https://github.com/paulscherrerinstitute/ecmccfg/tree/b30e46072f900b37f7c674aee9a77b3c18f27735/examples/PSI/best_practice/motion/stepper_incremental/ex7062_CSV)
|
||||
- [PSI CSV/CSP/CSP-PC mode documentation](https://paulscherrerinstitute.github.io/ecmccfg/manual/motion_cfg/modes_csv_csp_csp_pc/)
|
||||
- [PSI axis YAML documentation](https://paulscherrerinstitute.github.io/ecmccfg/manual/motion_cfg/axisyaml/)
|
||||
|
||||
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:
|
||||
|
||||
```text
|
||||
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 to `0.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/count` for 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
|
||||
|
||||
```sh
|
||||
# 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 declares `R_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=ED7062` matches the installed device and the available
|
||||
`ecmccfg 11.0.8` hardware 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 `attarget` as 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 loading
|
||||
- `cfg/axis.yaml` - ED7062 CSV mapping, primary SSI feedback, trajectory,
|
||||
controller, limits, and monitoring
|
||||
- `cfg/enc_open_loop.yaml` - secondary ED7062 internal counter
|
||||
- `cfg/code_2.plc` - active FAT motion sequence
|
||||
- `cfg/code.plc` - alternate older sequence, not loaded by `startup.cmd`
|
||||
|
||||
## Commissioning sequence
|
||||
|
||||
1. Confirm that the IOC loads `ECMC/ED7062_CSV/startup.cmd`.
|
||||
2. Verify that EtherCAT slave 10 is the installed ED7062 and that channel 1 is
|
||||
connected to the motor while channel 2 is unused.
|
||||
3. Resolve the motor-resistance mismatch and run the appropriate drive autotune.
|
||||
4. Confirm 9.0 V at the EL5042 connector before attaching the encoder.
|
||||
5. With motion disabled, verify SSI readiness, position, status bits, ED7062
|
||||
counter, limit inputs, and limit-switch supply.
|
||||
6. Enable at reduced current and command a very low positive motion. Confirm
|
||||
motor direction, SSI direction, `velocitySetpoint01`, and actual velocity.
|
||||
7. Verify the 500/2147483648 CSV scaling against live setpoint and velocity.
|
||||
8. Tune and validate the ECMC position controller, following error, settling,
|
||||
software limits, and stop behaviour.
|
||||
9. Test disable/re-enable counter continuity on the installed ED7062 firmware.
|
||||
10. Validate the PLC execute/busy handshake before running the complete FAT
|
||||
sequence.
|
||||
@@ -0,0 +1,105 @@
|
||||
axis: # Physical-axis configuration
|
||||
id: ${AXIS_ID=1} # Unique numeric axis identifier
|
||||
feedSwitchesOutput: ec0.s${BO_SID}.binaryOutput${BO_CH=04} # EL2008 channel 4: 24 V supply for limit switches
|
||||
type: joint # Physical motor axis
|
||||
mode: CSP # ED7062 cyclic synchronous velocity mode
|
||||
autoEnable: # Native ecmc automatic axis enable/disable
|
||||
enableTimeout: 10 # Maximum time allowed to auto-enable [s]
|
||||
disableTimeout: 10 # Idle time before automatic disable [s]
|
||||
tweakDist: 1.0
|
||||
|
||||
plc: # Axis PLC configuration
|
||||
id: 1 # PLC identifier
|
||||
enable: yes # Enable the axis PLC
|
||||
externalCommands: true # Allow the PLC to issue axis commands
|
||||
|
||||
epics:
|
||||
name: ${AX_NAME=M1}
|
||||
precision: 3
|
||||
description: OWIS Stage ED7062
|
||||
unit: mm
|
||||
motorRecord:
|
||||
syncSoftLimits: False
|
||||
fieldInit: 'RTRY=0,FOFF=Frozen'
|
||||
|
||||
|
||||
drive:
|
||||
numerator: 1 #500 # 1 mm/rev * 500 EtherCAT cycles/s
|
||||
denominator: 1048576 #2147483648 # Signed 32-bit ED7062 CSV velocity range
|
||||
type: 1 # Stepper: 0. DS402: 1 (DS402 = servos and advanced stepper drives)
|
||||
setpoint: ec0.s$(DRV_SID).positionSetpoint01 # ED7062 CSV velocity setpoint
|
||||
control: ec0.s$(DRV_SID).driveControl01 # Control word EtherCAT entry
|
||||
status: ec0.s$(DRV_SID).driveStatus01 # Status word EtherCAT entry
|
||||
warning: 2 # Warning bit in status word (if no drive warning bit then leave empty)
|
||||
error: # max 3 error bits in status word
|
||||
- 3 # Error 0 (if no drive error bit then leave empty)
|
||||
- 7 # Error 1 (if no drive error bit then leave empty)
|
||||
- 14 # Error 2 (if no drive error bit then leave empty)
|
||||
|
||||
encoder: # Primary encoder configuration
|
||||
primary: true # Use this encoder as the primary feedback encoder
|
||||
desc: SSI # Encoder description: TR-Electronic LT140-S SSI
|
||||
numerator: 1 # Encoder scaling numerator [mm]
|
||||
denominator: 10000 # Interferometer-calibrated encoder scale [counts/mm]
|
||||
type: 1 # Encoder type: 0=incremental; 1=absolute
|
||||
bits: 24 # Total raw encoder data width [bits]
|
||||
absBits: 24 # Absolute-data width in the least-significant part of the raw value [bits]
|
||||
absOffset: -11.826 # Absolute encoder offset in engineering units [mm]
|
||||
allowOverUnderFlow: false # Disallow raw-counter wraparound for this linear encoder
|
||||
position: ec0.s$(ENC_SID).positionActual${ENC_CH=01} # EtherCAT encoder actual-position entry
|
||||
status: ec0.s$(ENC_SID).encoderStatus${ENC_CH=01} # EtherCAT encoder status-word entry; required by warning/error checks
|
||||
ready: 2 # Ready-bit index in the encoder status word
|
||||
warning: 0 # Warning-bit index in the encoder status word
|
||||
error: # Encoder-error bit indices in the status word; maximum three
|
||||
- 1 # Encoder error 0 bit
|
||||
delayComp: # Compensation for delay between setpoint output and encoder readback
|
||||
time: 0 # Compensation delay [EtherCAT cycles]
|
||||
enable: true # Enable encoder delay compensation
|
||||
|
||||
controller: # Centralized ecmc position controller driving CSV velocity
|
||||
Kp: 0.06 # Proportional gain
|
||||
Ki: 0.04 # Integral gain
|
||||
Kd: 0.01 # Derivative gain
|
||||
Kff: 1
|
||||
|
||||
trajectory: # Trajectory-generator configuration
|
||||
type: 1 # Velocity profile: 0=trapezoidal; 1=S-curve (Ruckig)
|
||||
source: 0 # Position source: 0=axis trajectory generator; 1=PLC
|
||||
axis: # Normal-motion initialization values
|
||||
velocity: 3 # Default axis velocity [mm/s]
|
||||
acceleration: 2 # Default axis acceleration [mm/s^2]
|
||||
deceleration: 2 # Default axis deceleration [mm/s^2]
|
||||
emergencyDeceleration: 10 # Emergency deceleration [mm/s^2]
|
||||
jerk: 10 # S-curve jerk [mm/s^3]
|
||||
jog: # Jog-motion initialization values
|
||||
velocity: 1 # Default jog velocity [mm/s]
|
||||
|
||||
input: # Limit, home, and external-interlock inputs
|
||||
limit: # Hardware limit-switch inputs
|
||||
forward: ec0.s$(DRV_SID).binaryInputs${DRV_CH=01}.1 # EtherCAT forward-limit input
|
||||
backward: ec0.s$(DRV_SID).binaryInputs${DRV_CH=01}.0 # EtherCAT backward-limit input
|
||||
home: 'ec0.s$(DRV_SID).ONE.0' # Home input; constant true because no home sensor is used
|
||||
interlock: 'ec0.s$(DRV_SID).ONE.0' # External interlock; constant true because none is used
|
||||
|
||||
softlimits: # ecmc software travel-limit configuration
|
||||
enable: true # Globally enable software limits
|
||||
forward: 95 # Forward software-limit position [mm]
|
||||
forwardEnable: true # Enable the forward software limit
|
||||
backward: -1 # Backward software-limit position [mm]
|
||||
backwardEnable: true # Enable the backward software limit
|
||||
|
||||
monitoring: # Axis following-error, velocity, and in-position monitoring
|
||||
lag: # Position-lag/following-error monitoring
|
||||
enable: true # Enable position-lag monitoring
|
||||
tolerance: 0.5 # Maximum permitted position lag [mm]
|
||||
time: 10 # Allowed time outside lag tolerance [EtherCAT cycles]
|
||||
velocity: # Axis velocity monitoring
|
||||
enable: true # Enable velocity monitoring
|
||||
max: 10 # Maximum permitted velocity [mm/s]
|
||||
time: # Allowed velocity-violation durations
|
||||
trajectory: 100 # Cycles before trajectory initialization is halted
|
||||
drive: 400 # Cycles before the drive is disabled
|
||||
target: # At-target/in-position monitoring
|
||||
enable: true # Enable at-target monitoring; required by the motor record
|
||||
tolerance: 0.002 # At-target position tolerance [mm]
|
||||
time: 50 # Required time inside tolerance [EtherCAT cycles]
|
||||
@@ -0,0 +1,158 @@
|
||||
#############
|
||||
# PLC multi-position motion sequence
|
||||
#
|
||||
# Motion parameters
|
||||
#
|
||||
|
||||
var VEL := 2;
|
||||
var ACC := 3;
|
||||
var DEC := 3;
|
||||
var DWELL_TIME := 12;
|
||||
var N_POS := 10; # number of scan positions, count with the 0 position :)
|
||||
var MAX_CYCLES := 5;
|
||||
|
||||
|
||||
VAR
|
||||
myAxis : ax${AX_ID=1};
|
||||
step : static.seqStep;
|
||||
cycles : static.cycleCounter;
|
||||
doMotion : static.doMotion;
|
||||
doMotionOld : static.doMotionOld;
|
||||
posIndex : static.posIndex;
|
||||
direction : static.direction;
|
||||
dwellCnt : static.dwellCnt;
|
||||
END_VAR
|
||||
|
||||
|
||||
var errorCode := 0;
|
||||
var pos := 0;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Initialization
|
||||
# --------------------------------------------------
|
||||
|
||||
if(${SELF}.firstscan){
|
||||
step := 0;
|
||||
cycles := 0;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
dwellCnt := 0;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Trigger start
|
||||
# --------------------------------------------------
|
||||
|
||||
if(doMotion and not(doMotionOld)){
|
||||
println('PLC position sequence started');
|
||||
step := 1;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Position lookup
|
||||
# --------------------------------------------------
|
||||
|
||||
pos := 0;
|
||||
|
||||
if(posIndex==0){pos:=1.0000;}
|
||||
if(posIndex==1){pos:=10.8575;}
|
||||
if(posIndex==2){pos:=20.1050;}
|
||||
if(posIndex==3){pos:=31.8050;}
|
||||
if(posIndex==4){pos:=38.3275;}
|
||||
if(posIndex==5){pos:=51.9900;}
|
||||
if(posIndex==6){pos:=57.6875;}
|
||||
if(posIndex==7){pos:=71.4650;}
|
||||
if(posIndex==8){pos:=81.2450;}
|
||||
if(posIndex==9){pos:=90.0000;}
|
||||
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 1 – move to next position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==1 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,pos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,pos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 2;
|
||||
|
||||
println('Move done, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 2 – dwell
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==2 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= DWELL_TIME){
|
||||
|
||||
posIndex := posIndex + direction;
|
||||
|
||||
# reached end of list
|
||||
if(posIndex >= N_POS){
|
||||
direction := -1;
|
||||
posIndex := N_POS - 2;
|
||||
};
|
||||
|
||||
# reached start of list
|
||||
if(posIndex < 0){
|
||||
|
||||
direction := 1;
|
||||
posIndex := 1;
|
||||
|
||||
cycles := cycles + 1;
|
||||
|
||||
println('Cycle completed:',cycles);
|
||||
|
||||
if(cycles >= MAX_CYCLES){
|
||||
println('Sequence completed');
|
||||
doMotion := 0;
|
||||
step := 0;
|
||||
};
|
||||
};
|
||||
|
||||
if(step<>0){
|
||||
step := 1;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
doMotionOld := doMotion;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Safety
|
||||
# --------------------------------------------------
|
||||
|
||||
if(not(myAxis.drv.enabled)){
|
||||
return [];
|
||||
};
|
||||
|
||||
if(((not(ax1.mon.lowlim) or not(ax1.mon.highlim))) or errorCode){
|
||||
mc_power(${AX_ID=1},0);
|
||||
println('Sequence ended by limit switch violation or errorcode:', errorCode);
|
||||
step := 0;
|
||||
${SELF}.enable := 0;
|
||||
};
|
||||
@@ -0,0 +1,19 @@
|
||||
encoder: # ED7062 open-loop encoder configuration
|
||||
desc: 'Open loop' # Encoder description
|
||||
primary: false # Do not use this encoder as primary position feedback
|
||||
unit: mm # Encoder engineering unit
|
||||
numerator: 1 #500 # Encoder scaling numerator: stage travel per motor revolution [mm/rev]
|
||||
denominator: 1048576 #2147483648 # Encoder scaling denominator: ED7062 counts per revolution
|
||||
type: 0 # Encoder type: 0=incremental; 1=absolute
|
||||
bits: 32 # Total raw encoder counter width [bits]
|
||||
absBits: 0 # Absolute-data width [bits]; zero for an incremental encoder
|
||||
absOffset: 0 # Absolute encoder offset in engineering units [mm]
|
||||
position: ec0.s$(DRV_SID).positionActual01 # EtherCAT ED7062 open-loop actual-position entry
|
||||
homing: # Referencing configuration for this incremental encoder
|
||||
refToEncIDAtStartup: 0 # At startup, reference to primary SSI encoder index 0
|
||||
type: 2 # Homing/reference sequence type
|
||||
position: 0 # Reference position in engineering units [mm]
|
||||
velocity: # Homing velocities
|
||||
to: 0.5 # Velocity toward the reference cam/sensor [mm/s]
|
||||
from: 0.25 # Velocity away from the reference cam/sensor [mm/s]
|
||||
useAsCSPDrvEnc: 1
|
||||
@@ -0,0 +1,203 @@
|
||||
#############
|
||||
# PLC multi-position motion sequence
|
||||
#
|
||||
# Motion parameters
|
||||
#
|
||||
|
||||
var VEL := 2;
|
||||
var ACC := 3;
|
||||
var DEC := 3;
|
||||
|
||||
var INTERMEDIATE_DWELL_TIME := 2;
|
||||
var DWELL_TIME := 12;
|
||||
var N_POS := 10; # number of calibrated measurement positions
|
||||
var MAX_CYCLES := 5;
|
||||
|
||||
VAR
|
||||
myAxis : ax${AX_ID=1};
|
||||
step : static.seqStep;
|
||||
cycles : static.cycleCounter;
|
||||
doMotion : static.doMotion;
|
||||
doMotionOld : static.doMotionOld;
|
||||
posIndex : static.posIndex;
|
||||
direction : static.direction;
|
||||
dwellCnt : static.dwellCnt;
|
||||
END_VAR
|
||||
|
||||
|
||||
var errorCode := 0;
|
||||
var intermediatePos := 0;
|
||||
var pos := 0;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Initialization
|
||||
# --------------------------------------------------
|
||||
|
||||
if(${SELF}.firstscan){
|
||||
step := 0;
|
||||
cycles := 0;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
dwellCnt := 0;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Trigger start
|
||||
# --------------------------------------------------
|
||||
|
||||
if(doMotion and not(doMotionOld)){
|
||||
println('PLC position sequence started');
|
||||
step := 1;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Position lookup
|
||||
# --------------------------------------------------
|
||||
|
||||
# For every posIndex, in forward and backward travel:
|
||||
# 1. Move to intermediatePos.
|
||||
# 2. Move to pos and measure/dwell only at pos.
|
||||
# intermediatePos is always smaller than pos.
|
||||
|
||||
intermediatePos := 0;
|
||||
pos := 0;
|
||||
|
||||
if(posIndex==0){intermediatePos:=0.8000;pos:=1.0000;}
|
||||
if(posIndex==1){intermediatePos:=10.6900;pos:=10.8900;}
|
||||
if(posIndex==2){intermediatePos:=20.5775;pos:=20.7775;}
|
||||
if(posIndex==3){intermediatePos:=30.4675;pos:=30.6675;}
|
||||
if(posIndex==4){intermediatePos:=40.3550;pos:=40.5550;}
|
||||
if(posIndex==5){intermediatePos:=50.2450;pos:=50.4450;}
|
||||
if(posIndex==6){intermediatePos:=60.1325;pos:=60.3325;}
|
||||
if(posIndex==7){intermediatePos:=70.0225;pos:=70.2225;}
|
||||
if(posIndex==8){intermediatePos:=79.9100;pos:=80.1100;}
|
||||
if(posIndex==9){intermediatePos:=89.8000;pos:=90.0000;}
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 1 - move to intermediate position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==1 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,intermediatePos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,intermediatePos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 2;
|
||||
println('Intermediate move done, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 2 - dwell at intermediate position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==2 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= INTERMEDIATE_DWELL_TIME){
|
||||
step := 3;
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 3 - move to measurement position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==3 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,pos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,pos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 4;
|
||||
|
||||
println('Measurement position reached, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 4 - dwell at measurement position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==4 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= DWELL_TIME){
|
||||
|
||||
posIndex := posIndex + direction;
|
||||
|
||||
# reached end of list
|
||||
if(posIndex >= N_POS){
|
||||
direction := -1;
|
||||
posIndex := N_POS - 2;
|
||||
};
|
||||
|
||||
# reached start of list
|
||||
if(posIndex < 0){
|
||||
|
||||
direction := 1;
|
||||
posIndex := 1;
|
||||
|
||||
cycles := cycles + 1;
|
||||
|
||||
println('Cycle completed:',cycles);
|
||||
|
||||
if(cycles >= MAX_CYCLES){
|
||||
println('Sequence completed');
|
||||
doMotion := 0;
|
||||
step := 0;
|
||||
};
|
||||
};
|
||||
|
||||
if(step<>0){
|
||||
step := 1;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
doMotionOld := doMotion;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Safety
|
||||
# --------------------------------------------------
|
||||
|
||||
if(not(myAxis.drv.enabled)){
|
||||
return [];
|
||||
};
|
||||
|
||||
if(((not(ax1.mon.lowlim) or not(ax1.mon.highlim))) or errorCode){
|
||||
mc_power(${AX_ID=1},0);
|
||||
println('Sequence ended by limit switch violation or errorcode:', errorCode);
|
||||
step := 0;
|
||||
${SELF}.enable := 0;
|
||||
};
|
||||
|
||||
@@ -0,0 +1,212 @@
|
||||
#############
|
||||
# PLC multi-position motion sequence
|
||||
#
|
||||
# Motion parameters
|
||||
#
|
||||
|
||||
var VEL := 3;
|
||||
var ACC := 2;
|
||||
var DEC := 2;
|
||||
|
||||
var INTERMEDIATE_DWELL_TIME := 2;
|
||||
var DWELL_TIME := 10;
|
||||
var N_POS := 20; # number of calibrated measurement positions
|
||||
var MAX_CYCLES := 5;
|
||||
|
||||
VAR
|
||||
myAxis : ax${AX_ID=1};
|
||||
step : static.seqStep;
|
||||
cycles : static.cycleCounter;
|
||||
doMotion : static.doMotion;
|
||||
doMotionOld : static.doMotionOld;
|
||||
posIndex : static.posIndex;
|
||||
direction : static.direction;
|
||||
dwellCnt : static.dwellCnt;
|
||||
END_VAR
|
||||
|
||||
|
||||
var errorCode := 0;
|
||||
var intermediatePos := 0;
|
||||
var pos := 0;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Initialization
|
||||
# --------------------------------------------------
|
||||
|
||||
if(${SELF}.firstscan){
|
||||
step := 0;
|
||||
cycles := 0;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
dwellCnt := 0;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Trigger start
|
||||
# --------------------------------------------------
|
||||
|
||||
if(doMotion and not(doMotionOld)){
|
||||
println('PLC position sequence started');
|
||||
step := 1;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Position lookup
|
||||
# --------------------------------------------------
|
||||
|
||||
# Intermediate gap is disabled; intermediatePos equals pos.
|
||||
# Move to pos and measure/dwell at pos.
|
||||
|
||||
intermediatePos := 0;
|
||||
pos := 0;
|
||||
|
||||
if(posIndex==0){intermediatePos:=1.0000;pos:=1.0000;}
|
||||
if(posIndex==1){intermediatePos:=1.0000;pos:=1.0000;}
|
||||
if(posIndex==2){intermediatePos:=6.0000;pos:=6.0000;}
|
||||
if(posIndex==3){intermediatePos:=11.0000;pos:=11.0000;}
|
||||
if(posIndex==4){intermediatePos:=16.0000;pos:=16.0000;}
|
||||
if(posIndex==5){intermediatePos:=21.0000;pos:=21.0000;}
|
||||
if(posIndex==6){intermediatePos:=26.0000;pos:=26.0000;}
|
||||
if(posIndex==7){intermediatePos:=31.0000;pos:=31.0000;}
|
||||
if(posIndex==8){intermediatePos:=36.0000;pos:=36.0000;}
|
||||
if(posIndex==9){intermediatePos:=41.0000;pos:=41.0000;}
|
||||
if(posIndex==10){intermediatePos:=46.0000;pos:=46.0000;}
|
||||
if(posIndex==11){intermediatePos:=51.0000;pos:=51.0000;}
|
||||
if(posIndex==12){intermediatePos:=56.0000;pos:=56.0000;}
|
||||
if(posIndex==13){intermediatePos:=61.0000;pos:=61.0000;}
|
||||
if(posIndex==14){intermediatePos:=66.0000;pos:=66.0000;}
|
||||
if(posIndex==15){intermediatePos:=71.0000;pos:=71.0000;}
|
||||
if(posIndex==16){intermediatePos:=76.0000;pos:=76.0000;}
|
||||
if(posIndex==17){intermediatePos:=81.0000;pos:=81.0000;}
|
||||
if(posIndex==18){intermediatePos:=86.0000;pos:=86.0000;}
|
||||
if(posIndex==19){intermediatePos:=86.0000;pos:=86.0000;}
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 1 - move to intermediate position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==1 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,intermediatePos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,intermediatePos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 2;
|
||||
println('Intermediate move done, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 2 - dwell at intermediate position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==2 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= INTERMEDIATE_DWELL_TIME){
|
||||
step := 3;
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 3 - move to measurement position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==3 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,pos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,pos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 4;
|
||||
|
||||
println('Measurement position reached, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 4 - dwell at measurement position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==4 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= DWELL_TIME){
|
||||
|
||||
posIndex := posIndex + direction;
|
||||
|
||||
# reached end of list
|
||||
if(posIndex >= N_POS){
|
||||
direction := -1;
|
||||
posIndex := N_POS - 2;
|
||||
};
|
||||
|
||||
# reached start of list
|
||||
if(posIndex < 0){
|
||||
|
||||
direction := 1;
|
||||
posIndex := 1;
|
||||
|
||||
cycles := cycles + 1;
|
||||
|
||||
println('Cycle completed:',cycles);
|
||||
|
||||
if(cycles >= MAX_CYCLES){
|
||||
println('Sequence completed');
|
||||
doMotion := 0;
|
||||
step := 0;
|
||||
};
|
||||
};
|
||||
|
||||
if(step<>0){
|
||||
step := 1;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
doMotionOld := doMotion;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Safety
|
||||
# --------------------------------------------------
|
||||
|
||||
if(not(myAxis.drv.enabled)){
|
||||
return [];
|
||||
};
|
||||
|
||||
if(((not(ax1.mon.lowlim) or not(ax1.mon.highlim))) or errorCode){
|
||||
mc_power(${AX_ID=1},0);
|
||||
println('Sequence ended by limit switch violation or errorcode:', errorCode);
|
||||
step := 0;
|
||||
${SELF}.enable := 0;
|
||||
};
|
||||
|
||||
@@ -0,0 +1,66 @@
|
||||
# Script used to control the FAT stage in closed-loop CSV configuration with ED7062
|
||||
require ecmccfg 11.0.8 "ENG_MODE=1, EC_RATE=500"
|
||||
require ecmccomp
|
||||
|
||||
epicsEnvSet(ECMC_SLAVE_RESET,false) # Override reset of EL5042
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=2,HW_DESC=EL5042_DC"
|
||||
|
||||
#- Shift away the 2 status bits (ST_BITS=26, OFF_BITS=2, total 28bits)
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Encoder-Generic-SSI,CH_ID=1,MACROS=MT_BITS=0,ST_BITS=24,CLK_FRQ_KHZ=1000,CODING=0,OFF_BITS=0"
|
||||
epicsEnvSet(ENC_SID,${ECMC_EC_SLAVE_NUM})
|
||||
# -------------------------------------------------------------------------------------
|
||||
# EL5042 Channel 1
|
||||
# TR-Electronic LT140-S
|
||||
# SSI / 24 bit / Binary / 1 MHz / 9 V
|
||||
# -------------------------------------------------------------------------------------
|
||||
#- To allow change to 9v, 0xF008 must be set to 0x72657375
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0xF008,0x0,0x72657375,4)"
|
||||
|
||||
# Disable status bits = TRUE
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x02,1,1)"
|
||||
# CRC invert = TRUE
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x03,1,1)"
|
||||
# CRC polynomial = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x11,0,4)"
|
||||
# Supply voltage = 9.0 V
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x12,90,1)"
|
||||
# Clock frequency = 1 MHz
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x13,9,1)"
|
||||
# Coding = Binary / Dual code
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x14,0,1)"
|
||||
# Multiturn bits = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x15,0,1)"
|
||||
# Singleturn / position bits = 24
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x16,24,1)"
|
||||
# Offset LSB bits = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x17,0,1)"
|
||||
#Mode = SSI
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x18,1,1)"
|
||||
epicsEnvSet(ECMC_SLAVE_RESET,true) # Override reset of EL5042
|
||||
|
||||
# EL2008 channel 4 supplies 24 V to the ED7062 limit switches
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=5,HW_DESC=EL2008"
|
||||
epicsEnvSet(BO_SID,${ECMC_EC_SLAVE_NUM})
|
||||
|
||||
# ED7062 two-channel stepper drive in CSV mode (EtherCAT slave position 10)
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=10,HW_DESC=ED7062_CSP"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Motor-Generic-2Phase-Stepper,CH_ID=1,MACROS='I_MAX_MA=800,I_STDBY_MA=500,U_NOM_MV=48000,L_COIL_UH=3080,R_COIL_MOHM=7500,STEPS=400'"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Drive-Generic-Ctrl-Params,CH_ID=1,MACROS='L_COIL_UH=45530,R_COIL_MOHM=15894,I_TI=29,I_KP=654,V_TI=150,V_KP=176,P_KP=10'"
|
||||
#- Must tell ecmc that channel is not used
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Generic-Ch-Not-Used, CH_ID=2"
|
||||
epicsEnvSet(DRV_SID,${ECMC_EC_SLAVE_NUM})
|
||||
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadYamlAxis.cmd, "FILE=./cfg/axis.yaml,DEV=${IOC},AX_NAME=M1,AXIS_ID=1,DRV_SID=${DRV_SID},ENC_SID=${ENC_SID},ENC_CH=01,BO_SID=${BO_SID}"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadYamlEnc.cmd, "FILE=./cfg/enc_open_loop.yaml,DEV=${IOC},ENC_SID=${DRV_SID}"
|
||||
|
||||
# PLC configuration
|
||||
# PLC code for Positioning
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}loadPLCFile.cmd "FILE=./cfg/stopBeforePosition.plc,SAMPLE_RATE_MS=500,PLC_MACROS='AX_ID=1'"
|
||||
# PLC code for Straightness Test
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadPLCFile.cmd "FILE=./cfg/straightnessTest.plc,SAMPLE_RATE_MS=500,PLC_MACROS='AX_ID=1'"
|
||||
|
||||
dbLoadRecords("ecmcPlcAnalog.db","P=$(IOC):,PORT=MC_CPU1,ASYN_NAME=plcs.plc${ECMC_PLC_ID}.static.seqStep,REC_NAME=-M${AX_ID=1}-State")
|
||||
dbLoadRecords("ecmcPlcBinary.db","P=$(IOC):,PORT=MC_CPU1,ASYN_NAME=plcs.plc${ECMC_PLC_ID}.static.doMotion,REC_NAME=-M${AX_ID=1}-DoMtn")
|
||||
|
||||
# Start motion with: caput aik-motion-pc5:Set-M1-DoMtn-RB 1
|
||||
# Stop motion with: caput aik-motion-pc5:Set-M1-DoMtn-RB 0
|
||||
@@ -0,0 +1,200 @@
|
||||
# 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:
|
||||
|
||||
- [PSI EX7062/ED7062 CSV example](https://github.com/paulscherrerinstitute/ecmccfg/tree/b30e46072f900b37f7c674aee9a77b3c18f27735/examples/PSI/best_practice/motion/stepper_incremental/ex7062_CSV)
|
||||
- [PSI CSV/CSP/CSP-PC mode documentation](https://paulscherrerinstitute.github.io/ecmccfg/manual/motion_cfg/modes_csv_csp_csp_pc/)
|
||||
- [PSI axis YAML documentation](https://paulscherrerinstitute.github.io/ecmccfg/manual/motion_cfg/axisyaml/)
|
||||
|
||||
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:
|
||||
|
||||
```text
|
||||
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 to `0.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/count` for 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
|
||||
|
||||
```sh
|
||||
# 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 declares `R_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=ED7062` matches the installed device and the available
|
||||
`ecmccfg 11.0.8` hardware 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 `attarget` as 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 loading
|
||||
- `cfg/axis.yaml` - ED7062 CSV mapping, primary SSI feedback, trajectory,
|
||||
controller, limits, and monitoring
|
||||
- `cfg/enc_open_loop.yaml` - secondary ED7062 internal counter
|
||||
- `cfg/code_2.plc` - active FAT motion sequence
|
||||
- `cfg/code.plc` - alternate older sequence, not loaded by `startup.cmd`
|
||||
|
||||
## Commissioning sequence
|
||||
|
||||
1. Confirm that the IOC loads `ECMC/ED7062_CSV/startup.cmd`.
|
||||
2. Verify that EtherCAT slave 10 is the installed ED7062 and that channel 1 is
|
||||
connected to the motor while channel 2 is unused.
|
||||
3. Resolve the motor-resistance mismatch and run the appropriate drive autotune.
|
||||
4. Confirm 9.0 V at the EL5042 connector before attaching the encoder.
|
||||
5. With motion disabled, verify SSI readiness, position, status bits, ED7062
|
||||
counter, limit inputs, and limit-switch supply.
|
||||
6. Enable at reduced current and command a very low positive motion. Confirm
|
||||
motor direction, SSI direction, `velocitySetpoint01`, and actual velocity.
|
||||
7. Verify the 500/2147483648 CSV scaling against live setpoint and velocity.
|
||||
8. Tune and validate the ECMC position controller, following error, settling,
|
||||
software limits, and stop behaviour.
|
||||
9. Test disable/re-enable counter continuity on the installed ED7062 firmware.
|
||||
10. Validate the PLC execute/busy handshake before running the complete FAT
|
||||
sequence.
|
||||
@@ -0,0 +1,101 @@
|
||||
axis: # Physical-axis configuration
|
||||
id: ${AXIS_ID=1} # Unique numeric axis identifier
|
||||
feedSwitchesOutput: ec0.s${BO_SID}.binaryOutput${BO_CH=04} # EL2008 channel 4: 24 V supply for limit switches
|
||||
type: joint # Physical motor axis
|
||||
mode: CSV # ED7062 cyclic synchronous velocity mode
|
||||
autoEnable: # Native ecmc automatic axis enable/disable
|
||||
enableTimeout: 10 # Maximum time allowed to auto-enable [s]
|
||||
disableTimeout: 10 # Idle time before automatic disable [s]
|
||||
tweakDist: 1.0
|
||||
|
||||
plc: # Axis PLC configuration
|
||||
id: 1 # PLC identifier
|
||||
enable: yes # Enable the axis PLC
|
||||
externalCommands: true # Allow the PLC to issue axis commands
|
||||
|
||||
epics:
|
||||
name: ${AX_NAME=M1}
|
||||
precision: 3
|
||||
description: OWIS Stage ED7062
|
||||
unit: mm
|
||||
motorRecord:
|
||||
syncSoftLimits: False
|
||||
fieldInit: 'RTRY=0,FOFF=Frozen'
|
||||
|
||||
|
||||
drive:
|
||||
numerator: 1 #500 # 1 mm/rev * 500 EtherCAT cycles/s
|
||||
denominator: 1048576 #2147483648 # Signed 32-bit ED7062 CSV velocity range
|
||||
type: 1 # Stepper: 0. DS402: 1 (DS402 = servos and advanced stepper drives)
|
||||
setpoint: ec0.s$(DRV_SID).velocitySetpoint01 # ED7062 CSV velocity setpoint
|
||||
control: ec0.s$(DRV_SID).driveControl01 # Control word EtherCAT entry
|
||||
status: ec0.s$(DRV_SID).driveStatus01 # Status word EtherCAT entry
|
||||
|
||||
|
||||
encoder: # Primary encoder configuration
|
||||
primary: true # Use this encoder as the primary feedback encoder
|
||||
desc: SSI # Encoder description: TR-Electronic LT140-S SSI
|
||||
numerator: 1 # Encoder scaling numerator [mm]
|
||||
denominator: 10000 # Interferometer-calibrated encoder scale [counts/mm]
|
||||
type: 1 # Encoder type: 0=incremental; 1=absolute
|
||||
bits: 24 # Total raw encoder data width [bits]
|
||||
absBits: 24 # Absolute-data width in the least-significant part of the raw value [bits]
|
||||
absOffset: -11.826 # Absolute encoder offset in engineering units [mm]
|
||||
allowOverUnderFlow: false # Disallow raw-counter wraparound for this linear encoder
|
||||
position: ec0.s$(ENC_SID).positionActual${ENC_CH=01} # EtherCAT encoder actual-position entry
|
||||
status: ec0.s$(ENC_SID).encoderStatus${ENC_CH=01} # EtherCAT encoder status-word entry; required by warning/error checks
|
||||
ready: 2 # Ready-bit index in the encoder status word
|
||||
warning: 0 # Warning-bit index in the encoder status word
|
||||
error: # Encoder-error bit indices in the status word; maximum three
|
||||
- 1 # Encoder error 0 bit
|
||||
delayComp: # Compensation for delay between setpoint output and encoder readback
|
||||
time: 0 # Compensation delay [EtherCAT cycles]
|
||||
enable: true # Enable encoder delay compensation
|
||||
|
||||
controller: # Centralized ecmc position controller driving CSV velocity
|
||||
Kp: 4 # Proportional gain
|
||||
Ki: 0.4 # Integral gain
|
||||
Kd: 0 # Derivative gain
|
||||
Kff: 1
|
||||
|
||||
trajectory: # Trajectory-generator configuration
|
||||
type: 1 # Velocity profile: 0=trapezoidal; 1=S-curve (Ruckig)
|
||||
source: 0 # Position source: 0=axis trajectory generator; 1=PLC
|
||||
axis: # Normal-motion initialization values
|
||||
velocity: 3 # Default axis velocity [mm/s]
|
||||
acceleration: 2 # Default axis acceleration [mm/s^2]
|
||||
deceleration: 2 # Default axis deceleration [mm/s^2]
|
||||
emergencyDeceleration: 10 # Emergency deceleration [mm/s^2]
|
||||
jerk: 10 # S-curve jerk [mm/s^3]
|
||||
jog: # Jog-motion initialization values
|
||||
velocity: 1 # Default jog velocity [mm/s]
|
||||
|
||||
input: # Limit, home, and external-interlock inputs
|
||||
limit: # Hardware limit-switch inputs
|
||||
forward: ec0.s$(DRV_SID).binaryInputs${DRV_CH=01}.1 # EtherCAT forward-limit input
|
||||
backward: ec0.s$(DRV_SID).binaryInputs${DRV_CH=01}.0 # EtherCAT backward-limit input
|
||||
home: 'ec0.s$(DRV_SID).ONE.0' # Home input; constant true because no home sensor is used
|
||||
interlock: 'ec0.s$(DRV_SID).ONE.0' # External interlock; constant true because none is used
|
||||
|
||||
softlimits: # ecmc software travel-limit configuration
|
||||
enable: true # Globally enable software limits
|
||||
forward: 95 # Forward software-limit position [mm]
|
||||
forwardEnable: true # Enable the forward software limit
|
||||
backward: -1 # Backward software-limit position [mm]
|
||||
backwardEnable: true # Enable the backward software limit
|
||||
|
||||
monitoring: # Axis following-error, velocity, and in-position monitoring
|
||||
lag: # Position-lag/following-error monitoring
|
||||
enable: true # Enable position-lag monitoring
|
||||
tolerance: 0.5 # Maximum permitted position lag [mm]
|
||||
time: 10 # Allowed time outside lag tolerance [EtherCAT cycles]
|
||||
velocity: # Axis velocity monitoring
|
||||
enable: true # Enable velocity monitoring
|
||||
max: 10 # Maximum permitted velocity [mm/s]
|
||||
time: # Allowed velocity-violation durations
|
||||
trajectory: 100 # Cycles before trajectory initialization is halted
|
||||
drive: 400 # Cycles before the drive is disabled
|
||||
target: # At-target/in-position monitoring
|
||||
enable: true # Enable at-target monitoring; required by the motor record
|
||||
tolerance: 0.002 # At-target position tolerance [mm]
|
||||
time: 50 # Required time inside tolerance [EtherCAT cycles]
|
||||
@@ -0,0 +1,158 @@
|
||||
#############
|
||||
# PLC multi-position motion sequence
|
||||
#
|
||||
# Motion parameters
|
||||
#
|
||||
|
||||
var VEL := 2;
|
||||
var ACC := 3;
|
||||
var DEC := 3;
|
||||
var DWELL_TIME := 12;
|
||||
var N_POS := 10; # number of scan positions, count with the 0 position :)
|
||||
var MAX_CYCLES := 5;
|
||||
|
||||
|
||||
VAR
|
||||
myAxis : ax${AX_ID=1};
|
||||
step : static.seqStep;
|
||||
cycles : static.cycleCounter;
|
||||
doMotion : static.doMotion;
|
||||
doMotionOld : static.doMotionOld;
|
||||
posIndex : static.posIndex;
|
||||
direction : static.direction;
|
||||
dwellCnt : static.dwellCnt;
|
||||
END_VAR
|
||||
|
||||
|
||||
var errorCode := 0;
|
||||
var pos := 0;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Initialization
|
||||
# --------------------------------------------------
|
||||
|
||||
if(${SELF}.firstscan){
|
||||
step := 0;
|
||||
cycles := 0;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
dwellCnt := 0;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Trigger start
|
||||
# --------------------------------------------------
|
||||
|
||||
if(doMotion and not(doMotionOld)){
|
||||
println('PLC position sequence started');
|
||||
step := 1;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Position lookup
|
||||
# --------------------------------------------------
|
||||
|
||||
pos := 0;
|
||||
|
||||
if(posIndex==0){pos:=1.0000;}
|
||||
if(posIndex==1){pos:=10.8575;}
|
||||
if(posIndex==2){pos:=20.1050;}
|
||||
if(posIndex==3){pos:=31.8050;}
|
||||
if(posIndex==4){pos:=38.3275;}
|
||||
if(posIndex==5){pos:=51.9900;}
|
||||
if(posIndex==6){pos:=57.6875;}
|
||||
if(posIndex==7){pos:=71.4650;}
|
||||
if(posIndex==8){pos:=81.2450;}
|
||||
if(posIndex==9){pos:=90.0000;}
|
||||
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 1 – move to next position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==1 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,pos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,pos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 2;
|
||||
|
||||
println('Move done, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 2 – dwell
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==2 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= DWELL_TIME){
|
||||
|
||||
posIndex := posIndex + direction;
|
||||
|
||||
# reached end of list
|
||||
if(posIndex >= N_POS){
|
||||
direction := -1;
|
||||
posIndex := N_POS - 2;
|
||||
};
|
||||
|
||||
# reached start of list
|
||||
if(posIndex < 0){
|
||||
|
||||
direction := 1;
|
||||
posIndex := 1;
|
||||
|
||||
cycles := cycles + 1;
|
||||
|
||||
println('Cycle completed:',cycles);
|
||||
|
||||
if(cycles >= MAX_CYCLES){
|
||||
println('Sequence completed');
|
||||
doMotion := 0;
|
||||
step := 0;
|
||||
};
|
||||
};
|
||||
|
||||
if(step<>0){
|
||||
step := 1;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
doMotionOld := doMotion;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Safety
|
||||
# --------------------------------------------------
|
||||
|
||||
if(not(myAxis.drv.enabled)){
|
||||
return [];
|
||||
};
|
||||
|
||||
if(((not(ax1.mon.lowlim) or not(ax1.mon.highlim))) or errorCode){
|
||||
mc_power(${AX_ID=1},0);
|
||||
println('Sequence ended by limit switch violation or errorcode:', errorCode);
|
||||
step := 0;
|
||||
${SELF}.enable := 0;
|
||||
};
|
||||
@@ -0,0 +1,203 @@
|
||||
#############
|
||||
# PLC multi-position motion sequence
|
||||
#
|
||||
# Motion parameters
|
||||
#
|
||||
|
||||
var VEL := 2;
|
||||
var ACC := 3;
|
||||
var DEC := 3;
|
||||
|
||||
var INTERMEDIATE_DWELL_TIME := 2;
|
||||
var DWELL_TIME := 12;
|
||||
var N_POS := 10; # number of calibrated measurement positions
|
||||
var MAX_CYCLES := 5;
|
||||
|
||||
VAR
|
||||
myAxis : ax${AX_ID=1};
|
||||
step : static.seqStep;
|
||||
cycles : static.cycleCounter;
|
||||
doMotion : static.doMotion;
|
||||
doMotionOld : static.doMotionOld;
|
||||
posIndex : static.posIndex;
|
||||
direction : static.direction;
|
||||
dwellCnt : static.dwellCnt;
|
||||
END_VAR
|
||||
|
||||
|
||||
var errorCode := 0;
|
||||
var intermediatePos := 0;
|
||||
var pos := 0;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Initialization
|
||||
# --------------------------------------------------
|
||||
|
||||
if(${SELF}.firstscan){
|
||||
step := 0;
|
||||
cycles := 0;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
dwellCnt := 0;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Trigger start
|
||||
# --------------------------------------------------
|
||||
|
||||
if(doMotion and not(doMotionOld)){
|
||||
println('PLC position sequence started');
|
||||
step := 1;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Position lookup
|
||||
# --------------------------------------------------
|
||||
|
||||
# For every posIndex, in forward and backward travel:
|
||||
# 1. Move to intermediatePos.
|
||||
# 2. Move to pos and measure/dwell only at pos.
|
||||
# intermediatePos is always smaller than pos.
|
||||
|
||||
intermediatePos := 0;
|
||||
pos := 0;
|
||||
|
||||
if(posIndex==0){intermediatePos:=0.8000;pos:=1.0000;}
|
||||
if(posIndex==1){intermediatePos:=10.6900;pos:=10.8900;}
|
||||
if(posIndex==2){intermediatePos:=20.5775;pos:=20.7775;}
|
||||
if(posIndex==3){intermediatePos:=30.4675;pos:=30.6675;}
|
||||
if(posIndex==4){intermediatePos:=40.3550;pos:=40.5550;}
|
||||
if(posIndex==5){intermediatePos:=50.2450;pos:=50.4450;}
|
||||
if(posIndex==6){intermediatePos:=60.1325;pos:=60.3325;}
|
||||
if(posIndex==7){intermediatePos:=70.0225;pos:=70.2225;}
|
||||
if(posIndex==8){intermediatePos:=79.9100;pos:=80.1100;}
|
||||
if(posIndex==9){intermediatePos:=89.8000;pos:=90.0000;}
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 1 - move to intermediate position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==1 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,intermediatePos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,intermediatePos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 2;
|
||||
println('Intermediate move done, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 2 - dwell at intermediate position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==2 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= INTERMEDIATE_DWELL_TIME){
|
||||
step := 3;
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 3 - move to measurement position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==3 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,pos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,pos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 4;
|
||||
|
||||
println('Measurement position reached, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 4 - dwell at measurement position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==4 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= DWELL_TIME){
|
||||
|
||||
posIndex := posIndex + direction;
|
||||
|
||||
# reached end of list
|
||||
if(posIndex >= N_POS){
|
||||
direction := -1;
|
||||
posIndex := N_POS - 2;
|
||||
};
|
||||
|
||||
# reached start of list
|
||||
if(posIndex < 0){
|
||||
|
||||
direction := 1;
|
||||
posIndex := 1;
|
||||
|
||||
cycles := cycles + 1;
|
||||
|
||||
println('Cycle completed:',cycles);
|
||||
|
||||
if(cycles >= MAX_CYCLES){
|
||||
println('Sequence completed');
|
||||
doMotion := 0;
|
||||
step := 0;
|
||||
};
|
||||
};
|
||||
|
||||
if(step<>0){
|
||||
step := 1;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
doMotionOld := doMotion;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Safety
|
||||
# --------------------------------------------------
|
||||
|
||||
if(not(myAxis.drv.enabled)){
|
||||
return [];
|
||||
};
|
||||
|
||||
if(((not(ax1.mon.lowlim) or not(ax1.mon.highlim))) or errorCode){
|
||||
mc_power(${AX_ID=1},0);
|
||||
println('Sequence ended by limit switch violation or errorcode:', errorCode);
|
||||
step := 0;
|
||||
${SELF}.enable := 0;
|
||||
};
|
||||
|
||||
@@ -0,0 +1,19 @@
|
||||
encoder: # ED7062 open-loop encoder configuration
|
||||
desc: 'Open loop' # Encoder description
|
||||
primary: false # Do not use this encoder as primary position feedback
|
||||
unit: mm # Encoder engineering unit
|
||||
numerator: 1 # 500 # Encoder scaling numerator: stage travel per motor revolution [mm/rev]
|
||||
denominator: 1048576 #2147483648 # Encoder scaling denominator: ED7062 counts per revolution
|
||||
type: 0 # Encoder type: 0=incremental; 1=absolute
|
||||
bits: 32 # Total raw encoder counter width [bits]
|
||||
absBits: 0 # Absolute-data width [bits]; zero for an incremental encoder
|
||||
absOffset: 0 # Absolute encoder offset in engineering units [mm]
|
||||
position: ec0.s$(DRV_SID).positionActual01 # EtherCAT ED7062 open-loop actual-position entry
|
||||
homing: # Referencing configuration for this incremental encoder
|
||||
refToEncIDAtStartup: 0 # At startup, reference to primary SSI encoder index 0
|
||||
type: 2 # Homing/reference sequence type
|
||||
position: 0 # Reference position in engineering units [mm]
|
||||
velocity: # Homing velocities
|
||||
to: 0.5 # Velocity toward the reference cam/sensor [mm/s]
|
||||
from: 0.25 # Velocity away from the reference cam/sensor [mm/s]
|
||||
|
||||
@@ -0,0 +1,66 @@
|
||||
# Script used to control the FAT stage in closed-loop CSV configuration with ED7062
|
||||
require ecmccfg 11.0.8 "ENG_MODE=1, EC_RATE=500"
|
||||
require ecmccomp
|
||||
|
||||
epicsEnvSet(ECMC_SLAVE_RESET,false) # Override reset of EL5042
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=2,HW_DESC=EL5042_DC"
|
||||
|
||||
#- Shift away the 2 status bits (ST_BITS=26, OFF_BITS=2, total 28bits)
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Encoder-Generic-SSI,CH_ID=1,MACROS=MT_BITS=0,ST_BITS=24,CLK_FRQ_KHZ=1000,CODING=0,OFF_BITS=0"
|
||||
epicsEnvSet(ENC_SID,${ECMC_EC_SLAVE_NUM})
|
||||
# -------------------------------------------------------------------------------------
|
||||
# EL5042 Channel 1
|
||||
# TR-Electronic LT140-S
|
||||
# SSI / 24 bit / Binary / 1 MHz / 9 V
|
||||
# -------------------------------------------------------------------------------------
|
||||
#- To allow change to 9v, 0xF008 must be set to 0x72657375
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0xF008,0x0,0x72657375,4)"
|
||||
|
||||
# Disable status bits = TRUE
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x02,1,1)"
|
||||
# CRC invert = TRUE
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x03,1,1)"
|
||||
# CRC polynomial = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x11,0,4)"
|
||||
# Supply voltage = 9.0 V
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x12,90,1)"
|
||||
# Clock frequency = 1 MHz
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x13,9,1)"
|
||||
# Coding = Binary / Dual code
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x14,0,1)"
|
||||
# Multiturn bits = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x15,0,1)"
|
||||
# Singleturn / position bits = 24
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x16,24,1)"
|
||||
# Offset LSB bits = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x17,0,1)"
|
||||
#Mode = SSI
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x18,1,1)"
|
||||
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Generic-Ch-Not-Used, CH_ID=2"
|
||||
epicsEnvSet(DRV_SID,${ECMC_EC_SLAVE_NUM})
|
||||
|
||||
epicsEnvSet(ECMC_SLAVE_RESET,true) # Override reset of EL5042
|
||||
|
||||
# EL2008 channel 4 supplies 24 V to the ED7062 limit switches
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=5,HW_DESC=EL2008"
|
||||
epicsEnvSet(BO_SID,${ECMC_EC_SLAVE_NUM})
|
||||
|
||||
# ED7062 two-channel stepper drive in CSV mode (EtherCAT slave position 10)
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=10,HW_DESC=ED7062"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Motor-Generic-2Phase-Stepper,CH_ID=1,MACROS='I_MAX_MA=800,I_STDBY_MA=500,U_NOM_MV=48000,L_COIL_UH=3080,R_COIL_MOHM=7500,STEPS=400'"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Drive-Generic-Ctrl-Params,CH_ID=1,MACROS='L_COIL_UH=45530,R_COIL_MOHM=15894,I_TI=29,I_KP=654,V_TI=150,V_KP=176,P_KP=10'"
|
||||
#- Must tell ecmc that channel is not used
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Generic-Ch-Not-Used, CH_ID=2"
|
||||
epicsEnvSet(DRV_SID,${ECMC_EC_SLAVE_NUM})
|
||||
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadYamlAxis.cmd, "FILE=./cfg/axis.yaml,DEV=${IOC},AX_NAME=M1,AXIS_ID=1,DRV_SID=${DRV_SID},ENC_SID=${ENC_SID},ENC_CH=01,BO_SID=${BO_SID}"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadYamlEnc.cmd, "FILE=./cfg/enc_open_loop.yaml,DEV=${IOC},ENC_SID=${DRV_SID}"
|
||||
|
||||
# PLC configuration
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadPLCFile.cmd "FILE=./cfg/code_2.plc,SAMPLE_RATE_MS=500,PLC_MACROS='AX_ID=1'"
|
||||
dbLoadRecords("ecmcPlcAnalog.db","P=$(IOC):,PORT=MC_CPU1,ASYN_NAME=plcs.plc${ECMC_PLC_ID}.static.seqStep,REC_NAME=-M${AX_ID=1}-State")
|
||||
dbLoadRecords("ecmcPlcBinary.db","P=$(IOC):,PORT=MC_CPU1,ASYN_NAME=plcs.plc${ECMC_PLC_ID}.static.doMotion,REC_NAME=-M${AX_ID=1}-DoMtn")
|
||||
|
||||
# Start motion with: caput aik-motion-pc5:Set-M1-DoMtn-RB 1
|
||||
# Stop motion with: caput aik-motion-pc5:Set-M1-DoMtn-RB 0
|
||||
@@ -0,0 +1,168 @@
|
||||
# OWIS stage with EL7041 and TR SSI encoder
|
||||
|
||||
This folder contains the ECMC configuration used for the OWIS linear stage with
|
||||
an EL7041-0052 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, master 0, `EC_RATE=500` |
|
||||
| Motion axis | Axis 1, EPICS name `M1`, description `OWIS stage with TR SSI encoder` |
|
||||
| Stepper terminal | EL7041-0052 at EtherCAT slave 7, configured for CSV |
|
||||
| Motor | OWIS two-phase stepper; 0.8 A maximum current, 0.5 A standby current, 48 V nominal, 7.5 ohm/phase, 400 full steps/revolution |
|
||||
| Primary feedback | TR-Electronic LT140-S on EL5042 slave 2, channel 1 |
|
||||
| Position unit | mm |
|
||||
|
||||
The EL7041 distributed-clock configuration uses `ASSIGN_ACTIVATE=0x0300`, a
|
||||
2,000,000 ns Sync0 cycle, and zero Sync0 shift.
|
||||
|
||||
## 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 described in `cfg/axis.yaml` as the measured
|
||||
encoder scale. These files do not independently establish the calibration
|
||||
uncertainty or confirm the current mechanical datum.
|
||||
|
||||
### EL7041 drive and open-loop counter
|
||||
|
||||
- CSV velocity scaling: `5 / 32768 mm/s` per raw setpoint unit
|
||||
- The source comment identifies 5 mm/s as 2000 full steps/s at 400 steps/mm.
|
||||
- Open-loop scale: `1 / 25600 mm/count`
|
||||
- Open-loop position width: 16 bits
|
||||
- The open-loop encoder is secondary; the SSI encoder is primary feedback.
|
||||
- At startup, the open-loop encoder references encoder ID 1.
|
||||
|
||||
## Axis behaviour
|
||||
|
||||
| Characteristic | Configured value |
|
||||
| --- | --- |
|
||||
| Default velocity | 2 mm/s |
|
||||
| Default acceleration/deceleration | 3 mm/s^2 |
|
||||
| Emergency deceleration | 5 mm/s^2 |
|
||||
| Jog velocity | 1 mm/s |
|
||||
| Backward software limit | -1 mm |
|
||||
| Forward software limit | 95 mm |
|
||||
| Maximum monitored velocity | 3 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 | 15 s |
|
||||
| Automatic disable delay | 15 s idle |
|
||||
|
||||
The trajectory generator is configured for an S-curve profile. Automatic
|
||||
enable at startup is disabled, and the EPICS motor record is disabled in this
|
||||
axis configuration. External axis commands remain enabled.
|
||||
|
||||
The external interlock and home inputs are constant true because no external
|
||||
interlock or home sensor is assigned. The hardware limits are read from the
|
||||
EL7041 drive status word:
|
||||
|
||||
- Backward limit: `driveStatus01.11`
|
||||
- Forward limit: `driveStatus01.12`
|
||||
|
||||
## Controller configuration
|
||||
|
||||
ECMC uses the TR SSI encoder as the primary position feedback and applies these
|
||||
controller values from `cfg/axis.yaml`:
|
||||
|
||||
| Parameter | Value |
|
||||
| --- | ---: |
|
||||
| `Kp` | 1 |
|
||||
| `Ki` | 0.1 |
|
||||
| `Kd` | 1.5 |
|
||||
| `Kff` | 1 |
|
||||
|
||||
These are configured values; the files do not show when or how they were tuned.
|
||||
|
||||
## Automatic FAT motion sequence
|
||||
|
||||
`startup.cmd` loads `cfg/code.plc` at a 500 ms PLC sample period. A rising edge
|
||||
on the `doMotion` variable starts the sequence.
|
||||
|
||||
The sequence uses:
|
||||
|
||||
- Move velocity: 2 mm/s
|
||||
- Acceleration and deceleration: 2 mm/s^2
|
||||
- Ten positions from 1.0000 mm to 90.0000 mm
|
||||
- Dwell: 12 PLC scans, nominally 6 s at each position
|
||||
- Five forward/backward cycles
|
||||
|
||||
The configured positions are:
|
||||
|
||||
```text
|
||||
1.0000 mm
|
||||
10.8575 mm
|
||||
20.1050 mm
|
||||
31.8050 mm
|
||||
38.3275 mm
|
||||
51.9900 mm
|
||||
57.6875 mm
|
||||
71.4650 mm
|
||||
81.2450 mm
|
||||
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:
|
||||
|
||||
```sh
|
||||
caput aik-motion-pc5:Set-M1-DoMtn-RB 1
|
||||
caput aik-motion-pc5:Set-M1-DoMtn-RB 0
|
||||
```
|
||||
|
||||
## Configuration caveats
|
||||
|
||||
- `ECMC_SLAVE_RESET` is set to `false` before the EL5042 is added and remains
|
||||
`false` after its SDO configuration. Confirm that retaining this reset override
|
||||
is intentional for the installed terminal and startup procedure.
|
||||
- No limit-switch feed-output mapping is enabled in `cfg/axis.yaml`; the
|
||||
`feedSwitchesOutput` line is commented out.
|
||||
- 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.
|
||||
- The 16-bit open-loop counter and its overflow behaviour should be checked over
|
||||
the required travel. No explicit overflow setting is present in
|
||||
`cfg/enc_open_loop.yaml`.
|
||||
|
||||
## Relevant files
|
||||
|
||||
- `startup.cmd` - EtherCAT slave setup, EL5042 SDOs, EL7041 motor component,
|
||||
distributed clocks, axis loading, and PLC loading
|
||||
- `cfg/axis.yaml` - axis, primary encoder, limits, trajectory, controller, and
|
||||
monitoring configuration
|
||||
- `cfg/enc_open_loop.yaml` - EL7041 secondary/open-loop encoder configuration
|
||||
- `cfg/code.plc` - active multi-position FAT sequence
|
||||
|
||||
## Checks required before operation
|
||||
|
||||
1. Verify the loaded IOC working directory and confirm that this `startup.cmd`
|
||||
and `cfg/code.plc` are the active files.
|
||||
2. Verify EL7041 channel assignment, motor phase wiring, phase resistance,
|
||||
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
|
||||
status bits and configured directions.
|
||||
8. Validate following error, settling, software limits, open-loop counter
|
||||
behaviour, and the PLC move handshake at reduced speed before running the
|
||||
complete automatic sequence.
|
||||
@@ -0,0 +1,109 @@
|
||||
axis:
|
||||
id: ${AXIS_ID=1} # Axis id
|
||||
type: joint # Physical motor axis
|
||||
mode: CSV # EL7041 velocity setpoint mode
|
||||
#feedSwitchesOutput: ec0.s${BO_SID}.binaryOutput${BO_CH=01} # Ethercat entry for feed switches
|
||||
autoEnable:
|
||||
enableTimeout: 15.0
|
||||
disableTimeout: 15.0
|
||||
atStartup: false # Enable only when motion is requested
|
||||
tweakDist: 1.0
|
||||
|
||||
plc:
|
||||
id: 1
|
||||
enable: true
|
||||
externalCommands: true
|
||||
|
||||
epics:
|
||||
name: ${AX_NAME=M1} # Axis name
|
||||
precision: 3 # Decimal count
|
||||
description: OWIS stage with TR SSI encoder # Axis description
|
||||
unit: mm # Unit
|
||||
motorRecord:
|
||||
enable: false
|
||||
description: OWIS stage with TR SSI encoder
|
||||
syncSoftLimits: false
|
||||
fieldInit: 'RTRY=0,FOFF=Frozen' # Extra config for Motor record
|
||||
|
||||
drive:
|
||||
numerator: 5 # 2000 full-steps/s at 400 steps/mm = 5 mm/s
|
||||
denominator: 32768 # I/O range for ECMC_EC_ALIAS_DRV_VELO_SET (normally +-16bit)
|
||||
type: 0 # Stepper: 0. DS402: 1 (DS402 = servos and advanced stepper drives)
|
||||
setpoint: ec0.s$(DRV_SID).velocitySetpoint01 # Velocity setpoint if CSV. Position setpoint if CSP
|
||||
control: ec0.s$(DRV_SID).driveControl01 # Control word ethercat entry
|
||||
enable: 0 # Enable bit index in control word (not used if DS402)
|
||||
reset: 1 # Reset bit in control word (if no drive reset bit then leave empty)
|
||||
reduceTorque: 2 # Reduce torque bit in drive control word
|
||||
reduceTorqueEnable: true # Enable reduce torque functionality
|
||||
status: ec0.s$(DRV_SID).driveStatus01 # Status word ethercat entry
|
||||
enabled: 1 # Enabled bit index in status word (not used if DS402)
|
||||
warning: 2 # Warning bit in status word (if no drive warning bit then leave empty)
|
||||
error: # max 3 error bits in status word
|
||||
- 3 # Error 0 (if no drive error bit then leave empty)
|
||||
- 7 # Error 1 (if no drive error bit then leave empty)
|
||||
- 14 # Error 2 (if no drive error bit then leave empty)
|
||||
|
||||
encoder:
|
||||
source: 0 # Encoder value from EtherCAT hardware
|
||||
desc: SSI
|
||||
primary: true
|
||||
numerator: 1 # Engineering-unit numerator in mm
|
||||
denominator: 10000 # Measured encoder counts per mm
|
||||
type: 1 # Type: 0=Incremental, 1=Absolute
|
||||
bits: 24 # Total bit count of encoder raw data
|
||||
absBits: 24 # Absolute bit count (for absolute encoders) always least significant part of 'bits'
|
||||
absOffset: -11.826 # Absolute encoder offset in mm
|
||||
allowOverUnderFlow: false # Linear encoder: do not wrap at raw-count limits
|
||||
position: ec0.s$(ENC_SID).positionActual${ENC_CH=01} # Ethercat entry for actual position input (encoder)
|
||||
status: ec0.s$(ENC_SID).encoderStatus${ENC_CH=01} # mandatory only if 'warning' or 'error' are used
|
||||
ready: 2 # Bit in encoder status word for encoder ready
|
||||
warning: 0 # Warning (optional)
|
||||
error: # max 3 (optional)
|
||||
- 1 # Error 0
|
||||
|
||||
controller:
|
||||
Kp: 1 # Proportional gain
|
||||
Ki: 0.1 # Ki integral gain
|
||||
Kd: 1.5 # Kd derivative gain
|
||||
Kff: 1 # Feed-forward gain
|
||||
|
||||
trajectory:
|
||||
type: 1 # 0 = trapezoidal, 1 = S-curve (Ruckig)
|
||||
source: 0 # 0 = take trajectory setpoint from axis traj object, 1 =trajectory setpoint from plc
|
||||
axis:
|
||||
velocity: 2 # Default velo for axis
|
||||
acceleration: 3 # Default acc for axis
|
||||
deceleration: 3 # Default dec for axis
|
||||
emergencyDeceleration: 5 # Deceleration when axis in error state
|
||||
jog:
|
||||
velocity: 1 # Default motor-record jog velocity
|
||||
|
||||
input:
|
||||
limit:
|
||||
forward: ec0.s$(DRV_SID).driveStatus01.12 # EL7041 forward limit input
|
||||
backward: ec0.s$(DRV_SID).driveStatus01.11 # EL7041 backward limit input
|
||||
home: 'ec0.s$(DRV_SID).ONE.0' # Ethercat entry for home switch
|
||||
interlock: 'ec0.s$(DRV_SID).ONE.0' # Ethercat entry for interlock switch input
|
||||
|
||||
softlimits:
|
||||
enable: true # Enable soft limits
|
||||
forward: 95.0 # Soft limit position fwd
|
||||
forwardEnable: true # Soft limit position fwd enable
|
||||
backward: -1.0 # Soft limit position bwd
|
||||
backwardEnable: true # Soft limit position bwd enable
|
||||
|
||||
monitoring:
|
||||
lag:
|
||||
enable: true # Enable position lag monitoring (following error)
|
||||
tolerance: 0.05 # Allowed tolerance
|
||||
time: 10 # Allowed time outside tolerance target:
|
||||
velocity:
|
||||
enable: true # Enable velocity monitoring
|
||||
max: 3 # Allowed max velocity
|
||||
time:
|
||||
trajectory: 100 # Time allowed outside max velo before system init halt
|
||||
drive: 400 # Time allowed outside max velo before system disables drive
|
||||
target:
|
||||
enable: true # Enable at target monitoring (needs to be enabled if using motor record)
|
||||
tolerance: 0.0015 # Allowed tolerance
|
||||
time: 50 # Filter time inside tolerance to be at target
|
||||
@@ -0,0 +1,156 @@
|
||||
#############
|
||||
# PLC multi-position motion sequence
|
||||
#
|
||||
# Motion parameters
|
||||
#
|
||||
|
||||
var VEL := 2;
|
||||
var ACC := 2;
|
||||
var DEC := 2;
|
||||
var DWELL_TIME := 12;
|
||||
var N_POS := 10; # number of scan positions, count with the 0 position :)
|
||||
var MAX_CYCLES := 5;
|
||||
|
||||
|
||||
VAR
|
||||
myAxis : ax${AX_ID=1};
|
||||
step : static.seqStep;
|
||||
cycles : static.cycleCounter;
|
||||
doMotion : static.doMotion;
|
||||
doMotionOld : static.doMotionOld;
|
||||
posIndex : static.posIndex;
|
||||
direction : static.direction;
|
||||
dwellCnt : static.dwellCnt;
|
||||
END_VAR
|
||||
|
||||
|
||||
var errorCode := 0;
|
||||
var pos := 0;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Initialization
|
||||
# --------------------------------------------------
|
||||
|
||||
if(${SELF}.firstscan){
|
||||
step := 0;
|
||||
cycles := 0;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
dwellCnt := 0;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Trigger start
|
||||
# --------------------------------------------------
|
||||
|
||||
if(doMotion and not(doMotionOld)){
|
||||
println('PLC position sequence started');
|
||||
step := 1;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Position lookup
|
||||
# --------------------------------------------------
|
||||
|
||||
pos := 0;
|
||||
|
||||
if(posIndex==0){pos:=1.0000;}
|
||||
if(posIndex==1){pos:=10.8575;}
|
||||
if(posIndex==2){pos:=20.1050;}
|
||||
if(posIndex==3){pos:=31.8050;}
|
||||
if(posIndex==4){pos:=38.3275;}
|
||||
if(posIndex==5){pos:=51.9900;}
|
||||
if(posIndex==6){pos:=57.6875;}
|
||||
if(posIndex==7){pos:=71.4650;}
|
||||
if(posIndex==8){pos:=81.2450;}
|
||||
if(posIndex==9){pos:=90.0000;}
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 1 – move to next position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==1 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,pos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,pos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 2;
|
||||
|
||||
println('Move done, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 2 – dwell
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==2 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= DWELL_TIME){
|
||||
|
||||
posIndex := posIndex + direction;
|
||||
|
||||
# reached end of list
|
||||
if(posIndex >= N_POS){
|
||||
direction := -1;
|
||||
posIndex := N_POS - 2;
|
||||
};
|
||||
|
||||
# reached start of list
|
||||
if(posIndex < 0){
|
||||
|
||||
direction := 1;
|
||||
posIndex := 1;
|
||||
|
||||
cycles := cycles + 1;
|
||||
|
||||
println('Cycle completed:',cycles);
|
||||
|
||||
if(cycles >= MAX_CYCLES){
|
||||
println('Sequence completed');
|
||||
doMotion := 0;
|
||||
step := 0;
|
||||
};
|
||||
};
|
||||
|
||||
if(step<>0){
|
||||
step := 1;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
doMotionOld := doMotion;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Safety
|
||||
# --------------------------------------------------
|
||||
|
||||
if(not(myAxis.drv.enabled)){
|
||||
return [];
|
||||
};
|
||||
|
||||
if(((not(ax1.mon.lowlim) or not(ax1.mon.highlim))) or errorCode){
|
||||
mc_power(${AX_ID=1},0);
|
||||
println('Sequence ended by limit switch violation or errorcode:', errorCode);
|
||||
step := 0;
|
||||
${SELF}.enable := 0;
|
||||
};
|
||||
@@ -0,0 +1,20 @@
|
||||
encoder:
|
||||
#source: 1
|
||||
desc: 'Open loop'
|
||||
primary: false
|
||||
unit: mm
|
||||
numerator: 1 # Scaling numerator
|
||||
denominator: 25600 #12800 # Scaling denominator
|
||||
type: 0 # Type: 0=Incremental, 1=Absolute
|
||||
bits: 16 # Total bit count of encoder raw data
|
||||
absBits: 0 # Absolute bit count (for absolute encoders)
|
||||
absOffset: 0 #0.036 # Encoder offset in eng units (for absolute encoders)
|
||||
position: ec0.s$(DRV_SID).positionActual01 # Ethercat entry for actual position input (encoder)
|
||||
homing:
|
||||
refToEncIDAtStartup: 0 # Ref encoder at startup (to BISS value)
|
||||
type: 2
|
||||
position: 0
|
||||
velocity:
|
||||
to: 0.5
|
||||
from: 0.25
|
||||
|
||||
@@ -0,0 +1,63 @@
|
||||
##############################################################################
|
||||
## FAT Absolute Linear Encoder
|
||||
|
||||
require ecmccfg 11.0.8 "ENG_MODE=1,MASTER_ID=0, EC_RATE=500"
|
||||
require ecmccomp
|
||||
|
||||
# -------------------------------------------------------------------------------------
|
||||
epicsEnvSet(ECMC_SLAVE_RESET,false) # Override reset of EL5042
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=2,HW_DESC=EL5042_DC"
|
||||
|
||||
#- Shift away the 2 status bits (ST_BITS=26, OFF_BITS=2, total 28bits)
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Encoder-Generic-SSI,CH_ID=1,MACROS=MT_BITS=0,ST_BITS=24,CLK_FRQ_KHZ=1000,CODING=0,OFF_BITS=0"
|
||||
epicsEnvSet(ENC_SID,${ECMC_EC_SLAVE_NUM})
|
||||
# -------------------------------------------------------------------------------------
|
||||
# EL5042 Channel 1
|
||||
# TR-Electronic LT140-S
|
||||
# SSI / 24 bit / Binary / 1 MHz / 9 V
|
||||
# -------------------------------------------------------------------------------------
|
||||
|
||||
#- To allow change to 9v, 0xF008 must be set to 0x72657375
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0xF008,0x0,0x72657375,4)"
|
||||
|
||||
# Disable status bits = TRUE
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x02,1,1)"
|
||||
# CRC invert = TRUE
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x03,1,1)"
|
||||
# CRC polynomial = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x11,0,4)"
|
||||
# Supply voltage = 9.0 V
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x12,90,1)"
|
||||
# Clock frequency = 1 MHz
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x13,9,1)"
|
||||
# Coding = Binary / Dual code
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x14,0,1)"
|
||||
# Multiturn bits = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x15,0,1)"
|
||||
# Singleturn / position bits = 24
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x16,24,1)"
|
||||
# Offset LSB bits = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x17,0,1)"
|
||||
#Mode = SSI
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x18,1,1)"
|
||||
|
||||
epicsEnvSet(ECMC_SLAVE_RESET,false) # Override reset
|
||||
# -------------------------------------------------------------------------------------
|
||||
# EL7041 1Ch Stepper
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=7,HW_DESC=EL7041-0052"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Motor-Generic-2Phase-Stepper, MACROS='I_MAX_MA=800, I_STDBY_MA=500, U_NOM_MV=48000, R_COIL_MOHM=7500, STEPS=400' "
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applySlaveDCconfig.cmd \
|
||||
"ASSIGN_ACTIVATE=0x0300,SYNC_0_CYCLE=2000000,SYNC_0_SHIFT=0"
|
||||
epicsEnvSet(DRV_SID,${ECMC_EC_SLAVE_NUM})
|
||||
# -------------------------------------------------------------------------------------
|
||||
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadYamlAxis.cmd, "FILE=./cfg/axis.yaml, DEV=${IOC}, AX_NAME=M1, AXIS_ID=1, DRV_SID=${DRV_SID}, ENC_SID=${ENC_SID}, ENC_CH=01"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadYamlEnc.cmd, "FILE=./cfg/enc_open_loop.yaml, DEV=${IOC}, DRV_SID=${DRV_SID}"
|
||||
|
||||
# PLC configuration --------------------------------------
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadPLCFile.cmd, "FILE=./cfg/code.plc, DESC='Position sequence', SAMPLE_RATE_MS=500, PLC_MACROS='AX_ID=1'"
|
||||
dbLoadRecords("ecmcPlcAnalog.db","P=$(IOC):,PORT=MC_CPU1,ASYN_NAME=plcs.plc${ECMC_PLC_ID}.static.seqStep,REC_NAME=-M${AX_ID=1}-State")
|
||||
dbLoadRecords("ecmcPlcBinary.db","P=$(IOC):,PORT=MC_CPU1,ASYN_NAME=plcs.plc${ECMC_PLC_ID}.static.doMotion,REC_NAME=-M${AX_ID=1}-DoMtn")
|
||||
#PLC_ID=0,
|
||||
# Start motion with " caput aik-motion-pc5:Set-M1-DoMtn-RB 1 "
|
||||
# Stop motion with " caput aik-motion-pc5:Set-M1-DoMtn-RB 0 "
|
||||
@@ -0,0 +1,161 @@
|
||||
# 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:
|
||||
|
||||
```text
|
||||
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:
|
||||
|
||||
```sh
|
||||
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.
|
||||
@@ -0,0 +1,105 @@
|
||||
axis: # Physical-axis configuration
|
||||
id: ${AXIS_ID=1} # Unique numeric axis identifier
|
||||
feedSwitchesOutput: ec0.s${BO_SID}.binaryOutput${BO_CH=04} # EL2008 channel 4: 24 V supply for limit switches
|
||||
type: joint # Physical motor axis
|
||||
mode: CSP # EL7062 cyclic synchronous velocity mode
|
||||
autoEnable: # Native ecmc automatic axis enable/disable
|
||||
enableTimeout: 10 # Maximum time allowed to auto-enable [s]
|
||||
disableTimeout: 10 # Idle time before automatic disable [s]
|
||||
tweakDist: 1.0
|
||||
|
||||
plc: # Axis PLC configuration
|
||||
id: 1 # PLC identifier
|
||||
enable: yes # Enable the axis PLC
|
||||
externalCommands: true # Allow the PLC to issue axis commands
|
||||
|
||||
epics:
|
||||
name: ${AX_NAME=M1}
|
||||
precision: 3
|
||||
description: OWIS Stage EL7062
|
||||
unit: mm
|
||||
motorRecord:
|
||||
syncSoftLimits: False
|
||||
fieldInit: 'RTRY=0,FOFF=Frozen'
|
||||
|
||||
|
||||
drive:
|
||||
numerator: 1 # Fastest speed in eng. units (1mm/s*8000Hz)
|
||||
denominator: 1048576 # I/O range for ECMC_EC_ALIAS_DRV_VELO_SET (normally +-16bit)
|
||||
type: 1 # Stepper: 0. DS402: 1 (DS402 = servos and advanced stepper drives)
|
||||
setpoint: ec0.s$(DRV_SID).positionSetpoint01 #ec0.s$(DRV_SID).positionSetpoint${DRV_CH=01}
|
||||
control: ec0.s$(DRV_SID).driveControl01 # Control word EtherCAT entry
|
||||
status: ec0.s$(DRV_SID).driveStatus01 # Status word EtherCAT entry
|
||||
warning: 2 # Warning bit in status word (if no drive warning bit then leave empty)
|
||||
error: # max 3 error bits in status word
|
||||
- 3 # Error 0 (if no drive error bit then leave empty)
|
||||
- 7 # Error 1 (if no drive error bit then leave empty)
|
||||
- 14 # Error 2 (if no drive error bit then leave empty)
|
||||
|
||||
encoder: # Primary encoder configuration
|
||||
primary: true # Use this encoder as the primary feedback encoder
|
||||
desc: SSI # Encoder description: TR-Electronic LT140-S SSI
|
||||
numerator: 1 # Encoder scaling numerator [mm]
|
||||
denominator: 10000 # Interferometer-calibrated encoder scale [counts/mm]
|
||||
type: 1 # Encoder type: 0=incremental; 1=absolute
|
||||
bits: 24 # Total raw encoder data width [bits]
|
||||
absBits: 24 # Absolute-data width in the least-significant part of the raw value [bits]
|
||||
absOffset: -11.826 # Absolute encoder offset in engineering units [mm]
|
||||
allowOverUnderFlow: false # Disallow raw-counter wraparound for this linear encoder
|
||||
position: ec0.s$(ENC_SID).positionActual${ENC_CH=01} # EtherCAT encoder actual-position entry
|
||||
status: ec0.s$(ENC_SID).encoderStatus${ENC_CH=01} # EtherCAT encoder status-word entry; required by warning/error checks
|
||||
ready: 2 # Ready-bit index in the encoder status word
|
||||
warning: 0 # Warning-bit index in the encoder status word
|
||||
error: # Encoder-error bit indices in the status word; maximum three
|
||||
- 1 # Encoder error 0 bit
|
||||
delayComp: # Compensation for delay between setpoint output and encoder readback
|
||||
time: 0 # Compensation delay [EtherCAT cycles]
|
||||
enable: true # Enable encoder delay compensation
|
||||
|
||||
controller: # Centralized ecmc PID controller for CSP-PC operation
|
||||
Kp: 0.02 # Proportional gain
|
||||
Ki: 0.01 # Integral gain
|
||||
Kd: 0.01 # Derivative gain
|
||||
Kff: 1
|
||||
|
||||
trajectory: # Trajectory-generator configuration
|
||||
type: 1 # Velocity profile: 0=trapezoidal; 1=S-curve (Ruckig)
|
||||
source: 0 # Position source: 0=axis trajectory generator; 1=PLC
|
||||
axis: # Normal-motion initialization values
|
||||
velocity: 2 # Default axis velocity [mm/s]
|
||||
acceleration: 2 # Default axis acceleration [mm/s^2]
|
||||
deceleration: 2 # Default axis deceleration [mm/s^2]
|
||||
emergencyDeceleration: 10 # Emergency deceleration [mm/s^2]
|
||||
jerk: 10 # S-curve jerk [mm/s^3]
|
||||
jog: # Jog-motion initialization values
|
||||
velocity: 1 # Default jog velocity [mm/s]
|
||||
|
||||
input: # Limit, home, and external-interlock inputs
|
||||
limit: # Hardware limit-switch inputs
|
||||
forward: ec0.s$(DRV_SID).binaryInputs${DRV_CH=01}.1 # EtherCAT forward-limit input
|
||||
backward: ec0.s$(DRV_SID).binaryInputs${DRV_CH=01}.0 # EtherCAT backward-limit input
|
||||
home: 'ec0.s$(DRV_SID).ONE.0' # Home input; constant true because no home sensor is used
|
||||
interlock: 'ec0.s$(DRV_SID).ONE.0' # External interlock; constant true because none is used
|
||||
|
||||
softlimits: # ecmc software travel-limit configuration
|
||||
enable: true # Globally enable software limits
|
||||
forward: 95 # Forward software-limit position [mm]
|
||||
forwardEnable: true # Enable the forward software limit
|
||||
backward: -1 # Backward software-limit position [mm]
|
||||
backwardEnable: true # Enable the backward software limit
|
||||
|
||||
monitoring: # Axis following-error, velocity, and in-position monitoring
|
||||
lag: # Position-lag/following-error monitoring
|
||||
enable: true # Enable position-lag monitoring
|
||||
tolerance: 0.05 # Maximum permitted position lag [mm]
|
||||
time: 10 # Allowed time outside lag tolerance [EtherCAT cycles]
|
||||
velocity: # Axis velocity monitoring
|
||||
enable: true # Enable velocity monitoring
|
||||
max: 3 # Maximum permitted velocity [mm/s]
|
||||
time: # Allowed velocity-violation durations
|
||||
trajectory: 100 # Cycles before trajectory initialization is halted
|
||||
drive: 400 # Cycles before the drive is disabled
|
||||
target: # At-target/in-position monitoring
|
||||
enable: true # Enable at-target monitoring; required by the motor record
|
||||
tolerance: 0.0015 # At-target position tolerance [mm]
|
||||
time: 50 # Required time inside tolerance [EtherCAT cycles]
|
||||
@@ -0,0 +1,158 @@
|
||||
#############
|
||||
# PLC multi-position motion sequence
|
||||
#
|
||||
# Motion parameters
|
||||
#
|
||||
|
||||
var VEL := 2;
|
||||
var ACC := 3;
|
||||
var DEC := 3;
|
||||
var DWELL_TIME := 12;
|
||||
var N_POS := 10; # number of scan positions, count with the 0 position :)
|
||||
var MAX_CYCLES := 5;
|
||||
|
||||
|
||||
VAR
|
||||
myAxis : ax${AX_ID=1};
|
||||
step : static.seqStep;
|
||||
cycles : static.cycleCounter;
|
||||
doMotion : static.doMotion;
|
||||
doMotionOld : static.doMotionOld;
|
||||
posIndex : static.posIndex;
|
||||
direction : static.direction;
|
||||
dwellCnt : static.dwellCnt;
|
||||
END_VAR
|
||||
|
||||
|
||||
var errorCode := 0;
|
||||
var pos := 0;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Initialization
|
||||
# --------------------------------------------------
|
||||
|
||||
if(${SELF}.firstscan){
|
||||
step := 0;
|
||||
cycles := 0;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
dwellCnt := 0;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Trigger start
|
||||
# --------------------------------------------------
|
||||
|
||||
if(doMotion and not(doMotionOld)){
|
||||
println('PLC position sequence started');
|
||||
step := 1;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Position lookup
|
||||
# --------------------------------------------------
|
||||
|
||||
pos := 0;
|
||||
|
||||
if(posIndex==0){pos:=1.0000;}
|
||||
if(posIndex==1){pos:=10.8575;}
|
||||
if(posIndex==2){pos:=20.1050;}
|
||||
if(posIndex==3){pos:=31.8050;}
|
||||
if(posIndex==4){pos:=38.3275;}
|
||||
if(posIndex==5){pos:=51.9900;}
|
||||
if(posIndex==6){pos:=57.6875;}
|
||||
if(posIndex==7){pos:=71.4650;}
|
||||
if(posIndex==8){pos:=81.2450;}
|
||||
if(posIndex==9){pos:=90.0000;}
|
||||
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 1 – move to next position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==1 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,pos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,pos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 2;
|
||||
|
||||
println('Move done, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 2 – dwell
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==2 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= DWELL_TIME){
|
||||
|
||||
posIndex := posIndex + direction;
|
||||
|
||||
# reached end of list
|
||||
if(posIndex >= N_POS){
|
||||
direction := -1;
|
||||
posIndex := N_POS - 2;
|
||||
};
|
||||
|
||||
# reached start of list
|
||||
if(posIndex < 0){
|
||||
|
||||
direction := 1;
|
||||
posIndex := 1;
|
||||
|
||||
cycles := cycles + 1;
|
||||
|
||||
println('Cycle completed:',cycles);
|
||||
|
||||
if(cycles >= MAX_CYCLES){
|
||||
println('Sequence completed');
|
||||
doMotion := 0;
|
||||
step := 0;
|
||||
};
|
||||
};
|
||||
|
||||
if(step<>0){
|
||||
step := 1;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
doMotionOld := doMotion;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Safety
|
||||
# --------------------------------------------------
|
||||
|
||||
if(not(myAxis.drv.enabled)){
|
||||
return [];
|
||||
};
|
||||
|
||||
if(((not(ax1.mon.lowlim) or not(ax1.mon.highlim))) or errorCode){
|
||||
mc_power(${AX_ID=1},0);
|
||||
println('Sequence ended by limit switch violation or errorcode:', errorCode);
|
||||
step := 0;
|
||||
${SELF}.enable := 0;
|
||||
};
|
||||
@@ -0,0 +1,203 @@
|
||||
#############
|
||||
# PLC multi-position motion sequence
|
||||
#
|
||||
# Motion parameters
|
||||
#
|
||||
|
||||
var VEL := 2;
|
||||
var ACC := 3;
|
||||
var DEC := 3;
|
||||
|
||||
var INTERMEDIATE_DWELL_TIME := 2;
|
||||
var DWELL_TIME := 12;
|
||||
var N_POS := 10; # number of calibrated measurement positions
|
||||
var MAX_CYCLES := 5;
|
||||
|
||||
VAR
|
||||
myAxis : ax${AX_ID=1};
|
||||
step : static.seqStep;
|
||||
cycles : static.cycleCounter;
|
||||
doMotion : static.doMotion;
|
||||
doMotionOld : static.doMotionOld;
|
||||
posIndex : static.posIndex;
|
||||
direction : static.direction;
|
||||
dwellCnt : static.dwellCnt;
|
||||
END_VAR
|
||||
|
||||
|
||||
var errorCode := 0;
|
||||
var intermediatePos := 0;
|
||||
var pos := 0;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Initialization
|
||||
# --------------------------------------------------
|
||||
|
||||
if(${SELF}.firstscan){
|
||||
step := 0;
|
||||
cycles := 0;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
dwellCnt := 0;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Trigger start
|
||||
# --------------------------------------------------
|
||||
|
||||
if(doMotion and not(doMotionOld)){
|
||||
println('PLC position sequence started');
|
||||
step := 1;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Position lookup
|
||||
# --------------------------------------------------
|
||||
|
||||
# For every posIndex, in forward and backward travel:
|
||||
# 1. Move to intermediatePos.
|
||||
# 2. Move to pos and measure/dwell only at pos.
|
||||
# intermediatePos is always smaller than pos.
|
||||
|
||||
intermediatePos := 0;
|
||||
pos := 0;
|
||||
|
||||
if(posIndex==0){intermediatePos:=0.8000;pos:=1.0000;}
|
||||
if(posIndex==1){intermediatePos:=10.6900;pos:=10.8900;}
|
||||
if(posIndex==2){intermediatePos:=20.5775;pos:=20.7775;}
|
||||
if(posIndex==3){intermediatePos:=30.4675;pos:=30.6675;}
|
||||
if(posIndex==4){intermediatePos:=40.3550;pos:=40.5550;}
|
||||
if(posIndex==5){intermediatePos:=50.2450;pos:=50.4450;}
|
||||
if(posIndex==6){intermediatePos:=60.1325;pos:=60.3325;}
|
||||
if(posIndex==7){intermediatePos:=70.0225;pos:=70.2225;}
|
||||
if(posIndex==8){intermediatePos:=79.9100;pos:=80.1100;}
|
||||
if(posIndex==9){intermediatePos:=89.8000;pos:=90.0000;}
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 1 - move to intermediate position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==1 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,intermediatePos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,intermediatePos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 2;
|
||||
println('Intermediate move done, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 2 - dwell at intermediate position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==2 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= INTERMEDIATE_DWELL_TIME){
|
||||
step := 3;
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 3 - move to measurement position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==3 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,pos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,pos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 4;
|
||||
|
||||
println('Measurement position reached, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 4 - dwell at measurement position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==4 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= DWELL_TIME){
|
||||
|
||||
posIndex := posIndex + direction;
|
||||
|
||||
# reached end of list
|
||||
if(posIndex >= N_POS){
|
||||
direction := -1;
|
||||
posIndex := N_POS - 2;
|
||||
};
|
||||
|
||||
# reached start of list
|
||||
if(posIndex < 0){
|
||||
|
||||
direction := 1;
|
||||
posIndex := 1;
|
||||
|
||||
cycles := cycles + 1;
|
||||
|
||||
println('Cycle completed:',cycles);
|
||||
|
||||
if(cycles >= MAX_CYCLES){
|
||||
println('Sequence completed');
|
||||
doMotion := 0;
|
||||
step := 0;
|
||||
};
|
||||
};
|
||||
|
||||
if(step<>0){
|
||||
step := 1;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
doMotionOld := doMotion;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Safety
|
||||
# --------------------------------------------------
|
||||
|
||||
if(not(myAxis.drv.enabled)){
|
||||
return [];
|
||||
};
|
||||
|
||||
if(((not(ax1.mon.lowlim) or not(ax1.mon.highlim))) or errorCode){
|
||||
mc_power(${AX_ID=1},0);
|
||||
println('Sequence ended by limit switch violation or errorcode:', errorCode);
|
||||
step := 0;
|
||||
${SELF}.enable := 0;
|
||||
};
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
encoder: # EL7062 open-loop encoder configuration
|
||||
desc: 'Open loop' # Encoder description
|
||||
primary: false # Do not use this encoder as primary position feedback
|
||||
unit: mm # Encoder engineering unit
|
||||
numerator: 1 # Encoder scaling numerator: stage travel per motor revolution [mm/rev]
|
||||
denominator: 1048576 # Encoder scaling denominator: EL7062 CSP units per revolution
|
||||
type: 0 # Encoder type: 0=incremental; 1=absolute
|
||||
bits: 32 # Total raw encoder counter width [bits]
|
||||
absBits: 0 # Absolute-data width [bits]; zero for an incremental encoder
|
||||
absOffset: 0 # Absolute encoder offset in engineering units [mm]
|
||||
position: ec0.s$(DRV_SID).positionActual01 # EtherCAT EL7062 open-loop actual-position entry
|
||||
homing: # Referencing configuration for this incremental encoder
|
||||
refToEncIDAtStartup: 0 # At startup, reference to the actual position of encoder ID 1
|
||||
type: 2 # Homing/reference sequence type
|
||||
position: 0 # Reference position in engineering units [mm]
|
||||
velocity: # Homing velocities
|
||||
to: 0.5 # Velocity toward the reference cam/sensor [mm/s]
|
||||
from: 0.25 # Velocity away from the reference cam/sensor [mm/s]
|
||||
useAsCSPDrvEnc: 1
|
||||
|
||||
@@ -0,0 +1,65 @@
|
||||
# Script used to control the FAT stage in closed-loop configuration with EL7062
|
||||
require ecmccfg 11.0.8 "ENG_MODE=1, EC_RATE=500"
|
||||
require ecmccomp
|
||||
|
||||
epicsEnvSet(ECMC_SLAVE_RESET,false) # Override reset of EL5042
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=2,HW_DESC=EL5042_DC"
|
||||
|
||||
#- Shift away the 2 status bits (ST_BITS=26, OFF_BITS=2, total 28bits)
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Encoder-Generic-SSI,CH_ID=1,MACROS=MT_BITS=0,ST_BITS=24,CLK_FRQ_KHZ=1000,CODING=0,OFF_BITS=0"
|
||||
epicsEnvSet(ENC_SID,${ECMC_EC_SLAVE_NUM})
|
||||
# -------------------------------------------------------------------------------------
|
||||
# EL5042 Channel 1
|
||||
# TR-Electronic LT140-S
|
||||
# SSI / 24 bit / Binary / 1 MHz / 9 V
|
||||
# -------------------------------------------------------------------------------------
|
||||
#- To allow change to 9v, 0xF008 must be set to 0x72657375
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0xF008,0x0,0x72657375,4)"
|
||||
|
||||
# Disable status bits = TRUE
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x02,1,1)"
|
||||
# CRC invert = TRUE
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x03,1,1)"
|
||||
# CRC polynomial = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x11,0,4)"
|
||||
# Supply voltage = 9.0 V
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x12,90,1)"
|
||||
# Clock frequency = 1 MHz
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x13,9,1)"
|
||||
# Coding = Binary / Dual code
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x14,0,1)"
|
||||
# Multiturn bits = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x15,0,1)"
|
||||
# Singleturn / position bits = 24
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x16,24,1)"
|
||||
# Offset LSB bits = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x17,0,1)"
|
||||
#Mode = SSI
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x18,1,1)"
|
||||
epicsEnvSet(ECMC_SLAVE_RESET,true) # Override reset of EL5042
|
||||
|
||||
# EL2008 channel 4 supplies 24 V to the EL7062 limit switches
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=5,HW_DESC=EL2008"
|
||||
epicsEnvSet(BO_SID,${ECMC_EC_SLAVE_NUM})
|
||||
|
||||
# EL7062 1-channel stepper drive in CSV mode (EtherCAT slave position 10)
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=10,HW_DESC=EL7062_CSP"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Motor-Generic-2Phase-Stepper,CH_ID=1,MACROS='I_MAX_MA=800,I_STDBY_MA=500,U_NOM_MV=48000,L_COIL_UH=3080,R_COIL_MOHM=7500,STEPS=400'"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Drive-Generic-Ctrl-Params,CH_ID=1,MACROS='L_COIL_UH=3080,R_COIL_MOHM=2471,I_TI=12,I_KP=58,V_TI=150,V_KP=176,P_KP=10'"
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Motor-Generic-2Phase-Stepper,CH_ID=2,MACROS='I_MAX_MA=800,I_STDBY_MA=500,U_NOM_MV=48000,L_COIL_UH=3080,R_COIL_MOHM=7500,STEPS=400'"
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Drive-Generic-Ctrl-Params,CH_ID=2,MACROS='L_COIL_UH=3080,R_COIL_MOHM=2471,I_TI=12,I_KP=58,V_TI=150,V_KP=176,P_KP=10'"
|
||||
#- Must tell ecmc that channel 02 is not used
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Generic-Ch-Not-Used, CH_ID=2'"
|
||||
|
||||
epicsEnvSet(DRV_SID,${ECMC_EC_SLAVE_NUM})
|
||||
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadYamlAxis.cmd, "FILE=./cfg/axis.yaml,DEV=${IOC},AX_NAME=M1,AXIS_ID=1,DRV_SID=${DRV_SID},ENC_SID=${ENC_SID},ENC_CH=01,BO_SID=${BO_SID}"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadYamlEnc.cmd, "FILE=./cfg/enc_open_loop.yaml,DEV=${IOC},ENC_SID=${DRV_SID}"
|
||||
|
||||
# PLC configuration
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadPLCFile.cmd "FILE=./cfg/code_2.plc,SAMPLE_RATE_MS=500,PLC_MACROS='AX_ID=1'"
|
||||
dbLoadRecords("ecmcPlcAnalog.db","P=$(IOC):,PORT=MC_CPU1,ASYN_NAME=plcs.plc${ECMC_PLC_ID}.static.seqStep,REC_NAME=-M${AX_ID=1}-State")
|
||||
dbLoadRecords("ecmcPlcBinary.db","P=$(IOC):,PORT=MC_CPU1,ASYN_NAME=plcs.plc${ECMC_PLC_ID}.static.doMotion,REC_NAME=-M${AX_ID=1}-DoMtn")
|
||||
|
||||
# Start motion with: caput aik-motion-pc5:Set-M1-DoMtn-RB 1
|
||||
# Stop motion with: caput aik-motion-pc5:Set-M1-DoMtn-RB 0
|
||||
@@ -0,0 +1,201 @@
|
||||
# OWIS stage with EL7062 CSP-PC and TR SSI encoder
|
||||
|
||||
This folder configures the OWIS linear stage in **CSP-PC** mode: cyclic
|
||||
synchronous position with dual position loops. The EL7062 closes its inner
|
||||
position loop using its internal motor-position counter, while ECMC closes an
|
||||
outer position loop using the TR-Electronic LT140-S absolute SSI linear encoder.
|
||||
|
||||
The engineering unit for the drive and both encoders is millimetres.
|
||||
|
||||
## How CSP-PC is selected
|
||||
|
||||
ECMC does not use a separate `mode: CSP_PC` YAML value. PSI documents CSP-PC as
|
||||
this combination:
|
||||
|
||||
1. Load the CSP PDO layout with `HW_DESC=EL7062_CSP`.
|
||||
2. Set the axis to `mode: CSP`.
|
||||
3. Map `positionSetpoint01` as the drive setpoint.
|
||||
4. Define the external SSI encoder as the primary encoder.
|
||||
5. Define the EL7062 internal position counter as a secondary encoder and set
|
||||
`useAsCSPDrvEnc: 1`.
|
||||
6. Configure and tune the ECMC controller for the outer position loop.
|
||||
|
||||
The defining local settings are:
|
||||
|
||||
```text
|
||||
startup.cmd: HW_DESC=EL7062_CSP
|
||||
cfg/axis.yaml: mode: CSP
|
||||
cfg/axis.yaml: setpoint: ...positionSetpoint01
|
||||
cfg/axis.yaml: primary: true # TR SSI encoder
|
||||
cfg/enc_open_loop.yaml: useAsCSPDrvEnc: 1 # EL7062 drive encoder
|
||||
```
|
||||
|
||||
References:
|
||||
|
||||
- [PSI drive modes: CSV, CSP, and CSP-PC](https://paulscherrerinstitute.github.io/ecmccfg/manual/motion_cfg/modes_csv_csp_csp_pc/)
|
||||
- [PSI EL7062/EL5042 best-practice example](https://github.com/paulscherrerinstitute/ecmccfg/tree/master/examples/PSI/best_practice/motion/stepper_bissc/el7062_el5042)
|
||||
- [PSI axis YAML controller documentation](https://paulscherrerinstitute.github.io/ecmccfg/manual/motion_cfg/axisyaml/)
|
||||
- [PSI tuning guidance](https://paulscherrerinstitute.github.io/ecmccfg/manual/knowledgebase/tuning/)
|
||||
|
||||
## Control-loop ownership
|
||||
|
||||
| Function | Location | Feedback or command |
|
||||
| --- | --- | --- |
|
||||
| Trajectory generation | ECMC | Position trajectory in mm |
|
||||
| Outer position loop | ECMC | TR SSI position versus trajectory position |
|
||||
| Inner position loop | EL7062 | EL7062 internal motor-position counter versus CSP setpoint |
|
||||
| Velocity loop | EL7062 | Drive internal |
|
||||
| Current loop | EL7062 | Drive internal |
|
||||
|
||||
ECMC adjusts the CSP position command sent to the EL7062 to correct the error
|
||||
measured by the external SSI encoder. This is the dual-position-loop behaviour
|
||||
shown in the supplied CSP-PC diagram.
|
||||
|
||||
## 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 EL7062 CSP-PC` |
|
||||
| Stepper terminal | EL7062 at EtherCAT slave 10, channel 1, CSP PDO layout |
|
||||
| Unused drive channel | EL7062 channel 2, `Generic-Ch-Not-Used` |
|
||||
| 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 |
|
||||
| Outer-loop feedback | TR-Electronic LT140-S on EL5042 slave 2, channel 1 |
|
||||
| Limit-switch supply | EL2008 slave 5, channel 4 switched output |
|
||||
| Position unit | mm |
|
||||
|
||||
## Encoder and drive scaling
|
||||
|
||||
All position signals in the two loops must use the same engineering coordinate
|
||||
system.
|
||||
|
||||
### Primary SSI encoder: ECMC outer loop
|
||||
|
||||
- SSI, 24-bit binary, 1 MHz clock
|
||||
- EL5042 supply configured to 9.0 V
|
||||
- Scale: `1 / 10000 mm/count`, or `0.1 um/count`
|
||||
- Absolute offset: `-11.826 mm`
|
||||
- Absolute encoder with wraparound disabled
|
||||
- Ready bit 2, warning bit 0, error bit 1
|
||||
|
||||
### EL7062 CSP drive encoder: inner loop
|
||||
|
||||
- Scale: `1 / 1048576 mm/count` for a 1 mm/revolution stage
|
||||
- Incremental, 32-bit position counter
|
||||
- Referenced to primary SSI encoder index 0 at startup
|
||||
- Selected with `useAsCSPDrvEnc: 1`
|
||||
|
||||
### CSP position command
|
||||
|
||||
- Scale: `1 / 1048576 mm/count`
|
||||
- Setpoint PDO: `positionSetpoint01`
|
||||
- Control/status PDOs: `driveControl01` and `driveStatus01`
|
||||
- DS402/advanced drive type: `1`
|
||||
|
||||
## Outer ECMC controller
|
||||
|
||||
The current outer-loop controller values are:
|
||||
|
||||
| Parameter | Value |
|
||||
| --- | ---: |
|
||||
| `Kp` | 0.02 |
|
||||
| `Ki` | 0.01 |
|
||||
| `Kd` | 0.01 |
|
||||
| `Kff` | 1 |
|
||||
|
||||
PSI guidance states that CSP-PC normally needs both proportional and integral
|
||||
action because ECMC and the drive each run a position loop. These copied values
|
||||
are not proof of stable tuning. Tune the EL7062 inner loops first, then tune the
|
||||
ECMC outer loop at reduced speed and current while observing both encoder errors.
|
||||
|
||||
## Motion and monitoring
|
||||
|
||||
| Characteristic | Configured value |
|
||||
| --- | --- |
|
||||
| Default velocity | 2 mm/s |
|
||||
| Default acceleration/deceleration | 2 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 | 3 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 | 10 s idle |
|
||||
|
||||
The hardware limits use EL7062 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` with a 500 ms PLC sample period. The active
|
||||
sequence is unchanged from the CSP source configuration:
|
||||
|
||||
- Velocity: 2 mm/s
|
||||
- Acceleration/deceleration: 3 mm/s^2
|
||||
- Ten measurement positions from 1.0000 mm to 90.0000 mm
|
||||
- A preliminary point 0.2 mm below each measurement position
|
||||
- Intermediate dwell: 2 scans, nominally 1 s
|
||||
- Measurement dwell: 12 scans, nominally 6 s
|
||||
- Five forward/backward cycles
|
||||
|
||||
```sh
|
||||
# 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 declares `R_COIL_MOHM=2471`. Resolve this mismatch and use EL7062
|
||||
autotune results for the installed motor before enabling motion.
|
||||
- Confirm the EL5042 output is 9.0 V and compatible with the exact encoder order
|
||||
code before connecting the encoder.
|
||||
- Confirm both position signals use the same direction, datum, and scale before
|
||||
closing the outer loop. A sign error in a closed position loop can cause
|
||||
immediate uncontrolled motion.
|
||||
- The PLC accepts busy-low plus `attarget` as move completion without first
|
||||
latching that busy became high. Validate or correct this handshake before
|
||||
unattended operation.
|
||||
- This is a static source configuration. PDO compatibility, loop stability,
|
||||
limit polarity, and safe operation require validation on the target IOC and
|
||||
hardware.
|
||||
|
||||
## Relevant files
|
||||
|
||||
- `startup.cmd` - EL5042 SDOs, EL7062 CSP hardware description, motor and drive
|
||||
parameters, axis loading, and PLC loading
|
||||
- `cfg/axis.yaml` - primary SSI encoder, CSP position mapping, outer controller,
|
||||
trajectory, limits, and monitoring
|
||||
- `cfg/enc_open_loop.yaml` - EL7062 drive encoder and CSP-PC selection
|
||||
- `cfg/code_2.plc` - active FAT motion sequence
|
||||
- `cfg/code.plc` - alternate older sequence, not loaded by `startup.cmd`
|
||||
|
||||
## Commissioning sequence
|
||||
|
||||
1. Confirm that the IOC is loading `ECMC/EL7062_CSP_PC/startup.cmd`.
|
||||
2. Verify motor phase wiring, configured current, resistance, and inductance.
|
||||
3. Run EL7062 autotune and validate the drive's inner position loop first.
|
||||
4. Confirm 9.0 V at the EL5042 connector before attaching the encoder.
|
||||
5. With the outer loop disabled, compare SSI and EL7062 position direction and
|
||||
scale through a small manually controlled displacement.
|
||||
6. Align/reference the EL7062 counter to the SSI coordinate and verify that no
|
||||
position step occurs during enable.
|
||||
7. Enable the ECMC outer loop with conservative gains, reduced current, and a
|
||||
low following-error threshold appropriate for the test.
|
||||
8. Tune `Kp` and `Ki`, adding derivative action only if measurements show it is
|
||||
needed. Verify stability at standstill, during motion, and after reversal.
|
||||
9. Exercise both hardware limits and software limits at low velocity.
|
||||
10. Validate the PLC execute/busy handshake before running the complete FAT
|
||||
sequence.
|
||||
@@ -0,0 +1,105 @@
|
||||
axis: # Physical-axis configuration
|
||||
id: ${AXIS_ID=1} # Unique numeric axis identifier
|
||||
feedSwitchesOutput: ec0.s${BO_SID}.binaryOutput${BO_CH=04} # EL2008 channel 4: 24 V supply for limit switches
|
||||
type: joint # Physical motor axis
|
||||
mode: CSP # CSP-PC uses CSP plus a designated CSP drive encoder
|
||||
autoEnable: # Native ecmc automatic axis enable/disable
|
||||
enableTimeout: 10 # Maximum time allowed to auto-enable [s]
|
||||
disableTimeout: 10 # Idle time before automatic disable [s]
|
||||
tweakDist: 1.0
|
||||
|
||||
plc: # Axis PLC configuration
|
||||
id: 1 # PLC identifier
|
||||
enable: yes # Enable the axis PLC
|
||||
externalCommands: true # Allow the PLC to issue axis commands
|
||||
|
||||
epics:
|
||||
name: ${AX_NAME=M1}
|
||||
precision: 3
|
||||
description: OWIS Stage EL7062 CSP-PC
|
||||
unit: mm
|
||||
motorRecord:
|
||||
syncSoftLimits: False
|
||||
fieldInit: 'RTRY=0,FOFF=Frozen'
|
||||
|
||||
|
||||
drive:
|
||||
numerator: 1 # Stage travel per motor revolution [mm/rev]
|
||||
denominator: 1048576 # EL7062 CSP position units per revolution
|
||||
type: 1 # Stepper: 0. DS402: 1 (DS402 = servos and advanced stepper drives)
|
||||
setpoint: ec0.s$(DRV_SID).positionSetpoint01 # CSP position setpoint to the EL7062
|
||||
control: ec0.s$(DRV_SID).driveControl01 # Control word EtherCAT entry
|
||||
status: ec0.s$(DRV_SID).driveStatus01 # Status word EtherCAT entry
|
||||
warning: 2 # Warning bit in status word (if no drive warning bit then leave empty)
|
||||
error: # max 3 error bits in status word
|
||||
- 3 # Error 0 (if no drive error bit then leave empty)
|
||||
- 7 # Error 1 (if no drive error bit then leave empty)
|
||||
- 14 # Error 2 (if no drive error bit then leave empty)
|
||||
|
||||
encoder: # Primary encoder configuration
|
||||
primary: true # Use this encoder as the primary feedback encoder
|
||||
desc: SSI # Encoder description: TR-Electronic LT140-S SSI
|
||||
numerator: 1 # Encoder scaling numerator [mm]
|
||||
denominator: 10000 # Interferometer-calibrated encoder scale [counts/mm]
|
||||
type: 1 # Encoder type: 0=incremental; 1=absolute
|
||||
bits: 24 # Total raw encoder data width [bits]
|
||||
absBits: 24 # Absolute-data width in the least-significant part of the raw value [bits]
|
||||
absOffset: -11.826 # Absolute encoder offset in engineering units [mm]
|
||||
allowOverUnderFlow: false # Disallow raw-counter wraparound for this linear encoder
|
||||
position: ec0.s$(ENC_SID).positionActual${ENC_CH=01} # EtherCAT encoder actual-position entry
|
||||
status: ec0.s$(ENC_SID).encoderStatus${ENC_CH=01} # EtherCAT encoder status-word entry; required by warning/error checks
|
||||
ready: 2 # Ready-bit index in the encoder status word
|
||||
warning: 0 # Warning-bit index in the encoder status word
|
||||
error: # Encoder-error bit indices in the status word; maximum three
|
||||
- 1 # Encoder error 0 bit
|
||||
delayComp: # Compensation for delay between setpoint output and encoder readback
|
||||
time: 0 # Compensation delay [EtherCAT cycles]
|
||||
enable: true # Enable encoder delay compensation
|
||||
|
||||
controller: # Centralized ecmc PID controller for CSP-PC operation
|
||||
Kp: 0.02 # Proportional gain
|
||||
Ki: 0.01 # Integral gain
|
||||
Kd: 0.01 # Derivative gain
|
||||
Kff: 1
|
||||
|
||||
trajectory: # Trajectory-generator configuration
|
||||
type: 1 # Velocity profile: 0=trapezoidal; 1=S-curve (Ruckig)
|
||||
source: 0 # Position source: 0=axis trajectory generator; 1=PLC
|
||||
axis: # Normal-motion initialization values
|
||||
velocity: 2 # Default axis velocity [mm/s]
|
||||
acceleration: 2 # Default axis acceleration [mm/s^2]
|
||||
deceleration: 2 # Default axis deceleration [mm/s^2]
|
||||
emergencyDeceleration: 10 # Emergency deceleration [mm/s^2]
|
||||
jerk: 10 # S-curve jerk [mm/s^3]
|
||||
jog: # Jog-motion initialization values
|
||||
velocity: 1 # Default jog velocity [mm/s]
|
||||
|
||||
input: # Limit, home, and external-interlock inputs
|
||||
limit: # Hardware limit-switch inputs
|
||||
forward: ec0.s$(DRV_SID).binaryInputs${DRV_CH=01}.1 # EtherCAT forward-limit input
|
||||
backward: ec0.s$(DRV_SID).binaryInputs${DRV_CH=01}.0 # EtherCAT backward-limit input
|
||||
home: 'ec0.s$(DRV_SID).ONE.0' # Home input; constant true because no home sensor is used
|
||||
interlock: 'ec0.s$(DRV_SID).ONE.0' # External interlock; constant true because none is used
|
||||
|
||||
softlimits: # ecmc software travel-limit configuration
|
||||
enable: true # Globally enable software limits
|
||||
forward: 95 # Forward software-limit position [mm]
|
||||
forwardEnable: true # Enable the forward software limit
|
||||
backward: -1 # Backward software-limit position [mm]
|
||||
backwardEnable: true # Enable the backward software limit
|
||||
|
||||
monitoring: # Axis following-error, velocity, and in-position monitoring
|
||||
lag: # Position-lag/following-error monitoring
|
||||
enable: true # Enable position-lag monitoring
|
||||
tolerance: 0.05 # Maximum permitted position lag [mm]
|
||||
time: 10 # Allowed time outside lag tolerance [EtherCAT cycles]
|
||||
velocity: # Axis velocity monitoring
|
||||
enable: true # Enable velocity monitoring
|
||||
max: 3 # Maximum permitted velocity [mm/s]
|
||||
time: # Allowed velocity-violation durations
|
||||
trajectory: 100 # Cycles before trajectory initialization is halted
|
||||
drive: 400 # Cycles before the drive is disabled
|
||||
target: # At-target/in-position monitoring
|
||||
enable: true # Enable at-target monitoring; required by the motor record
|
||||
tolerance: 0.0015 # At-target position tolerance [mm]
|
||||
time: 50 # Required time inside tolerance [EtherCAT cycles]
|
||||
@@ -0,0 +1,159 @@
|
||||
#############
|
||||
# PLC multi-position motion sequence
|
||||
#
|
||||
# Motion parameters
|
||||
#
|
||||
|
||||
var VEL := 2;
|
||||
var ACC := 3;
|
||||
var DEC := 3;
|
||||
var DWELL_TIME := 12;
|
||||
var N_POS := 10; # number of scan positions, count with the 0 position :)
|
||||
var MAX_CYCLES := 5;
|
||||
|
||||
|
||||
VAR
|
||||
myAxis : ax${AX_ID=1};
|
||||
step : static.seqStep;
|
||||
cycles : static.cycleCounter;
|
||||
doMotion : static.doMotion;
|
||||
doMotionOld : static.doMotionOld;
|
||||
posIndex : static.posIndex;
|
||||
direction : static.direction;
|
||||
dwellCnt : static.dwellCnt;
|
||||
END_VAR
|
||||
|
||||
|
||||
var errorCode := 0;
|
||||
var pos := 0;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Initialization
|
||||
# --------------------------------------------------
|
||||
|
||||
if(${SELF}.firstscan){
|
||||
step := 0;
|
||||
cycles := 0;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
dwellCnt := 0;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Trigger start
|
||||
# --------------------------------------------------
|
||||
|
||||
if(doMotion and not(doMotionOld)){
|
||||
println('PLC position sequence started');
|
||||
step := 1;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Position lookup
|
||||
# --------------------------------------------------
|
||||
|
||||
pos := 0;
|
||||
|
||||
if(posIndex==0){pos:=1.0000;}
|
||||
if(posIndex==1){pos:=10.8575;}
|
||||
if(posIndex==2){pos:=20.1050;}
|
||||
if(posIndex==3){pos:=31.8050;}
|
||||
if(posIndex==4){pos:=38.3275;}
|
||||
if(posIndex==5){pos:=51.9900;}
|
||||
if(posIndex==6){pos:=57.6875;}
|
||||
if(posIndex==7){pos:=71.4650;}
|
||||
if(posIndex==8){pos:=81.2450;}
|
||||
if(posIndex==9){pos:=90.0000;}
|
||||
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 1 – move to next position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==1 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,pos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,pos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 2;
|
||||
|
||||
println('Move done, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 2 – dwell
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==2 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= DWELL_TIME){
|
||||
|
||||
posIndex := posIndex + direction;
|
||||
|
||||
# reached end of list
|
||||
if(posIndex >= N_POS){
|
||||
direction := -1;
|
||||
posIndex := N_POS - 2;
|
||||
};
|
||||
|
||||
# reached start of list
|
||||
if(posIndex < 0){
|
||||
|
||||
direction := 1;
|
||||
posIndex := 1;
|
||||
|
||||
cycles := cycles + 1;
|
||||
|
||||
println('Cycle completed:',cycles);
|
||||
|
||||
if(cycles >= MAX_CYCLES){
|
||||
println('Sequence completed');
|
||||
doMotion := 0;
|
||||
step := 0;
|
||||
};
|
||||
};
|
||||
|
||||
if(step<>0){
|
||||
step := 1;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
doMotionOld := doMotion;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Safety
|
||||
# --------------------------------------------------
|
||||
|
||||
if(not(myAxis.drv.enabled)){
|
||||
return [];
|
||||
};
|
||||
|
||||
if(((not(ax1.mon.lowlim) or not(ax1.mon.highlim))) or errorCode){
|
||||
mc_power(${AX_ID=1},0);
|
||||
println('Sequence ended by limit switch violation or errorcode:', errorCode);
|
||||
step := 0;
|
||||
${SELF}.enable := 0;
|
||||
};
|
||||
|
||||
@@ -0,0 +1,204 @@
|
||||
#############
|
||||
# PLC multi-position motion sequence
|
||||
#
|
||||
# Motion parameters
|
||||
#
|
||||
|
||||
var VEL := 2;
|
||||
var ACC := 3;
|
||||
var DEC := 3;
|
||||
|
||||
var INTERMEDIATE_DWELL_TIME := 2;
|
||||
var DWELL_TIME := 12;
|
||||
var N_POS := 10; # number of calibrated measurement positions
|
||||
var MAX_CYCLES := 5;
|
||||
|
||||
VAR
|
||||
myAxis : ax${AX_ID=1};
|
||||
step : static.seqStep;
|
||||
cycles : static.cycleCounter;
|
||||
doMotion : static.doMotion;
|
||||
doMotionOld : static.doMotionOld;
|
||||
posIndex : static.posIndex;
|
||||
direction : static.direction;
|
||||
dwellCnt : static.dwellCnt;
|
||||
END_VAR
|
||||
|
||||
|
||||
var errorCode := 0;
|
||||
var intermediatePos := 0;
|
||||
var pos := 0;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Initialization
|
||||
# --------------------------------------------------
|
||||
|
||||
if(${SELF}.firstscan){
|
||||
step := 0;
|
||||
cycles := 0;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
dwellCnt := 0;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Trigger start
|
||||
# --------------------------------------------------
|
||||
|
||||
if(doMotion and not(doMotionOld)){
|
||||
println('PLC position sequence started');
|
||||
step := 1;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Position lookup
|
||||
# --------------------------------------------------
|
||||
|
||||
# For every posIndex, in forward and backward travel:
|
||||
# 1. Move to intermediatePos.
|
||||
# 2. Move to pos and measure/dwell only at pos.
|
||||
# intermediatePos is always smaller than pos.
|
||||
|
||||
intermediatePos := 0;
|
||||
pos := 0;
|
||||
|
||||
if(posIndex==0){intermediatePos:=0.8000;pos:=1.0000;}
|
||||
if(posIndex==1){intermediatePos:=10.6900;pos:=10.8900;}
|
||||
if(posIndex==2){intermediatePos:=20.5775;pos:=20.7775;}
|
||||
if(posIndex==3){intermediatePos:=30.4675;pos:=30.6675;}
|
||||
if(posIndex==4){intermediatePos:=40.3550;pos:=40.5550;}
|
||||
if(posIndex==5){intermediatePos:=50.2450;pos:=50.4450;}
|
||||
if(posIndex==6){intermediatePos:=60.1325;pos:=60.3325;}
|
||||
if(posIndex==7){intermediatePos:=70.0225;pos:=70.2225;}
|
||||
if(posIndex==8){intermediatePos:=79.9100;pos:=80.1100;}
|
||||
if(posIndex==9){intermediatePos:=89.8000;pos:=90.0000;}
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 1 - move to intermediate position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==1 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,intermediatePos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,intermediatePos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 2;
|
||||
println('Intermediate move done, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 2 - dwell at intermediate position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==2 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= INTERMEDIATE_DWELL_TIME){
|
||||
step := 3;
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 3 - move to measurement position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==3 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,pos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,pos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 4;
|
||||
|
||||
println('Measurement position reached, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 4 - dwell at measurement position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==4 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= DWELL_TIME){
|
||||
|
||||
posIndex := posIndex + direction;
|
||||
|
||||
# reached end of list
|
||||
if(posIndex >= N_POS){
|
||||
direction := -1;
|
||||
posIndex := N_POS - 2;
|
||||
};
|
||||
|
||||
# reached start of list
|
||||
if(posIndex < 0){
|
||||
|
||||
direction := 1;
|
||||
posIndex := 1;
|
||||
|
||||
cycles := cycles + 1;
|
||||
|
||||
println('Cycle completed:',cycles);
|
||||
|
||||
if(cycles >= MAX_CYCLES){
|
||||
println('Sequence completed');
|
||||
doMotion := 0;
|
||||
step := 0;
|
||||
};
|
||||
};
|
||||
|
||||
if(step<>0){
|
||||
step := 1;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
doMotionOld := doMotion;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Safety
|
||||
# --------------------------------------------------
|
||||
|
||||
if(not(myAxis.drv.enabled)){
|
||||
return [];
|
||||
};
|
||||
|
||||
if(((not(ax1.mon.lowlim) or not(ax1.mon.highlim))) or errorCode){
|
||||
mc_power(${AX_ID=1},0);
|
||||
println('Sequence ended by limit switch violation or errorcode:', errorCode);
|
||||
step := 0;
|
||||
${SELF}.enable := 0;
|
||||
};
|
||||
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
encoder: # EL7062 open-loop encoder configuration
|
||||
desc: 'CSP drive encoder' # EL7062 internal position used by the drive loop
|
||||
primary: false # Do not use this encoder as primary position feedback
|
||||
unit: mm # Encoder engineering unit
|
||||
numerator: 1 # Encoder scaling numerator: stage travel per motor revolution [mm/rev]
|
||||
denominator: 1048576 # Encoder scaling denominator: EL7062 CSP units per revolution
|
||||
type: 0 # Encoder type: 0=incremental; 1=absolute
|
||||
bits: 32 # Total raw encoder counter width [bits]
|
||||
absBits: 0 # Absolute-data width [bits]; zero for an incremental encoder
|
||||
absOffset: 0 # Absolute encoder offset in engineering units [mm]
|
||||
position: ec0.s$(DRV_SID).positionActual01 # EtherCAT EL7062 open-loop actual-position entry
|
||||
homing: # Referencing configuration for this incremental encoder
|
||||
refToEncIDAtStartup: 0 # At startup, reference to primary SSI encoder index 0
|
||||
type: 2 # Homing/reference sequence type
|
||||
position: 0 # Reference position in engineering units [mm]
|
||||
velocity: # Homing velocities
|
||||
to: 0.5 # Velocity toward the reference cam/sensor [mm/s]
|
||||
from: 0.25 # Velocity away from the reference cam/sensor [mm/s]
|
||||
useAsCSPDrvEnc: 1 # Enables the ECMC outer position loop: CSP-PC
|
||||
|
||||
@@ -0,0 +1,65 @@
|
||||
# Script used to control the FAT stage in EL7062 CSP-PC dual-position-loop mode
|
||||
require ecmccfg 11.0.8 "ENG_MODE=1, EC_RATE=500"
|
||||
require ecmccomp
|
||||
|
||||
epicsEnvSet(ECMC_SLAVE_RESET,false) # Override reset of EL5042
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=2,HW_DESC=EL5042_DC"
|
||||
|
||||
#- Shift away the 2 status bits (ST_BITS=26, OFF_BITS=2, total 28bits)
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Encoder-Generic-SSI,CH_ID=1,MACROS=MT_BITS=0,ST_BITS=24,CLK_FRQ_KHZ=1000,CODING=0,OFF_BITS=0"
|
||||
epicsEnvSet(ENC_SID,${ECMC_EC_SLAVE_NUM})
|
||||
# -------------------------------------------------------------------------------------
|
||||
# EL5042 Channel 1
|
||||
# TR-Electronic LT140-S
|
||||
# SSI / 24 bit / Binary / 1 MHz / 9 V
|
||||
# -------------------------------------------------------------------------------------
|
||||
#- To allow change to 9v, 0xF008 must be set to 0x72657375
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0xF008,0x0,0x72657375,4)"
|
||||
|
||||
# Disable status bits = TRUE
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x02,1,1)"
|
||||
# CRC invert = TRUE
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x03,1,1)"
|
||||
# CRC polynomial = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x11,0,4)"
|
||||
# Supply voltage = 9.0 V
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x12,90,1)"
|
||||
# Clock frequency = 1 MHz
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x13,9,1)"
|
||||
# Coding = Binary / Dual code
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x14,0,1)"
|
||||
# Multiturn bits = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x15,0,1)"
|
||||
# Singleturn / position bits = 24
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x16,24,1)"
|
||||
# Offset LSB bits = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x17,0,1)"
|
||||
#Mode = SSI
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x18,1,1)"
|
||||
epicsEnvSet(ECMC_SLAVE_RESET,true) # Override reset of EL5042
|
||||
|
||||
# EL2008 channel 4 supplies 24 V to the EL7062 limit switches
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=5,HW_DESC=EL2008"
|
||||
epicsEnvSet(BO_SID,${ECMC_EC_SLAVE_NUM})
|
||||
|
||||
# EL7062 channel 1 in CSP with centralized ECMC position control (CSP-PC)
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=10,HW_DESC=EL7062_CSP"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Motor-Generic-2Phase-Stepper,CH_ID=1,MACROS='I_MAX_MA=800,I_STDBY_MA=500,U_NOM_MV=48000,L_COIL_UH=3080,R_COIL_MOHM=7500,STEPS=400'"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Drive-Generic-Ctrl-Params,CH_ID=1,MACROS='L_COIL_UH=3080,R_COIL_MOHM=2471,I_TI=12,I_KP=58,V_TI=150,V_KP=176,P_KP=10'"
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Motor-Generic-2Phase-Stepper,CH_ID=2,MACROS='I_MAX_MA=800,I_STDBY_MA=500,U_NOM_MV=48000,L_COIL_UH=3080,R_COIL_MOHM=7500,STEPS=400'"
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Drive-Generic-Ctrl-Params,CH_ID=2,MACROS='L_COIL_UH=3080,R_COIL_MOHM=2471,I_TI=12,I_KP=58,V_TI=150,V_KP=176,P_KP=10'"
|
||||
#- Channel 2 is unused and must be acknowledged for SDO-settings verification
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Generic-Ch-Not-Used, CH_ID=2"
|
||||
|
||||
epicsEnvSet(DRV_SID,${ECMC_EC_SLAVE_NUM})
|
||||
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadYamlAxis.cmd, "FILE=./cfg/axis.yaml,DEV=${IOC},AX_NAME=M1,AXIS_ID=1,DRV_SID=${DRV_SID},ENC_SID=${ENC_SID},ENC_CH=01,BO_SID=${BO_SID}"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadYamlEnc.cmd, "FILE=./cfg/enc_open_loop.yaml,DEV=${IOC},ENC_SID=${DRV_SID}"
|
||||
|
||||
# PLC configuration
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadPLCFile.cmd "FILE=./cfg/code_2.plc,SAMPLE_RATE_MS=500,PLC_MACROS='AX_ID=1'"
|
||||
dbLoadRecords("ecmcPlcAnalog.db","P=$(IOC):,PORT=MC_CPU1,ASYN_NAME=plcs.plc${ECMC_PLC_ID}.static.seqStep,REC_NAME=-M${AX_ID=1}-State")
|
||||
dbLoadRecords("ecmcPlcBinary.db","P=$(IOC):,PORT=MC_CPU1,ASYN_NAME=plcs.plc${ECMC_PLC_ID}.static.doMotion,REC_NAME=-M${AX_ID=1}-DoMtn")
|
||||
|
||||
# Start motion with: caput aik-motion-pc5:Set-M1-DoMtn-RB 1
|
||||
# Stop motion with: caput aik-motion-pc5:Set-M1-DoMtn-RB 0
|
||||
@@ -0,0 +1,218 @@
|
||||
# OWIS stage with EL7062 CSV and TR SSI encoder
|
||||
|
||||
This folder configures the OWIS linear stage with an EL7062 stepper terminal in
|
||||
cyclic synchronous velocity (CSV) mode. Position control is closed through the
|
||||
TR-Electronic LT140-S absolute SSI encoder. The engineering unit is millimetres.
|
||||
|
||||
## Important EL7062 CSV firmware warning
|
||||
|
||||
PSI documents an EL7062 firmware defect in CSV mode: when the drive is disabled,
|
||||
its internal open-loop counter can jump to the nearest full turn (multiples of
|
||||
`1048576` counts). The current PSI best-practice configuration for an EL7062
|
||||
with external position feedback therefore uses CSP instead of CSV.
|
||||
|
||||
Use `../EL7062_CSP` for normal operation unless the installed EL7062 firmware is
|
||||
positively identified as containing the vendor fix. Before commissioning this
|
||||
CSV variant, reproduce the enable/move/disable test at low speed and confirm
|
||||
that `positionActual01` remains continuous across disable and re-enable.
|
||||
|
||||
References reviewed at PSI `ecmccfg` commit
|
||||
[`b30e4607`](https://github.com/paulscherrerinstitute/ecmccfg/commit/b30e46072f900b37f7c674aee9a77b3c18f27735):
|
||||
|
||||
- [EL7062/EL5042 best-practice configuration](https://github.com/paulscherrerinstitute/ecmccfg/blob/b30e46072f900b37f7c674aee9a77b3c18f27735/examples/PSI/best_practice/motion/stepper_bissc/el7062_el5042/README.md)
|
||||
- [EL7062 CSV firmware-warning example](https://github.com/paulscherrerinstitute/ecmccfg/blob/b30e46072f900b37f7c674aee9a77b3c18f27735/examples/PSI/lab_setup/el7062/openloop/README.md)
|
||||
- [EL7062 closed-loop CSV lab example](https://github.com/paulscherrerinstitute/ecmccfg/tree/b30e46072f900b37f7c674aee9a77b3c18f27735/examples/PSI/lab_setup/el7062/closed_loop_bissc)
|
||||
- [EtherCAT-rate guidance](https://paulscherrerinstitute.github.io/ecmccfg/manual/general_cfg/best_practice/)
|
||||
|
||||
## CSV configuration changes
|
||||
|
||||
The CSV folder now differs from `../EL7062_CSP` in all mode-dependent settings:
|
||||
|
||||
| Setting | CSV value | Reason |
|
||||
| --- | --- | --- |
|
||||
| Hardware description | `HW_DESC=EL7062` | Loads the EL7062 CSV PDO layout |
|
||||
| Axis mode | `mode: CSV` | Selects cyclic synchronous velocity operation |
|
||||
| Drive setpoint | `velocitySetpoint01` | CSV commands velocity, not position |
|
||||
| Drive numerator | `500` | `1 mm/revolution * 500 EtherCAT cycles/second` |
|
||||
| Drive denominator | `2147483648` | Signed 32-bit CSV velocity range |
|
||||
| CSP drive encoder flag | Omitted | `useAsCSPDrvEnc` applies only to CSP |
|
||||
| Channel 2 | `Generic-Ch-Not-Used` | Completes SDO handling without configuring an absent motor |
|
||||
|
||||
The CSV drive conversion is therefore:
|
||||
|
||||
```text
|
||||
raw velocity = commanded velocity * 2147483648 / 500
|
||||
commanded velocity = raw velocity * 500 / 2147483648 mm/s
|
||||
```
|
||||
|
||||
At the configured 2 mm/s motion velocity, the nominal raw velocity command is
|
||||
approximately `8589935` counts. This calculation must be checked against the
|
||||
live command and actual-velocity entries during low-speed commissioning.
|
||||
|
||||
## 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 EL7062` |
|
||||
| Stepper terminal | EL7062 at EtherCAT slave 10, channel 1, CSV mode |
|
||||
| Unused drive channel | EL7062 channel 2, `Generic-Ch-Not-Used` |
|
||||
| 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 |
|
||||
|
||||
`EC_RATE=500` is a 500 Hz EtherCAT rate. PSI describes 100-500 Hz as a normal
|
||||
range for many motion systems.
|
||||
|
||||
## 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 to `0.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.
|
||||
|
||||
### EL7062 open-loop counter
|
||||
|
||||
- Secondary encoder; the SSI encoder remains primary feedback
|
||||
- Scale: `1 / 1048576 mm/count` for a 1 mm/revolution stage
|
||||
- Incremental, 32-bit counter
|
||||
- Referenced to the primary SSI encoder at startup (`refToEncIDAtStartup: 0`)
|
||||
- Not selected as a CSP drive encoder
|
||||
|
||||
The counter is retained for observation and comparison. It is also the signal
|
||||
affected by the documented CSV disable defect.
|
||||
|
||||
## Axis behaviour
|
||||
|
||||
| Characteristic | Configured value |
|
||||
| --- | --- |
|
||||
| Default velocity | 2 mm/s |
|
||||
| Default acceleration/deceleration | 2 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 | 3 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 | 10 s idle |
|
||||
|
||||
The centralized ECMC controller closes the position loop using the SSI encoder
|
||||
and produces the EL7062 CSV velocity command. The configured gains are:
|
||||
|
||||
| Parameter | Value |
|
||||
| --- | ---: |
|
||||
| `Kp` | 0.02 |
|
||||
| `Ki` | 0.01 |
|
||||
| `Kd` | 0.01 |
|
||||
| `Kff` | 1 |
|
||||
|
||||
PSI notes that CSV normally needs proportional gain at minimum. These local
|
||||
values are retained from the source configuration and must be tuned and verified
|
||||
with the installed mechanics.
|
||||
|
||||
The hardware limits use EL7062 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, giving a final
|
||||
positive-direction approach
|
||||
- Intermediate dwell: 2 PLC scans, nominally 1 s
|
||||
- Measurement dwell: 12 PLC scans, nominally 6 s
|
||||
- Five forward/backward cycles
|
||||
|
||||
The ten `(preliminary -> measurement)` pairs are:
|
||||
|
||||
```text
|
||||
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.
|
||||
|
||||
```sh
|
||||
# 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 controller
|
||||
component declares `R_COIL_MOHM=2471`. Resolve this mismatch before enabling
|
||||
the drive. Motor resistance, inductance, and controller parameters should be
|
||||
obtained from the installed motor and EL7062 autotune.
|
||||
- The PLC currently accepts busy-low plus `attarget` as move completion without
|
||||
first latching that busy became high. Validate the helper behaviour or add the
|
||||
established execute/busy handshake before unattended operation.
|
||||
- The configured 9.0 V EL5042 supply must be checked physically and confirmed
|
||||
against the exact encoder order code before connecting the encoder.
|
||||
- Static source consistency does not prove PDO compatibility, correct polarity,
|
||||
stable control, or safe motion on the installed hardware.
|
||||
|
||||
## Relevant files
|
||||
|
||||
- `startup.cmd` - EtherCAT slaves, SSI SDOs, CSV hardware description, motor and
|
||||
controller components, axis loading, and PLC loading
|
||||
- `cfg/axis.yaml` - CSV drive mapping, primary SSI feedback, trajectory, limits,
|
||||
controller, and monitoring
|
||||
- `cfg/enc_open_loop.yaml` - secondary EL7062 open-loop counter
|
||||
- `cfg/code_2.plc` - active multi-position FAT sequence
|
||||
- `cfg/code.plc` - alternate older sequence, not loaded by `startup.cmd`
|
||||
|
||||
## Commissioning sequence
|
||||
|
||||
1. Confirm that the IOC is loading `ECMC/EL7062_CSV/startup.cmd`.
|
||||
2. Verify the installed EL7062 firmware and resolve the CSV counter-defect gate.
|
||||
3. Confirm channel 1 motor wiring and that channel 2 is physically unused.
|
||||
4. Resolve the 7500/2471 mOhm resistance mismatch, run autotune, and apply the
|
||||
resulting motor/controller parameters.
|
||||
5. Confirm 9.0 V at the EL5042 connector before attaching the encoder.
|
||||
6. With motion disabled, verify SSI readiness, raw position, status bits, limit
|
||||
inputs, and limit-switch supply.
|
||||
7. Enable at reduced current and command a very low positive velocity. Confirm
|
||||
motor direction, SSI direction, `velocitySetpoint01`, and actual velocity.
|
||||
8. Move within one motor revolution, disable, and verify that
|
||||
`positionActual01` does not jump to a multiple of `1048576` counts.
|
||||
9. Verify following error, settling, software limits, and stop behaviour.
|
||||
10. Validate the PLC execute/busy handshake before running the complete FAT
|
||||
sequence.
|
||||
@@ -0,0 +1,105 @@
|
||||
axis: # Physical-axis configuration
|
||||
id: ${AXIS_ID=1} # Unique numeric axis identifier
|
||||
feedSwitchesOutput: ec0.s${BO_SID}.binaryOutput${BO_CH=04} # EL2008 channel 4: 24 V supply for limit switches
|
||||
type: joint # Physical motor axis
|
||||
mode: CSV # EL7062 cyclic synchronous velocity mode
|
||||
autoEnable: # Native ecmc automatic axis enable/disable
|
||||
enableTimeout: 10 # Maximum time allowed to auto-enable [s]
|
||||
disableTimeout: 10 # Idle time before automatic disable [s]
|
||||
tweakDist: 1.0
|
||||
|
||||
plc: # Axis PLC configuration
|
||||
id: 1 # PLC identifier
|
||||
enable: yes # Enable the axis PLC
|
||||
externalCommands: true # Allow the PLC to issue axis commands
|
||||
|
||||
epics:
|
||||
name: ${AX_NAME=M1}
|
||||
precision: 3
|
||||
description: OWIS Stage EL7062
|
||||
unit: mm
|
||||
motorRecord:
|
||||
syncSoftLimits: False
|
||||
fieldInit: 'RTRY=0,FOFF=Frozen'
|
||||
|
||||
|
||||
drive:
|
||||
numerator: 1 # 1 mm/rev * 500 EtherCAT cycles/s
|
||||
denominator: 1048576 #10737418 #2147483648 # Signed 32-bit EL7062 CSV velocity range
|
||||
type: 1 # Stepper: 0. DS402: 1 (DS402 = servos and advanced stepper drives)
|
||||
setpoint: ec0.s$(DRV_SID).velocitySetpoint01 # EL7062 CSV velocity setpoint
|
||||
control: ec0.s$(DRV_SID).driveControl01 # Control word EtherCAT entry
|
||||
status: ec0.s$(DRV_SID).driveStatus01 # Status word EtherCAT entry
|
||||
warning: 2 # Warning bit in status word (if no drive warning bit then leave empty)
|
||||
error: # max 3 error bits in status word
|
||||
- 3 # Error 0 (if no drive error bit then leave empty)
|
||||
- 7 # Error 1 (if no drive error bit then leave empty)
|
||||
- 14 # Error 2 (if no drive error bit then leave empty)
|
||||
|
||||
encoder: # Primary encoder configuration
|
||||
primary: true # Use this encoder as the primary feedback encoder
|
||||
desc: SSI # Encoder description: TR-Electronic LT140-S SSI
|
||||
numerator: 1 # Encoder scaling numerator [mm]
|
||||
denominator: 10000 # Interferometer-calibrated encoder scale [counts/mm]
|
||||
type: 1 # Encoder type: 0=incremental; 1=absolute
|
||||
bits: 24 # Total raw encoder data width [bits]
|
||||
absBits: 24 # Absolute-data width in the least-significant part of the raw value [bits]
|
||||
absOffset: -11.826 # Absolute encoder offset in engineering units [mm]
|
||||
allowOverUnderFlow: false # Disallow raw-counter wraparound for this linear encoder
|
||||
position: ec0.s$(ENC_SID).positionActual${ENC_CH=01} # EtherCAT encoder actual-position entry
|
||||
status: ec0.s$(ENC_SID).encoderStatus${ENC_CH=01} # EtherCAT encoder status-word entry; required by warning/error checks
|
||||
ready: 2 # Ready-bit index in the encoder status word
|
||||
warning: 0 # Warning-bit index in the encoder status word
|
||||
error: # Encoder-error bit indices in the status word; maximum three
|
||||
- 1 # Encoder error 0 bit
|
||||
delayComp: # Compensation for delay between setpoint output and encoder readback
|
||||
time: 0 # Compensation delay [EtherCAT cycles]
|
||||
enable: true # Enable encoder delay compensation
|
||||
|
||||
controller: # Centralized ecmc position controller driving CSV velocity
|
||||
Kp: 14 # Proportional gain
|
||||
Ki: 1.6 # Integral gain
|
||||
Kd: 0.5 # Derivative gain
|
||||
Kff: 1
|
||||
|
||||
trajectory: # Trajectory-generator configuration
|
||||
type: 0 # Velocity profile: 0=trapezoidal; 1=S-curve (Ruckig)
|
||||
source: 0 # Position source: 0=axis trajectory generator; 1=PLC
|
||||
axis: # Normal-motion initialization values
|
||||
velocity: 3 # Default axis velocity [mm/s]
|
||||
acceleration: 2 # Default axis acceleration [mm/s^2]
|
||||
deceleration: 2 # Default axis deceleration [mm/s^2]
|
||||
emergencyDeceleration: 10 # Emergency deceleration [mm/s^2]
|
||||
jerk: 10 # S-curve jerk [mm/s^3]
|
||||
jog: # Jog-motion initialization values
|
||||
velocity: 1 # Default jog velocity [mm/s]
|
||||
|
||||
input: # Limit, home, and external-interlock inputs
|
||||
limit: # Hardware limit-switch inputs
|
||||
forward: ec0.s$(DRV_SID).binaryInputs${DRV_CH=01}.1 # EtherCAT forward-limit input
|
||||
backward: ec0.s$(DRV_SID).binaryInputs${DRV_CH=01}.0 # EtherCAT backward-limit input
|
||||
home: 'ec0.s$(DRV_SID).ONE.0' # Home input; constant true because no home sensor is used
|
||||
interlock: 'ec0.s$(DRV_SID).ONE.0' # External interlock; constant true because none is used
|
||||
|
||||
softlimits: # ecmc software travel-limit configuration
|
||||
enable: true # Globally enable software limits
|
||||
forward: 95 # Forward software-limit position [mm]
|
||||
forwardEnable: true # Enable the forward software limit
|
||||
backward: -1 # Backward software-limit position [mm]
|
||||
backwardEnable: true # Enable the backward software limit
|
||||
|
||||
monitoring: # Axis following-error, velocity, and in-position monitoring
|
||||
lag: # Position-lag/following-error monitoring
|
||||
enable: true # Enable position-lag monitoring
|
||||
tolerance: 0.5 # Maximum permitted position lag [mm]
|
||||
time: 10 # Allowed time outside lag tolerance [EtherCAT cycles]
|
||||
velocity: # Axis velocity monitoring
|
||||
enable: true # Enable velocity monitoring
|
||||
max: 10 # Maximum permitted velocity [mm/s]
|
||||
time: # Allowed velocity-violation durations
|
||||
trajectory: 100 # Cycles before trajectory initialization is halted
|
||||
drive: 400 # Cycles before the drive is disabled
|
||||
target: # At-target/in-position monitoring
|
||||
enable: true # Enable at-target monitoring; required by the motor record
|
||||
tolerance: 0.002 # At-target position tolerance [mm]
|
||||
time: 50 # Required time inside tolerance [EtherCAT cycles]
|
||||
@@ -0,0 +1,158 @@
|
||||
#############
|
||||
# PLC multi-position motion sequence
|
||||
#
|
||||
# Motion parameters
|
||||
#
|
||||
|
||||
var VEL := 2;
|
||||
var ACC := 3;
|
||||
var DEC := 3;
|
||||
var DWELL_TIME := 12;
|
||||
var N_POS := 10; # number of scan positions, count with the 0 position :)
|
||||
var MAX_CYCLES := 5;
|
||||
|
||||
|
||||
VAR
|
||||
myAxis : ax${AX_ID=1};
|
||||
step : static.seqStep;
|
||||
cycles : static.cycleCounter;
|
||||
doMotion : static.doMotion;
|
||||
doMotionOld : static.doMotionOld;
|
||||
posIndex : static.posIndex;
|
||||
direction : static.direction;
|
||||
dwellCnt : static.dwellCnt;
|
||||
END_VAR
|
||||
|
||||
|
||||
var errorCode := 0;
|
||||
var pos := 0;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Initialization
|
||||
# --------------------------------------------------
|
||||
|
||||
if(${SELF}.firstscan){
|
||||
step := 0;
|
||||
cycles := 0;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
dwellCnt := 0;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Trigger start
|
||||
# --------------------------------------------------
|
||||
|
||||
if(doMotion and not(doMotionOld)){
|
||||
println('PLC position sequence started');
|
||||
step := 1;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Position lookup
|
||||
# --------------------------------------------------
|
||||
|
||||
pos := 0;
|
||||
|
||||
if(posIndex==0){pos:=1.0000;}
|
||||
if(posIndex==1){pos:=10.8575;}
|
||||
if(posIndex==2){pos:=20.1050;}
|
||||
if(posIndex==3){pos:=31.8050;}
|
||||
if(posIndex==4){pos:=38.3275;}
|
||||
if(posIndex==5){pos:=51.9900;}
|
||||
if(posIndex==6){pos:=57.6875;}
|
||||
if(posIndex==7){pos:=71.4650;}
|
||||
if(posIndex==8){pos:=81.2450;}
|
||||
if(posIndex==9){pos:=90.0000;}
|
||||
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 1 – move to next position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==1 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,pos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,pos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 2;
|
||||
|
||||
println('Move done, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 2 – dwell
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==2 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= DWELL_TIME){
|
||||
|
||||
posIndex := posIndex + direction;
|
||||
|
||||
# reached end of list
|
||||
if(posIndex >= N_POS){
|
||||
direction := -1;
|
||||
posIndex := N_POS - 2;
|
||||
};
|
||||
|
||||
# reached start of list
|
||||
if(posIndex < 0){
|
||||
|
||||
direction := 1;
|
||||
posIndex := 1;
|
||||
|
||||
cycles := cycles + 1;
|
||||
|
||||
println('Cycle completed:',cycles);
|
||||
|
||||
if(cycles >= MAX_CYCLES){
|
||||
println('Sequence completed');
|
||||
doMotion := 0;
|
||||
step := 0;
|
||||
};
|
||||
};
|
||||
|
||||
if(step<>0){
|
||||
step := 1;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
doMotionOld := doMotion;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Safety
|
||||
# --------------------------------------------------
|
||||
|
||||
if(not(myAxis.drv.enabled)){
|
||||
return [];
|
||||
};
|
||||
|
||||
if(((not(ax1.mon.lowlim) or not(ax1.mon.highlim))) or errorCode){
|
||||
mc_power(${AX_ID=1},0);
|
||||
println('Sequence ended by limit switch violation or errorcode:', errorCode);
|
||||
step := 0;
|
||||
${SELF}.enable := 0;
|
||||
};
|
||||
@@ -0,0 +1,203 @@
|
||||
#############
|
||||
# PLC multi-position motion sequence
|
||||
#
|
||||
# Motion parameters
|
||||
#
|
||||
|
||||
var VEL := 2;
|
||||
var ACC := 3;
|
||||
var DEC := 3;
|
||||
|
||||
var INTERMEDIATE_DWELL_TIME := 2;
|
||||
var DWELL_TIME := 12;
|
||||
var N_POS := 10; # number of calibrated measurement positions
|
||||
var MAX_CYCLES := 5;
|
||||
|
||||
VAR
|
||||
myAxis : ax${AX_ID=1};
|
||||
step : static.seqStep;
|
||||
cycles : static.cycleCounter;
|
||||
doMotion : static.doMotion;
|
||||
doMotionOld : static.doMotionOld;
|
||||
posIndex : static.posIndex;
|
||||
direction : static.direction;
|
||||
dwellCnt : static.dwellCnt;
|
||||
END_VAR
|
||||
|
||||
|
||||
var errorCode := 0;
|
||||
var intermediatePos := 0;
|
||||
var pos := 0;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Initialization
|
||||
# --------------------------------------------------
|
||||
|
||||
if(${SELF}.firstscan){
|
||||
step := 0;
|
||||
cycles := 0;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
dwellCnt := 0;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Trigger start
|
||||
# --------------------------------------------------
|
||||
|
||||
if(doMotion and not(doMotionOld)){
|
||||
println('PLC position sequence started');
|
||||
step := 1;
|
||||
posIndex := 0;
|
||||
direction := 1;
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Position lookup
|
||||
# --------------------------------------------------
|
||||
|
||||
# For every posIndex, in forward and backward travel:
|
||||
# 1. Move to intermediatePos.
|
||||
# 2. Move to pos and measure/dwell only at pos.
|
||||
# intermediatePos is always smaller than pos.
|
||||
|
||||
intermediatePos := 0;
|
||||
pos := 0;
|
||||
|
||||
if(posIndex==0){intermediatePos:=0.8000;pos:=1.0000;}
|
||||
if(posIndex==1){intermediatePos:=10.6900;pos:=10.8900;}
|
||||
if(posIndex==2){intermediatePos:=20.5775;pos:=20.7775;}
|
||||
if(posIndex==3){intermediatePos:=30.4675;pos:=30.6675;}
|
||||
if(posIndex==4){intermediatePos:=40.3550;pos:=40.5550;}
|
||||
if(posIndex==5){intermediatePos:=50.2450;pos:=50.4450;}
|
||||
if(posIndex==6){intermediatePos:=60.1325;pos:=60.3325;}
|
||||
if(posIndex==7){intermediatePos:=70.0225;pos:=70.2225;}
|
||||
if(posIndex==8){intermediatePos:=79.9100;pos:=80.1100;}
|
||||
if(posIndex==9){intermediatePos:=89.8000;pos:=90.0000;}
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 1 - move to intermediate position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==1 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,intermediatePos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,intermediatePos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 2;
|
||||
println('Intermediate move done, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 2 - dwell at intermediate position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==2 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= INTERMEDIATE_DWELL_TIME){
|
||||
step := 3;
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 3 - move to measurement position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==3 and doMotion){
|
||||
|
||||
errorCode := mc_move_abs(${AX_ID=1},1,pos,VEL,ACC,DEC);
|
||||
|
||||
if(errorCode){
|
||||
println('mc_move_abs error:',errorCode);
|
||||
${SELF}.error := errorCode;
|
||||
};
|
||||
|
||||
if(not(mc_get_busy(${AX_ID=1})) and myAxis.mon.attarget){
|
||||
|
||||
mc_move_abs(${AX_ID=1},0,pos,VEL,ACC,DEC);
|
||||
|
||||
dwellCnt := 0;
|
||||
step := 4;
|
||||
|
||||
println('Measurement position reached, index:',posIndex);
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# STEP 4 - dwell at measurement position
|
||||
# --------------------------------------------------
|
||||
|
||||
if(step==4 and doMotion){
|
||||
|
||||
dwellCnt := dwellCnt + 1;
|
||||
|
||||
if(dwellCnt >= DWELL_TIME){
|
||||
|
||||
posIndex := posIndex + direction;
|
||||
|
||||
# reached end of list
|
||||
if(posIndex >= N_POS){
|
||||
direction := -1;
|
||||
posIndex := N_POS - 2;
|
||||
};
|
||||
|
||||
# reached start of list
|
||||
if(posIndex < 0){
|
||||
|
||||
direction := 1;
|
||||
posIndex := 1;
|
||||
|
||||
cycles := cycles + 1;
|
||||
|
||||
println('Cycle completed:',cycles);
|
||||
|
||||
if(cycles >= MAX_CYCLES){
|
||||
println('Sequence completed');
|
||||
doMotion := 0;
|
||||
step := 0;
|
||||
};
|
||||
};
|
||||
|
||||
if(step<>0){
|
||||
step := 1;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
|
||||
doMotionOld := doMotion;
|
||||
|
||||
|
||||
# --------------------------------------------------
|
||||
# Safety
|
||||
# --------------------------------------------------
|
||||
|
||||
if(not(myAxis.drv.enabled)){
|
||||
return [];
|
||||
};
|
||||
|
||||
if(((not(ax1.mon.lowlim) or not(ax1.mon.highlim))) or errorCode){
|
||||
mc_power(${AX_ID=1},0);
|
||||
println('Sequence ended by limit switch violation or errorcode:', errorCode);
|
||||
step := 0;
|
||||
${SELF}.enable := 0;
|
||||
};
|
||||
|
||||
@@ -0,0 +1,19 @@
|
||||
encoder: # EL7062 open-loop encoder configuration
|
||||
desc: 'Open loop' # Encoder description
|
||||
primary: false # Do not use this encoder as primary position feedback
|
||||
unit: mm # Encoder engineering unit
|
||||
numerator: 1 # Encoder scaling numerator: stage travel per motor revolution [mm/rev]
|
||||
denominator: 1048576 # Encoder scaling denominator: EL7062 counts per revolution
|
||||
type: 0 # Encoder type: 0=incremental; 1=absolute
|
||||
bits: 32 # Total raw encoder counter width [bits]
|
||||
absBits: 0 # Absolute-data width [bits]; zero for an incremental encoder
|
||||
absOffset: 0 # Absolute encoder offset in engineering units [mm]
|
||||
position: ec0.s$(DRV_SID).positionActual01 # EtherCAT EL7062 open-loop actual-position entry
|
||||
homing: # Referencing configuration for this incremental encoder
|
||||
refToEncIDAtStartup: 0 # At startup, reference to primary SSI encoder index 0
|
||||
type: 2 # Homing/reference sequence type
|
||||
position: 0 # Reference position in engineering units [mm]
|
||||
velocity: # Homing velocities
|
||||
to: 0.5 # Velocity toward the reference cam/sensor [mm/s]
|
||||
from: 0.25 # Velocity away from the reference cam/sensor [mm/s]
|
||||
|
||||
@@ -0,0 +1,64 @@
|
||||
# Script used to control the FAT stage in closed-loop configuration with EL7062
|
||||
require ecmccfg 11.0.8 "ENG_MODE=1, EC_RATE=500"
|
||||
require ecmccomp
|
||||
|
||||
epicsEnvSet(ECMC_SLAVE_RESET,false) # Override reset of EL5042
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=2,HW_DESC=EL5042_DC"
|
||||
|
||||
#- Shift away the 2 status bits (ST_BITS=26, OFF_BITS=2, total 28bits)
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Encoder-Generic-SSI,CH_ID=1,MACROS=MT_BITS=0,ST_BITS=24,CLK_FRQ_KHZ=1000,CODING=0,OFF_BITS=0"
|
||||
epicsEnvSet(ENC_SID,${ECMC_EC_SLAVE_NUM})
|
||||
# -------------------------------------------------------------------------------------
|
||||
# EL5042 Channel 1
|
||||
# TR-Electronic LT140-S
|
||||
# SSI / 24 bit / Binary / 1 MHz / 9 V
|
||||
# -------------------------------------------------------------------------------------
|
||||
#- To allow change to 9v, 0xF008 must be set to 0x72657375
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0xF008,0x0,0x72657375,4)"
|
||||
|
||||
# Disable status bits = TRUE
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x02,1,1)"
|
||||
# CRC invert = TRUE
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x03,1,1)"
|
||||
# CRC polynomial = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x11,0,4)"
|
||||
# Supply voltage = 9.0 V
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x12,90,1)"
|
||||
# Clock frequency = 1 MHz
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x13,9,1)"
|
||||
# Coding = Binary / Dual code
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x14,0,1)"
|
||||
# Multiturn bits = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x15,0,1)"
|
||||
# Singleturn / position bits = 24
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x16,24,1)"
|
||||
# Offset LSB bits = 0
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x17,0,1)"
|
||||
#Mode = SSI
|
||||
ecmcConfigOrDie "Cfg.EcAddSdo(${ECMC_EC_SLAVE_NUM},0x8008,0x18,1,1)"
|
||||
epicsEnvSet(ECMC_SLAVE_RESET,true) # Override reset of EL5042
|
||||
|
||||
# EL2008 channel 4 supplies 24 V to the EL7062 limit switches
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=5,HW_DESC=EL2008"
|
||||
epicsEnvSet(BO_SID,${ECMC_EC_SLAVE_NUM})
|
||||
|
||||
# EL7062 two-channel stepper drive in CSV mode (EtherCAT slave position 10)
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}addSlave.cmd, "SLAVE_ID=10,HW_DESC=EL7062"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Motor-Generic-2Phase-Stepper,CH_ID=1,MACROS='I_MAX_MA=800,I_STDBY_MA=500,U_NOM_MV=48000,L_COIL_UH=3080,R_COIL_MOHM=7500,STEPS=400'"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Drive-Generic-Ctrl-Params,CH_ID=1,MACROS='L_COIL_UH=3080,R_COIL_MOHM=2471,I_TI=12,I_KP=58,V_TI=150,V_KP=176,P_KP=10'"
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Motor-Generic-2Phase-Stepper,CH_ID=2,MACROS='I_MAX_MA=800,I_STDBY_MA=500,U_NOM_MV=48000,L_COIL_UH=3080,R_COIL_MOHM=7500,STEPS=400'"
|
||||
#${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Drive-Generic-Ctrl-Params,CH_ID=2,MACROS='L_COIL_UH=3080,R_COIL_MOHM=2471,I_TI=12,I_KP=58,V_TI=150,V_KP=176,P_KP=10'"
|
||||
#- Must tell ecmc that channel is not used
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}applyComponent.cmd "COMP=Generic-Ch-Not-Used, CH_ID=2"
|
||||
epicsEnvSet(DRV_SID,${ECMC_EC_SLAVE_NUM})
|
||||
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadYamlAxis.cmd, "FILE=./cfg/axis.yaml,DEV=${IOC},AX_NAME=M1,AXIS_ID=1,DRV_SID=${DRV_SID},ENC_SID=${ENC_SID},ENC_CH=01,BO_SID=${BO_SID}"
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadYamlEnc.cmd, "FILE=./cfg/enc_open_loop.yaml,DEV=${IOC},ENC_SID=${DRV_SID}"
|
||||
|
||||
# PLC configuration
|
||||
${SCRIPTEXEC} ${ecmccfg_DIR}loadPLCFile.cmd "FILE=./cfg/code_2.plc,SAMPLE_RATE_MS=500,PLC_MACROS='AX_ID=1'"
|
||||
dbLoadRecords("ecmcPlcAnalog.db","P=$(IOC):,PORT=MC_CPU1,ASYN_NAME=plcs.plc${ECMC_PLC_ID}.static.seqStep,REC_NAME=-M${AX_ID=1}-State")
|
||||
dbLoadRecords("ecmcPlcBinary.db","P=$(IOC):,PORT=MC_CPU1,ASYN_NAME=plcs.plc${ECMC_PLC_ID}.static.doMotion,REC_NAME=-M${AX_ID=1}-DoMtn")
|
||||
|
||||
# Start motion with: caput aik-motion-pc5:Set-M1-DoMtn-RB 1
|
||||
# Stop motion with: caput aik-motion-pc5:Set-M1-DoMtn-RB 0
|
||||
@@ -0,0 +1,11 @@
|
||||
# ECMC evidence
|
||||
|
||||
Use this folder for project-specific ECMC configuration, controller settings,
|
||||
revision records, and relevant logs. Preserve exact filenames and distinguish
|
||||
configured or commanded values from measured stage behavior.
|
||||
|
||||
Command examples and configuration files are evidence only during report
|
||||
preparation. Do not execute them to generate a report or infer that hardware
|
||||
behavior has been verified.
|
||||
|
||||
The report instructions are in [`../Report/AGENTS.md`](../Report/AGENTS.md).
|
||||
@@ -0,0 +1,22 @@
|
||||
#Python Environment SLSLC
|
||||
source /psi.ch/group/8315/python/tcr/bin/activate
|
||||
|
||||
------------------------------------
|
||||
#Copy files from ioc to lx-term
|
||||
scp -r garcia_h@slslc:/ioc/hosts/aik-motion-pc5/temp_control /home/garcia_h/Documents
|
||||
|
||||
------------------------------------
|
||||
#Expose PV to terminal
|
||||
export EPICS_CA_ADDR_LIST=129.129.181.171
|
||||
#or
|
||||
export EPICS_CA_ADDR_LIST=aik-motion-pc5
|
||||
|
||||
------------------------------------
|
||||
#Open ECMC/GUI
|
||||
caqtdm -macro IOC=aik-motion-pc5 ecmcMain.ui
|
||||
|
||||
------------------------------------
|
||||
#Run IOC command
|
||||
sudo iocsh -7.0.9 startup.cmd
|
||||
|
||||
------------------------------------
|
||||
|
After Width: | Height: | Size: 3.2 MiB |
@@ -0,0 +1,7 @@
|
||||
# Encoder evidence
|
||||
|
||||
Use this folder for project-specific evidence about the stage encoder and its interface. Preserve source files and record the exact model, revision, resolution, scaling, and interface details from traceable sources.
|
||||
|
||||
Include relevant manufacturer documentation, configuration records, and calibration or measurement evidence when available. Distinguish encoder resolution and configured scaling from measured minimum incremental motion, repeatability, accuracy, and measurement uncertainty.
|
||||
|
||||
The report instructions are in [`../Report/AGENTS.md`](../Report/AGENTS.md). The report image for the encoder belongs in `../Media/` as `I2` with a supported image extension; do not substitute a different component image.
|
||||
@@ -0,0 +1,7 @@
|
||||
# Measurement evidence
|
||||
|
||||
Place the original measurement report PDFs for this FAT in this folder. The report workflow attaches every PDF present here as complete appendix pages, so include only evidence intended for the report and retain the original filenames and contents.
|
||||
|
||||
Keep raw data and analysis files here when they are part of the project evidence. In the report, list each raw and analysis file by its exact basename. Do not rely on a file count alone. Identify failed, superseded, or anomalous runs and explain their status in the report; do not silently omit them.
|
||||
|
||||
Before report preparation, confirm that each PDF is the correct, complete source and that applicable acceptance criteria, calibration status, and uncertainty evidence are available. See [`../Report/AGENTS.md`](../Report/AGENTS.md) for the full workflow.
|
||||
@@ -0,0 +1,201 @@
|
||||
<Option Description File - Rev. 1.00a - Keysight E1733A 1.14.1 (Win64)>
|
||||
UserSetup
|
||||
|
||||
Identify=MeaType,Choosing=0
|
||||
Identify=FileName,ItemText=OWIS_stageTR_Electronics_FAT_ISO230_Stepper_ED7062_CSP_EL5042_DC_ClosedLoop_SCurve_gap.Lin
|
||||
Identify=MergedFile,ItemText=
|
||||
Identify=CaliPeriod,"TextUnit=24 Month"
|
||||
Identify=SynchOp,Choosing=1
|
||||
Identify=RotaryDev,Choosing=1
|
||||
Identify=UserEdited,Choosing=0
|
||||
Identify=AutoScale,Choosing=0
|
||||
Identify=StopOnErr,Choosing=1
|
||||
Identify=StopOnLost,Choosing=0
|
||||
Identify=Extended,Choosing=1
|
||||
Identify=TargetSign,Choosing=0
|
||||
Identify=FootSpace,"TextUnit=50.8 mm"
|
||||
Identify=DeadPath,"TextUnit=0 mm"
|
||||
Identify=Preset,"TextUnit=0 mm"
|
||||
Identify=Average,Choosing=1
|
||||
Identify=OCFactor,Choosing=0
|
||||
Identify=RangeType,Choosing=0
|
||||
Identify=SquareErr,"TextUnit=0 arcsec"
|
||||
Identify=RotAQBRes,Choosing=0
|
||||
Identify=ParaType,Choosing=0
|
||||
Identify=AllowKBPos,Choosing=0
|
||||
Identify=Hysteresis,ItemText=3
|
||||
Identify=Axis,Choosing=2
|
||||
Identify=AutoTitle,Choosing=1
|
||||
Identify=Mode,Choosing=0
|
||||
Identify=Cycles,ItemText=5
|
||||
Identify=StartPos,"TextUnit=1 mm"
|
||||
Identify=Interval,"TextUnit=1 mm"
|
||||
Identify=EndPos,"TextUnit=90 mm"
|
||||
Identify=Points,TextUnit=10
|
||||
Identify=UserDef,Choosing=1
|
||||
Identify=Positions,"TextUnit=1,10.89,20.7775,30.6675,40.555,50.445,60.3325,70.2225,80.11,90 mm",Expanded=N
|
||||
Identify=Axis2,Choosing=1
|
||||
Identify=Mode2,Choosing=0
|
||||
Identify=Cycles2,ItemText=5
|
||||
Identify=StartPos2,"TextUnit=0 mm"
|
||||
Identify=Interval2,"TextUnit=100 mm"
|
||||
Identify=EndPos2,"TextUnit=1000 mm"
|
||||
Identify=Points2,TextUnit=11
|
||||
Identify=UserDef2,Choosing=0
|
||||
Identify=Positions2,"TextUnit=0,100,200,300,400,500,600,700,800,900,1000 mm",Expanded=N
|
||||
Identify=TrigType,Choosing=2
|
||||
Identify=TrigWnd,"TextUnit=0.025 mm"
|
||||
Identify=TrigDwell,"TextUnit=4 sec"
|
||||
Identify=AQBMode,Choosing=0
|
||||
Identify=AQBRes,"TextUnit=1 um"
|
||||
Identify=EPTimeOut,ItemText=1.0
|
||||
Identify=AutoTimer,"TextUnit=1 sec"
|
||||
Identify=UnitSysSel,Choosing=0
|
||||
Identify=PosUnit,Choosing=0
|
||||
Identify=ErrUnit,Choosing=0
|
||||
Identify=ResultRes,Choosing=7
|
||||
Identify=ExpCoef,Choosing=0
|
||||
Identify=ExpCoef2,TextUnit=
|
||||
Identify=WayLength,"TextUnit=812.8 mm"
|
||||
Identify=WayDir,Choosing=0
|
||||
Identify=WayStaNum,ItemText=16
|
||||
Identify=FlaStaAC,ItemText=8
|
||||
Identify=FlaStaAG,ItemText=6
|
||||
Identify=FlaAxisDir,Choosing=0
|
||||
Identify=FlaLenAC,"TextUnit=812.8 mm"
|
||||
Identify=FlaLenAG,"TextUnit=609.6 mm"
|
||||
Identify=FlaLenAE,"TextUnit=1012 mm"
|
||||
Identify=FlaAllSta,"ItemText=20,20,16,12,16,12,16,12",Expanded=N
|
||||
Identify=DiaScaleX,TextUnit=4
|
||||
Identify=DiaScaleY,TextUnit=4
|
||||
Identify=DiaScaleZ,TextUnit=3
|
||||
Identify=AxisDirSel,ItemText=00000000
|
||||
Identify=AxisOrder,ItemText=1
|
||||
Identify=AxisDone,Comprise=Y,Expanded=N
|
||||
Identify=MeaAxisSel,ItemText=
|
||||
Identify=SameAs,Choosing=0
|
||||
Identify=TBDispSel,Comprise=YNNN,Expanded=N
|
||||
Identify=StartType,Choosing=0
|
||||
Identify=TBStartPos,"TextUnit=0 mm"
|
||||
Identify=StopType,Choosing=2
|
||||
Identify=TBStopPos,"TextUnit=100 mm"
|
||||
Identify=TBInterval,"TextUnit=0.1 sec"
|
||||
Identify=TotalTime,"TextUnit=10 sec"
|
||||
Identify=PointNum,ItemText=101
|
||||
Identify=ManualRH,Choosing=0
|
||||
Identify=EnvUnitSel,Choosing=0
|
||||
Identify=EnvUpdate,"TextUnit=10 sec"
|
||||
Identify=Standard,Choosing=12
|
||||
Identify=AnaMod,Choosing=1
|
||||
Identify=AnaGraph,Comprise=YYYYYYYNNY,Expanded=N
|
||||
Identify=AnaSigma,TextUnit=2
|
||||
Identify=AnaNum,Comprise=YYYYYNNYNNN,Expanded=N
|
||||
Identify=AnaSlope,Choosing=0
|
||||
Identify=PrnShowSel,Comprise=YYYY,Expanded=N
|
||||
Identify=PrnEnvSel,Choosing=0
|
||||
Identify=PrnCopies,ItemText=1
|
||||
Identify=PrnOrient,Choosing=0
|
||||
Identify=PrnMargin,Choosing=0
|
||||
Identify=TBDataPnt,Choosing=0
|
||||
Identify=FlaMethod,Choosing=0
|
||||
Identify=CompZero,ItemText=1
|
||||
Identify=Location,"ItemText=Mechatronics Lab"
|
||||
Identify=AssetNo,ItemText=
|
||||
Identify=Comments,"ItemText=TR-Electronics,EL5042_DC,ED7062_CSP,ClosedLoop,S-Curve,""100 microns step before position""",Expanded=N
|
||||
Identify=StartTime,"ItemText=07.09.2026 11:11:25"
|
||||
Identify=MachName,"ItemText=Test setup"
|
||||
Identify=MachType,ItemText=StepperMottor
|
||||
Identify=MachSN,ItemText=
|
||||
Identify=MachModel,ItemText=
|
||||
Identify=DateTest,"ItemText=07.09.2026 11:32:19"
|
||||
Identify=Operator,ItemText=Henrique
|
||||
Identify=MeaInst,ItemText=
|
||||
Identify=TypeScale,ItemText=
|
||||
Identify=NDECorr,Choosing=0
|
||||
Identify=FeedRate,"TextUnit=120 mm/min"
|
||||
Identify=DwellTime,"TextUnit=3 sec"
|
||||
Identify=CompUsed,ItemText=
|
||||
Identify=CoefScale,TextUnit=
|
||||
Identify=PosAxes,ItemText=
|
||||
Identify=ToolX,TextUnit=
|
||||
Identify=ToolY,TextUnit=
|
||||
Identify=ToolZ,TextUnit=
|
||||
Identify=PieceX,TextUnit=
|
||||
Identify=PieceY,TextUnit=
|
||||
Identify=PieceZ,TextUnit=
|
||||
Identify=MatSen1,ItemText=
|
||||
Identify=MatSen2,ItemText=
|
||||
Identify=MatSen3,ItemText=
|
||||
Identify=ATSen,ItemText=
|
||||
Identify=MeaLength,"TextUnit=90 mm"
|
||||
Identify=CalMeaDev,Choosing=0
|
||||
Identify=ErrorRange,"TextUnit=0.8 ppm"
|
||||
Identify=AlignErr,Choosing=0
|
||||
Identify=Diff20CMax,Choosing=1
|
||||
Identify=MatTempDev,Choosing=0
|
||||
Identify=UncExpCoef,"TextUnit=2 ppm/C"
|
||||
Identify=EnvVarErr,"TextUnit=0.0017 mm"
|
||||
Identify=CompRout,"TextUnit=4 sec"
|
||||
Identify=CompCalc,Choosing=0
|
||||
Identify=CompDir,Choosing=0
|
||||
Identify=CompSign,Choosing=0
|
||||
Identify=CompAbs,Choosing=0
|
||||
Identify=CompTI,Choosing=0
|
||||
Identify=MachUnit,"TextUnit=1 um"
|
||||
Identify=CompSel,Choosing=0
|
||||
Identify=CompStart,"TextUnit=1 mm"
|
||||
Identify=CompIntvl,"TextUnit=1 mm"
|
||||
Identify=CompEnd,"TextUnit=90 mm"
|
||||
Identify=UpperSel,Choosing=0
|
||||
Identify=LaserRes,"TextUnit=-0.1 um"
|
||||
Identify=LaserSen,Choosing=1
|
||||
Identify=ErrorRes,"TextUnit=-0.0001 mm"
|
||||
Identify=ComboRes,"TextUnit=-0.0001 arcdeg"
|
||||
Identify=SpeedRes,"TextUnit=-0.01 mm/s"
|
||||
Identify=LaserRes2,"TextUnit=-0.01 um"
|
||||
Identify=LaserSen2,Choosing=1
|
||||
Identify=LowerSel,Choosing=3
|
||||
Identify=TargetRes,"TextUnit=-0.1 um"
|
||||
Identify=EncoderRes,"TextUnit=-0.01 um"
|
||||
Identify=RotaryRes,"TextUnit=-0.0001 arcdeg"
|
||||
Identify=RotarySen,Choosing=1
|
||||
Identify=MidDispSel,Choosing=0
|
||||
Identify=GraPanel,"ItemText=Linear - Measurement Axis: Z"
|
||||
Identify=LimitSel,Choosing=1
|
||||
Identify=LimitLine,"TextUnit=0.01 mm"
|
||||
Identify=UserSel,Choosing=1
|
||||
Identify=UserScale,"TextUnit=0.1 mm"
|
||||
Identify=Legend,Choosing=1
|
||||
Identify=TarInRow,Choosing=1
|
||||
Identify=ResAxisSel,Choosing=0
|
||||
Identify=GridLines,Choosing=1
|
||||
Identify=Centered,Choosing=1
|
||||
Identify=FlaGraSel,Choosing=1
|
||||
Identify=ErrorSign,Choosing=0
|
||||
Identify=FirstRow,ItemText=1
|
||||
Identify=RefDisp,Choosing=2
|
||||
Identify=RotThita,"TextUnit=30 arcdeg"
|
||||
Identify=RotPhy,"TextUnit=15 arcdeg"
|
||||
Identify=FigRanges,"ItemText=0,-0.02,95,0.02",Expanded=N
|
||||
Identify=EnvRanges,"ItemText=,,,",Expanded=N
|
||||
Identify=EnvUser,Choosing=0
|
||||
Identify=DataGrids,"ItemText=0,0,0,0",Expanded=N
|
||||
Identify=CompGrids,"ItemText=0,0,0,0",Expanded=N
|
||||
Identify=LinearErr,"TextUnit=0.000994235,0.002595408,0.004028431,0.004816103,0.005103203,0.006362299,0.007658977,0.007429147,0.007142232,0.006172853,0.006177795,0.006885240,0.006904827,0.006759196,0.005493607,0.004204018,0.003899505,0.003061395,0.001582524,0.000575785,0.000577723,0.001927094,0.003600401,0.004191313,0.004574551,0.005711223,0.007184402,0.006913005,0.006916338,0.006246422,0.006247971,0.006520116,0.006545296,0.006477112,0.005159400,0.003757874,0.003437214,0.002750826,0.001343544,0.000149475,0.000151858,0.001716791,0.003247581,0.003981482,0.004252661,0.005374932,0.006760898,0.006862863,0.006651121,0.005922998,0.005915451,0.006360570,0.006433206,0.006250622,0.004805239,0.003642205,0.003396816,0.002441683,0.001252362,0.000016607,0.000019393,0.001617610,0.002772983,0.003713579,0.004251145,0.005231714,0.006552492,0.006764931,0.006578086,0.005627180,0.005638127,0.006149320,0.006296252,0.006150415,0.004664802,0.003582538,0.003208424,0.002149705,0.000880682,-0.000270009,-0.000269953,0.001328054,0.002749551,0.003612443,0.003984067,0.005081026,0.006525090,0.006560562,0.006358406,0.005765525,0.005778431,0.006059920,0.006054108,0.006049448,0.004422809,0.003266426,0.003082817,0.002043588,0.000713857,-0.000452453 mm",Expanded=N
|
||||
Identify=EnvDispSel,Choosing=4
|
||||
Identify=ATHistory,"TextUnit=22.03,22.03,22.03,22.03,22.03,22.03,22.03,22.03,22.03,22.03,22.03,22.03,22.03,22.03,22.03,22.03,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.04,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.05,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06 C",Expanded=N
|
||||
Identify=APHistory,"TextUnit=738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.1,738.2,738.1,738.1,738.1,738.1,738.2,738.1,738.2,738.2,738.2,738.2,738.2,738.2,738.1,738.1,738.1,738.1,738.1,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.1,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.2,738.1,738.1,738.1,738.1,738.1 mmHg",Expanded=N
|
||||
Identify=RHHistory,"TextUnit=53,53,54,53,53,53,53,53,53,54,53,53,53,53,53,53,54,54,53,53,54,54,54,54,54,53,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54,54 %",Expanded=N
|
||||
Identify=MTHistory,"TextUnit=22.15,22.15,22.15,22.15,22.15,22.15,22.15,22.15,22.15,22.15,22.15,22.15,22.16,22.15,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18 C",Expanded=N
|
||||
Identify=ProgHist,"ItemText=0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100",Expanded=N
|
||||
Identify=TimeHist,"ItemText=0,1,14,27,41,54,68,81,95,108,122,123,136,150,164,178,192,206,220,234,248,249,261,275,288,302,315,329,342,356,369,370,383,397,411,425,439,453,467,481,495,496,509,522,536,549,563,576,590,603,617,618,631,645,659,673,687,701,715,729,743,744,756,770,783,797,810,824,837,851,864,865,878,892,906,920,934,948,962,976,990,991,1004,1017,1031,1044,1058,1071,1085,1098,1112,1113,1126,1140,1154,1168,1182,1196,1210,1224,1238",Expanded=N
|
||||
Identify=NormRange,Choosing=1
|
||||
Identify=ATList,"TextUnit=22.03,,22.06,22.03,22.05,22.06 C",Expanded=N
|
||||
Identify=APList,"TextUnit=738.2,,738.2,738.1,738.2,738.1 mmHg",Expanded=N
|
||||
Identify=RHList,"TextUnit=53,,54,53,54,54 %",Expanded=N
|
||||
Identify=MT1List,"TextUnit=22.25,,22.28,22.25,22.26,22.28 C",Expanded=N
|
||||
Identify=MT2List,"TextUnit=22.05,,22.07,22.05,22.06,22.07 C",Expanded=N
|
||||
Identify=MT3List,"TextUnit=,,,,, C",Expanded=N
|
||||
Identify=EnvCount,ItemText=1254
|
||||
|
||||
<End of Option Description File - Rev. 1.00a>
|
||||
@@ -0,0 +1,201 @@
|
||||
<Option Description File - Rev. 1.00a - Keysight E1733A 1.14.1 (Win64)>
|
||||
UserSetup
|
||||
|
||||
Identify=MeaType,Choosing=0
|
||||
Identify=FileName,ItemText=OWIS_stageTR_Electronics_FAT_ISO230_Stepper_ED7062_CSV_EL5042_DC_ClosedLoop_SCurve_gap.Lin
|
||||
Identify=MergedFile,ItemText=
|
||||
Identify=CaliPeriod,"TextUnit=24 Month"
|
||||
Identify=SynchOp,Choosing=1
|
||||
Identify=RotaryDev,Choosing=1
|
||||
Identify=UserEdited,Choosing=0
|
||||
Identify=AutoScale,Choosing=0
|
||||
Identify=StopOnErr,Choosing=1
|
||||
Identify=StopOnLost,Choosing=0
|
||||
Identify=Extended,Choosing=1
|
||||
Identify=TargetSign,Choosing=0
|
||||
Identify=FootSpace,"TextUnit=50.8 mm"
|
||||
Identify=DeadPath,"TextUnit=0 mm"
|
||||
Identify=Preset,"TextUnit=0 mm"
|
||||
Identify=Average,Choosing=1
|
||||
Identify=OCFactor,Choosing=0
|
||||
Identify=RangeType,Choosing=0
|
||||
Identify=SquareErr,"TextUnit=0 arcsec"
|
||||
Identify=RotAQBRes,Choosing=0
|
||||
Identify=ParaType,Choosing=0
|
||||
Identify=AllowKBPos,Choosing=0
|
||||
Identify=Hysteresis,ItemText=3
|
||||
Identify=Axis,Choosing=2
|
||||
Identify=AutoTitle,Choosing=1
|
||||
Identify=Mode,Choosing=0
|
||||
Identify=Cycles,ItemText=5
|
||||
Identify=StartPos,"TextUnit=1 mm"
|
||||
Identify=Interval,"TextUnit=1 mm"
|
||||
Identify=EndPos,"TextUnit=90 mm"
|
||||
Identify=Points,TextUnit=10
|
||||
Identify=UserDef,Choosing=1
|
||||
Identify=Positions,"TextUnit=1,10.89,20.7775,30.6675,40.555,50.445,60.3325,70.2225,80.11,90 mm",Expanded=N
|
||||
Identify=Axis2,Choosing=1
|
||||
Identify=Mode2,Choosing=0
|
||||
Identify=Cycles2,ItemText=5
|
||||
Identify=StartPos2,"TextUnit=0 mm"
|
||||
Identify=Interval2,"TextUnit=100 mm"
|
||||
Identify=EndPos2,"TextUnit=1000 mm"
|
||||
Identify=Points2,TextUnit=11
|
||||
Identify=UserDef2,Choosing=0
|
||||
Identify=Positions2,"TextUnit=0,100,200,300,400,500,600,700,800,900,1000 mm",Expanded=N
|
||||
Identify=TrigType,Choosing=2
|
||||
Identify=TrigWnd,"TextUnit=0.025 mm"
|
||||
Identify=TrigDwell,"TextUnit=4 sec"
|
||||
Identify=AQBMode,Choosing=0
|
||||
Identify=AQBRes,"TextUnit=1 um"
|
||||
Identify=EPTimeOut,ItemText=1.0
|
||||
Identify=AutoTimer,"TextUnit=1 sec"
|
||||
Identify=UnitSysSel,Choosing=0
|
||||
Identify=PosUnit,Choosing=0
|
||||
Identify=ErrUnit,Choosing=0
|
||||
Identify=ResultRes,Choosing=7
|
||||
Identify=ExpCoef,Choosing=0
|
||||
Identify=ExpCoef2,TextUnit=
|
||||
Identify=WayLength,"TextUnit=812.8 mm"
|
||||
Identify=WayDir,Choosing=0
|
||||
Identify=WayStaNum,ItemText=16
|
||||
Identify=FlaStaAC,ItemText=8
|
||||
Identify=FlaStaAG,ItemText=6
|
||||
Identify=FlaAxisDir,Choosing=0
|
||||
Identify=FlaLenAC,"TextUnit=812.8 mm"
|
||||
Identify=FlaLenAG,"TextUnit=609.6 mm"
|
||||
Identify=FlaLenAE,"TextUnit=1012 mm"
|
||||
Identify=FlaAllSta,"ItemText=20,20,16,12,16,12,16,12",Expanded=N
|
||||
Identify=DiaScaleX,TextUnit=4
|
||||
Identify=DiaScaleY,TextUnit=4
|
||||
Identify=DiaScaleZ,TextUnit=3
|
||||
Identify=AxisDirSel,ItemText=00000000
|
||||
Identify=AxisOrder,ItemText=1
|
||||
Identify=AxisDone,Comprise=Y,Expanded=N
|
||||
Identify=MeaAxisSel,ItemText=
|
||||
Identify=SameAs,Choosing=0
|
||||
Identify=TBDispSel,Comprise=YNNN,Expanded=N
|
||||
Identify=StartType,Choosing=0
|
||||
Identify=TBStartPos,"TextUnit=0 mm"
|
||||
Identify=StopType,Choosing=2
|
||||
Identify=TBStopPos,"TextUnit=100 mm"
|
||||
Identify=TBInterval,"TextUnit=0.1 sec"
|
||||
Identify=TotalTime,"TextUnit=10 sec"
|
||||
Identify=PointNum,ItemText=101
|
||||
Identify=ManualRH,Choosing=0
|
||||
Identify=EnvUnitSel,Choosing=0
|
||||
Identify=EnvUpdate,"TextUnit=10 sec"
|
||||
Identify=Standard,Choosing=12
|
||||
Identify=AnaMod,Choosing=1
|
||||
Identify=AnaGraph,Comprise=YYYYYYYNNY,Expanded=N
|
||||
Identify=AnaSigma,TextUnit=2
|
||||
Identify=AnaNum,Comprise=YYYYYNNYNNN,Expanded=N
|
||||
Identify=AnaSlope,Choosing=0
|
||||
Identify=PrnShowSel,Comprise=YYYY,Expanded=N
|
||||
Identify=PrnEnvSel,Choosing=0
|
||||
Identify=PrnCopies,ItemText=1
|
||||
Identify=PrnOrient,Choosing=0
|
||||
Identify=PrnMargin,Choosing=0
|
||||
Identify=TBDataPnt,Choosing=0
|
||||
Identify=FlaMethod,Choosing=0
|
||||
Identify=CompZero,ItemText=1
|
||||
Identify=Location,"ItemText=Mechatronics Lab"
|
||||
Identify=AssetNo,ItemText=
|
||||
Identify=Comments,"ItemText=TR-Electronics,EL5042_DC,ED7062_CSV,ClosedLoop,S-Curve,""100 microns step before position""",Expanded=N
|
||||
Identify=StartTime,"ItemText=07.09.2026 09:41:38"
|
||||
Identify=MachName,"ItemText=Test setup"
|
||||
Identify=MachType,ItemText=StepperMottor
|
||||
Identify=MachSN,ItemText=
|
||||
Identify=MachModel,ItemText=
|
||||
Identify=DateTest,"ItemText=07.09.2026 10:02:27"
|
||||
Identify=Operator,ItemText=Henrique
|
||||
Identify=MeaInst,ItemText=
|
||||
Identify=TypeScale,ItemText=
|
||||
Identify=NDECorr,Choosing=0
|
||||
Identify=FeedRate,"TextUnit=120 mm/min"
|
||||
Identify=DwellTime,"TextUnit=3 sec"
|
||||
Identify=CompUsed,ItemText=
|
||||
Identify=CoefScale,TextUnit=
|
||||
Identify=PosAxes,ItemText=
|
||||
Identify=ToolX,TextUnit=
|
||||
Identify=ToolY,TextUnit=
|
||||
Identify=ToolZ,TextUnit=
|
||||
Identify=PieceX,TextUnit=
|
||||
Identify=PieceY,TextUnit=
|
||||
Identify=PieceZ,TextUnit=
|
||||
Identify=MatSen1,ItemText=
|
||||
Identify=MatSen2,ItemText=
|
||||
Identify=MatSen3,ItemText=
|
||||
Identify=ATSen,ItemText=
|
||||
Identify=MeaLength,"TextUnit=90 mm"
|
||||
Identify=CalMeaDev,Choosing=0
|
||||
Identify=ErrorRange,"TextUnit=0.8 ppm"
|
||||
Identify=AlignErr,Choosing=0
|
||||
Identify=Diff20CMax,Choosing=1
|
||||
Identify=MatTempDev,Choosing=0
|
||||
Identify=UncExpCoef,"TextUnit=2 ppm/C"
|
||||
Identify=EnvVarErr,"TextUnit=0.0017 mm"
|
||||
Identify=CompRout,"TextUnit=4 sec"
|
||||
Identify=CompCalc,Choosing=0
|
||||
Identify=CompDir,Choosing=0
|
||||
Identify=CompSign,Choosing=0
|
||||
Identify=CompAbs,Choosing=0
|
||||
Identify=CompTI,Choosing=0
|
||||
Identify=MachUnit,"TextUnit=1 um"
|
||||
Identify=CompSel,Choosing=0
|
||||
Identify=CompStart,"TextUnit=1 mm"
|
||||
Identify=CompIntvl,"TextUnit=1 mm"
|
||||
Identify=CompEnd,"TextUnit=90 mm"
|
||||
Identify=UpperSel,Choosing=0
|
||||
Identify=LaserRes,"TextUnit=-0.1 um"
|
||||
Identify=LaserSen,Choosing=1
|
||||
Identify=ErrorRes,"TextUnit=-0.0001 mm"
|
||||
Identify=ComboRes,"TextUnit=-0.0001 arcdeg"
|
||||
Identify=SpeedRes,"TextUnit=-0.01 mm/s"
|
||||
Identify=LaserRes2,"TextUnit=-0.01 um"
|
||||
Identify=LaserSen2,Choosing=1
|
||||
Identify=LowerSel,Choosing=3
|
||||
Identify=TargetRes,"TextUnit=-0.1 um"
|
||||
Identify=EncoderRes,"TextUnit=-0.01 um"
|
||||
Identify=RotaryRes,"TextUnit=-0.0001 arcdeg"
|
||||
Identify=RotarySen,Choosing=1
|
||||
Identify=MidDispSel,Choosing=0
|
||||
Identify=GraPanel,"ItemText=Linear - Measurement Axis: Z"
|
||||
Identify=LimitSel,Choosing=1
|
||||
Identify=LimitLine,"TextUnit=0.01 mm"
|
||||
Identify=UserSel,Choosing=1
|
||||
Identify=UserScale,"TextUnit=0.1 mm"
|
||||
Identify=Legend,Choosing=1
|
||||
Identify=TarInRow,Choosing=1
|
||||
Identify=ResAxisSel,Choosing=0
|
||||
Identify=GridLines,Choosing=1
|
||||
Identify=Centered,Choosing=1
|
||||
Identify=FlaGraSel,Choosing=1
|
||||
Identify=ErrorSign,Choosing=0
|
||||
Identify=FirstRow,ItemText=1
|
||||
Identify=RefDisp,Choosing=2
|
||||
Identify=RotThita,"TextUnit=30 arcdeg"
|
||||
Identify=RotPhy,"TextUnit=15 arcdeg"
|
||||
Identify=FigRanges,"ItemText=0,-0.02,95,0.02",Expanded=N
|
||||
Identify=EnvRanges,"ItemText=,,,",Expanded=N
|
||||
Identify=EnvUser,Choosing=0
|
||||
Identify=DataGrids,"ItemText=0,0,0,0",Expanded=N
|
||||
Identify=CompGrids,"ItemText=0,0,0,0",Expanded=N
|
||||
Identify=LinearErr,"TextUnit=0.001440800,0.002974017,0.004450408,0.005126797,0.004893900,0.005701863,0.007207494,0.006648095,0.006284393,0.005445580,0.005448663,0.006077500,0.006173470,0.005986274,0.004747928,0.003499263,0.003454139,0.002665161,0.001257751,0.000033137,0.000026264,0.001643127,0.002949337,0.003421497,0.003912059,0.004997334,0.006243385,0.006326520,0.006142238,0.005588395,0.005592324,0.005891462,0.006079765,0.005741912,0.004505973,0.003264929,0.002813408,0.002439311,0.000786288,-0.000459109,-0.000453150,0.001457338,0.002409130,0.003326406,0.003811224,0.004920681,0.006262303,0.006196076,0.006197014,0.005333921,0.005335107,0.005838874,0.006176159,0.005718964,0.004336468,0.003273399,0.002797293,0.002136376,0.000585292,-0.000666956,-0.000658292,0.001163927,0.002293383,0.003175265,0.003770570,0.004883629,0.006256995,0.006398930,0.006130271,0.005627573,0.005628881,0.005825934,0.006360913,0.005842409,0.004143910,0.003418992,0.002695897,0.002039241,0.000601383,-0.000835712,-0.000830812,0.000943799,0.002440872,0.003237568,0.003626113,0.004989473,0.006360533,0.006336904,0.006092409,0.005620711,0.005630463,0.005874344,0.006357194,0.005960076,0.004311065,0.003382925,0.002744836,0.002221686,0.000720614,-0.000781809 mm",Expanded=N
|
||||
Identify=EnvDispSel,Choosing=4
|
||||
Identify=ATHistory,"TextUnit=21.86,21.86,21.86,21.86,21.86,21.86,21.86,21.86,21.86,21.86,21.86,21.86,21.86,21.86,21.86,21.86,21.86,21.86,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.87,21.88,21.88,21.88,21.87,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88,21.88 C",Expanded=N
|
||||
Identify=APHistory,"TextUnit=738.6,738.6,738.6,738.6,738.6,738.6,738.6,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.4,738.4,738.4,738.4,738.4,738.4,738.4,738.4,738.4,738.4,738.4,738.4,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.5,738.6,738.6,738.6,738.6,738.6,738.6,738.6,738.6,738.6,738.6,738.6,738.6,738.7,738.7,738.7,738.7,738.7,738.7,738.7,738.7,738.7,738.7,738.7,738.7,738.7,738.7,738.7,738.7,738.6,738.6,738.6,738.7,738.7,738.6,738.6,738.6,738.6,738.6,738.7,738.7,738.6,738.6,738.6,738.6,738.7 mmHg",Expanded=N
|
||||
Identify=RHHistory,"TextUnit=53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53,53 %",Expanded=N
|
||||
Identify=MTHistory,"TextUnit=21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.98,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,21.99,22.00,22.00,21.99,22.00,22.00,22.00,22.00,22.00,22.00,22.00,22.00,22.00,22.00,22.00,22.00,22.00,22.00,22.00,22.00 C",Expanded=N
|
||||
Identify=ProgHist,"ItemText=0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100",Expanded=N
|
||||
Identify=TimeHist,"ItemText=0,1,14,27,41,54,68,81,95,108,122,123,136,150,164,178,192,206,220,234,248,249,261,275,288,302,315,329,342,356,369,370,383,397,411,425,439,453,467,481,495,496,509,522,536,549,563,576,590,603,617,618,631,645,659,673,687,701,715,729,743,744,756,770,783,797,810,824,837,851,864,865,878,892,906,920,934,948,962,976,990,991,1004,1017,1031,1044,1058,1071,1085,1098,1112,1113,1126,1140,1154,1168,1182,1196,1210,1224,1238",Expanded=N
|
||||
Identify=NormRange,Choosing=1
|
||||
Identify=ATList,"TextUnit=21.86,,21.88,21.86,21.87,21.88 C",Expanded=N
|
||||
Identify=APList,"TextUnit=738.5,,738.7,738.3,738.6,738.6 mmHg",Expanded=N
|
||||
Identify=RHList,"TextUnit=53,,53,53,53,53 %",Expanded=N
|
||||
Identify=MT1List,"TextUnit=22.11,,22.13,22.11,22.12,22.13 C",Expanded=N
|
||||
Identify=MT2List,"TextUnit=21.84,,21.87,21.84,21.86,21.87 C",Expanded=N
|
||||
Identify=MT3List,"TextUnit=,,,,, C",Expanded=N
|
||||
Identify=EnvCount,ItemText=1251
|
||||
|
||||
<End of Option Description File - Rev. 1.00a>
|
||||
@@ -0,0 +1,201 @@
|
||||
<Option Description File - Rev. 1.00a - Keysight E1733A 1.14.1 (Win64)>
|
||||
UserSetup
|
||||
|
||||
Identify=MeaType,Choosing=0
|
||||
Identify=FileName,ItemText=OWIS_stageTR_Electronics_FAT_ISO230_Stepper_EL7041_EL5042.Lin
|
||||
Identify=MergedFile,ItemText=
|
||||
Identify=CaliPeriod,"TextUnit=12 Month"
|
||||
Identify=SynchOp,Choosing=1
|
||||
Identify=RotaryDev,Choosing=1
|
||||
Identify=UserEdited,Choosing=0
|
||||
Identify=AutoScale,Choosing=0
|
||||
Identify=StopOnErr,Choosing=1
|
||||
Identify=StopOnLost,Choosing=0
|
||||
Identify=Extended,Choosing=1
|
||||
Identify=TargetSign,Choosing=0
|
||||
Identify=FootSpace,"TextUnit=50.8 mm"
|
||||
Identify=DeadPath,"TextUnit=0 mm"
|
||||
Identify=Preset,"TextUnit=0 mm"
|
||||
Identify=Average,Choosing=1
|
||||
Identify=OCFactor,Choosing=0
|
||||
Identify=RangeType,Choosing=0
|
||||
Identify=SquareErr,"TextUnit=0 arcsec"
|
||||
Identify=RotAQBRes,Choosing=0
|
||||
Identify=ParaType,Choosing=0
|
||||
Identify=AllowKBPos,Choosing=0
|
||||
Identify=Hysteresis,ItemText=3
|
||||
Identify=Axis,Choosing=2
|
||||
Identify=AutoTitle,Choosing=1
|
||||
Identify=Mode,Choosing=0
|
||||
Identify=Cycles,ItemText=5
|
||||
Identify=StartPos,"TextUnit=1 mm"
|
||||
Identify=Interval,"TextUnit=1 mm"
|
||||
Identify=EndPos,"TextUnit=89.312 mm"
|
||||
Identify=Points,TextUnit=10
|
||||
Identify=UserDef,Choosing=1
|
||||
Identify=Positions,"TextUnit=1,11.773,18.755,30.982,42.674,49.344,62.56,71.617,77.436,89.312 mm",Expanded=N
|
||||
Identify=Axis2,Choosing=1
|
||||
Identify=Mode2,Choosing=0
|
||||
Identify=Cycles2,ItemText=5
|
||||
Identify=StartPos2,"TextUnit=0 mm"
|
||||
Identify=Interval2,"TextUnit=100 mm"
|
||||
Identify=EndPos2,"TextUnit=1000 mm"
|
||||
Identify=Points2,TextUnit=11
|
||||
Identify=UserDef2,Choosing=0
|
||||
Identify=Positions2,"TextUnit=0,100,200,300,400,500,600,700,800,900,1000 mm",Expanded=N
|
||||
Identify=TrigType,Choosing=2
|
||||
Identify=TrigWnd,"TextUnit=0.2 mm"
|
||||
Identify=TrigDwell,"TextUnit=4 sec"
|
||||
Identify=AQBMode,Choosing=0
|
||||
Identify=AQBRes,"TextUnit=1 um"
|
||||
Identify=EPTimeOut,ItemText=1.0
|
||||
Identify=AutoTimer,"TextUnit=1 sec"
|
||||
Identify=UnitSysSel,Choosing=0
|
||||
Identify=PosUnit,Choosing=0
|
||||
Identify=ErrUnit,Choosing=0
|
||||
Identify=ResultRes,Choosing=7
|
||||
Identify=ExpCoef,Choosing=0
|
||||
Identify=ExpCoef2,TextUnit=
|
||||
Identify=WayLength,"TextUnit=812.8 mm"
|
||||
Identify=WayDir,Choosing=0
|
||||
Identify=WayStaNum,ItemText=16
|
||||
Identify=FlaStaAC,ItemText=8
|
||||
Identify=FlaStaAG,ItemText=6
|
||||
Identify=FlaAxisDir,Choosing=0
|
||||
Identify=FlaLenAC,"TextUnit=812.8 mm"
|
||||
Identify=FlaLenAG,"TextUnit=609.6 mm"
|
||||
Identify=FlaLenAE,"TextUnit=1012 mm"
|
||||
Identify=FlaAllSta,"ItemText=20,20,16,12,16,12,16,12",Expanded=N
|
||||
Identify=DiaScaleX,TextUnit=4
|
||||
Identify=DiaScaleY,TextUnit=4
|
||||
Identify=DiaScaleZ,TextUnit=3
|
||||
Identify=AxisDirSel,ItemText=00000000
|
||||
Identify=AxisOrder,ItemText=1
|
||||
Identify=AxisDone,Comprise=Y,Expanded=N
|
||||
Identify=MeaAxisSel,ItemText=
|
||||
Identify=SameAs,Choosing=0
|
||||
Identify=TBDispSel,Comprise=YNNN,Expanded=N
|
||||
Identify=StartType,Choosing=0
|
||||
Identify=TBStartPos,"TextUnit=0 mm"
|
||||
Identify=StopType,Choosing=2
|
||||
Identify=TBStopPos,"TextUnit=100 mm"
|
||||
Identify=TBInterval,"TextUnit=0.1 sec"
|
||||
Identify=TotalTime,"TextUnit=10 sec"
|
||||
Identify=PointNum,ItemText=101
|
||||
Identify=ManualRH,Choosing=0
|
||||
Identify=EnvUnitSel,Choosing=0
|
||||
Identify=EnvUpdate,"TextUnit=10 sec"
|
||||
Identify=Standard,Choosing=12
|
||||
Identify=AnaMod,Choosing=1
|
||||
Identify=AnaGraph,Comprise=YYYYYYYNNY,Expanded=N
|
||||
Identify=AnaSigma,TextUnit=2
|
||||
Identify=AnaNum,Comprise=YYYYYNNYNNN,Expanded=N
|
||||
Identify=AnaSlope,Choosing=0
|
||||
Identify=PrnShowSel,Comprise=YYYY,Expanded=N
|
||||
Identify=PrnEnvSel,Choosing=0
|
||||
Identify=PrnCopies,ItemText=1
|
||||
Identify=PrnOrient,Choosing=0
|
||||
Identify=PrnMargin,Choosing=0
|
||||
Identify=TBDataPnt,Choosing=0
|
||||
Identify=FlaMethod,Choosing=0
|
||||
Identify=CompZero,ItemText=1
|
||||
Identify=Location,"ItemText=Mechatronics Lab"
|
||||
Identify=AssetNo,ItemText=
|
||||
Identify=Comments,"ItemText=TR-Electronics,EL5042,EL7041,closedLoop,S-Curve",Expanded=N
|
||||
Identify=StartTime,"ItemText=27.08.2026 10:35:24"
|
||||
Identify=MachName,"ItemText=Test setup"
|
||||
Identify=MachType,ItemText=StepperMottor
|
||||
Identify=MachSN,ItemText=
|
||||
Identify=MachModel,ItemText=
|
||||
Identify=DateTest,"ItemText=27.08.2026 10:54:19"
|
||||
Identify=Operator,ItemText=Henrique
|
||||
Identify=MeaInst,ItemText=
|
||||
Identify=TypeScale,ItemText=
|
||||
Identify=NDECorr,Choosing=0
|
||||
Identify=FeedRate,"TextUnit=120 mm/min"
|
||||
Identify=DwellTime,"TextUnit=3 sec"
|
||||
Identify=CompUsed,ItemText=
|
||||
Identify=CoefScale,TextUnit=
|
||||
Identify=PosAxes,ItemText=
|
||||
Identify=ToolX,TextUnit=
|
||||
Identify=ToolY,TextUnit=
|
||||
Identify=ToolZ,TextUnit=
|
||||
Identify=PieceX,TextUnit=
|
||||
Identify=PieceY,TextUnit=
|
||||
Identify=PieceZ,TextUnit=
|
||||
Identify=MatSen1,ItemText=
|
||||
Identify=MatSen2,ItemText=
|
||||
Identify=MatSen3,ItemText=
|
||||
Identify=ATSen,ItemText=
|
||||
Identify=MeaLength,"TextUnit=89.312 mm"
|
||||
Identify=CalMeaDev,Choosing=0
|
||||
Identify=ErrorRange,"TextUnit=0.8 ppm"
|
||||
Identify=AlignErr,Choosing=0
|
||||
Identify=Diff20CMax,Choosing=1
|
||||
Identify=MatTempDev,Choosing=0
|
||||
Identify=UncExpCoef,"TextUnit=2 ppm/C"
|
||||
Identify=EnvVarErr,"TextUnit=0.0017 mm"
|
||||
Identify=CompRout,"TextUnit=4 sec"
|
||||
Identify=CompCalc,Choosing=0
|
||||
Identify=CompDir,Choosing=0
|
||||
Identify=CompSign,Choosing=0
|
||||
Identify=CompAbs,Choosing=0
|
||||
Identify=CompTI,Choosing=0
|
||||
Identify=MachUnit,"TextUnit=1 um"
|
||||
Identify=CompSel,Choosing=0
|
||||
Identify=CompStart,"TextUnit=1 mm"
|
||||
Identify=CompIntvl,"TextUnit=1 mm"
|
||||
Identify=CompEnd,"TextUnit=89.312 mm"
|
||||
Identify=UpperSel,Choosing=0
|
||||
Identify=LaserRes,"TextUnit=-0.1 um"
|
||||
Identify=LaserSen,Choosing=1
|
||||
Identify=ErrorRes,"TextUnit=-0.0001 mm"
|
||||
Identify=ComboRes,"TextUnit=-0.0001 arcdeg"
|
||||
Identify=SpeedRes,"TextUnit=-0.01 mm/s"
|
||||
Identify=LaserRes2,"TextUnit=-0.01 um"
|
||||
Identify=LaserSen2,Choosing=1
|
||||
Identify=LowerSel,Choosing=3
|
||||
Identify=TargetRes,"TextUnit=-0.1 um"
|
||||
Identify=EncoderRes,"TextUnit=-0.01 um"
|
||||
Identify=RotaryRes,"TextUnit=-0.0001 arcdeg"
|
||||
Identify=RotarySen,Choosing=1
|
||||
Identify=MidDispSel,Choosing=0
|
||||
Identify=GraPanel,"ItemText=Linear - Measurement Axis: Z"
|
||||
Identify=LimitSel,Choosing=1
|
||||
Identify=LimitLine,"TextUnit=0.01 mm"
|
||||
Identify=UserSel,Choosing=1
|
||||
Identify=UserScale,"TextUnit=0.1 mm"
|
||||
Identify=Legend,Choosing=1
|
||||
Identify=TarInRow,Choosing=1
|
||||
Identify=ResAxisSel,Choosing=0
|
||||
Identify=GridLines,Choosing=1
|
||||
Identify=Centered,Choosing=1
|
||||
Identify=FlaGraSel,Choosing=1
|
||||
Identify=ErrorSign,Choosing=0
|
||||
Identify=FirstRow,ItemText=1
|
||||
Identify=RefDisp,Choosing=2
|
||||
Identify=RotThita,"TextUnit=30 arcdeg"
|
||||
Identify=RotPhy,"TextUnit=15 arcdeg"
|
||||
Identify=FigRanges,"ItemText=,,,",Expanded=N
|
||||
Identify=EnvRanges,"ItemText=,,,",Expanded=N
|
||||
Identify=EnvUser,Choosing=0
|
||||
Identify=DataGrids,"ItemText=0,0,0,0",Expanded=N
|
||||
Identify=CompGrids,"ItemText=0,0,0,0",Expanded=N
|
||||
Identify=LinearErr,"TextUnit=0.001596587,0.002692864,0.001402576,-0.000595569,-0.002088399,-0.001876606,-0.002777320,-0.004391774,-0.004566598,-0.006595645,-0.006573541,-0.007449596,-0.006802074,-0.003573712,-0.002523636,-0.003262037,-0.001635291,0.000171451,0.001487028,0.000932380,0.000937827,-0.000475497,-0.001331578,-0.003052872,-0.004696503,-0.004177096,-0.005507850,-0.006421660,-0.006035635,-0.008834924,-0.008827866,-0.004750833,-0.004953997,-0.003284863,-0.002347948,-0.003087027,-0.001460024,0.000242832,0.001507707,0.000943546,0.000933272,-0.000594191,-0.001366937,-0.003169314,-0.004923559,-0.004224448,-0.005519703,-0.005266130,-0.006077565,-0.008525623,-0.008508133,-0.004460332,-0.005132435,-0.003415587,-0.002189586,-0.003002913,-0.001516132,0.000267918,0.001751935,0.000952906,0.000956730,-0.000440707,-0.001235613,-0.003014112,-0.004391984,-0.003886062,-0.005221162,-0.006042263,-0.005629210,-0.008429608,-0.008415418,-0.003840578,-0.004642029,-0.004988247,-0.002073362,-0.002544997,-0.001247580,0.000789305,0.002160610,0.001428912,0.001429855,0.000036022,-0.000903406,-0.002578481,-0.004266920,-0.003594794,-0.005028697,-0.004576637,-0.005441396,-0.008251731,-0.008246117,-0.003758622,-0.004390792,-0.004801846,-0.001873625,-0.002534203,-0.000778867,0.000950938,0.002294916,0.001815607 mm",Expanded=N
|
||||
Identify=EnvDispSel,Choosing=4
|
||||
Identify=ATHistory,"TextUnit=22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14,22.14 C",Expanded=N
|
||||
Identify=APHistory,"TextUnit=734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4,734.4 mmHg",Expanded=N
|
||||
Identify=RHHistory,"TextUnit=33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33,33 %",Expanded=N
|
||||
Identify=MTHistory,"TextUnit=22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93,22.93 C",Expanded=N
|
||||
Identify=ProgHist,"ItemText=0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100",Expanded=N
|
||||
Identify=TimeHist,"ItemText=0,1,13,26,41,56,69,85,99,111,126,127,142,154,168,182,192,205,219,230,242,243,255,266,280,293,303,317,329,339,352,353,365,375,387,401,412,425,438,449,462,463,474,485,499,512,523,537,549,560,573,574,586,596,608,622,633,646,659,670,683,684,695,706,720,733,743,757,769,779,792,793,806,816,828,843,853,866,880,890,903,904,916,927,941,954,964,978,990,1001,1014,1015,1028,1038,1050,1065,1075,1088,1102,1113,1125",Expanded=N
|
||||
Identify=NormRange,Choosing=1
|
||||
Identify=ATList,"TextUnit=22.14,,22.14,22.14,22.14,22.14 C",Expanded=N
|
||||
Identify=APList,"TextUnit=734.4,,734.4,734.4,734.4,734.4 mmHg",Expanded=N
|
||||
Identify=RHList,"TextUnit=33,,33,33,33,33 %",Expanded=N
|
||||
Identify=MT1List,"TextUnit=22.74,,22.74,22.74,22.74,22.74 C",Expanded=N
|
||||
Identify=MT2List,"TextUnit=23.11,,23.11,23.11,23.11,23.11 C",Expanded=N
|
||||
Identify=MT3List,"TextUnit=,,,,, C",Expanded=N
|
||||
Identify=EnvCount,ItemText=1135
|
||||
|
||||
<End of Option Description File - Rev. 1.00a>
|
||||
@@ -0,0 +1,201 @@
|
||||
<Option Description File - Rev. 1.00a - Keysight E1733A 1.14.1 (Win64)>
|
||||
UserSetup
|
||||
|
||||
Identify=MeaType,Choosing=2
|
||||
Identify=FileName,ItemText=OWIS_stageTR_Electronics_FAT_Straightness_Horizontal_XZ.Str
|
||||
Identify=MergedFile,ItemText=
|
||||
Identify=CaliPeriod,"TextUnit=12 Month"
|
||||
Identify=SynchOp,Choosing=1
|
||||
Identify=RotaryDev,Choosing=1
|
||||
Identify=UserEdited,Choosing=0
|
||||
Identify=AutoScale,Choosing=0
|
||||
Identify=StopOnErr,Choosing=1
|
||||
Identify=StopOnLost,Choosing=0
|
||||
Identify=Extended,Choosing=1
|
||||
Identify=TargetSign,Choosing=0
|
||||
Identify=FootSpace,"TextUnit=50.8 mm"
|
||||
Identify=DeadPath,"TextUnit=0 mm"
|
||||
Identify=Preset,"TextUnit=0 mm"
|
||||
Identify=Average,Choosing=1
|
||||
Identify=OCFactor,Choosing=0
|
||||
Identify=RangeType,Choosing=0
|
||||
Identify=SquareErr,"TextUnit=0 arcsec"
|
||||
Identify=RotAQBRes,Choosing=0
|
||||
Identify=ParaType,Choosing=0
|
||||
Identify=AllowKBPos,Choosing=0
|
||||
Identify=Hysteresis,ItemText=3
|
||||
Identify=Axis,Choosing=2
|
||||
Identify=AutoTitle,Choosing=1
|
||||
Identify=Mode,Choosing=0
|
||||
Identify=Cycles,ItemText=5
|
||||
Identify=StartPos,"TextUnit=1 mm"
|
||||
Identify=Interval,"TextUnit=9.88888889 mm"
|
||||
Identify=EndPos,"TextUnit=86 mm"
|
||||
Identify=Points,TextUnit=18
|
||||
Identify=UserDef,Choosing=1
|
||||
Identify=Positions,"TextUnit=1,6,11,16,21,26,31,36,41,46,51,56,61,66,71,76,81,86 mm",Expanded=N
|
||||
Identify=Axis2,Choosing=1
|
||||
Identify=Mode2,Choosing=0
|
||||
Identify=Cycles2,ItemText=5
|
||||
Identify=StartPos2,"TextUnit=0 mm"
|
||||
Identify=Interval2,"TextUnit=100 mm"
|
||||
Identify=EndPos2,"TextUnit=1000 mm"
|
||||
Identify=Points2,TextUnit=11
|
||||
Identify=UserDef2,Choosing=0
|
||||
Identify=Positions2,"TextUnit=0,100,200,300,400,500,600,700,800,900,1000 mm",Expanded=N
|
||||
Identify=TrigType,Choosing=0
|
||||
Identify=TrigWnd,"TextUnit=0.5 mm"
|
||||
Identify=TrigDwell,"TextUnit=1 sec"
|
||||
Identify=AQBMode,Choosing=0
|
||||
Identify=AQBRes,"TextUnit=1 um"
|
||||
Identify=EPTimeOut,Choosing=0
|
||||
Identify=AutoTimer,"TextUnit=1 sec"
|
||||
Identify=UnitSysSel,Choosing=0
|
||||
Identify=PosUnit,Choosing=0
|
||||
Identify=ErrUnit,Choosing=1
|
||||
Identify=ResultRes,Choosing=0
|
||||
Identify=ExpCoef,Choosing=0
|
||||
Identify=ExpCoef2,TextUnit=
|
||||
Identify=WayLength,"TextUnit=812.8 mm"
|
||||
Identify=WayDir,Choosing=0
|
||||
Identify=WayStaNum,ItemText=16
|
||||
Identify=FlaStaAC,ItemText=8
|
||||
Identify=FlaStaAG,ItemText=6
|
||||
Identify=FlaAxisDir,Choosing=0
|
||||
Identify=FlaLenAC,"TextUnit=812.8 mm"
|
||||
Identify=FlaLenAG,"TextUnit=609.6 mm"
|
||||
Identify=FlaLenAE,"TextUnit=1012 mm"
|
||||
Identify=FlaAllSta,"ItemText=20,20,16,12,16,12,16,12",Expanded=N
|
||||
Identify=DiaScaleX,TextUnit=4
|
||||
Identify=DiaScaleY,TextUnit=4
|
||||
Identify=DiaScaleZ,TextUnit=3
|
||||
Identify=AxisDirSel,ItemText=00000000
|
||||
Identify=AxisOrder,ItemText=1
|
||||
Identify=AxisDone,Comprise=Y,Expanded=N
|
||||
Identify=MeaAxisSel,ItemText=
|
||||
Identify=SameAs,Choosing=0
|
||||
Identify=TBDispSel,Comprise=YNNN,Expanded=N
|
||||
Identify=StartType,Choosing=0
|
||||
Identify=TBStartPos,"TextUnit=0 mm"
|
||||
Identify=StopType,Choosing=2
|
||||
Identify=TBStopPos,"TextUnit=100 mm"
|
||||
Identify=TBInterval,"TextUnit=0.1 sec"
|
||||
Identify=TotalTime,"TextUnit=10 sec"
|
||||
Identify=PointNum,ItemText=101
|
||||
Identify=ManualRH,Choosing=0
|
||||
Identify=EnvUnitSel,Choosing=0
|
||||
Identify=EnvUpdate,"TextUnit=10 sec"
|
||||
Identify=Standard,Choosing=7
|
||||
Identify=AnaMod,Choosing=0
|
||||
Identify=AnaGraph,Comprise=YYYYYYYNNN,Expanded=N
|
||||
Identify=AnaSigma,TextUnit=2
|
||||
Identify=AnaNum,Comprise=YYYYYNNYNNN,Expanded=N
|
||||
Identify=AnaSlope,Choosing=0
|
||||
Identify=PrnShowSel,Comprise=YYYY,Expanded=N
|
||||
Identify=PrnEnvSel,Choosing=0
|
||||
Identify=PrnCopies,ItemText=1
|
||||
Identify=PrnOrient,Choosing=0
|
||||
Identify=PrnMargin,Choosing=0
|
||||
Identify=TBDataPnt,Choosing=0
|
||||
Identify=FlaMethod,Choosing=0
|
||||
Identify=CompZero,ItemText=1
|
||||
Identify=Location,"ItemText=Mechatronics Lab"
|
||||
Identify=AssetNo,ItemText=
|
||||
Identify=Comments,"ItemText=""TR-Electronics Encoder"",EL5042_DC,ED7062_CSP,""Horizontal XZ plane""",Expanded=N
|
||||
Identify=StartTime,"ItemText=08.09.2026 10:39:50"
|
||||
Identify=MachName,"ItemText=Owis Stage"
|
||||
Identify=MachType,"ItemText=Stepper Motor"
|
||||
Identify=MachSN,ItemText=
|
||||
Identify=MachModel,ItemText=
|
||||
Identify=DateTest,"ItemText=08.09.2026 11:12:37"
|
||||
Identify=Operator,ItemText=Henrique
|
||||
Identify=MeaInst,ItemText=
|
||||
Identify=TypeScale,ItemText=
|
||||
Identify=NDECorr,Choosing=0
|
||||
Identify=FeedRate,"TextUnit=180 mm/min"
|
||||
Identify=DwellTime,"TextUnit=2 sec"
|
||||
Identify=CompUsed,ItemText=
|
||||
Identify=CoefScale,TextUnit=
|
||||
Identify=PosAxes,ItemText=
|
||||
Identify=ToolX,TextUnit=
|
||||
Identify=ToolY,TextUnit=
|
||||
Identify=ToolZ,TextUnit=
|
||||
Identify=PieceX,TextUnit=
|
||||
Identify=PieceY,TextUnit=
|
||||
Identify=PieceZ,TextUnit=
|
||||
Identify=MatSen1,ItemText=
|
||||
Identify=MatSen2,ItemText=
|
||||
Identify=MatSen3,ItemText=
|
||||
Identify=ATSen,ItemText=
|
||||
Identify=MeaLength,"TextUnit=86 mm"
|
||||
Identify=CalMeaDev,Choosing=0
|
||||
Identify=ErrorRange,"TextUnit=0.8 ppm"
|
||||
Identify=AlignErr,Choosing=0
|
||||
Identify=Diff20CMax,Choosing=1
|
||||
Identify=MatTempDev,Choosing=0
|
||||
Identify=UncExpCoef,"TextUnit=2 ppm/C"
|
||||
Identify=EnvVarErr,"TextUnit=1.7 um"
|
||||
Identify=CompRout,"TextUnit=4 sec"
|
||||
Identify=CompCalc,Choosing=0
|
||||
Identify=CompDir,Choosing=0
|
||||
Identify=CompSign,Choosing=0
|
||||
Identify=CompAbs,Choosing=0
|
||||
Identify=CompTI,Choosing=0
|
||||
Identify=MachUnit,"TextUnit=1 um"
|
||||
Identify=CompSel,Choosing=0
|
||||
Identify=CompStart,"TextUnit=1 mm"
|
||||
Identify=CompIntvl,"TextUnit=9.88888889 mm"
|
||||
Identify=CompEnd,"TextUnit=86 mm"
|
||||
Identify=UpperSel,Choosing=0
|
||||
Identify=LaserRes,"TextUnit=-0.1 um"
|
||||
Identify=LaserSen,Choosing=1
|
||||
Identify=ErrorRes,"TextUnit=-0.1 um"
|
||||
Identify=ComboRes,"TextUnit=-0.0001 arcdeg"
|
||||
Identify=SpeedRes,"TextUnit=-0.01 mm/s"
|
||||
Identify=LaserRes2,"TextUnit=-0.01 um"
|
||||
Identify=LaserSen2,Choosing=1
|
||||
Identify=LowerSel,Choosing=3
|
||||
Identify=TargetRes,"TextUnit=-0.01 um"
|
||||
Identify=EncoderRes,"TextUnit=-0.01 um"
|
||||
Identify=RotaryRes,"TextUnit=-0.0001 arcdeg"
|
||||
Identify=RotarySen,Choosing=1
|
||||
Identify=MidDispSel,Choosing=0
|
||||
Identify=GraPanel,"ItemText=Straightness - Measurement Axis: Z"
|
||||
Identify=LimitSel,Choosing=0
|
||||
Identify=LimitLine,"TextUnit=25 um"
|
||||
Identify=UserSel,Choosing=0
|
||||
Identify=UserScale,"TextUnit=100 um"
|
||||
Identify=Legend,Choosing=1
|
||||
Identify=TarInRow,Choosing=1
|
||||
Identify=ResAxisSel,Choosing=0
|
||||
Identify=GridLines,Choosing=1
|
||||
Identify=Centered,Choosing=1
|
||||
Identify=FlaGraSel,Choosing=1
|
||||
Identify=ErrorSign,Choosing=0
|
||||
Identify=FirstRow,ItemText=1
|
||||
Identify=RefDisp,Choosing=2
|
||||
Identify=RotThita,"TextUnit=30 arcdeg"
|
||||
Identify=RotPhy,"TextUnit=15 arcdeg"
|
||||
Identify=FigRanges,"ItemText=,,,",Expanded=N
|
||||
Identify=EnvRanges,"ItemText=,,,",Expanded=N
|
||||
Identify=EnvUser,Choosing=0
|
||||
Identify=DataGrids,"ItemText=0,0,0,0",Expanded=N
|
||||
Identify=CompGrids,"ItemText=0,0,0,0",Expanded=N
|
||||
Identify=LinearErr,"TextUnit=-0.0881,-1.1387,-2.4187,-2.8612,-3.8111,-4.5402,-4.8424,-5.1013,-5.6721,-6.0568,-7.0473,-6.8168,-7.5313,-7.8235,-7.7958,-8.7668,-9.2412,-10.1033,-10.2070,-9.3098,-8.2351,-8.0094,-7.1465,-7.6430,-6.9017,-5.2319,-6.7423,-4.4755,-4.3983,-4.1328,-4.1837,-3.3671,-0.4243,-0.1161,-0.6771,-0.3288,-0.8902,-1.4654,-1.5917,-2.8771,-2.9387,-4.3833,-3.0965,-4.8246,-4.7290,-6.2717,-5.8820,-6.5718,-6.2336,-6.7114,-7.0304,-8.8281,-8.4939,-11.0892,-10.9646,-8.8750,-8.8664,-7.7955,-7.3296,-6.9523,-7.5120,-4.8509,-6.5179,-2.6555,-5.5120,-4.5157,-3.7881,-4.3973,-1.9146,-1.0812,2.1826,-1.2046,1.9548,-2.4460,0.4225,-0.4055,-2.3672,-3.4981,-1.8201,-3.4823,-4.0171,-4.8900,-3.5497,-8.9204,-8.0884,-8.3361,-8.0566,-8.2369,-8.3681,-9.8812,-8.6580,-9.1855,-8.2702,-8.2640,-6.1625,-5.8563,-7.3927,-6.8092,-5.6800,-4.1461,-3.3341,-1.2190,-2.5256,-4.2932,-1.1474,1.0498,-0.5428,-0.8182,0.9621,-0.4044,-2.5196,-1.3116,-1.6262,-4.4690,-3.4822,-5.0159,-4.9037,-4.5393,-4.8669,-4.9353,-7.5426,-6.6178,-7.7379,-8.9430,-7.9259,-8.7831,-9.5916,-6.6854,-10.1703,-9.2525,-7.8213,-8.0682,-5.8627,-3.0995,-6.3121,-2.9867,-5.9261,-4.2125,-4.3784,-1.2683,2.1563,0.5735,0.5010,1.5437,0.3432,-1.1392,1.2454,-2.8815,-2.8297,-0.5406,-5.8656,-3.6737,-7.0341,-4.8744,-6.8783,-7.4902,-8.4416,-7.0861,-6.1431,-7.0219,-8.4250,-10.6446,-8.9596,-8.2236,-8.2288,-7.7329,-8.6908,-6.4195,-6.7164,-3.9870,-5.3535,-4.2747,-2.5600,-3.9365,-2.9549,-3.6811,-0.8363,4.4722,0.4430,1.6883 um",Expanded=N
|
||||
Identify=EnvDispSel,Choosing=0
|
||||
Identify=ATHistory,"TextUnit=22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.06,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.07,22.08,22.08,22.08,22.08,22.08,22.08,22.08,22.08,22.08,22.08,22.08,22.08,22.08,22.08,22.08,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.09,22.10,22.09,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.10,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.11,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.12,22.13,22.13,22.13,22.13,22.13,22.13,22.13,22.13,22.13,22.13,22.13,22.13,22.13,22.13,22.13,22.13,22.14,22.14,22.14,22.14 C",Expanded=N
|
||||
Identify=APHistory,"TextUnit=732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.5,732.4,732.4,732.5,732.4,732.5,732.5,732.4,732.4,732.4,732.5,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.4,732.3,732.4,732.4,732.3,732.3,732.3,732.4,732.3,732.3,732.3,732.3,732.4,732.4,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.4,732.4,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.3,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2,732.2 mmHg",Expanded=N
|
||||
Identify=RHHistory,"TextUnit=58,58,58,58,57,58,58,58,58,58,58,58,58,57,58,58,58,58,58,58,57,58,57,58,58,58,58,57,58,58,58,58,58,58,58,58,58,58,58,58,58,58,58,58,58,58,58,58,58,58,58,58,57,58,58,58,58,58,58,58,58,58,58,58,58,58,58,58,58,57,58,58,58,58,58,58,58,58,58,58,57,58,58,58,58,58,58,58,58,58,58,58,58,58,58,57,58,58,58,58,58,57,58,58,58,58,57,58,58,57,58,57,58,58,57,57,57,58,58,58,57,57,57,58,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57,57 %",Expanded=N
|
||||
Identify=MTHistory,"TextUnit=22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.16,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.17,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.18,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.19,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.20,22.21,22.21,22.21,22.21,22.21,22.21,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.22,22.23,22.23,22.23,22.23,22.23,22.23,22.23,22.23,22.23,22.23,22.23,22.23,22.23,22.23,22.23,22.23,22.23,22.23,22.24,22.24,22.24,22.24,22.24,22.24,22.24,22.24,22.24,22.24,22.24,22.24,22.24,22.24,22.24,22.24,22.25,22.25,22.25,22.25,22.25,22.25,22.25,22.25,22.25,22.25 C",Expanded=N
|
||||
Identify=ProgHist,"ItemText=0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176,177,178,179,180",Expanded=N
|
||||
Identify=TimeHist,"ItemText=0,1,18,29,40,50,61,71,82,92,103,113,124,134,145,155,166,176,187,191,212,223,233,244,254,265,275,286,296,307,317,328,338,349,359,370,380,385,406,417,427,438,448,459,469,480,490,501,511,522,532,543,553,564,574,579,600,611,621,632,642,653,663,674,684,695,705,716,726,737,747,758,768,773,794,805,815,826,836,847,857,868,878,889,899,910,920,931,941,952,962,967,988,999,1009,1020,1030,1041,1051,1062,1072,1082,1093,1104,1114,1125,1135,1145,1156,1161,1182,1192,1203,1213,1224,1234,1245,1256,1266,1277,1287,1298,1308,1319,1329,1340,1350,1355,1376,1386,1397,1408,1418,1428,1439,1449,1460,1471,1481,1491,1502,1512,1523,1533,1544,1548,1562,1572,1583,1593,1604,1614,1625,1635,1646,1656,1667,1677,1688,1698,1709,1720,1730,1734,1756,1766,1777,1787,1798,1808,1819,1829,1839,1850,1861,1871,1882,1892,1903,1913,1924",Expanded=N
|
||||
Identify=NormRange,Choosing=1
|
||||
Identify=ATList,"TextUnit=22.06,,22.14,22.06,22.10,22.14 C",Expanded=N
|
||||
Identify=APList,"TextUnit=732.5,,732.5,732.2,732.4,732.2 mmHg",Expanded=N
|
||||
Identify=RHList,"TextUnit=58,,58,57,58,57 %",Expanded=N
|
||||
Identify=MT1List,"TextUnit=22.29,,22.36,22.29,22.32,22.36 C",Expanded=N
|
||||
Identify=MT2List,"TextUnit=22.02,,22.13,22.02,22.08,22.13 C",Expanded=N
|
||||
Identify=MT3List,"TextUnit=,,,,, C",Expanded=N
|
||||
Identify=EnvCount,ItemText=1960
|
||||
|
||||
<End of Option Description File - Rev. 1.00a>
|
||||
@@ -0,0 +1,201 @@
|
||||
<Option Description File - Rev. 1.00a - Keysight E1733A 1.14.1 (Win64)>
|
||||
UserSetup
|
||||
|
||||
Identify=MeaType,Choosing=2
|
||||
Identify=FileName,ItemText=OWIS_stageTR_Electronics_FAT_Straightness_Vertical_YZ.Str
|
||||
Identify=MergedFile,ItemText=
|
||||
Identify=CaliPeriod,"TextUnit=12 Month"
|
||||
Identify=SynchOp,Choosing=1
|
||||
Identify=RotaryDev,Choosing=1
|
||||
Identify=UserEdited,Choosing=0
|
||||
Identify=AutoScale,Choosing=0
|
||||
Identify=StopOnErr,Choosing=1
|
||||
Identify=StopOnLost,Choosing=0
|
||||
Identify=Extended,Choosing=1
|
||||
Identify=TargetSign,Choosing=0
|
||||
Identify=FootSpace,"TextUnit=50.8 mm"
|
||||
Identify=DeadPath,"TextUnit=0 mm"
|
||||
Identify=Preset,"TextUnit=0 mm"
|
||||
Identify=Average,Choosing=1
|
||||
Identify=OCFactor,Choosing=0
|
||||
Identify=RangeType,Choosing=0
|
||||
Identify=SquareErr,"TextUnit=0 arcsec"
|
||||
Identify=RotAQBRes,Choosing=0
|
||||
Identify=ParaType,Choosing=0
|
||||
Identify=AllowKBPos,Choosing=0
|
||||
Identify=Hysteresis,ItemText=3
|
||||
Identify=Axis,Choosing=2
|
||||
Identify=AutoTitle,Choosing=1
|
||||
Identify=Mode,Choosing=0
|
||||
Identify=Cycles,ItemText=5
|
||||
Identify=StartPos,"TextUnit=1 mm"
|
||||
Identify=Interval,"TextUnit=9.88888889 mm"
|
||||
Identify=EndPos,"TextUnit=86 mm"
|
||||
Identify=Points,TextUnit=18
|
||||
Identify=UserDef,Choosing=1
|
||||
Identify=Positions,"TextUnit=1,6,11,16,21,26,31,36,41,46,51,56,61,66,71,76,81,86 mm",Expanded=N
|
||||
Identify=Axis2,Choosing=1
|
||||
Identify=Mode2,Choosing=0
|
||||
Identify=Cycles2,ItemText=5
|
||||
Identify=StartPos2,"TextUnit=0 mm"
|
||||
Identify=Interval2,"TextUnit=100 mm"
|
||||
Identify=EndPos2,"TextUnit=1000 mm"
|
||||
Identify=Points2,TextUnit=11
|
||||
Identify=UserDef2,Choosing=0
|
||||
Identify=Positions2,"TextUnit=0,100,200,300,400,500,600,700,800,900,1000 mm",Expanded=N
|
||||
Identify=TrigType,Choosing=0
|
||||
Identify=TrigWnd,"TextUnit=0.5 mm"
|
||||
Identify=TrigDwell,"TextUnit=1 sec"
|
||||
Identify=AQBMode,Choosing=0
|
||||
Identify=AQBRes,"TextUnit=1 um"
|
||||
Identify=EPTimeOut,Choosing=0
|
||||
Identify=AutoTimer,"TextUnit=1 sec"
|
||||
Identify=UnitSysSel,Choosing=0
|
||||
Identify=PosUnit,Choosing=0
|
||||
Identify=ErrUnit,Choosing=1
|
||||
Identify=ResultRes,Choosing=0
|
||||
Identify=ExpCoef,Choosing=0
|
||||
Identify=ExpCoef2,TextUnit=
|
||||
Identify=WayLength,"TextUnit=812.8 mm"
|
||||
Identify=WayDir,Choosing=0
|
||||
Identify=WayStaNum,ItemText=16
|
||||
Identify=FlaStaAC,ItemText=8
|
||||
Identify=FlaStaAG,ItemText=6
|
||||
Identify=FlaAxisDir,Choosing=0
|
||||
Identify=FlaLenAC,"TextUnit=812.8 mm"
|
||||
Identify=FlaLenAG,"TextUnit=609.6 mm"
|
||||
Identify=FlaLenAE,"TextUnit=1012 mm"
|
||||
Identify=FlaAllSta,"ItemText=20,20,16,12,16,12,16,12",Expanded=N
|
||||
Identify=DiaScaleX,TextUnit=4
|
||||
Identify=DiaScaleY,TextUnit=4
|
||||
Identify=DiaScaleZ,TextUnit=3
|
||||
Identify=AxisDirSel,ItemText=00000000
|
||||
Identify=AxisOrder,ItemText=1
|
||||
Identify=AxisDone,Comprise=Y,Expanded=N
|
||||
Identify=MeaAxisSel,ItemText=
|
||||
Identify=SameAs,Choosing=0
|
||||
Identify=TBDispSel,Comprise=YNNN,Expanded=N
|
||||
Identify=StartType,Choosing=0
|
||||
Identify=TBStartPos,"TextUnit=0 mm"
|
||||
Identify=StopType,Choosing=2
|
||||
Identify=TBStopPos,"TextUnit=100 mm"
|
||||
Identify=TBInterval,"TextUnit=0.1 sec"
|
||||
Identify=TotalTime,"TextUnit=10 sec"
|
||||
Identify=PointNum,ItemText=101
|
||||
Identify=ManualRH,Choosing=0
|
||||
Identify=EnvUnitSel,Choosing=0
|
||||
Identify=EnvUpdate,"TextUnit=10 sec"
|
||||
Identify=Standard,Choosing=7
|
||||
Identify=AnaMod,Choosing=0
|
||||
Identify=AnaGraph,Comprise=YYYYYYYNNN,Expanded=N
|
||||
Identify=AnaSigma,TextUnit=2
|
||||
Identify=AnaNum,Comprise=YYYYYNNYNNN,Expanded=N
|
||||
Identify=AnaSlope,Choosing=0
|
||||
Identify=PrnShowSel,Comprise=YYYY,Expanded=N
|
||||
Identify=PrnEnvSel,Choosing=0
|
||||
Identify=PrnCopies,ItemText=1
|
||||
Identify=PrnOrient,Choosing=0
|
||||
Identify=PrnMargin,Choosing=0
|
||||
Identify=TBDataPnt,Choosing=0
|
||||
Identify=FlaMethod,Choosing=0
|
||||
Identify=CompZero,ItemText=1
|
||||
Identify=Location,"ItemText=Mechatronics Lab"
|
||||
Identify=AssetNo,ItemText=
|
||||
Identify=Comments,"ItemText=""TR-Electronics Encoder"",EL5042_DC,ED7062_CSP,""Vertical YZ plane""",Expanded=N
|
||||
Identify=StartTime,"ItemText=08.09.2026 13:18:25"
|
||||
Identify=MachName,"ItemText=Owis Stage"
|
||||
Identify=MachType,"ItemText=Stepper Motor"
|
||||
Identify=MachSN,ItemText=
|
||||
Identify=MachModel,ItemText=
|
||||
Identify=DateTest,"ItemText=08.09.2026 13:49:48"
|
||||
Identify=Operator,ItemText=Henrique
|
||||
Identify=MeaInst,ItemText=
|
||||
Identify=TypeScale,ItemText=
|
||||
Identify=NDECorr,Choosing=0
|
||||
Identify=FeedRate,"TextUnit=180 mm/min"
|
||||
Identify=DwellTime,"TextUnit=2 sec"
|
||||
Identify=CompUsed,ItemText=
|
||||
Identify=CoefScale,TextUnit=
|
||||
Identify=PosAxes,ItemText=
|
||||
Identify=ToolX,TextUnit=
|
||||
Identify=ToolY,TextUnit=
|
||||
Identify=ToolZ,TextUnit=
|
||||
Identify=PieceX,TextUnit=
|
||||
Identify=PieceY,TextUnit=
|
||||
Identify=PieceZ,TextUnit=
|
||||
Identify=MatSen1,ItemText=
|
||||
Identify=MatSen2,ItemText=
|
||||
Identify=MatSen3,ItemText=
|
||||
Identify=ATSen,ItemText=
|
||||
Identify=MeaLength,"TextUnit=86 mm"
|
||||
Identify=CalMeaDev,Choosing=0
|
||||
Identify=ErrorRange,"TextUnit=0.8 ppm"
|
||||
Identify=AlignErr,Choosing=0
|
||||
Identify=Diff20CMax,Choosing=1
|
||||
Identify=MatTempDev,Choosing=0
|
||||
Identify=UncExpCoef,"TextUnit=2 ppm/C"
|
||||
Identify=EnvVarErr,"TextUnit=1.7 um"
|
||||
Identify=CompRout,"TextUnit=4 sec"
|
||||
Identify=CompCalc,Choosing=0
|
||||
Identify=CompDir,Choosing=0
|
||||
Identify=CompSign,Choosing=0
|
||||
Identify=CompAbs,Choosing=0
|
||||
Identify=CompTI,Choosing=0
|
||||
Identify=MachUnit,"TextUnit=1 um"
|
||||
Identify=CompSel,Choosing=0
|
||||
Identify=CompStart,"TextUnit=1 mm"
|
||||
Identify=CompIntvl,"TextUnit=9.88888889 mm"
|
||||
Identify=CompEnd,"TextUnit=86 mm"
|
||||
Identify=UpperSel,Choosing=0
|
||||
Identify=LaserRes,"TextUnit=-1 um"
|
||||
Identify=LaserSen,Choosing=1
|
||||
Identify=ErrorRes,"TextUnit=-0.1 um"
|
||||
Identify=ComboRes,"TextUnit=-0.0001 arcdeg"
|
||||
Identify=SpeedRes,"TextUnit=-0.01 mm/s"
|
||||
Identify=LaserRes2,"TextUnit=-0.01 um"
|
||||
Identify=LaserSen2,Choosing=1
|
||||
Identify=LowerSel,Choosing=3
|
||||
Identify=TargetRes,"TextUnit=-10 um"
|
||||
Identify=EncoderRes,"TextUnit=-0.01 um"
|
||||
Identify=RotaryRes,"TextUnit=-0.0001 arcdeg"
|
||||
Identify=RotarySen,Choosing=1
|
||||
Identify=MidDispSel,Choosing=0
|
||||
Identify=GraPanel,"ItemText=Straightness - Measurement Axis: Z"
|
||||
Identify=LimitSel,Choosing=0
|
||||
Identify=LimitLine,"TextUnit=25 um"
|
||||
Identify=UserSel,Choosing=0
|
||||
Identify=UserScale,"TextUnit=100 um"
|
||||
Identify=Legend,Choosing=1
|
||||
Identify=TarInRow,Choosing=1
|
||||
Identify=ResAxisSel,Choosing=0
|
||||
Identify=GridLines,Choosing=1
|
||||
Identify=Centered,Choosing=1
|
||||
Identify=FlaGraSel,Choosing=1
|
||||
Identify=ErrorSign,Choosing=0
|
||||
Identify=FirstRow,ItemText=1
|
||||
Identify=RefDisp,Choosing=2
|
||||
Identify=RotThita,"TextUnit=30 arcdeg"
|
||||
Identify=RotPhy,"TextUnit=15 arcdeg"
|
||||
Identify=FigRanges,"ItemText=,,,",Expanded=N
|
||||
Identify=EnvRanges,"ItemText=,,,",Expanded=N
|
||||
Identify=EnvUser,Choosing=0
|
||||
Identify=DataGrids,"ItemText=0,0,0,0",Expanded=N
|
||||
Identify=CompGrids,"ItemText=0,0,0,0",Expanded=N
|
||||
Identify=LinearErr,"TextUnit=0.2309,1.1066,1.1236,0.7065,0.7424,0.6015,0.6407,-0.0070,-0.0791,0.2495,0.0853,0.2843,0.0807,0.4149,0.3897,0.4959,0.9113,0.4671,0.4640,0.7678,0.4946,0.7891,0.2065,0.4478,0.5273,0.2084,0.4906,-0.2051,0.3843,0.2670,0.6710,1.1268,1.2638,0.0794,1.1442,0.5069,0.9500,0.7563,1.0693,0.9062,0.7473,0.4261,0.2065,0.4298,0.3427,0.6618,0.5267,0.6362,0.7141,0.9321,0.7070,1.1220,0.6669,0.8263,0.6669,1.0608,0.2538,1.0818,0.7784,0.4537,0.7349,0.8669,0.4538,0.2444,0.1273,-0.2647,0.5686,0.4898,0.6199,1.3150,1.1688,0.3818,0.3028,-0.8318,1.2917,1.0161,0.0774,1.0368,1.1644,-0.0687,-0.1394,0.6983,0.6052,0.8832,0.7100,1.0659,1.0543,1.1443,1.0485,1.2004,1.3057,1.2536,1.4207,1.3571,-1.0266,0.5507,0.6986,0.6371,0.0803,0.4896,-0.1995,0.7373,1.2137,-0.3587,1.1977,0.2063,1.3496,0.5114,-0.4726,1.2701,2.7404,1.6817,1.6456,1.1986,0.1868,1.0004,0.5065,0.9420,0.7348,0.8311,-0.7930,0.6150,1.0714,1.2067,1.2425,1.2730,1.1968,1.4592,1.5688,1.5077,1.0881,0.9313,0.9990,0.5684,1.0551,-0.1024,0.2996,1.1416,1.3296,1.7691,0.8712,1.6156,0.4654,0.9865,2.1242,0.8445,1.2889,1.8472,0.5855,1.5743,1.0457,0.8600,1.3186,0.9223,1.1026,0.9134,1.1266,0.6134,1.2899,1.5382,1.2653,1.6661,1.9044,1.7415,1.7231,1.3423,1.4657,1.2603,1.1224,1.1943,0.9025,0.3183,1.0032,-0.2353,1.1062,2.4430,1.9017,1.7712,1.1830,0.9947 um",Expanded=N
|
||||
Identify=EnvDispSel,Choosing=0
|
||||
Identify=ATHistory,"TextUnit=22.45,22.45,22.45,22.45,22.45,22.45,22.45,22.45,22.45,22.45,22.45,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.46,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.47,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.48,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.49,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.50,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.51,22.52,22.52,22.52 C",Expanded=N
|
||||
Identify=APHistory,"TextUnit=730.7,730.6,730.6,730.6,730.6,730.6,730.6,730.6,730.6,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.6,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.5,730.4,730.5,730.5,730.5,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.4,730.3,730.4,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.3,730.2,730.2,730.2,730.2,730.2,730.2,730.2,730.2,730.2,730.2,730.2,730.2,730.2,730.2,730.1,730.1,730.1,730.1,730.1,730.1,730.1,730.1,730.2,730.2,730.1,730.2,730.1,730.2,730.1,730.1,730.2,730.2,730.1,730.1,730.1,730.1,730.1,730.1,730.1,730.1,730.1,730.2,730.1,730.1,730.1,730.1,730.1,730.1,730.1,730.1,730.1,730.1,730.1,730.1,730.1,730.0 mmHg",Expanded=N
|
||||
Identify=RHHistory,"TextUnit=55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55,55 %",Expanded=N
|
||||
Identify=MTHistory,"TextUnit=22.51,22.52,22.52,22.52,22.52,22.52,22.52,22.52,22.52,22.52,22.52,22.52,22.52,22.52,22.52,22.52,22.52,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.53,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.54,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.55,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.56,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.57,22.58,22.58,22.58,22.58,22.58,22.58,22.58,22.58,22.58,22.58,22.58,22.58,22.58,22.58,22.58,22.58 C",Expanded=N
|
||||
Identify=ProgHist,"ItemText=0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176,177,178,179,180",Expanded=N
|
||||
Identify=TimeHist,"ItemText=0,1,16,26,35,45,54,64,73,83,92,102,112,121,130,140,149,159,168,173,191,200,210,219,229,238,248,257,267,276,286,295,305,314,324,333,343,347,366,375,385,394,404,413,423,432,442,451,461,470,480,489,499,508,518,522,541,551,560,569,579,588,598,607,617,626,636,645,655,665,674,683,693,697,716,726,735,744,754,763,773,782,792,801,811,820,830,839,849,858,868,872,891,900,910,919,929,938,948,957,967,976,986,995,1005,1014,1024,1033,1043,1047,1066,1075,1085,1094,1104,1113,1123,1132,1142,1151,1161,1170,1180,1189,1199,1208,1218,1222,1241,1250,1260,1269,1279,1288,1298,1307,1317,1326,1336,1345,1355,1364,1374,1383,1393,1397,1416,1425,1435,1444,1454,1463,1473,1482,1490,1499,1509,1518,1528,1537,1547,1556,1566,1570,1588,1595,1605,1614,1624,1633,1643,1652,1662,1671,1681,1690,1700,1709,1719,1728,1738",Expanded=N
|
||||
Identify=NormRange,Choosing=1
|
||||
Identify=ATList,"TextUnit=22.45,,22.52,22.45,22.48,22.52 C",Expanded=N
|
||||
Identify=APList,"TextUnit=730.6,,730.7,730.0,730.4,730.0 mmHg",Expanded=N
|
||||
Identify=RHList,"TextUnit=55,,55,55,55,55 %",Expanded=N
|
||||
Identify=MT1List,"TextUnit=22.65,,22.72,22.65,22.68,22.72 C",Expanded=N
|
||||
Identify=MT2List,"TextUnit=22.37,,22.44,22.37,22.41,22.44 C",Expanded=N
|
||||
Identify=MT3List,"TextUnit=,,,,, C",Expanded=N
|
||||
Identify=EnvCount,ItemText=1879
|
||||
|
||||
<End of Option Description File - Rev. 1.00a>
|
||||
|
After Width: | Height: | Size: 3.3 MiB |
|
After Width: | Height: | Size: 3.5 MiB |
|
After Width: | Height: | Size: 3.7 MiB |
|
After Width: | Height: | Size: 3.4 MiB |
|
After Width: | Height: | Size: 3.1 MiB |
|
After Width: | Height: | Size: 3.4 MiB |
|
After Width: | Height: | Size: 3.4 MiB |
|
After Width: | Height: | Size: 3.5 MiB |
|
After Width: | Height: | Size: 1.9 MiB |
|
After Width: | Height: | Size: 3.3 MiB |
|
After Width: | Height: | Size: 2.5 MiB |
|
After Width: | Height: | Size: 3.7 MiB |
|
After Width: | Height: | Size: 3.2 MiB |
|
After Width: | Height: | Size: 3.5 MiB |
|
After Width: | Height: | Size: 3.2 MiB |
|
After Width: | Height: | Size: 3.6 MiB |
|
After Width: | Height: | Size: 3.6 MiB |
|
After Width: | Height: | Size: 3.4 MiB |
@@ -0,0 +1,16 @@
|
||||
# FAT report images
|
||||
|
||||
Place the six images referenced by the report template in this folder using these exact basenames (case-sensitive):
|
||||
|
||||
| Basename | Required subject |
|
||||
| --- | --- |
|
||||
| `I1` | Overall linear stage; appears first and on report page 1 |
|
||||
| `I2` | Encoder |
|
||||
| `I3` | Motor or actuator |
|
||||
| `I4` | Coupling |
|
||||
| `I5` | General FAT setup, view 1 |
|
||||
| `I6` | General FAT setup, view 2 |
|
||||
|
||||
Use `.jpg`, `.jpeg`, `.png`, or `.pdf` as the extension. For example, `I1.jpg` is valid. The basename-to-subject mapping is mandatory: do not guess, rename, or substitute an image when the correct evidence is missing. Keep source photographs unchanged and visually verify that each image shows the assigned subject.
|
||||
|
||||
See [`../Report/AGENTS.md`](../Report/AGENTS.md) for report preparation and image validation requirements.
|
||||
@@ -0,0 +1,7 @@
|
||||
# Motor or actuator evidence
|
||||
|
||||
Use this folder for project-specific evidence about the linear stage motor or actuator. Preserve source files and record the exact model and revision from a traceable source such as a nameplate photograph or manufacturer document.
|
||||
|
||||
Include relevant manufacturer documentation, wiring or connection details, and verified project settings when available. Keep commanded values, configured limits, measured results, and specifications clearly distinguished. Do not treat a nominal specification or configuration file as proof of FAT performance.
|
||||
|
||||
The report instructions are in [`../Report/AGENTS.md`](../Report/AGENTS.md). The report image for the motor or actuator belongs in `../Media/` as `I3` with a supported image extension; do not substitute a different component image.
|
||||
@@ -0,0 +1,190 @@
|
||||
<mxfile host="Electron" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/29.0.3 Chrome/140.0.7339.249 Electron/38.7.0 Safari/537.36" version="29.0.3">
|
||||
<diagram name="Report Workflow" id="OWy0dci5RTJpJNXqNlxN">
|
||||
<mxGraphModel dx="2824" dy="1894" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="2336" pageHeight="1654" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
<mxCell id="title" value="Linear-stage report workflow — evidence-bounded FAT or characterization" style="text;html=1;align=center;verticalAlign=middle;fontSize=22;fontStyle=1;fontColor=#1A1A1A;" parent="1" vertex="1">
|
||||
<mxGeometry x="230" y="20" width="1660" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="start" value="Start: create a project repository from the FAT_Template" style="ellipse;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;" parent="1" vertex="1">
|
||||
<mxGeometry x="60" y="294" width="210" height="70" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="collect" value="Collect and preserve source evidence<br>• measurements / raw data<br>• hardware and configuration evidence<br>• six mapped images I1–I6<br>• acceptance criteria (FAT only)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="327" y="274" width="300" height="110" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="workbook" value="Complete FAT_Checklist.xlsx during the test<br>• Report Type<br>• stage ID and repository URL<br>• coordinate convention<br>• explicit Yes/No and remarks" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="658" y="274" width="300" height="110" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="selector" value="Is the workbook Report Type<br>unambiguous and consistent?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=14;fontStyle=1;" parent="1" vertex="1">
|
||||
<mxGeometry x="994" y="269" width="190" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="resolve" value="Resolve with the user<br>Do not construct the report" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=14;" parent="1" vertex="1">
|
||||
<mxGeometry x="996" y="459" width="190" height="70" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="template" value="Select the authoritative static template<br>FAT → FAT template<br>Characterization → characterization template" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="1246" y="274" width="300" height="110" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="preflight" value="Evidence preflight<br>Read Report/AGENTS.md; inventory and hash inputs; inspect every image; confirm exact identities, dates, revisions, settings, calibration and PDF appendix set" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="1604" y="221.5" width="286" height="215" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="sufficient" value="Evidence sufficient<br>for a supported report?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=14;fontStyle=1;" parent="1" vertex="1">
|
||||
<mxGeometry x="1936" y="269" width="190" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="gaps" value="Record exact evidence gaps in workflow state<br>Prepare only an incomplete working draft; do not issue or infer values" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="2092" y="394" width="202" height="175" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="populate" value="Create a new project-specific report<br>Populate marked data only; transfer workbook answers by stable item ID; retain blanks; list exact evidence filenames; preserve fixed template prose/layout" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="22" y="644" width="360" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fat" value="FAT path<br>Trace criteria, results and uncertainty; compare only supported results; record deviations / owners / due dates; write evidence-backed conclusions" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="482" y="639" width="310" height="130" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="char" value="Characterization path<br>State scope and positioning / straightness results only; no acceptance criteria, pass/fail disposition, uncertainty commentary, observations or conclusions" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="482" y="809" width="310" height="130" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="build" value="Build and assemble<br>Compile with MiKTeX pdflatex twice; resolve errors/references; append every Measurements PDF as complete pages; retain workflow records under Report/unused/workflow" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="897" y="689" width="360" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="qa" value="Independent validation<br>1. Build/log check<br>2. Content/evidence check<br>3. Render and visually inspect every page<br>4. Verify appendices, logo, Repository URL, no placeholders or auxiliary files" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="1357" y="669" width="420" height="160" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="ready" value="All issued-report completion criteria met?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=14;fontStyle=1;" parent="1" vertex="1">
|
||||
<mxGeometry x="1847" y="689" width="170" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="correct" value="Correct source or evidence register<br>then rebuild and repeat all affected QA" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=14;" parent="1" vertex="1">
|
||||
<mxGeometry x="2008" y="834" width="300" height="75" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="review" value="Ready for issue review<br>Deliver project-specific .tex and .pdf; report page count, appended PDFs, validation status and residual unverified conditions" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="437" y="1087" width="390" height="95" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="issue" value="User explicitly directs issuance?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=14;fontStyle=1;" parent="1" vertex="1">
|
||||
<mxGeometry x="977" y="1074" width="190" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="hold" value="Keep as review-ready<br>Technical QA is not FAT acceptance authorization" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=14;" parent="1" vertex="1">
|
||||
<mxGeometry x="1284" y="1091" width="290" height="85" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="issued" value="Issue controlled report<br>Archive workflow state; do not claim acceptance without supported FAT disposition and authorization" style="ellipse;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;" parent="1" vertex="1">
|
||||
<mxGeometry x="922" y="1319" width="300" height="85" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e1" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="start" target="collect" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e2" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="collect" target="workbook" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e3" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="workbook" target="selector" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e4" value="No" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;" parent="1" source="selector" target="resolve" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e5" value="Yes" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;" parent="1" source="selector" target="template" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e6" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;entryX=0;entryY=0.5;entryDx=0;entryDy=0;" parent="1" source="template" target="preflight" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<mxPoint x="1613.999999999999" y="329.5" as="targetPoint" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e7" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" parent="1" source="preflight" target="sufficient" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<mxPoint x="1900" y="329.5" as="sourcePoint" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e8" value="No" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" parent="1" source="sufficient" target="gaps" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<mxPoint x="2148" y="326.47" as="sourcePoint" />
|
||||
<mxPoint x="2336" y="331.47" as="targetPoint" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e9" value="Yes" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;" parent="1" source="sufficient" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="2031" y="589" />
|
||||
<mxPoint x="180" y="589" />
|
||||
</Array>
|
||||
<mxPoint x="2120" y="439" as="sourcePoint" />
|
||||
<mxPoint x="180.0666666666666" y="644" as="targetPoint" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="wm-nTcyZt0jjmNqrfcTj-1" value="Yes" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];fontStyle=1" vertex="1" connectable="0" parent="e9">
|
||||
<mxGeometry x="-0.9863" relative="1" as="geometry">
|
||||
<mxPoint as="offset" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e10" value="FAT" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;" parent="1" source="populate" target="fat" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e11" value="Characterization" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;" parent="1" source="populate" target="char" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="407" y="874" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e12" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="fat" target="build" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="847" y="704" />
|
||||
<mxPoint x="847" y="749" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e13" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="char" target="build" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="847" y="874" />
|
||||
<mxPoint x="847" y="749" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e14" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="build" target="qa" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e15" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="qa" target="ready" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e16" value="No" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" parent="1" source="ready" target="correct" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e17" value="Yes" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;" parent="1" source="ready" target="review" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="1932" y="1039" />
|
||||
<mxPoint x="632" y="1039" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="wm-nTcyZt0jjmNqrfcTj-2" value="<b>Yes</b>" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" vertex="1" connectable="0" parent="e17">
|
||||
<mxGeometry x="-0.9713" y="1" relative="1" as="geometry">
|
||||
<mxPoint as="offset" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e18" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;dashed=1;" parent="1" source="correct" target="build" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="1607" y="979" />
|
||||
<mxPoint x="1607" y="869" />
|
||||
<mxPoint x="1077" y="869" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e19" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="review" target="issue" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e20" value="No" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;" parent="1" source="issue" target="hold" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e21" value="Yes" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;" parent="1" source="issue" target="issued" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="1072" y="1329" />
|
||||
<mxPoint x="1072" y="1329" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
@@ -0,0 +1,528 @@
|
||||
\documentclass[11pt,a4paper]{article}
|
||||
\usepackage[english]{babel}
|
||||
\usepackage[T1]{fontenc}
|
||||
\usepackage[utf8]{inputenc}
|
||||
\usepackage{lmodern}
|
||||
\usepackage[a4paper]{geometry}
|
||||
\usepackage{graphicx}
|
||||
\usepackage{tabularx}
|
||||
\usepackage{array}
|
||||
\usepackage{enumitem}
|
||||
\usepackage{amssymb}
|
||||
\usepackage{pdfpages}
|
||||
\usepackage{xurl}
|
||||
\usepackage{fancyhdr}
|
||||
|
||||
% Mirror the Kivel template's A4 text block and header/footer clearances.
|
||||
% The report content remains evidence-driven; this governs presentation only.
|
||||
\hoffset -5.4mm
|
||||
\voffset -5.4mm
|
||||
\marginparwidth 0mm
|
||||
\marginparsep 0mm
|
||||
\oddsidemargin 0mm
|
||||
\evensidemargin 0mm
|
||||
\textheight 244mm
|
||||
\textwidth 168mm
|
||||
\topmargin -12mm
|
||||
\headheight 12mm
|
||||
\headsep 25pt
|
||||
\columnsep 15pt
|
||||
\columnseprule 0pt
|
||||
\footskip 10mm
|
||||
|
||||
\setlength{\parindent}{0pt}
|
||||
\setlength{\parskip}{0.5em}
|
||||
\renewcommand{\arraystretch}{1.3}
|
||||
\widowpenalty=10000
|
||||
\clubpenalty=10000
|
||||
\setlength{\headheight}{12mm}
|
||||
\setlength{\headsep}{25pt}
|
||||
|
||||
\newcommand{\TBD}{\textbf{TBD}}
|
||||
\newcommand{\StageModel}{\TBD}
|
||||
\newcommand{\StageIdentifier}{\TBD}
|
||||
\newcommand{\EncoderModel}{\TBD}
|
||||
\newcommand{\MotorModel}{\TBD}
|
||||
\newcommand{\DriveModel}{\TBD}
|
||||
\newcommand{\EncoderInterface}{\TBD}
|
||||
\newcommand{\Controller}{\TBD}
|
||||
\newcommand{\MeasurementSystem}{\TBD}
|
||||
\newcommand{\TestDates}{\TBD}
|
||||
\newcommand{\TestOperator}{\TBD}
|
||||
\newcommand{\TravelRange}{\TBD}
|
||||
\newcommand{\ReportVersion}{0.1}
|
||||
\newcommand{\ReportDate}{\today}
|
||||
% Corporate-document metadata for the cover and running header. Update these
|
||||
% in a project-specific report; the baseline intentionally retains placeholders.
|
||||
% --------------------------------------------------------------------------
|
||||
% PROJECT DATA ENTRY -- edit values only in a project-specific report.
|
||||
% The narrative, checklist items, table structure and evidence mapping below
|
||||
% are fixed for a characterization. Every value must be traceable to project
|
||||
% evidence; \TBD is permitted in this baseline only, never in an issued report.
|
||||
% Use Linear_Stage_FAT_Report_Template.tex for a Factory Acceptance Test.
|
||||
% --------------------------------------------------------------------------
|
||||
\newcommand{\ProjectName}{\TBD}
|
||||
\newcommand{\DocumentNumber}{\TBD}
|
||||
% Set this to \url{https://...} in a project-specific report.
|
||||
\newcommand{\RepositoryLink}{\TBD}
|
||||
\newcommand{\ReportHeaderTitle}{Linear Stage Characterization Report}
|
||||
\newcommand{\ApplicableStandards}{\TBD}
|
||||
\newcommand{\ApplicableProcedures}{\TBD}
|
||||
\newcommand{\MeasurementProcedure}{\TBD}
|
||||
\newcommand{\EncoderResolutionAndScaling}{\TBD}
|
||||
\newcommand{\PositioningTravelAndTargets}{\TBD}
|
||||
\newcommand{\PositioningCyclesAndDirection}{\TBD}
|
||||
\newcommand{\PositioningMotionConditions}{\TBD}
|
||||
\newcommand{\PositioningOrientationsAndModes}{\TBD}
|
||||
\newcommand{\StraightnessMethod}{\TBD}
|
||||
\newcommand{\StraightnessCyclesAndDirection}{\TBD}
|
||||
\newcommand{\StraightnessMotionConditions}{\TBD}
|
||||
\newcommand{\StraightnessOrientationsAndModes}{\TBD}
|
||||
\newcommand{\PositioningTemperature}{\TBD}
|
||||
\newcommand{\PositioningPressure}{\TBD}
|
||||
\newcommand{\PositioningHumidity}{\TBD}
|
||||
\newcommand{\StraightnessTemperature}{\TBD}
|
||||
\newcommand{\StraightnessPressure}{\TBD}
|
||||
\newcommand{\StraightnessHumidity}{\TBD}
|
||||
\newcommand{\AdditionalTemperature}{\TBD}
|
||||
\newcommand{\AdditionalPressure}{\TBD}
|
||||
\newcommand{\AdditionalHumidity}{\TBD}
|
||||
\newcommand{\PositioningResult}{\TBD}
|
||||
\newcommand{\StraightnessResult}{\TBD}
|
||||
\newcommand{\StageReference}{\TBD}
|
||||
\newcommand{\ComponentReferences}{\TBD}
|
||||
\newcommand{\CalibrationReferences}{\TBD}
|
||||
% Replace each list body with exact evidence basenames. The appendix inclusion
|
||||
% list must be generated from the complete Measurement-PDF inventory.
|
||||
\newcommand{\RawFileList}{%
|
||||
\item \path{TBD_positioning_raw_file.ext}
|
||||
\item \path{TBD_straightness_raw_file.ext}
|
||||
\item \path{TBD_environment_log.ext}}
|
||||
\newcommand{\AnalysisFileList}{%
|
||||
\item \path{TBD_positioning_analysis.pdf}
|
||||
\item \path{TBD_straightness_analysis.pdf}}
|
||||
\newcommand{\MeasurementAppendixList}{%
|
||||
\item \path{TBD_positioning_analysis.pdf}
|
||||
\item \path{TBD_straightness_analysis.pdf}}
|
||||
\newcommand{\IncludeMeasurementPdf}[1]{%
|
||||
\includepdf[pages=-,fitpaper=false,scale=0.82,pagecommand={\thispagestyle{fatreport}}]{#1}}
|
||||
\newcommand{\MeasurementAppendices}{%
|
||||
% \IncludeMeasurementPdf{../Measurements/TBD_positioning_analysis.pdf}
|
||||
}
|
||||
\newcommand{\TestType}{Characterization}
|
||||
|
||||
% Required image basenames in ../Media: I1 through I6.
|
||||
% Supported extensions: .jpg, .jpeg, .png, and .pdf.
|
||||
\newcommand{\imageorplaceholder}[2][55mm]{%
|
||||
\IfFileExists{#2.jpg}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.jpg}}{%
|
||||
\IfFileExists{#2.jpeg}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.jpeg}}{%
|
||||
\IfFileExists{#2.png}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.png}}{%
|
||||
\IfFileExists{#2.pdf}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.pdf}}{%
|
||||
\fbox{\parbox[c][#1][c]{0.92\linewidth}{\centering Required image not found\\\path{#2.[jpg|jpeg|png|pdf]}}}}}}}}
|
||||
|
||||
% The two report templates use the same explicit Latin Modern font setup.
|
||||
% Keep the PSI identity in this Report folder with the controlled cover.
|
||||
\newcommand{\PSILogo}{%
|
||||
\IfFileExists{PSI_Logo.png}{%
|
||||
\includegraphics[width=32mm,height=11mm,keepaspectratio]{PSI_Logo.png}}{%
|
||||
\fbox{\parbox[c][9mm][c]{30mm}{\centering\scriptsize Required PSI logo not found}}}}
|
||||
|
||||
\newlength{\checklistitemwidth}
|
||||
\settowidth{\checklistitemwidth}{\small Measurement system calibrated}
|
||||
|
||||
% Running header and footer contain the report title, a separating rule, and
|
||||
% page/date traceability.
|
||||
\fancypagestyle{fatreport}{%
|
||||
\fancyhf{}
|
||||
\fancyhead[C]{\small \ReportHeaderTitle\\[-2pt]\rule{\textwidth}{0.5pt}}
|
||||
\fancyfoot[C]{\small Page~\thepage\quad(\ReportDate)}
|
||||
\renewcommand{\headrulewidth}{0pt}
|
||||
\renewcommand{\footrulewidth}{0.5pt}
|
||||
}
|
||||
\pagestyle{fatreport}
|
||||
|
||||
% BEGIN FIXED PROJECT DATA -- generated by fixed_tex_update.py
|
||||
\renewcommand{\AdditionalHumidity}{}
|
||||
\renewcommand{\AdditionalPressure}{}
|
||||
\renewcommand{\AdditionalTemperature}{}
|
||||
\renewcommand{\ApplicableProcedures}{}
|
||||
\renewcommand{\ApplicableStandards}{}
|
||||
\renewcommand{\CalibrationReferences}{}
|
||||
\renewcommand{\ComponentReferences}{}
|
||||
\renewcommand{\Controller}{}
|
||||
\renewcommand{\DocumentNumber}{}
|
||||
\renewcommand{\DriveModel}{}
|
||||
\renewcommand{\EncoderInterface}{}
|
||||
\renewcommand{\EncoderModel}{}
|
||||
\renewcommand{\EncoderResolutionAndScaling}{}
|
||||
\renewcommand{\MeasurementProcedure}{}
|
||||
\renewcommand{\MeasurementSystem}{}
|
||||
\renewcommand{\MotorModel}{}
|
||||
\renewcommand{\PositioningCyclesAndDirection}{}
|
||||
\renewcommand{\PositioningHumidity}{}
|
||||
\renewcommand{\PositioningMotionConditions}{}
|
||||
\renewcommand{\PositioningOrientationsAndModes}{}
|
||||
\renewcommand{\PositioningPressure}{}
|
||||
\renewcommand{\PositioningResult}{}
|
||||
\renewcommand{\PositioningTemperature}{}
|
||||
\renewcommand{\PositioningTravelAndTargets}{}
|
||||
\renewcommand{\ProjectName}{}
|
||||
\renewcommand{\ReportDate}{\today}
|
||||
\renewcommand{\ReportVersion}{0.1}
|
||||
\renewcommand{\RepositoryLink}{}
|
||||
\renewcommand{\StageIdentifier}{}
|
||||
\renewcommand{\StageModel}{}
|
||||
\renewcommand{\StageReference}{}
|
||||
\renewcommand{\StraightnessCyclesAndDirection}{}
|
||||
\renewcommand{\StraightnessHumidity}{}
|
||||
\renewcommand{\StraightnessMethod}{}
|
||||
\renewcommand{\StraightnessMotionConditions}{}
|
||||
\renewcommand{\StraightnessOrientationsAndModes}{}
|
||||
\renewcommand{\StraightnessPressure}{}
|
||||
\renewcommand{\StraightnessResult}{}
|
||||
\renewcommand{\StraightnessTemperature}{}
|
||||
\renewcommand{\TestDates}{}
|
||||
\renewcommand{\TestOperator}{}
|
||||
\renewcommand{\TravelRange}{}
|
||||
\renewcommand{\RawFileList}{%
|
||||
}
|
||||
\renewcommand{\AnalysisFileList}{%
|
||||
}
|
||||
\renewcommand{\MeasurementAppendixList}{%
|
||||
}
|
||||
\renewcommand{\MeasurementAppendices}{%
|
||||
}
|
||||
% END FIXED PROJECT DATA
|
||||
|
||||
\begin{document}
|
||||
|
||||
% Page 1 format adapted from Template-Kivel. I1 is retained as the first
|
||||
% image on page 1, as required by this FAT template's evidence rules.
|
||||
\enlargethispage*{3cm}
|
||||
\thispagestyle{empty}
|
||||
\vspace*{-15mm}
|
||||
\hspace*{-5mm}
|
||||
\setlength{\unitlength}{1mm}
|
||||
\begin{picture}(175,255)
|
||||
\sffamily
|
||||
\thicklines
|
||||
\put(0,255){\line(1,0){175}}
|
||||
\put(0,0){\line(1,0){175}}
|
||||
\put(0,0){\line(0,1){255}}
|
||||
\put(175,0){\line(0,1){255}}
|
||||
\put(0,241){\line(1,0){175}}
|
||||
\put(0,227){\line(1,0){175}}
|
||||
\put(0,211){\line(1,0){175}}
|
||||
\put(123,255){\line(0,-1){44}}
|
||||
\thinlines
|
||||
\put(0,9){\line(1,0){175}}
|
||||
\put(80,0){\line(0,1){9}}
|
||||
\put(130,0){\line(0,1){9}}
|
||||
|
||||
% Header fields
|
||||
\put(3,242.5){\PSILogo}
|
||||
\put(124,252){\scriptsize Project}
|
||||
\put(125,245){\bfseries\large \ProjectName}
|
||||
\put(2,237){\small Title}
|
||||
\put(20,234){\bfseries \ReportHeaderTitle}
|
||||
\put(124,238){\scriptsize Document Identification}
|
||||
\put(125,231){\footnotesize\bfseries \DocumentNumber}
|
||||
\put(1,221){\small Author}
|
||||
\put(30,221){\TestOperator}
|
||||
\put(124,224){\scriptsize Review Index}
|
||||
\put(130,217){\footnotesize\bfseries \ReportVersion}
|
||||
|
||||
% The central evidence field deliberately carries I1 at the same prominence as
|
||||
% the Kivel cover's primary content field; it is never substituted or inferred.
|
||||
\put(10,204){\bfseries Overall stage image}
|
||||
\put(30,120){\begin{minipage}[t]{12cm}\centering
|
||||
\imageorplaceholder[75mm]{../Media/I1}
|
||||
\end{minipage}}
|
||||
|
||||
% Equipment summary
|
||||
\put(10,75){\begin{minipage}[t]{15cm}
|
||||
\begin{tabularx}{\linewidth}{|l|X|}
|
||||
\hline
|
||||
\textbf{Test type} & \TestType \\ \hline
|
||||
\textbf{Stage identifier} & \StageIdentifier \\ \hline
|
||||
\textbf{Repository} & \RepositoryLink \\ \hline
|
||||
\textbf{Encoder} & \EncoderModel \\ \hline
|
||||
\textbf{Motor} & \MotorModel \\ \hline
|
||||
\textbf{Drive} & \DriveModel \\ \hline
|
||||
\textbf{Dates} & \TestDates \\ \hline
|
||||
\textbf{Applicable standards} & \ApplicableStandards \\ \hline
|
||||
\end{tabularx}
|
||||
\end{minipage}}
|
||||
|
||||
% Compact file traceability footer
|
||||
\put(1,6){\scriptsize File Name:}
|
||||
\put(20,6){\scriptsize \jobname.pdf}
|
||||
\put(1,2){\scriptsize Date:}
|
||||
\put(20,2){\scriptsize \ReportDate}
|
||||
\put(81,6){\scriptsize Author signature}
|
||||
\put(81,2){\scriptsize \TestOperator}
|
||||
\put(131,6){\scriptsize Date / Signature}
|
||||
\end{picture}
|
||||
\label{fig:I1_stage}
|
||||
|
||||
\clearpage
|
||||
\section{Test Checklists}
|
||||
|
||||
\subsection{Pre-Test Safety}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
2.1 & Risk assessment conducted & $\square$ & $\square$ & \\ \hline
|
||||
2.2 & Safety barriers in place & $\square$ & $\square$ & \\ \hline
|
||||
2.3 & E-stop functional & $\square$ & $\square$ & \\ \hline
|
||||
2.4 & Equipment grounded & $\square$ & $\square$ & \\ \hline
|
||||
2.5 & Personnel briefed & $\square$ & $\square$ & \\ \hline
|
||||
2.6 & Cable routing safe & $\square$ & $\square$ & \\ \hline
|
||||
2.7 & Environmental conditions OK & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\subsection{Equipment Verification}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
3.1 & Stage model verified & $\square$ & $\square$ & \\ \hline
|
||||
3.2 & Encoder model verified & $\square$ & $\square$ & \\ \hline
|
||||
3.3 & Motor model verified & $\square$ & $\square$ & \\ \hline
|
||||
3.4 & Drive model verified & $\square$ & $\square$ & \\ \hline
|
||||
3.5 & Encoder interface verified & $\square$ & $\square$ & \\ \hline
|
||||
3.6 & Measurement system calibrated & $\square$ & $\square$ & \\ \hline
|
||||
3.7 & Documentation available & $\square$ & $\square$ & \\ \hline
|
||||
3.8 & Calibration certificates valid & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\subsection{Mechanical and Electrical Checks}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
4.1 & Mounting interfaces verified & $\square$ & $\square$ & \\ \hline
|
||||
4.2 & Travel unobstructed & $\square$ & $\square$ & \\ \hline
|
||||
4.3 & End stops functional & $\square$ & $\square$ & \\ \hline
|
||||
4.4 & Cable carrier movement OK & $\square$ & $\square$ & \\ \hline
|
||||
4.5 & Encoder alignment checked & $\square$ & $\square$ & \\ \hline
|
||||
4.6 & Motor coupling secure & $\square$ & $\square$ & \\ \hline
|
||||
4.7 & Supply voltage verified & $\square$ & $\square$ & \\ \hline
|
||||
4.8 & Signal connections verified & $\square$ & $\square$ & \\ \hline
|
||||
4.9 & Ground continuity checked & $\square$ & $\square$ & \\ \hline
|
||||
4.10 & No abnormal noise or vibration & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\clearpage
|
||||
\subsection{Control System Verification}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
5.1 & Communication established & $\square$ & $\square$ & \\ \hline
|
||||
5.2 & Drive parameters verified & $\square$ & $\square$ & \\ \hline
|
||||
5.3 & Encoder scaling verified & $\square$ & $\square$ & \\ \hline
|
||||
5.4 & Current or force limit verified & $\square$ & $\square$ & \\ \hline
|
||||
5.5 & Homing or referencing functional & $\square$ & $\square$ & \\ \hline
|
||||
5.6 & Software limits configured & $\square$ & $\square$ & \\ \hline
|
||||
5.7 & E-stop response verified & $\square$ & $\square$ & \\ \hline
|
||||
5.8 & Motion profile verified & $\square$ & $\square$ & \\ \hline
|
||||
5.9 & Closed-loop stability verified & $\square$ & $\square$ & \\ \hline
|
||||
5.10 & Following error acceptable & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\subsection{Test Execution}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
6.1 & Measurement system aligned & $\square$ & $\square$ & \\ \hline
|
||||
6.2 & Environmental compensation set & $\square$ & $\square$ & \\ \hline
|
||||
6.3 & Test parameters recorded & $\square$ & $\square$ & \\ \hline
|
||||
6.4 & Required cycles completed & $\square$ & $\square$ & \\ \hline
|
||||
6.5 & Raw data saved & $\square$ & $\square$ & \\ \hline
|
||||
6.6 & Analysis files generated & $\square$ & $\square$ & \\ \hline
|
||||
6.7 & Environmental data logged & $\square$ & $\square$ & \\ \hline
|
||||
6.8 & All configurations tested & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
|
||||
\clearpage
|
||||
\section{Hardware and Configuration}
|
||||
|
||||
|
||||
\subsection{Coordinate Convention}
|
||||
\begin{tabularx}{\textwidth}{>{\bfseries}p{45mm}X}
|
||||
\hline
|
||||
Quantity & Project convention (defaults shown) \\ \hline
|
||||
Linear stage travel & Z axis \\
|
||||
Vertical direction & Y axis, perpendicular to Z \\
|
||||
Horizontal direction & X axis, perpendicular to Y and Z \\
|
||||
Roll & Rotation about Z (travel axis) \\
|
||||
Yaw & Rotation about Y (vertical axis) \\
|
||||
Pitch & Rotation about X (horizontal axis) \\
|
||||
Positive rotational direction & Right-hand rule \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
|
||||
\begin{tabularx}{\textwidth}{>{\bfseries}p{45mm}X}
|
||||
\hline
|
||||
Component & Verified specification \\ \hline
|
||||
Stage & \StageModel \\
|
||||
Stage identifier & \StageIdentifier \\
|
||||
Travel & \TravelRange \\
|
||||
Encoder & \EncoderModel \\
|
||||
Encoder interface & \EncoderInterface \\
|
||||
Encoder resolution and scaling & \EncoderResolutionAndScaling \\
|
||||
Motor or actuator & \MotorModel \\
|
||||
Drive & \DriveModel \\
|
||||
Controller and control mode & \Controller \\
|
||||
Measurement system & \MeasurementSystem \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
|
||||
|
||||
\clearpage
|
||||
|
||||
|
||||
\begin{figure}[htbp]
|
||||
\centering
|
||||
\begin{minipage}[b]{0.32\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[45mm]{../Media/I2}
|
||||
\caption{Encoder}
|
||||
\label{fig:I2_encoder}
|
||||
\end{minipage}
|
||||
\hfill
|
||||
\begin{minipage}[b]{0.32\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[45mm]{../Media/I3}
|
||||
\caption{Motor}
|
||||
\label{fig:I3_motor}
|
||||
\end{minipage}
|
||||
\hfill
|
||||
\begin{minipage}[b]{0.32\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[45mm]{../Media/I4}
|
||||
\caption{Motor coupling}
|
||||
\label{fig:I4_coupling}
|
||||
\end{minipage}
|
||||
\end{figure}
|
||||
|
||||
\begin{figure}[htbp]
|
||||
\centering
|
||||
\begin{minipage}[b]{0.48\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[65mm]{../Media/I5}
|
||||
\caption{General test setup - view 1}
|
||||
\label{fig:I5_setup1}
|
||||
\end{minipage}
|
||||
\hfill
|
||||
\begin{minipage}[b]{0.48\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[65mm]{../Media/I6}
|
||||
\caption{General test setup - view 2}
|
||||
\label{fig:I6_setup2}
|
||||
\end{minipage}
|
||||
\end{figure}
|
||||
|
||||
\clearpage
|
||||
\section{Test Description}
|
||||
\subsection{Applicable Standards and Procedures}
|
||||
\begin{itemize}
|
||||
\item Applicable standard(s), edition(s), and clause(s): \ApplicableStandards
|
||||
\item Internal test procedure and revision: \ApplicableProcedures
|
||||
\item Measurement-system operating procedure and revision: \MeasurementProcedure
|
||||
\end{itemize}
|
||||
|
||||
\subsection{Positioning Test}
|
||||
\begin{tabularx}{\textwidth}{>{\raggedright\arraybackslash}p{0.42\textwidth}X}
|
||||
\hline
|
||||
\textbf{Parameter} & \textbf{Characterization setup} \\ \hline
|
||||
Travel and target positions & \PositioningTravelAndTargets \\
|
||||
Number and direction of cycles & \PositioningCyclesAndDirection \\
|
||||
Velocity, acceleration, and settling criterion & \PositioningMotionConditions \\
|
||||
Tested orientations and control modes & \PositioningOrientationsAndModes \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
\subsection{Straightness Test}
|
||||
\begin{tabularx}{\textwidth}{>{\raggedright\arraybackslash}p{0.42\textwidth}X}
|
||||
\hline
|
||||
\textbf{Parameter} & \textbf{Characterization setup} \\ \hline
|
||||
Travel range, target positions, planes, and point spacing & \StraightnessMethod \\
|
||||
Number and direction of cycles & \StraightnessCyclesAndDirection \\
|
||||
Velocity, acceleration, and settling criterion & \StraightnessMotionConditions \\
|
||||
Tested orientations and control modes & \StraightnessOrientationsAndModes \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
\section{Environmental Conditions}
|
||||
\begin{tabularx}{\textwidth}{lXXX}
|
||||
\hline
|
||||
Test & Temperature ($^\circ$C) & Pressure & Humidity (\%) \\ \hline
|
||||
Positioning & \PositioningTemperature & \PositioningPressure & \PositioningHumidity \\
|
||||
Straightness & \StraightnessTemperature & \StraightnessPressure & \StraightnessHumidity \\
|
||||
Additional test & \AdditionalTemperature & \AdditionalPressure & \AdditionalHumidity \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
\clearpage
|
||||
\pagestyle{fatreport}
|
||||
\thispagestyle{fatreport}
|
||||
\vspace*{2mm}
|
||||
\section{Test Files and Data}
|
||||
The following exact evidence basenames identify the delivered raw and analysis files.
|
||||
|
||||
\subsection{Raw Files}
|
||||
\begin{itemize}
|
||||
\RawFileList
|
||||
\end{itemize}
|
||||
|
||||
\subsection{Analysis Files}
|
||||
\begin{itemize}
|
||||
\AnalysisFileList
|
||||
\end{itemize}
|
||||
|
||||
\section{Characterization Results}
|
||||
\begin{tabularx}{\textwidth}{>{\bfseries}p{45mm}X}
|
||||
\hline
|
||||
Test & Result \\ \hline
|
||||
Positioning & \PositioningResult \\
|
||||
Straightness & \StraightnessResult \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
\section*{References}
|
||||
\begin{itemize}
|
||||
\item Stage manufacturer document, number, and revision: \StageReference
|
||||
\item Encoder, motor, drive, and controller documents and revisions: \ComponentReferences
|
||||
\item Standards and procedures: \ApplicableStandards; \ApplicableProcedures; \MeasurementProcedure
|
||||
\item Calibration certificates: \CalibrationReferences
|
||||
\end{itemize}
|
||||
|
||||
\clearpage
|
||||
\pagestyle{fatreport}
|
||||
\thispagestyle{fatreport}
|
||||
\vspace*{20mm}
|
||||
\section*{Document History}
|
||||
\begin{center}
|
||||
\begin{tabularx}{\textwidth}{|l|l|X|}
|
||||
\hline
|
||||
Date & Version & Description \\ \hline
|
||||
\ReportDate & \ReportVersion & Initial project-specific report generated from template \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\section*{Appendix: Measurement Analysis Files}
|
||||
The following measurement analysis documents are attached in the listed order.
|
||||
|
||||
\begin{itemize}
|
||||
\MeasurementAppendixList
|
||||
\end{itemize}
|
||||
|
||||
\MeasurementAppendices
|
||||
|
||||
\end{document}
|
||||
|
After Width: | Height: | Size: 9.5 KiB |
@@ -0,0 +1,475 @@
|
||||
\documentclass[11pt,a4paper]{article}
|
||||
\usepackage[english]{babel}
|
||||
\usepackage[T1]{fontenc}
|
||||
\usepackage[utf8]{inputenc}
|
||||
\usepackage{lmodern}
|
||||
\usepackage[a4paper]{geometry}
|
||||
\usepackage{graphicx}
|
||||
\usepackage{tabularx}
|
||||
\usepackage{array}
|
||||
\usepackage{enumitem}
|
||||
\usepackage{amssymb}
|
||||
\usepackage{pdfpages}
|
||||
\usepackage{xurl}
|
||||
\usepackage{fancyhdr}
|
||||
|
||||
% Mirror the Kivel template's A4 text block and header/footer clearances.
|
||||
% The report content remains evidence-driven; this governs presentation only.
|
||||
\hoffset -5.4mm
|
||||
\voffset -5.4mm
|
||||
\marginparwidth 0mm
|
||||
\marginparsep 0mm
|
||||
\oddsidemargin 0mm
|
||||
\evensidemargin 0mm
|
||||
\textheight 244mm
|
||||
\textwidth 168mm
|
||||
\topmargin -12mm
|
||||
\headheight 12mm
|
||||
\headsep 25pt
|
||||
\columnsep 15pt
|
||||
\columnseprule 0pt
|
||||
\footskip 10mm
|
||||
|
||||
\setlength{\parindent}{0pt}
|
||||
\setlength{\parskip}{0.5em}
|
||||
\renewcommand{\arraystretch}{1.3}
|
||||
\widowpenalty=10000
|
||||
\clubpenalty=10000
|
||||
\setlength{\headheight}{12mm}
|
||||
\setlength{\headsep}{25pt}
|
||||
|
||||
\newcommand{\TBD}{\textbf{TBD}}
|
||||
\newcommand{\StageModel}{\TBD}
|
||||
\newcommand{\StageIdentifier}{\TBD}
|
||||
\newcommand{\EncoderModel}{\TBD}
|
||||
\newcommand{\MotorModel}{\TBD}
|
||||
\newcommand{\DriveModel}{\TBD}
|
||||
\newcommand{\EncoderInterface}{\TBD}
|
||||
\newcommand{\Controller}{\TBD}
|
||||
\newcommand{\MeasurementSystem}{\TBD}
|
||||
\newcommand{\TestDates}{\TBD}
|
||||
\newcommand{\TestOperator}{\TBD}
|
||||
\newcommand{\TravelRange}{\TBD}
|
||||
\newcommand{\ReportVersion}{0.1}
|
||||
\newcommand{\ReportDate}{\today}
|
||||
% Corporate-document metadata for the cover and running header. Update these
|
||||
% in a project-specific report; the baseline intentionally retains placeholders.
|
||||
% --------------------------------------------------------------------------
|
||||
% PROJECT DATA ENTRY -- edit values only in a project-specific report.
|
||||
% The narrative, checklist items, table structure and evidence mapping below
|
||||
% are fixed for a characterization. Every value must be traceable to project
|
||||
% evidence; \TBD is permitted in this baseline only, never in an issued report.
|
||||
% Use Linear_Stage_FAT_Report_Template.tex for a Factory Acceptance Test.
|
||||
% --------------------------------------------------------------------------
|
||||
\newcommand{\ProjectName}{\TBD}
|
||||
\newcommand{\DocumentNumber}{\TBD}
|
||||
% Set this to \url{https://...} in a project-specific report.
|
||||
\newcommand{\RepositoryLink}{\TBD}
|
||||
\newcommand{\ReportHeaderTitle}{Linear Stage Characterization Report}
|
||||
\newcommand{\ApplicableStandards}{\TBD}
|
||||
\newcommand{\ApplicableProcedures}{\TBD}
|
||||
\newcommand{\MeasurementProcedure}{\TBD}
|
||||
\newcommand{\EncoderResolutionAndScaling}{\TBD}
|
||||
\newcommand{\PositioningTravelAndTargets}{\TBD}
|
||||
\newcommand{\PositioningCyclesAndDirection}{\TBD}
|
||||
\newcommand{\PositioningMotionConditions}{\TBD}
|
||||
\newcommand{\PositioningOrientationsAndModes}{\TBD}
|
||||
\newcommand{\StraightnessMethod}{\TBD}
|
||||
\newcommand{\StraightnessCyclesAndDirection}{\TBD}
|
||||
\newcommand{\StraightnessMotionConditions}{\TBD}
|
||||
\newcommand{\StraightnessOrientationsAndModes}{\TBD}
|
||||
\newcommand{\PositioningTemperature}{\TBD}
|
||||
\newcommand{\PositioningPressure}{\TBD}
|
||||
\newcommand{\PositioningHumidity}{\TBD}
|
||||
\newcommand{\StraightnessTemperature}{\TBD}
|
||||
\newcommand{\StraightnessPressure}{\TBD}
|
||||
\newcommand{\StraightnessHumidity}{\TBD}
|
||||
\newcommand{\AdditionalTemperature}{\TBD}
|
||||
\newcommand{\AdditionalPressure}{\TBD}
|
||||
\newcommand{\AdditionalHumidity}{\TBD}
|
||||
\newcommand{\PositioningResult}{\TBD}
|
||||
\newcommand{\StraightnessResult}{\TBD}
|
||||
\newcommand{\StageReference}{\TBD}
|
||||
\newcommand{\ComponentReferences}{\TBD}
|
||||
\newcommand{\CalibrationReferences}{\TBD}
|
||||
% Replace each list body with exact evidence basenames. The appendix inclusion
|
||||
% list must be generated from the complete Measurement-PDF inventory.
|
||||
\newcommand{\RawFileList}{%
|
||||
\item \path{TBD_positioning_raw_file.ext}
|
||||
\item \path{TBD_straightness_raw_file.ext}
|
||||
\item \path{TBD_environment_log.ext}}
|
||||
\newcommand{\AnalysisFileList}{%
|
||||
\item \path{TBD_positioning_analysis.pdf}
|
||||
\item \path{TBD_straightness_analysis.pdf}}
|
||||
\newcommand{\MeasurementAppendixList}{%
|
||||
\item \path{TBD_positioning_analysis.pdf}
|
||||
\item \path{TBD_straightness_analysis.pdf}}
|
||||
\newcommand{\IncludeMeasurementPdf}[1]{%
|
||||
\includepdf[pages=-,fitpaper=false,scale=0.82,pagecommand={\thispagestyle{fatreport}}]{#1}}
|
||||
\newcommand{\MeasurementAppendices}{%
|
||||
% \IncludeMeasurementPdf{../Measurements/TBD_positioning_analysis.pdf}
|
||||
}
|
||||
\newcommand{\TestType}{Characterization}
|
||||
|
||||
% Required image basenames in ../Media: I1 through I6.
|
||||
% Supported extensions: .jpg, .jpeg, .png, and .pdf.
|
||||
\newcommand{\imageorplaceholder}[2][55mm]{%
|
||||
\IfFileExists{#2.jpg}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.jpg}}{%
|
||||
\IfFileExists{#2.jpeg}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.jpeg}}{%
|
||||
\IfFileExists{#2.png}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.png}}{%
|
||||
\IfFileExists{#2.pdf}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.pdf}}{%
|
||||
\fbox{\parbox[c][#1][c]{0.92\linewidth}{\centering Required image not found\\\path{#2.[jpg|jpeg|png|pdf]}}}}}}}}
|
||||
|
||||
% The two report templates use the same explicit Latin Modern font setup.
|
||||
% Keep the PSI identity in this Report folder with the controlled cover.
|
||||
\newcommand{\PSILogo}{%
|
||||
\IfFileExists{PSI_Logo.png}{%
|
||||
\includegraphics[width=32mm,height=11mm,keepaspectratio]{PSI_Logo.png}}{%
|
||||
\fbox{\parbox[c][9mm][c]{30mm}{\centering\scriptsize Required PSI logo not found}}}}
|
||||
|
||||
\newlength{\checklistitemwidth}
|
||||
\settowidth{\checklistitemwidth}{\small Measurement system calibrated}
|
||||
|
||||
% Running header and footer contain the report title, a separating rule, and
|
||||
% page/date traceability.
|
||||
\fancypagestyle{fatreport}{%
|
||||
\fancyhf{}
|
||||
\fancyhead[C]{\small \ReportHeaderTitle\\[-2pt]\rule{\textwidth}{0.5pt}}
|
||||
\fancyfoot[C]{\small Page~\thepage\quad(\ReportDate)}
|
||||
\renewcommand{\headrulewidth}{0pt}
|
||||
\renewcommand{\footrulewidth}{0.5pt}
|
||||
}
|
||||
\pagestyle{fatreport}
|
||||
|
||||
\begin{document}
|
||||
|
||||
% Page 1 format adapted from Template-Kivel. I1 is retained as the first
|
||||
% image on page 1, as required by this FAT template's evidence rules.
|
||||
\enlargethispage*{3cm}
|
||||
\thispagestyle{empty}
|
||||
\vspace*{-15mm}
|
||||
\hspace*{-5mm}
|
||||
\setlength{\unitlength}{1mm}
|
||||
\begin{picture}(175,255)
|
||||
\sffamily
|
||||
\thicklines
|
||||
\put(0,255){\line(1,0){175}}
|
||||
\put(0,0){\line(1,0){175}}
|
||||
\put(0,0){\line(0,1){255}}
|
||||
\put(175,0){\line(0,1){255}}
|
||||
\put(0,241){\line(1,0){175}}
|
||||
\put(0,227){\line(1,0){175}}
|
||||
\put(0,211){\line(1,0){175}}
|
||||
\put(123,255){\line(0,-1){44}}
|
||||
\thinlines
|
||||
\put(0,9){\line(1,0){175}}
|
||||
\put(80,0){\line(0,1){9}}
|
||||
\put(130,0){\line(0,1){9}}
|
||||
|
||||
% Header fields
|
||||
\put(3,242.5){\PSILogo}
|
||||
\put(124,252){\scriptsize Project}
|
||||
\put(125,245){\bfseries\large \ProjectName}
|
||||
\put(2,237){\small Title}
|
||||
\put(20,234){\bfseries \ReportHeaderTitle}
|
||||
\put(124,238){\scriptsize Document Identification}
|
||||
\put(125,231){\footnotesize\bfseries \DocumentNumber}
|
||||
\put(1,221){\small Author}
|
||||
\put(30,221){\TestOperator}
|
||||
\put(124,224){\scriptsize Review Index}
|
||||
\put(130,217){\footnotesize\bfseries \ReportVersion}
|
||||
|
||||
% The central evidence field deliberately carries I1 at the same prominence as
|
||||
% the Kivel cover's primary content field; it is never substituted or inferred.
|
||||
\put(10,204){\bfseries Overall stage image}
|
||||
\put(30,120){\begin{minipage}[t]{12cm}\centering
|
||||
\imageorplaceholder[75mm]{../Media/I1}
|
||||
\end{minipage}}
|
||||
|
||||
% Equipment summary
|
||||
\put(10,75){\begin{minipage}[t]{15cm}
|
||||
\begin{tabularx}{\linewidth}{|l|X|}
|
||||
\hline
|
||||
\textbf{Test type} & \TestType \\ \hline
|
||||
\textbf{Stage identifier} & \StageIdentifier \\ \hline
|
||||
\textbf{Repository} & \RepositoryLink \\ \hline
|
||||
\textbf{Encoder} & \EncoderModel \\ \hline
|
||||
\textbf{Motor} & \MotorModel \\ \hline
|
||||
\textbf{Drive} & \DriveModel \\ \hline
|
||||
\textbf{Dates} & \TestDates \\ \hline
|
||||
\textbf{Applicable standards} & \ApplicableStandards \\ \hline
|
||||
\end{tabularx}
|
||||
\end{minipage}}
|
||||
|
||||
% Compact file traceability footer
|
||||
\put(1,6){\scriptsize File Name:}
|
||||
\put(20,6){\scriptsize \jobname.pdf}
|
||||
\put(1,2){\scriptsize Date:}
|
||||
\put(20,2){\scriptsize \ReportDate}
|
||||
\put(81,6){\scriptsize Author signature}
|
||||
\put(81,2){\scriptsize \TestOperator}
|
||||
\put(131,6){\scriptsize Date / Signature}
|
||||
\end{picture}
|
||||
\label{fig:I1_stage}
|
||||
|
||||
\clearpage
|
||||
\section{Test Checklists}
|
||||
|
||||
\subsection{Pre-Test Safety}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
2.1 & Risk assessment conducted & $\square$ & $\square$ & \\ \hline
|
||||
2.2 & Safety barriers in place & $\square$ & $\square$ & \\ \hline
|
||||
2.3 & E-stop functional & $\square$ & $\square$ & \\ \hline
|
||||
2.4 & Equipment grounded & $\square$ & $\square$ & \\ \hline
|
||||
2.5 & Personnel briefed & $\square$ & $\square$ & \\ \hline
|
||||
2.6 & Cable routing safe & $\square$ & $\square$ & \\ \hline
|
||||
2.7 & Environmental conditions OK & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\subsection{Equipment Verification}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
3.1 & Stage model verified & $\square$ & $\square$ & \\ \hline
|
||||
3.2 & Encoder model verified & $\square$ & $\square$ & \\ \hline
|
||||
3.3 & Motor model verified & $\square$ & $\square$ & \\ \hline
|
||||
3.4 & Drive model verified & $\square$ & $\square$ & \\ \hline
|
||||
3.5 & Encoder interface verified & $\square$ & $\square$ & \\ \hline
|
||||
3.6 & Measurement system calibrated & $\square$ & $\square$ & \\ \hline
|
||||
3.7 & Documentation available & $\square$ & $\square$ & \\ \hline
|
||||
3.8 & Calibration certificates valid & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\subsection{Mechanical and Electrical Checks}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
4.1 & Mounting interfaces verified & $\square$ & $\square$ & \\ \hline
|
||||
4.2 & Travel unobstructed & $\square$ & $\square$ & \\ \hline
|
||||
4.3 & End stops functional & $\square$ & $\square$ & \\ \hline
|
||||
4.4 & Cable carrier movement OK & $\square$ & $\square$ & \\ \hline
|
||||
4.5 & Encoder alignment checked & $\square$ & $\square$ & \\ \hline
|
||||
4.6 & Motor coupling secure & $\square$ & $\square$ & \\ \hline
|
||||
4.7 & Supply voltage verified & $\square$ & $\square$ & \\ \hline
|
||||
4.8 & Signal connections verified & $\square$ & $\square$ & \\ \hline
|
||||
4.9 & Ground continuity checked & $\square$ & $\square$ & \\ \hline
|
||||
4.10 & No abnormal noise or vibration & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\clearpage
|
||||
\subsection{Control System Verification}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
5.1 & Communication established & $\square$ & $\square$ & \\ \hline
|
||||
5.2 & Drive parameters verified & $\square$ & $\square$ & \\ \hline
|
||||
5.3 & Encoder scaling verified & $\square$ & $\square$ & \\ \hline
|
||||
5.4 & Current or force limit verified & $\square$ & $\square$ & \\ \hline
|
||||
5.5 & Homing or referencing functional & $\square$ & $\square$ & \\ \hline
|
||||
5.6 & Software limits configured & $\square$ & $\square$ & \\ \hline
|
||||
5.7 & E-stop response verified & $\square$ & $\square$ & \\ \hline
|
||||
5.8 & Motion profile verified & $\square$ & $\square$ & \\ \hline
|
||||
5.9 & Closed-loop stability verified & $\square$ & $\square$ & \\ \hline
|
||||
5.10 & Following error acceptable & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\subsection{Test Execution}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
6.1 & Measurement system aligned & $\square$ & $\square$ & \\ \hline
|
||||
6.2 & Environmental compensation set & $\square$ & $\square$ & \\ \hline
|
||||
6.3 & Test parameters recorded & $\square$ & $\square$ & \\ \hline
|
||||
6.4 & Required cycles completed & $\square$ & $\square$ & \\ \hline
|
||||
6.5 & Raw data saved & $\square$ & $\square$ & \\ \hline
|
||||
6.6 & Analysis files generated & $\square$ & $\square$ & \\ \hline
|
||||
6.7 & Environmental data logged & $\square$ & $\square$ & \\ \hline
|
||||
6.8 & All configurations tested & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
|
||||
\clearpage
|
||||
\section{Hardware and Configuration}
|
||||
|
||||
|
||||
\subsection{Coordinate Convention}
|
||||
\begin{tabularx}{\textwidth}{>{\bfseries}p{45mm}X}
|
||||
\hline
|
||||
Quantity & Project convention (defaults shown) \\ \hline
|
||||
Linear stage travel & Z axis \\
|
||||
Vertical direction & Y axis, perpendicular to Z \\
|
||||
Horizontal direction & X axis, perpendicular to Y and Z \\
|
||||
Roll & Rotation about Z (travel axis) \\
|
||||
Yaw & Rotation about Y (vertical axis) \\
|
||||
Pitch & Rotation about X (horizontal axis) \\
|
||||
Positive rotational direction & Right-hand rule \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
|
||||
\begin{tabularx}{\textwidth}{>{\bfseries}p{45mm}X}
|
||||
\hline
|
||||
Component & Verified specification \\ \hline
|
||||
Stage & \StageModel \\
|
||||
Stage identifier & \StageIdentifier \\
|
||||
Travel & \TravelRange \\
|
||||
Encoder & \EncoderModel \\
|
||||
Encoder interface & \EncoderInterface \\
|
||||
Encoder resolution and scaling & \EncoderResolutionAndScaling \\
|
||||
Motor or actuator & \MotorModel \\
|
||||
Drive & \DriveModel \\
|
||||
Controller and control mode & \Controller \\
|
||||
Measurement system & \MeasurementSystem \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
|
||||
|
||||
\clearpage
|
||||
|
||||
|
||||
\begin{figure}[htbp]
|
||||
\centering
|
||||
\begin{minipage}[b]{0.32\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[45mm]{../Media/I2}
|
||||
\caption{Encoder}
|
||||
\label{fig:I2_encoder}
|
||||
\end{minipage}
|
||||
\hfill
|
||||
\begin{minipage}[b]{0.32\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[45mm]{../Media/I3}
|
||||
\caption{Motor}
|
||||
\label{fig:I3_motor}
|
||||
\end{minipage}
|
||||
\hfill
|
||||
\begin{minipage}[b]{0.32\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[45mm]{../Media/I4}
|
||||
\caption{Motor coupling}
|
||||
\label{fig:I4_coupling}
|
||||
\end{minipage}
|
||||
\end{figure}
|
||||
|
||||
\begin{figure}[htbp]
|
||||
\centering
|
||||
\begin{minipage}[b]{0.48\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[65mm]{../Media/I5}
|
||||
\caption{General test setup - view 1}
|
||||
\label{fig:I5_setup1}
|
||||
\end{minipage}
|
||||
\hfill
|
||||
\begin{minipage}[b]{0.48\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[65mm]{../Media/I6}
|
||||
\caption{General test setup - view 2}
|
||||
\label{fig:I6_setup2}
|
||||
\end{minipage}
|
||||
\end{figure}
|
||||
|
||||
\clearpage
|
||||
\section{Test Description}
|
||||
\subsection{Applicable Standards and Procedures}
|
||||
\begin{itemize}
|
||||
\item Applicable standard(s), edition(s), and clause(s): \ApplicableStandards
|
||||
\item Internal test procedure and revision: \ApplicableProcedures
|
||||
\item Measurement-system operating procedure and revision: \MeasurementProcedure
|
||||
\end{itemize}
|
||||
|
||||
\subsection{Positioning Test}
|
||||
\begin{tabularx}{\textwidth}{>{\raggedright\arraybackslash}p{0.42\textwidth}X}
|
||||
\hline
|
||||
\textbf{Parameter} & \textbf{Characterization setup} \\ \hline
|
||||
Travel and target positions & \PositioningTravelAndTargets \\
|
||||
Number and direction of cycles & \PositioningCyclesAndDirection \\
|
||||
Velocity, acceleration, and settling criterion & \PositioningMotionConditions \\
|
||||
Tested orientations and control modes & \PositioningOrientationsAndModes \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
\subsection{Straightness Test}
|
||||
\begin{tabularx}{\textwidth}{>{\raggedright\arraybackslash}p{0.42\textwidth}X}
|
||||
\hline
|
||||
\textbf{Parameter} & \textbf{Characterization setup} \\ \hline
|
||||
Travel range, target positions, planes, and point spacing & \StraightnessMethod \\
|
||||
Number and direction of cycles & \StraightnessCyclesAndDirection \\
|
||||
Velocity, acceleration, and settling criterion & \StraightnessMotionConditions \\
|
||||
Tested orientations and control modes & \StraightnessOrientationsAndModes \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
\section{Environmental Conditions}
|
||||
\begin{tabularx}{\textwidth}{lXXX}
|
||||
\hline
|
||||
Test & Temperature ($^\circ$C) & Pressure & Humidity (\%) \\ \hline
|
||||
Positioning & \PositioningTemperature & \PositioningPressure & \PositioningHumidity \\
|
||||
Straightness & \StraightnessTemperature & \StraightnessPressure & \StraightnessHumidity \\
|
||||
Additional test & \AdditionalTemperature & \AdditionalPressure & \AdditionalHumidity \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
\clearpage
|
||||
\pagestyle{fatreport}
|
||||
\thispagestyle{fatreport}
|
||||
\vspace*{2mm}
|
||||
\section{Test Files and Data}
|
||||
The following exact evidence basenames identify the delivered raw and analysis files.
|
||||
|
||||
\subsection{Raw Files}
|
||||
\begin{itemize}
|
||||
\RawFileList
|
||||
\end{itemize}
|
||||
|
||||
\subsection{Analysis Files}
|
||||
\begin{itemize}
|
||||
\AnalysisFileList
|
||||
\end{itemize}
|
||||
|
||||
\section{Characterization Results}
|
||||
\begin{tabularx}{\textwidth}{>{\bfseries}p{45mm}X}
|
||||
\hline
|
||||
Test & Result \\ \hline
|
||||
Positioning & \PositioningResult \\
|
||||
Straightness & \StraightnessResult \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
\section*{References}
|
||||
\begin{itemize}
|
||||
\item Stage manufacturer document, number, and revision: \StageReference
|
||||
\item Encoder, motor, drive, and controller documents and revisions: \ComponentReferences
|
||||
\item Standards and procedures: \ApplicableStandards; \ApplicableProcedures; \MeasurementProcedure
|
||||
\item Calibration certificates: \CalibrationReferences
|
||||
\end{itemize}
|
||||
|
||||
\clearpage
|
||||
\pagestyle{fatreport}
|
||||
\thispagestyle{fatreport}
|
||||
\vspace*{20mm}
|
||||
\section*{Document History}
|
||||
\begin{center}
|
||||
\begin{tabularx}{\textwidth}{|l|l|X|}
|
||||
\hline
|
||||
Date & Version & Description \\ \hline
|
||||
\ReportDate & \ReportVersion & Initial project-specific report generated from template \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\section*{Appendix: Measurement Analysis Files}
|
||||
The following measurement analysis documents are attached in the listed order.
|
||||
|
||||
\begin{itemize}
|
||||
\MeasurementAppendixList
|
||||
\end{itemize}
|
||||
|
||||
\MeasurementAppendices
|
||||
|
||||
\end{document}
|
||||
@@ -0,0 +1,498 @@
|
||||
\documentclass[11pt,a4paper]{article}
|
||||
\usepackage[english]{babel}
|
||||
\usepackage[T1]{fontenc}
|
||||
\usepackage[utf8]{inputenc}
|
||||
\usepackage{lmodern}
|
||||
\usepackage[a4paper]{geometry}
|
||||
\usepackage{graphicx}
|
||||
\usepackage{tabularx}
|
||||
\usepackage{array}
|
||||
\usepackage{enumitem}
|
||||
\usepackage{amssymb}
|
||||
\usepackage{pdfpages}
|
||||
\usepackage{xurl}
|
||||
\usepackage{fancyhdr}
|
||||
|
||||
% Mirror the Kivel template's A4 text block and header/footer clearances.
|
||||
% The report content remains evidence-driven; this governs presentation only.
|
||||
\hoffset -5.4mm
|
||||
\voffset -5.4mm
|
||||
\marginparwidth 0mm
|
||||
\marginparsep 0mm
|
||||
\oddsidemargin 0mm
|
||||
\evensidemargin 0mm
|
||||
\textheight 244mm
|
||||
\textwidth 168mm
|
||||
\topmargin -12mm
|
||||
\headheight 12mm
|
||||
\headsep 25pt
|
||||
\columnsep 15pt
|
||||
\columnseprule 0pt
|
||||
\footskip 10mm
|
||||
|
||||
\setlength{\parindent}{0pt}
|
||||
\setlength{\parskip}{0.5em}
|
||||
\renewcommand{\arraystretch}{1.3}
|
||||
\widowpenalty=10000
|
||||
\clubpenalty=10000
|
||||
\setlength{\headheight}{12mm}
|
||||
\setlength{\headsep}{25pt}
|
||||
|
||||
\newcommand{\TBD}{\textbf{TBD}}
|
||||
\newcommand{\StageModel}{\TBD}
|
||||
\newcommand{\StageIdentifier}{\TBD}
|
||||
\newcommand{\EncoderModel}{\TBD}
|
||||
\newcommand{\MotorModel}{\TBD}
|
||||
\newcommand{\DriveModel}{\TBD}
|
||||
\newcommand{\EncoderInterface}{\TBD}
|
||||
\newcommand{\Controller}{\TBD}
|
||||
\newcommand{\MeasurementSystem}{\TBD}
|
||||
\newcommand{\TestDates}{\TBD}
|
||||
\newcommand{\TestOperator}{\TBD}
|
||||
\newcommand{\TravelRange}{\TBD}
|
||||
\newcommand{\ReportVersion}{0.1}
|
||||
\newcommand{\ReportDate}{\today}
|
||||
% Corporate-document metadata for the cover and running header. Update these
|
||||
% in a project-specific report; the baseline intentionally retains placeholders.
|
||||
% --------------------------------------------------------------------------
|
||||
% PROJECT DATA ENTRY -- edit values only in a project-specific report.
|
||||
% The narrative, checklist items, table structure and evidence mapping below
|
||||
% are fixed for a Factory Acceptance Test. Every value must be traceable to
|
||||
% project evidence; \TBD is permitted in this baseline only, never in an issued
|
||||
% report. Use Linear_Stage_Characterization_Report_Template.tex for a
|
||||
% characterization.
|
||||
% --------------------------------------------------------------------------
|
||||
\newcommand{\ProjectName}{\TBD}
|
||||
\newcommand{\DocumentNumber}{\TBD}
|
||||
% Set this to \url{https://...} in a project-specific report.
|
||||
\newcommand{\RepositoryLink}{\TBD}
|
||||
\newcommand{\ReportHeaderTitle}{Linear Stage Factory Acceptance Test Report}
|
||||
\newcommand{\ApplicableStandards}{\TBD}
|
||||
\newcommand{\ApplicableProcedures}{\TBD}
|
||||
\newcommand{\MeasurementProcedure}{\TBD}
|
||||
\newcommand{\EncoderResolutionAndScaling}{\TBD}
|
||||
\newcommand{\PositioningTravelAndTargets}{\TBD}
|
||||
\newcommand{\PositioningCyclesAndDirection}{\TBD}
|
||||
\newcommand{\PositioningMotionConditions}{\TBD}
|
||||
\newcommand{\PositioningOrientationsAndModes}{\TBD}
|
||||
\newcommand{\PositioningAccuracyLimit}{\TBD}
|
||||
\newcommand{\PositioningRepeatabilityLimit}{\TBD}
|
||||
\newcommand{\StraightnessMethod}{\TBD}
|
||||
\newcommand{\StraightnessCyclesAndDirection}{\TBD}
|
||||
\newcommand{\StraightnessMotionConditions}{\TBD}
|
||||
\newcommand{\StraightnessOrientationsAndModes}{\TBD}
|
||||
\newcommand{\StraightnessAcceptanceLimits}{\TBD}
|
||||
\newcommand{\PositioningTemperature}{\TBD}
|
||||
\newcommand{\PositioningPressure}{\TBD}
|
||||
\newcommand{\PositioningHumidity}{\TBD}
|
||||
\newcommand{\StraightnessTemperature}{\TBD}
|
||||
\newcommand{\StraightnessPressure}{\TBD}
|
||||
\newcommand{\StraightnessHumidity}{\TBD}
|
||||
\newcommand{\AdditionalTemperature}{\TBD}
|
||||
\newcommand{\AdditionalPressure}{\TBD}
|
||||
\newcommand{\AdditionalHumidity}{\TBD}
|
||||
\newcommand{\PositioningResult}{\TBD}
|
||||
\newcommand{\PositioningUncertainty}{\TBD}
|
||||
\newcommand{\PositioningDisposition}{\TBD}
|
||||
\newcommand{\StraightnessResult}{\TBD}
|
||||
\newcommand{\StraightnessUncertainty}{\TBD}
|
||||
\newcommand{\StraightnessDisposition}{\TBD}
|
||||
\newcommand{\OverallFATDisposition}{\TBD}
|
||||
\newcommand{\OpenActions}{\TBD}
|
||||
\newcommand{\StageReference}{\TBD}
|
||||
\newcommand{\ComponentReferences}{\TBD}
|
||||
\newcommand{\CalibrationReferences}{\TBD}
|
||||
% Replace each list body with exact evidence basenames. The appendix inclusion
|
||||
% list must be generated from the complete Measurement-PDF inventory.
|
||||
\newcommand{\RawFileList}{%
|
||||
\item \path{TBD_positioning_raw_file.ext}
|
||||
\item \path{TBD_straightness_raw_file.ext}
|
||||
\item \path{TBD_environment_log.ext}}
|
||||
\newcommand{\AnalysisFileList}{%
|
||||
\item \path{TBD_positioning_analysis.pdf}
|
||||
\item \path{TBD_straightness_analysis.pdf}}
|
||||
\newcommand{\MeasurementAppendixList}{%
|
||||
\item \path{TBD_positioning_analysis.pdf}
|
||||
\item \path{TBD_straightness_analysis.pdf}}
|
||||
\newcommand{\IncludeMeasurementPdf}[1]{%
|
||||
\includepdf[pages=-,fitpaper=false,scale=0.82,pagecommand={\thispagestyle{fatreport}}]{#1}}
|
||||
\newcommand{\MeasurementAppendices}{%
|
||||
% \IncludeMeasurementPdf{../Measurements/TBD_positioning_analysis.pdf}
|
||||
}
|
||||
\newcommand{\TestType}{Factory Acceptance Test}
|
||||
|
||||
% Required image basenames in ../Media: I1 through I6.
|
||||
% Supported extensions: .jpg, .jpeg, .png, and .pdf.
|
||||
\newcommand{\imageorplaceholder}[2][55mm]{%
|
||||
\IfFileExists{#2.jpg}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.jpg}}{%
|
||||
\IfFileExists{#2.jpeg}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.jpeg}}{%
|
||||
\IfFileExists{#2.png}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.png}}{%
|
||||
\IfFileExists{#2.pdf}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.pdf}}{%
|
||||
\fbox{\parbox[c][#1][c]{0.92\linewidth}{\centering Required image not found\\\path{#2.[jpg|jpeg|png|pdf]}}}}}}}}
|
||||
|
||||
% The two report templates use the same explicit Latin Modern font setup.
|
||||
% Keep the PSI identity in this Report folder with the controlled cover.
|
||||
\newcommand{\PSILogo}{%
|
||||
\IfFileExists{PSI_Logo.png}{%
|
||||
\includegraphics[width=32mm,height=11mm,keepaspectratio]{PSI_Logo.png}}{%
|
||||
\fbox{\parbox[c][9mm][c]{30mm}{\centering\scriptsize Required PSI logo not found}}}}
|
||||
|
||||
\newlength{\checklistitemwidth}
|
||||
\settowidth{\checklistitemwidth}{\small Measurement system calibrated}
|
||||
|
||||
% Running header and footer contain the report title, a separating rule, and
|
||||
% page/date traceability.
|
||||
\fancypagestyle{fatreport}{%
|
||||
\fancyhf{}
|
||||
\fancyhead[C]{\small \ReportHeaderTitle\\[-2pt]\rule{\textwidth}{0.5pt}}
|
||||
\fancyfoot[C]{\small Page~\thepage\quad(\ReportDate)}
|
||||
\renewcommand{\headrulewidth}{0pt}
|
||||
\renewcommand{\footrulewidth}{0.5pt}
|
||||
}
|
||||
\pagestyle{fatreport}
|
||||
|
||||
\begin{document}
|
||||
|
||||
% Page 1 format adapted from Template-Kivel. I1 is retained as the first
|
||||
% image on page 1, as required by this FAT template's evidence rules.
|
||||
\enlargethispage*{3cm}
|
||||
\thispagestyle{empty}
|
||||
\vspace*{-15mm}
|
||||
\hspace*{-5mm}
|
||||
\setlength{\unitlength}{1mm}
|
||||
\begin{picture}(175,255)
|
||||
\sffamily
|
||||
\thicklines
|
||||
\put(0,255){\line(1,0){175}}
|
||||
\put(0,0){\line(1,0){175}}
|
||||
\put(0,0){\line(0,1){255}}
|
||||
\put(175,0){\line(0,1){255}}
|
||||
\put(0,241){\line(1,0){175}}
|
||||
\put(0,227){\line(1,0){175}}
|
||||
\put(0,211){\line(1,0){175}}
|
||||
\put(123,255){\line(0,-1){44}}
|
||||
\thinlines
|
||||
\put(0,9){\line(1,0){175}}
|
||||
\put(80,0){\line(0,1){9}}
|
||||
\put(130,0){\line(0,1){9}}
|
||||
|
||||
% Header fields
|
||||
\put(3,242.5){\PSILogo}
|
||||
\put(124,252){\scriptsize Project}
|
||||
\put(125,245){\bfseries\large \ProjectName}
|
||||
\put(2,237){\small Title}
|
||||
\put(20,234){\bfseries \ReportHeaderTitle}
|
||||
\put(124,238){\scriptsize Document Identification}
|
||||
\put(125,231){\footnotesize\bfseries \DocumentNumber}
|
||||
\put(1,221){\small Author}
|
||||
\put(30,221){\TestOperator}
|
||||
\put(124,224){\scriptsize Review Index}
|
||||
\put(130,217){\footnotesize\bfseries \ReportVersion}
|
||||
|
||||
% The central evidence field deliberately carries I1 at the same prominence as
|
||||
% the Kivel cover's primary content field; it is never substituted or inferred.
|
||||
\put(10,204){\bfseries Overall stage image}
|
||||
\put(30,120){\begin{minipage}[t]{12cm}\centering
|
||||
\imageorplaceholder[75mm]{../Media/I1}
|
||||
\end{minipage}}
|
||||
|
||||
% Equipment summary
|
||||
\put(10,75){\begin{minipage}[t]{15cm}
|
||||
\begin{tabularx}{\linewidth}{|l|X|}
|
||||
\hline
|
||||
\textbf{Test type} & \TestType \\ \hline
|
||||
\textbf{Stage identifier} & \StageIdentifier \\ \hline
|
||||
\textbf{Repository} & \RepositoryLink \\ \hline
|
||||
\textbf{Encoder} & \EncoderModel \\ \hline
|
||||
\textbf{Motor} & \MotorModel \\ \hline
|
||||
\textbf{Drive} & \DriveModel \\ \hline
|
||||
\textbf{Dates} & \TestDates \\ \hline
|
||||
\textbf{Applicable standards} & \ApplicableStandards \\ \hline
|
||||
\end{tabularx}
|
||||
\end{minipage}}
|
||||
|
||||
% Compact file traceability footer
|
||||
\put(1,6){\scriptsize File Name:}
|
||||
\put(20,6){\scriptsize \jobname.pdf}
|
||||
\put(1,2){\scriptsize Date:}
|
||||
\put(20,2){\scriptsize \ReportDate}
|
||||
\put(81,6){\scriptsize Author signature}
|
||||
\put(81,2){\scriptsize \TestOperator}
|
||||
\put(131,6){\scriptsize Date / Signature}
|
||||
\end{picture}
|
||||
\label{fig:I1_stage}
|
||||
|
||||
\clearpage
|
||||
\section{FAT Checklists}
|
||||
|
||||
\subsection{Pre-Test Safety}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
2.1 & Risk assessment conducted & $\square$ & $\square$ & \\ \hline
|
||||
2.2 & Safety barriers in place & $\square$ & $\square$ & \\ \hline
|
||||
2.3 & E-stop functional & $\square$ & $\square$ & \\ \hline
|
||||
2.4 & Equipment grounded & $\square$ & $\square$ & \\ \hline
|
||||
2.5 & Personnel briefed & $\square$ & $\square$ & \\ \hline
|
||||
2.6 & Cable routing safe & $\square$ & $\square$ & \\ \hline
|
||||
2.7 & Environmental conditions OK & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\subsection{Equipment Verification}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
3.1 & Stage model verified & $\square$ & $\square$ & \\ \hline
|
||||
3.2 & Encoder model verified & $\square$ & $\square$ & \\ \hline
|
||||
3.3 & Motor model verified & $\square$ & $\square$ & \\ \hline
|
||||
3.4 & Drive model verified & $\square$ & $\square$ & \\ \hline
|
||||
3.5 & Encoder interface verified & $\square$ & $\square$ & \\ \hline
|
||||
3.6 & Measurement system calibrated & $\square$ & $\square$ & \\ \hline
|
||||
3.7 & Documentation available & $\square$ & $\square$ & \\ \hline
|
||||
3.8 & Calibration certificates valid & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\subsection{Mechanical and Electrical Checks}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
4.1 & Mounting interfaces verified & $\square$ & $\square$ & \\ \hline
|
||||
4.2 & Travel unobstructed & $\square$ & $\square$ & \\ \hline
|
||||
4.3 & End stops functional & $\square$ & $\square$ & \\ \hline
|
||||
4.4 & Cable carrier movement OK & $\square$ & $\square$ & \\ \hline
|
||||
4.5 & Encoder alignment checked & $\square$ & $\square$ & \\ \hline
|
||||
4.6 & Motor coupling secure & $\square$ & $\square$ & \\ \hline
|
||||
4.7 & Supply voltage verified & $\square$ & $\square$ & \\ \hline
|
||||
4.8 & Signal connections verified & $\square$ & $\square$ & \\ \hline
|
||||
4.9 & Ground continuity checked & $\square$ & $\square$ & \\ \hline
|
||||
4.10 & No abnormal noise or vibration & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\clearpage
|
||||
\subsection{Control System Verification}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
5.1 & Communication established & $\square$ & $\square$ & \\ \hline
|
||||
5.2 & Drive parameters verified & $\square$ & $\square$ & \\ \hline
|
||||
5.3 & Encoder scaling verified & $\square$ & $\square$ & \\ \hline
|
||||
5.4 & Current or force limit verified & $\square$ & $\square$ & \\ \hline
|
||||
5.5 & Homing or referencing functional & $\square$ & $\square$ & \\ \hline
|
||||
5.6 & Software limits configured & $\square$ & $\square$ & \\ \hline
|
||||
5.7 & E-stop response verified & $\square$ & $\square$ & \\ \hline
|
||||
5.8 & Motion profile verified & $\square$ & $\square$ & \\ \hline
|
||||
5.9 & Closed-loop stability verified & $\square$ & $\square$ & \\ \hline
|
||||
5.10 & Following error acceptable & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\subsection{Test Execution}
|
||||
\begin{center}\small
|
||||
\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|}
|
||||
\hline
|
||||
\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline
|
||||
6.1 & Measurement system aligned & $\square$ & $\square$ & \\ \hline
|
||||
6.2 & Environmental compensation set & $\square$ & $\square$ & \\ \hline
|
||||
6.3 & Test parameters recorded & $\square$ & $\square$ & \\ \hline
|
||||
6.4 & Required cycles completed & $\square$ & $\square$ & \\ \hline
|
||||
6.5 & Raw data saved & $\square$ & $\square$ & \\ \hline
|
||||
6.6 & Analysis files generated & $\square$ & $\square$ & \\ \hline
|
||||
6.7 & Environmental data logged & $\square$ & $\square$ & \\ \hline
|
||||
6.8 & All configurations tested & $\square$ & $\square$ & \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
|
||||
\clearpage
|
||||
\section{Hardware and Configuration}
|
||||
|
||||
|
||||
\subsection{Coordinate Convention}
|
||||
\begin{tabularx}{\textwidth}{>{\bfseries}p{45mm}X}
|
||||
\hline
|
||||
Quantity & Project convention (defaults shown) \\ \hline
|
||||
Linear stage travel & Z axis \\
|
||||
Vertical direction & Y axis, perpendicular to Z \\
|
||||
Horizontal direction & X axis, perpendicular to Y and Z \\
|
||||
Roll & Rotation about Z (travel axis) \\
|
||||
Yaw & Rotation about Y (vertical axis) \\
|
||||
Pitch & Rotation about X (horizontal axis) \\
|
||||
Positive rotational direction & Right-hand rule \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
|
||||
\begin{tabularx}{\textwidth}{>{\bfseries}p{45mm}X}
|
||||
\hline
|
||||
Component & Verified specification \\ \hline
|
||||
Stage & \StageModel \\
|
||||
Stage identifier & \StageIdentifier \\
|
||||
Travel & \TravelRange \\
|
||||
Encoder & \EncoderModel \\
|
||||
Encoder interface & \EncoderInterface \\
|
||||
Encoder resolution and scaling & \EncoderResolutionAndScaling \\
|
||||
Motor or actuator & \MotorModel \\
|
||||
Drive & \DriveModel \\
|
||||
Controller and control mode & \Controller \\
|
||||
Measurement system & \MeasurementSystem \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
|
||||
|
||||
\clearpage
|
||||
|
||||
|
||||
\begin{figure}[htbp]
|
||||
\centering
|
||||
\begin{minipage}[b]{0.32\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[45mm]{../Media/I2}
|
||||
\caption{Encoder}
|
||||
\label{fig:I2_encoder}
|
||||
\end{minipage}
|
||||
\hfill
|
||||
\begin{minipage}[b]{0.32\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[45mm]{../Media/I3}
|
||||
\caption{Motor}
|
||||
\label{fig:I3_motor}
|
||||
\end{minipage}
|
||||
\hfill
|
||||
\begin{minipage}[b]{0.32\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[45mm]{../Media/I4}
|
||||
\caption{Motor coupling}
|
||||
\label{fig:I4_coupling}
|
||||
\end{minipage}
|
||||
\end{figure}
|
||||
|
||||
\begin{figure}[htbp]
|
||||
\centering
|
||||
\begin{minipage}[b]{0.48\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[65mm]{../Media/I5}
|
||||
\caption{General test setup - view 1}
|
||||
\label{fig:I5_setup1}
|
||||
\end{minipage}
|
||||
\hfill
|
||||
\begin{minipage}[b]{0.48\textwidth}
|
||||
\centering
|
||||
\imageorplaceholder[65mm]{../Media/I6}
|
||||
\caption{General test setup - view 2}
|
||||
\label{fig:I6_setup2}
|
||||
\end{minipage}
|
||||
\end{figure}
|
||||
|
||||
\clearpage
|
||||
\section{Test Description and Acceptance Criteria}
|
||||
\subsection{Applicable Standards and Procedures}
|
||||
\begin{itemize}
|
||||
\item Applicable standard(s), edition(s), and clause(s): \ApplicableStandards
|
||||
\item Internal test procedure and revision: \ApplicableProcedures
|
||||
\item Measurement-system operating procedure and revision: \MeasurementProcedure
|
||||
\end{itemize}
|
||||
|
||||
\subsection{Positioning Test}
|
||||
\begin{itemize}
|
||||
\item Travel and target positions: \PositioningTravelAndTargets
|
||||
\item Number and direction of cycles: \PositioningCyclesAndDirection
|
||||
\item Velocity, acceleration, and settling criterion: \PositioningMotionConditions
|
||||
\item Tested orientations and control modes: \PositioningOrientationsAndModes
|
||||
\item Accuracy acceptance limit: \PositioningAccuracyLimit
|
||||
\item Repeatability acceptance limit: \PositioningRepeatabilityLimit
|
||||
\end{itemize}
|
||||
|
||||
\subsection{Straightness Test}
|
||||
\begin{itemize}
|
||||
\item Straightness travel range, target positions, planes, and point spacing: \StraightnessMethod
|
||||
\item Straightness number and direction of cycles: \StraightnessCyclesAndDirection
|
||||
\item Straightness velocity, acceleration, and settling criterion: \StraightnessMotionConditions
|
||||
\item Straightness tested orientations and control modes: \StraightnessOrientationsAndModes
|
||||
\item Applicable straightness acceptance limit(s): \StraightnessAcceptanceLimits
|
||||
\end{itemize}
|
||||
|
||||
\section{Environmental Conditions}
|
||||
\begin{tabularx}{\textwidth}{lXXX}
|
||||
\hline
|
||||
Test & Temperature ($^\circ$C) & Pressure & Humidity (\%) \\ \hline
|
||||
Positioning & \PositioningTemperature & \PositioningPressure & \PositioningHumidity \\
|
||||
Straightness & \StraightnessTemperature & \StraightnessPressure & \StraightnessHumidity \\
|
||||
Additional test & \AdditionalTemperature & \AdditionalPressure & \AdditionalHumidity \\ \hline
|
||||
\end{tabularx}
|
||||
|
||||
\clearpage
|
||||
\pagestyle{fatreport}
|
||||
\thispagestyle{fatreport}
|
||||
\vspace*{2mm}
|
||||
\section{Test Files and Data}
|
||||
The following exact evidence basenames identify the delivered raw and analysis files.
|
||||
|
||||
\subsection{Raw Files}
|
||||
\begin{itemize}
|
||||
\RawFileList
|
||||
\end{itemize}
|
||||
|
||||
\subsection{Analysis Files}
|
||||
\begin{itemize}
|
||||
\AnalysisFileList
|
||||
\end{itemize}
|
||||
|
||||
\section{Conclusions}
|
||||
\subsection{Positioning}
|
||||
\begin{itemize}
|
||||
\item Measured result: \PositioningResult
|
||||
\item Stated measurement uncertainty: \PositioningUncertainty
|
||||
\item Acceptance criterion: accuracy \PositioningAccuracyLimit; repeatability \PositioningRepeatabilityLimit
|
||||
\item Disposition: \PositioningDisposition
|
||||
\end{itemize}
|
||||
|
||||
\subsection{Straightness}
|
||||
\begin{itemize}
|
||||
\item Measured result: \StraightnessResult
|
||||
\item Stated measurement uncertainty: \StraightnessUncertainty
|
||||
\item Acceptance criterion: \StraightnessAcceptanceLimits
|
||||
\item Disposition: \StraightnessDisposition
|
||||
\end{itemize}
|
||||
|
||||
\subsection{Overall FAT Conclusion}
|
||||
\textbf{Overall disposition:} \OverallFATDisposition.
|
||||
|
||||
\textbf{Deviations and open actions (including responsible owner and due date):} \OpenActions.
|
||||
|
||||
\section*{References}
|
||||
\begin{itemize}
|
||||
\item Stage manufacturer document, number, and revision: \StageReference
|
||||
\item Encoder, motor, drive, and controller documents and revisions: \ComponentReferences
|
||||
\item Standards and procedures: \ApplicableStandards; \ApplicableProcedures; \MeasurementProcedure
|
||||
\item Calibration certificates: \CalibrationReferences
|
||||
\end{itemize}
|
||||
|
||||
\clearpage
|
||||
\pagestyle{fatreport}
|
||||
\thispagestyle{fatreport}
|
||||
\vspace*{20mm}
|
||||
\section*{Document History}
|
||||
\begin{center}
|
||||
\begin{tabularx}{\textwidth}{|l|l|X|}
|
||||
\hline
|
||||
Date & Version & Description \\ \hline
|
||||
\ReportDate & \ReportVersion & Initial project-specific report generated from template \\ \hline
|
||||
\end{tabularx}
|
||||
\end{center}
|
||||
|
||||
\section*{Appendix: Measurement Analysis Files}
|
||||
The following measurement analysis documents are attached in the listed order.
|
||||
|
||||
\begin{itemize}
|
||||
\MeasurementAppendixList
|
||||
\end{itemize}
|
||||
|
||||
\MeasurementAppendices
|
||||
|
||||
\end{document}
|
||||
@@ -0,0 +1,189 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Deterministically create one project-specific linear-stage report source.
|
||||
|
||||
This utility deliberately contains no document-generation logic, no model calls,
|
||||
and no heuristic matching. It applies literal project data and literal LaTeX
|
||||
blocks to one of the approved templates. Update FIXED_PROJECT_DATA and the
|
||||
three fixed file lists below, then run, for example:
|
||||
|
||||
python fixed_tex_update.py --report-type characterization \
|
||||
--output ../../OWIS_Characterization_Working_Draft.tex
|
||||
|
||||
The approved templates are never modified. The output is a separate working
|
||||
draft until its values have been verified against the project evidence.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import argparse
|
||||
from pathlib import Path
|
||||
|
||||
|
||||
# Edit only these literal values. Empty strings intentionally remain blank;
|
||||
# they are not substituted with invented equipment, test, or acceptance data.
|
||||
FIXED_PROJECT_DATA = {
|
||||
"ProjectName": "",
|
||||
"DocumentNumber": "",
|
||||
"StageModel": "",
|
||||
"StageIdentifier": "",
|
||||
"EncoderModel": "",
|
||||
"MotorModel": "",
|
||||
"DriveModel": "",
|
||||
"EncoderInterface": "",
|
||||
"Controller": "",
|
||||
"MeasurementSystem": "",
|
||||
"TestDates": "",
|
||||
"TestOperator": "",
|
||||
"TravelRange": "",
|
||||
"ReportVersion": "0.1",
|
||||
"ReportDate": r"\today",
|
||||
"RepositoryLink": "",
|
||||
"ApplicableStandards": "",
|
||||
"ApplicableProcedures": "",
|
||||
"MeasurementProcedure": "",
|
||||
"EncoderResolutionAndScaling": "",
|
||||
"PositioningTravelAndTargets": "",
|
||||
"PositioningCyclesAndDirection": "",
|
||||
"PositioningMotionConditions": "",
|
||||
"PositioningOrientationsAndModes": "",
|
||||
"StraightnessMethod": "",
|
||||
"StraightnessCyclesAndDirection": "",
|
||||
"StraightnessMotionConditions": "",
|
||||
"StraightnessOrientationsAndModes": "",
|
||||
"PositioningTemperature": "",
|
||||
"PositioningPressure": "",
|
||||
"PositioningHumidity": "",
|
||||
"StraightnessTemperature": "",
|
||||
"StraightnessPressure": "",
|
||||
"StraightnessHumidity": "",
|
||||
"AdditionalTemperature": "",
|
||||
"AdditionalPressure": "",
|
||||
"AdditionalHumidity": "",
|
||||
"PositioningResult": "",
|
||||
"StraightnessResult": "",
|
||||
"PositioningUncertainty": "",
|
||||
"StraightnessUncertainty": "",
|
||||
"PositioningAccuracyLimit": "",
|
||||
"PositioningRepeatabilityLimit": "",
|
||||
"StraightnessAcceptanceLimits": "",
|
||||
"PositioningDisposition": "",
|
||||
"StraightnessDisposition": "",
|
||||
"OverallFATDisposition": "",
|
||||
"OpenActions": "",
|
||||
"StageReference": "",
|
||||
"ComponentReferences": "",
|
||||
"CalibrationReferences": "",
|
||||
}
|
||||
|
||||
# Exact basenames only. Keep every measurement PDF in the appendix list.
|
||||
FIXED_RAW_FILES: tuple[str, ...] = ()
|
||||
FIXED_ANALYSIS_FILES: tuple[str, ...] = ()
|
||||
FIXED_APPENDIX_PDFS: tuple[str, ...] = ()
|
||||
|
||||
TEMPLATES = {
|
||||
"fat": "Linear_Stage_FAT_Report_Template.tex",
|
||||
"characterization": "Linear_Stage_Characterization_Report_Template.tex",
|
||||
}
|
||||
|
||||
|
||||
def latex_path_item(filename: str) -> str:
|
||||
"""Return one literal list item, rejecting unsafe LaTeX-list input."""
|
||||
if not filename or "\n" in filename or "\r" in filename or "{" in filename or "}" in filename:
|
||||
raise ValueError("Every evidence filename must be a non-empty single line without braces.")
|
||||
return rf" \item \path{{{filename}}}"
|
||||
|
||||
|
||||
def command_block(name: str, body: list[str]) -> str:
|
||||
"""Return a fixed replacement for one list-valued project-data command."""
|
||||
lines = "\n".join(body)
|
||||
return rf"\renewcommand{{\{name}}}{{%" + (f"\n{lines}" if lines else "") + "\n}"
|
||||
|
||||
|
||||
def appendices_block(pdf_names: tuple[str, ...]) -> str:
|
||||
includes: list[str] = []
|
||||
for name in pdf_names:
|
||||
if not name.lower().endswith(".pdf"):
|
||||
raise ValueError(f"Appendix file must be a PDF: {name}")
|
||||
includes.append(rf" \IncludeMeasurementPdf{{../Measurements/{name}}}")
|
||||
return command_block("MeasurementAppendices", includes)
|
||||
|
||||
|
||||
def project_data_block(report_type: str) -> str:
|
||||
"""Construct the complete, fixed override block inserted before the document."""
|
||||
overrides = ["% BEGIN FIXED PROJECT DATA -- generated by fixed_tex_update.py"]
|
||||
for name in sorted(FIXED_PROJECT_DATA):
|
||||
if name in required_commands(report_type):
|
||||
overrides.append(rf"\renewcommand{{\{name}}}{{{FIXED_PROJECT_DATA[name]}}}")
|
||||
overrides.extend(
|
||||
[
|
||||
command_block("RawFileList", [latex_path_item(name) for name in FIXED_RAW_FILES]),
|
||||
command_block("AnalysisFileList", [latex_path_item(name) for name in FIXED_ANALYSIS_FILES]),
|
||||
command_block("MeasurementAppendixList", [latex_path_item(name) for name in FIXED_APPENDIX_PDFS]),
|
||||
appendices_block(FIXED_APPENDIX_PDFS),
|
||||
"% END FIXED PROJECT DATA",
|
||||
]
|
||||
)
|
||||
return "\n".join(overrides)
|
||||
|
||||
|
||||
def required_commands(report_type: str) -> set[str]:
|
||||
"""Return macros supported by the selected static template."""
|
||||
common = {
|
||||
"ProjectName", "DocumentNumber", "StageModel", "StageIdentifier", "EncoderModel",
|
||||
"MotorModel", "DriveModel", "EncoderInterface", "Controller", "MeasurementSystem",
|
||||
"TestDates", "TestOperator", "TravelRange", "ReportVersion", "ReportDate",
|
||||
"RepositoryLink", "ApplicableStandards", "ApplicableProcedures", "MeasurementProcedure",
|
||||
"EncoderResolutionAndScaling", "PositioningTravelAndTargets", "PositioningCyclesAndDirection",
|
||||
"PositioningMotionConditions", "PositioningOrientationsAndModes", "StraightnessMethod",
|
||||
"StraightnessCyclesAndDirection", "StraightnessMotionConditions", "StraightnessOrientationsAndModes",
|
||||
"PositioningTemperature", "PositioningPressure", "PositioningHumidity", "StraightnessTemperature",
|
||||
"StraightnessPressure", "StraightnessHumidity", "AdditionalTemperature", "AdditionalPressure",
|
||||
"AdditionalHumidity", "PositioningResult", "StraightnessResult", "StageReference",
|
||||
"ComponentReferences", "CalibrationReferences",
|
||||
}
|
||||
if report_type == "fat":
|
||||
return common | {
|
||||
"PositioningUncertainty", "StraightnessUncertainty", "PositioningAccuracyLimit",
|
||||
"PositioningRepeatabilityLimit", "StraightnessAcceptanceLimits", "PositioningDisposition",
|
||||
"StraightnessDisposition", "OverallFATDisposition", "OpenActions",
|
||||
}
|
||||
return common
|
||||
|
||||
|
||||
def render(template_text: str, report_type: str) -> str:
|
||||
"""Insert exactly one generated override block at a stable template anchor."""
|
||||
marker_start = "% BEGIN FIXED PROJECT DATA -- generated by fixed_tex_update.py"
|
||||
marker_end = "% END FIXED PROJECT DATA"
|
||||
if marker_start in template_text or marker_end in template_text:
|
||||
raise ValueError("The input already contains a generated fixed-data block.")
|
||||
anchor = "\\begin{document}"
|
||||
if template_text.count(anchor) != 1:
|
||||
raise ValueError("Expected exactly one \\begin{document} anchor in the template.")
|
||||
return template_text.replace(anchor, project_data_block(report_type) + "\n\n" + anchor, 1)
|
||||
|
||||
|
||||
def main() -> int:
|
||||
parser = argparse.ArgumentParser(description=__doc__)
|
||||
parser.add_argument("--report-type", required=True, choices=sorted(TEMPLATES))
|
||||
parser.add_argument("--output", required=True, type=Path, help="New project-specific .tex path")
|
||||
parser.add_argument("--force", action="store_true", help="Replace an existing non-template output")
|
||||
args = parser.parse_args()
|
||||
|
||||
report_dir = Path(__file__).resolve().parents[2]
|
||||
template = report_dir / TEMPLATES[args.report_type]
|
||||
output = args.output.resolve()
|
||||
protected = {path.resolve() for path in (report_dir / name for name in TEMPLATES.values())}
|
||||
if output in protected:
|
||||
parser.error("Refusing to modify an authoritative template; choose a project-specific output name.")
|
||||
if output.suffix.lower() != ".tex":
|
||||
parser.error("Output must have a .tex extension.")
|
||||
if output.exists() and not args.force:
|
||||
parser.error("Output exists; use --force only for a disposable project-specific draft.")
|
||||
output.parent.mkdir(parents=True, exist_ok=True)
|
||||
output.write_text(render(template.read_text(encoding="utf-8"), args.report_type), encoding="utf-8", newline="\n")
|
||||
print(f"Wrote deterministic {args.report_type} draft: {output}")
|
||||
return 0
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
raise SystemExit(main())
|
||||
@@ -0,0 +1,77 @@
|
||||
#!/usr/bin/env python3
|
||||
# /// script
|
||||
# requires-python = ">=3.11"
|
||||
# dependencies = ["openpyxl>=3.1,<4"]
|
||||
# ///
|
||||
"""Create or refresh the editable Report Data table from repository inventory."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from pathlib import Path
|
||||
from openpyxl import load_workbook
|
||||
from openpyxl.styles import Alignment, Font, PatternFill, Border, Side
|
||||
|
||||
FIELDS = (
|
||||
("project_name", "Project name"), ("document_number", "Document number"),
|
||||
("stage_model", "Stage model"), ("encoder_model", "Encoder model"),
|
||||
("motor_model", "Motor or actuator model"), ("drive_model", "Drive model"),
|
||||
("encoder_interface", "Encoder interface"), ("controller", "Controller and control mode"),
|
||||
("measurement_system", "Measurement system"), ("test_dates", "Test date(s)"),
|
||||
("test_operator", "Test operator"), ("travel_range", "Travel range"),
|
||||
("applicable_standards", "Applicable standards"), ("applicable_procedures", "Internal procedure and revision"),
|
||||
("measurement_procedure", "Measurement procedure and revision"),
|
||||
("encoder_resolution_and_scaling", "Encoder resolution and scaling"),
|
||||
("positioning_travel_and_targets", "Positioning travel and targets"),
|
||||
("positioning_cycles_and_direction", "Positioning cycles and direction"),
|
||||
("positioning_motion_conditions", "Positioning motion conditions"),
|
||||
("positioning_orientations_and_modes", "Positioning orientations and control modes"),
|
||||
("straightness_method", "Straightness method, positions, planes, and spacing"),
|
||||
("straightness_cycles_and_direction", "Straightness cycles and direction"),
|
||||
("straightness_motion_conditions", "Straightness motion conditions"),
|
||||
("straightness_orientations_and_modes", "Straightness orientations and control modes"),
|
||||
("positioning_temperature", "Positioning temperature (°C)"), ("positioning_pressure", "Positioning pressure"),
|
||||
("positioning_humidity", "Positioning humidity (%)"), ("straightness_temperature", "Straightness temperature (°C)"),
|
||||
("straightness_pressure", "Straightness pressure"), ("straightness_humidity", "Straightness humidity (%)"),
|
||||
("additional_temperature", "Additional-test temperature (°C)"), ("additional_pressure", "Additional-test pressure"),
|
||||
("additional_humidity", "Additional-test humidity (%)"), ("positioning_result", "Positioning result"),
|
||||
("straightness_result", "Straightness result"), ("stage_reference", "Stage document number and revision"),
|
||||
("component_references", "Encoder/motor/drive/controller references"), ("calibration_references", "Calibration certificate references"),
|
||||
)
|
||||
|
||||
def main() -> int:
|
||||
root = Path(__file__).resolve().parents[3]
|
||||
workbook_path = root / "FAT_Checklist.xlsx"
|
||||
workbook = load_workbook(workbook_path)
|
||||
sheet = workbook["Report Data"] if "Report Data" in workbook.sheetnames else workbook.create_sheet("Report Data")
|
||||
existing = {str(sheet.cell(row, 1).value): sheet.cell(row, 2).value for row in range(1, sheet.max_row + 1) if sheet.cell(row, 1).value}
|
||||
sheet.delete_rows(1, sheet.max_row)
|
||||
sheet["A1"], sheet["A2"] = "Characterization Report Data", "Enter only evidence-backed values. Blank cells remain blank in the PDF."
|
||||
sheet["A4"], sheet["B4"], sheet["C4"] = "Key", "Value", "Source or notes"
|
||||
for cell in sheet[4]:
|
||||
cell.font = Font(bold=True, color="FFFFFF")
|
||||
cell.fill = PatternFill("solid", fgColor="1F4E78")
|
||||
thin = Side(style="thin", color="B7B7B7")
|
||||
for row, (key, label) in enumerate(FIELDS, start=5):
|
||||
sheet.cell(row, 1, key)
|
||||
sheet.cell(row, 2, existing.get(key, ""))
|
||||
sheet.cell(row, 3, label)
|
||||
for column in range(1, 4):
|
||||
cell = sheet.cell(row, column)
|
||||
cell.border = Border(top=thin, bottom=thin, left=thin, right=thin)
|
||||
cell.alignment = Alignment(vertical="top", wrap_text=True)
|
||||
media = [path.name for path in sorted((root / "Media").glob("I*.*")) if path.suffix.lower() in {".jpg", ".jpeg", ".png", ".pdf"}]
|
||||
measurement_pdfs = [path.name for path in sorted((root / "Measurements").glob("*.pdf"))]
|
||||
inventory_row = 5 + len(FIELDS) + 2
|
||||
sheet.cell(inventory_row, 1, "Repository inventory (read-only scan)").font = Font(bold=True)
|
||||
sheet.cell(inventory_row + 1, 1, "Media I1-I6 found")
|
||||
sheet.cell(inventory_row + 1, 2, ", ".join(media))
|
||||
sheet.cell(inventory_row + 2, 1, "Measurement PDFs found")
|
||||
sheet.cell(inventory_row + 2, 2, ", ".join(measurement_pdfs))
|
||||
sheet.column_dimensions["A"].width, sheet.column_dimensions["B"].width, sheet.column_dimensions["C"].width = 34, 48, 52
|
||||
sheet.freeze_panes = "A5"
|
||||
workbook.save(workbook_path)
|
||||
print(f"Refreshed Report Data in {workbook_path}")
|
||||
return 0
|
||||
|
||||
if __name__ == "__main__":
|
||||
raise SystemExit(main())
|
||||
@@ -0,0 +1,190 @@
|
||||
<mxfile host="Electron" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/29.0.3 Chrome/140.0.7339.249 Electron/38.7.0 Safari/537.36" version="29.0.3">
|
||||
<diagram name="Report Workflow" id="OWy0dci5RTJpJNXqNlxN">
|
||||
<mxGraphModel dx="2824" dy="1894" grid="0" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="2336" pageHeight="1654" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
<mxCell id="title" value="Linear-stage report workflow — evidence-bounded FAT or characterization" style="text;html=1;align=center;verticalAlign=middle;fontSize=22;fontStyle=1;fontColor=#1A1A1A;" parent="1" vertex="1">
|
||||
<mxGeometry x="230" y="20" width="1660" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="start" value="Start: create a project repository from the FAT_Template" style="ellipse;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;" parent="1" vertex="1">
|
||||
<mxGeometry x="60" y="294" width="210" height="70" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="collect" value="Collect and preserve source evidence<br>• measurements / raw data<br>• hardware and configuration evidence<br>• six mapped images I1–I6<br>• acceptance criteria (FAT only)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="327" y="274" width="300" height="110" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="workbook" value="Complete FAT_Checklist.xlsx during the test<br>• Report Type<br>• stage ID and repository URL<br>• coordinate convention<br>• explicit Yes/No and remarks" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="658" y="274" width="300" height="110" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="selector" value="Is the workbook Report Type<br>unambiguous and consistent?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=14;fontStyle=1;" parent="1" vertex="1">
|
||||
<mxGeometry x="994" y="269" width="190" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="resolve" value="Resolve with the user<br>Do not construct the report" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=14;" parent="1" vertex="1">
|
||||
<mxGeometry x="996" y="459" width="190" height="70" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="template" value="Select the authoritative static template<br>FAT → FAT template<br>Characterization → characterization template" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="1246" y="274" width="300" height="110" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="preflight" value="Evidence preflight<br>Read Report/AGENTS.md; inventory and hash inputs; inspect every image; confirm exact identities, dates, revisions, settings, calibration and PDF appendix set" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="1604" y="221.5" width="286" height="215" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="sufficient" value="Evidence sufficient<br>for a supported report?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=14;fontStyle=1;" parent="1" vertex="1">
|
||||
<mxGeometry x="1936" y="269" width="190" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="gaps" value="Record exact evidence gaps in workflow state<br>Prepare only an incomplete working draft; do not issue or infer values" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="2092" y="394" width="202" height="175" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="populate" value="Create a new project-specific report<br>Populate marked data only; transfer workbook answers by stable item ID; retain blanks; list exact evidence filenames; preserve fixed template prose/layout" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="22" y="644" width="360" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fat" value="FAT path<br>Trace criteria, results and uncertainty; compare only supported results; record deviations / owners / due dates; write evidence-backed conclusions" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="482" y="639" width="310" height="130" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="char" value="Characterization path<br>State scope and positioning / straightness results only; no acceptance criteria, pass/fail disposition, uncertainty commentary, observations or conclusions" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="482" y="809" width="310" height="130" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="build" value="Build and assemble<br>Compile with MiKTeX pdflatex twice; resolve errors/references; append every Measurements PDF as complete pages; retain workflow records under Report/unused/workflow" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="897" y="689" width="360" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="qa" value="Independent validation<br>1. Build/log check<br>2. Content/evidence check<br>3. Render and visually inspect every page<br>4. Verify appendices, logo, Repository URL, no placeholders or auxiliary files" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="1357" y="669" width="420" height="160" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="ready" value="All issued-report completion criteria met?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=14;fontStyle=1;" parent="1" vertex="1">
|
||||
<mxGeometry x="1847" y="689" width="170" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="correct" value="Correct source or evidence register<br>then rebuild and repeat all affected QA" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=14;" parent="1" vertex="1">
|
||||
<mxGeometry x="2008" y="834" width="300" height="75" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="review" value="Ready for issue review<br>Deliver project-specific .tex and .pdf; report page count, appended PDFs, validation status and residual unverified conditions" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;align=left;spacingLeft=10;" parent="1" vertex="1">
|
||||
<mxGeometry x="437" y="1087" width="390" height="95" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="issue" value="User explicitly directs issuance?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=14;fontStyle=1;" parent="1" vertex="1">
|
||||
<mxGeometry x="977" y="1074" width="190" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="hold" value="Keep as review-ready<br>Technical QA is not FAT acceptance authorization" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=14;" parent="1" vertex="1">
|
||||
<mxGeometry x="1284" y="1091" width="290" height="85" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="issued" value="Issue controlled report<br>Archive workflow state; do not claim acceptance without supported FAT disposition and authorization" style="ellipse;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;" parent="1" vertex="1">
|
||||
<mxGeometry x="922" y="1319" width="300" height="85" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e1" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="start" target="collect" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e2" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="collect" target="workbook" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e3" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="workbook" target="selector" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e4" value="No" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;" parent="1" source="selector" target="resolve" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e5" value="Yes" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;" parent="1" source="selector" target="template" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e6" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;entryX=0;entryY=0.5;entryDx=0;entryDy=0;" parent="1" source="template" target="preflight" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<mxPoint x="1613.999999999999" y="329.5" as="targetPoint" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e7" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" parent="1" source="preflight" target="sufficient" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<mxPoint x="1900" y="329.5" as="sourcePoint" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e8" value="No" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" parent="1" source="sufficient" target="gaps" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<mxPoint x="2148" y="326.47" as="sourcePoint" />
|
||||
<mxPoint x="2336" y="331.47" as="targetPoint" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e9" value="Yes" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;" parent="1" source="sufficient" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="2031" y="589" />
|
||||
<mxPoint x="180" y="589" />
|
||||
</Array>
|
||||
<mxPoint x="2120" y="439" as="sourcePoint" />
|
||||
<mxPoint x="180.0666666666666" y="644" as="targetPoint" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="wm-nTcyZt0jjmNqrfcTj-1" value="Yes" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];fontStyle=1" vertex="1" connectable="0" parent="e9">
|
||||
<mxGeometry x="-0.9863" relative="1" as="geometry">
|
||||
<mxPoint as="offset" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e10" value="FAT" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;" parent="1" source="populate" target="fat" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e11" value="Characterization" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;" parent="1" source="populate" target="char" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="407" y="874" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e12" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="fat" target="build" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="847" y="704" />
|
||||
<mxPoint x="847" y="749" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e13" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="char" target="build" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="847" y="874" />
|
||||
<mxPoint x="847" y="749" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e14" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="build" target="qa" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e15" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="qa" target="ready" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e16" value="No" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" parent="1" source="ready" target="correct" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e17" value="Yes" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;" parent="1" source="ready" target="review" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="1932" y="1039" />
|
||||
<mxPoint x="632" y="1039" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="wm-nTcyZt0jjmNqrfcTj-2" value="<b>Yes</b>" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" vertex="1" connectable="0" parent="e17">
|
||||
<mxGeometry x="-0.9713" y="1" relative="1" as="geometry">
|
||||
<mxPoint as="offset" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e18" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;dashed=1;" parent="1" source="correct" target="build" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="1607" y="979" />
|
||||
<mxPoint x="1607" y="869" />
|
||||
<mxPoint x="1077" y="869" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e19" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;" parent="1" source="review" target="issue" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e20" value="No" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;" parent="1" source="issue" target="hold" edge="1">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e21" value="Yes" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;endFill=1;fontStyle=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;" parent="1" source="issue" target="issued" edge="1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="1072" y="1329" />
|
||||
<mxPoint x="1072" y="1329" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
@@ -0,0 +1,18 @@
|
||||
# Linear Stage Characterization Report Template
|
||||
|
||||
This repository is a reusable, evidence-bound workflow for producing a linear
|
||||
stage Characterization working-draft PDF. It uses Python to generate the pdf report.
|
||||
|
||||
Place project evidence in `ECMC`, `Encoder`, `Motor`, `Measurements`,
|
||||
`Measurement_System`, and `Media`. Complete `FAT_Checklist.xlsx`, then populate
|
||||
`Report/python_script/Agent_Report_Data.json` using the source rules in
|
||||
`Report/python_script/Report_Input_Manifest.json`.
|
||||
|
||||
Run `Build_Characterization_Report.bat` from the repository root to create:
|
||||
|
||||
```text
|
||||
Report/Linear_Stage_Characterization_Working_Draft.pdf
|
||||
```
|
||||
|
||||
Read `Report/AGENTS.md` for the detailed evidence and report instructions. The
|
||||
`Transfer` folder contains a clean starter package for a new project.
|
||||
@@ -0,0 +1,78 @@
|
||||
# Linear Stage Python Report Instructions
|
||||
|
||||
The active report workflow is Python-only. Build the Characterization working
|
||||
draft from the repository root with:
|
||||
|
||||
```text
|
||||
Build_Characterization_Report.bat
|
||||
```
|
||||
|
||||
The launcher invokes `uv run --script Report/python_script/build_characterization_report.py`.
|
||||
It does not use LaTeX, MiKTeX, or a `.tex` source file.
|
||||
|
||||
## Evidence and boundaries
|
||||
|
||||
- Write generated reports only in this `Report` folder. Treat `Measurements`,
|
||||
`Media`, `Motor`, `Encoder`, `ECMC`, and other evidence folders as read-only.
|
||||
- Preserve `python_script/PSI_Logo.png`; the Python report displays this controlled logo on
|
||||
page 1.
|
||||
- The authoritative input is `../FAT_Checklist.xlsx`. The generator reads the
|
||||
Report type, stage identifier, repository URL, coordinate convention, and
|
||||
every explicit checklist Yes/No/Remarks response. This workbook is user-owned:
|
||||
agents and the generator must never modify it.
|
||||
- `Agent_Report_Data.json` is the separate agent-owned data file. Its required
|
||||
per-field source paths are governed by `Report_Input_Manifest.json`; the
|
||||
fixed generator rejects unmanifested fields or source paths without modifying
|
||||
either file.
|
||||
- The manifest locks input ownership: ECMC supplies only speed, acceleration,
|
||||
PID settings, and test-specific measured positions; Encoder supplies only
|
||||
encoder manufacturer/model/protocol/resolution/bit count; Motor supplies
|
||||
only motor manufacturer/model/type/step count/resistance; Measurements
|
||||
supplies only characterization metrics and environmental min/mean/max
|
||||
values. `Measurements/Temperature` is additional temperature data only.
|
||||
- Legible, unambiguous information visible in a photograph under `../Media`
|
||||
is also valid evidence for encoder, motor, drive, and measurement-system
|
||||
fields when the manifest allows it. Cite the exact image under
|
||||
`field_sources`; do not infer specifications, calibration state, or installed
|
||||
configuration from a model name or an indistinct image.
|
||||
- For Motor data, inspect `../Motor/Motor.xlsx` first when it exists. Use its
|
||||
explicitly identified motor record for manufacturer, model, motor type,
|
||||
step count, and resistance. Only when a requested field is absent or blank
|
||||
there, continue with other documents in `../Motor/`; preserve the exact
|
||||
source path for every populated field. Do not use Encoder-folder motor
|
||||
fields as a substitute for missing Motor-folder evidence.
|
||||
- The agent's work ends after updating `Agent_Report_Data.json` (and only the
|
||||
manifest when changing the approved input contract). The agent must
|
||||
not run the batch launcher, build a PDF, inspect or validate a PDF, or claim
|
||||
that the report is complete, issued, accepted, or visually correct.
|
||||
- The user runs `Build_Characterization_Report.bat` and is responsible for
|
||||
reviewing the resulting PDF.
|
||||
- The generator controls the applicable-standards text and the cover Document
|
||||
value. The agent table must not contain those keys: Document is always the
|
||||
generated PDF filename, and Applicable standards is fixed to
|
||||
`ISO 230-2:2014; ISO 230-2:1997`.
|
||||
- The current generator supports `Characterization`. It rejects a workbook
|
||||
selecting another report type, contradictory Yes/No cells, and a checklist
|
||||
structure that differs from the approved item IDs and wording.
|
||||
- Blank responses remain blank. The report never infers a test result, hardware
|
||||
identity, calibration state, measurement, or acceptance result.
|
||||
- The repository URL is shown only when the workbook contains a complete
|
||||
`http://` or `https://` URL. Placeholder text remains blank.
|
||||
- Required images use exact basenames `I1` through `I6` in `../Media`. A
|
||||
missing image is shown as a visible placeholder; it is not substituted. The
|
||||
mapping is fixed: I1 General view, I2 Encoder, I3 Motor, I4 Coupling, I5
|
||||
Measurement setup, I6 Measurement setup 2.
|
||||
- Every PDF in `../Measurements` is appended in filename order without editing
|
||||
its original content.
|
||||
|
||||
## Validation and status
|
||||
|
||||
- A successful PDF build is not FAT acceptance or evidence that hardware was
|
||||
operated or tested.
|
||||
- Inspect the generated PDF page by page before issue review. Confirm the
|
||||
cover logo, checklist transfer, image mapping, table wrapping, and every
|
||||
appended measurement page.
|
||||
- A working draft with missing evidence or placeholders is incomplete and must
|
||||
not be issued as an acceptance record.
|
||||
|
||||
Historical LaTeX templates and tools are retained only under `../OLD/`.
|
||||