Single-Axis Relative Move to Point
MOVE_AXIS_RELATIVE_POINT · V4.23Single-axis relative move using a point component.
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. |
Point IDpoint_index | 0x00000000UL | Point-table index. Absolute moves use target coordinates; relative moves use increments. The referenced point must exist. Zero-based IDs are 0x00000000UL to 0x000000FEUL; the selected index must also be below the actual point count. The invalid sentinel is MTGM_POINT_INVALID_INDEX (0xFFFFFFFFUL). |
Compensation IDcompensation_id | No compensation (0xFFFFFFFFUL) | MCU compensation ID 0x00000000UL to 0x00000007UL; 0xFFFFFFFFUL disables compensation. Verify the source and current result. MTGM_OP_COMPENSATION_NONE = 0xFFFFFFFFUL. |
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_POINT_INVALID_INDEX 0xFFFFFFFFUL
#define MTGM_POINT_MAX_COUNT 0xFFU
#define MTGM_OP_COMPENSATION_NONE 0xFFFFFFFFULExecution and usage
- Add the stored increment to current position to check the resulting target.