Single-Axis Home
RESET_AXIS · V4.23Home one selected X, Y, Z or R axis using single-stage or three-stage mode. Speed selection is separate from this motion command.
Requires multi-axis interpolation mode.
Hexadecimal notation is used for IDs, indexes, modes and sentinel values where applicable. Physical quantities (such as pulses, milliseconds and pulse/s) remain in their native units. Macro names are shown only when defined by the firmware.
Input parameters
| Parameter | Initial value | Meaning |
|---|---|---|
Axis / targetaxis | X | Selected X, Y, Z or R axis. The operating mode must support coordinate axes. |
Homing modehome_mode | 0x01U | 1 searches only; 2 searches, releases and latches. Both use the selected axis profile. 0x01U = MTGM_OP_HOME_MODE_SINGLE_STAGE; 0x02U = MTGM_OP_HOME_MODE_THREE_STAGE. |
Initial values are editor defaults for a newly inserted instruction; configure them for the actual machine.
Firmware macro definitions
Hexadecimal equivalents of the firmware definitions; numeric values are unchanged.
#define MTGM_OP_HOME_MODE_SINGLE_STAGE 0x01U
#define MTGM_OP_HOME_MODE_THREE_STAGE 0x02UExecution and usage
- Mode 1 uses only this axis search rate and completes without motion on a stable home switch. Mode 2 releases an initially active switch, then runs all three stages. Unified Reset speed is removed. Legacy RESET and HOME programs are converted on import/readback and must be recompiled and downloaded.