Read Vector Space PositionReads the position of all axes in a vector space.
| Device Compatibility
|
Board ID is a unique number assigned by Measurement & Automation Explorer (MAX) used to send and receive commands and data to or from a specific NI motion controller. | |||||||
Vector Space is the vector space to read. | |||||||
Retn Vect indicates the destination for the return data generated by this VI. Available return vectors include return data to the host (0xFF), to a variable (0x01 through 0x78), to an indirect variable (0x81 through 0xF8), and do not return data (0). Refer to Input and Return Vectors for more detailed information. | |||||||
error in (no error) describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
|
|||||||
X Position is the position in quadrature counts (for servo axes) or steps (for stepper axes) of the X axis in the vector space. | |||||||
Y Position is the position in quadrature counts (for servo axes) or steps (for stepper axes) of the Y axis in the vector space. For vector spaces with less than three axes, zero (0) is returned on the unused axes. | |||||||
Z Position is the position in quadrature counts (for servo axes) or steps (for stepper axes) of the Z axis in the vector space. For vector spaces with less than three axes, zero (0) is returned on the unused axes. | |||||||
Bd ID Out is provided for flow control. You can string together NI-Motion VIs by wiring the Bd ID Out terminal of one VI to the Board ID terminal of the next VI. | |||||||
Resource Output is the Axis, Vector Space, ADC, or Encoder you wired into the VI. Use Resource Output to pass the resource to another VI and/or to display information about the device. | |||||||
error out contains error information. If error in indicates an error, error out contains the same error information. Otherwise, it describes the error status that this VI produces.
|
Using This VI
The Read Vector Space Position VI returns the instantaneous positions of the axes in the specified vector space. For servo axes, it returns the primary feedback position in counts. For open-loop stepper axes, it returns the number of steps generated. For closed-loop stepper axes, it converts the primary feedback position from counts to steps and then returns the value in steps. Closed-loop stepper axes require correctly loaded values of steps per revolution and counts per revolution to function correctly.
Note For closed-loop axes, this VI always returns the position of the primary feedback resource. |
Note If you are doing onboard programming and are using Retn Vect to write data, this VI writes the variables starting at the memory address pointed to by Retn Vect in the following order: X Position, Y Position, Z Position. |