Check Move Complete StatusChecks the move complete status for an axis, vector space, group of axes, or group of vector spaces.
| Device Compatibility
|
 |
Axis/VS Map is the bitmap of axes or vector spaces to check. It is only required when multiple axes or vector spaces are selected with the Axis or Vector Space parameter. Otherwise, this parameter is ignored.
When checking multiple axes (Axis/VS Map = Axis Control):
When checking multiple vector spaces (Axis/Vector Space = Vector Space Control):
To check for move complete on a single axis or vector space, set the Axis or Vector Space selector to the appropriate axis or vector space. The Axis or Vector Space bitmap is ignored. For a vector space to be considered move complete, all axes in the vector space must be move complete. To check for move complete on multiple axes, the Axis or Vector Space selector is set to Axis Control and the Axis/VS Map bitmap defines the axes to check. All axes must be move complete for the Move Complete output to be true. Similarly, to check for move complete on multiple vector spaces, the Axis or Vector Space selector is set to Vector Space Control and the Axis/VS Map bitmap defines the vector spaces to check. |
||||||||||||||||||||||||
 |
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. | ||||||||||||||||||||||||
 |
Axis or Vector Space can select an axis (1 through 15), vector space (0x11 through 0x14), multiple axes (Axis Control), or multiple vector spaces (Vector Space Control). When simultaneously acting on multiple axes or vector spaces, the Axis/VS Map parameter indicates which axes or vector spaces are involved. | ||||||||||||||||||||||||
 |
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:
|
||||||||||||||||||||||||
 |
Move Complete
indicates whether or not the move is complete on the axes or vector spaces specified.
True (On) = Move complete |
||||||||||||||||||||||||
 |
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
This VI extends the functionality of the Read Trajectory Status VI, such that you can define a combination of axes or vector spaces to check as a group. It also can check the move complete status for a single axis or vector space, much the same as Read Blend Status. Instead of decoding the output of the Read Trajectory Status VI yourself, this VI does that for you by comparing the axes or vector spaces specified in the Axis or Vector Space and Axis or VS Map input parameters with the move complete status for the appropriate axes or vector spaces. The output is a single true/false value indicating whether or not the specified move or moves are complete.
This VI does not check for following error status or axis off status. Checking for faults during moves is recommended. To do this, use Read per Axis Status, which returns following error and axis off status in addition to the move complete status. Refer to the NI-Motion Help for more information and example code.
For more information about move complete status, refer to the Read Trajectory Status and Configure Move Complete Criteria VIs.
 |
Note Refer to VI Execution Times for benchmark timing information about your controller. |