kernelv_get_acs_command_positions()
Prototype
KERNELV_RETURN | kernelv_get_acs_command_positions (unsigned long* positions, |
Description
The ACS command positions of all axes existing in the CNC are returned in an array. If an axis-specific command value transformation is configured for an axis, this function returns the transformed command value for each specific axis.
Position values have a resolution of 0.1 µm for translatory axes or 1*10-4° for spindles or modulo axes.
The error code ERR_CNC_RET_MEMORY is returned if the memory provided by the calling application is not sufficient for returning all values.
The calling application must provide at least number of axes * sizeof(signed long int) bytes for returning of all position values.
The order of the axis positions in the returned array is equal to the configuration order of the axes.
Parameter
Name | Type | Meaning |
positions | unsigned long* | Pointer to the memory area for the axis positions to be returned. |
maxByteSize | unsigned long | Size of the memory area for the axis positions. |
returnSize | unsigned long* | Number of bytes returned in positions. |
Return values
Symbol | Value | Meaning |
RET_FINISHED | 0 | The function was executed without error. |
ERR_CNC_NOT_INIT | -3 | The simulation CNC kernel was not yet initialised. |
ERR_CNC_RET_MEMORY | -4 | The return value(s) does/do not fit into the memory provided. The number of bytes required is returned in the returnSize parameter. |