Write Trajectory DataConfigures trajectory generator parameters.
|
Device Compatibility
|
data in is a cluster of variables that contains the values for the selected attribute.
Based on the attribute, the correct member of data in must be set as follows:
|
|||||||
attribute is the attribute you want to load. The following are valid attributes:
The effect of the criteria parameters can be summarized with the following equation: Move Complete = (Profile Complete [ OR when deactivated ] ) |
|||||||
board in is a unique number assigned by Measurement & Automation Explorer used to send and receive commands and data to or from a specific NI motion controller. | |||||||
axis in is the axis you are controlling. | |||||||
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:
|
|||||||
board out is provided for flow control. You can string together NI-Motion VIs by wiring the board out terminal of one VI to the board in terminal of the next VI. | |||||||
axis out is provided for flow control. You can string together NI-Motion VIs by wiring the axis out terminal of one VI to the axis in terminal of the next VI. | |||||||
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
Use this VI to configure trajectory generator parameters for reporting a move complete. When a move is complete on an axis, the corresponding bit in the Move Complete Status (MCS) register is set. Refer to Read Move Complete Status for information about reading the MCS register.
If move complete when deactivated is true, any condition that causes the axis to turn its motor off (a kill or following error trip) satisfies this requirement for Move Complete.
If the move complete when not moving is true, the axis must be logically stopped for the move to be considered complete.
If move complete after delay is true, the axis must wait a user-defined delay after the other criteria are met before the move is considered complete. The move complete time delay attribute is typically used to wait the mechanical settling time so that a move is not considered complete until vibrations in the mechanical system have damped out. It also can be used to compensate for PID pull-in time due to the integral term. This pull-in is typically at velocities below the Run/Stop threshold.
Note You can use the move complete after delay parameter to guarantee a minimum time for the False state. The status transitions from Complete to Not Complete at the start of a move and stays in the Not Complete state for at least this delay time even in the case of a zero distance move. |
If move complete when in range is true, the axis checks its final stopping position versus its target position and only sets the Move Complete status if the absolute value of the difference is less than move complete range distance.
Finally, if move complete when in position active is true, the in-position input signal is used as a criteria for move complete, and the move is only complete if the in-position signal is active.
A non-zero value for move complete minimum active time guarantees the status stays in the True state for at least this minimum time, even if another move starts immediately. You can use this feature to make sure the host does not miss a Move Complete status when it polls the Move Complete Status register.
Tip You can adjust move complete criteria settings in MAX on the Trajectory Settings tab. |
This VI is typically called for each axis prior to using the axis for position control. After the attribute is set, it remains in effect until it is disabled. You can execute this VI at any time.
When an axis starts, its corresponding bit in the Move Complete Status register is reset to zero. When the move completes, the bit is set to one. You can check the status of an axis or axes at any time by polling the MCS register. Onboard programs can use this status to automatically sequence moves with the Wait on Condition VI.
Remarks
This section includes information about how the behavior of this VI differs among the controllers that support it.
NI 73xx Controller Considerations
The following list includes considerations you must make when you are using this VI with a 73xx motion controller:
- The NI 7344 does not support the move complete when in position active attribute.
- 7330, 7340, and 7350 controllers use Configure Motion I/O Map to map the in-position input to a general-purpose I/O line.
NI SoftMotion Controller Considerations
The following includes considerations you must make when you are using this VI with the NI SoftMotion Controller:
The NI SoftMotion Controller does not support the move complete when in position active attribute.