|Download Help (Windows Only)|
Executes a search operation to one of the following reference positions:
is the type of search executed by the Find Reference VI.
|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/VS Map (Disabled) is the bitmap of axes or vector spaces (coordinate spaces) to use with this VI. 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 searching on multiple axes (Axis or Vector Space = Axis Control):
When searching on multiple vector spaces (Axis or Vector Space = Vector Space Control):
|Axis or Vector Space can select an axis (1 through 8), vector space (0x11 through 0x14), multiple axes (0), or multiple vector spaces (0x10). When simultaneously starting multiple axes or vector spaces, the Axis/VS Map parameter indicates which axes or vector spaces are involved.
To start a find on a single axis or vector space, set the Axis or Vector Space selector to the appropriate axis or vector space. The Axis/VS Map bitmap is ignored.
To start a find on multiple axes, the Axis or Vector Space selector is set to 0 and the Axis/VS Map bitmap defines the axes to start. Similarly, to start a find on multiple vector spaces, the Axis or Vector Space selector is set to 16 and the Axis/VS Map bitmap defines the vector spaces to start.
|error in 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:
|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.|
|Axis or Vector Space Output is the Axis or Vector Space you wired into the VI. Use Axis or Vector Space 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.
This VI returns immediately after starting the given find operation. Use this VI in conjunction with Wait Reference to determine when the find operation completes and if the find was successful.
You can manually stop a search operation using MAX or by calling the Stop Motion VI. When encountering a limit or home input, a search operation performs a halt stop and then continues based on the Search Type. An unexpected limit condition during a find stops the sequence and generates a modal error. Refer to Errors and Error Handling for information about errors.
|Note You must set unused limit and home inputs to their inactive state using MAX or with the Enable Limits and Enable Home Inputs VIs.|
|Note Forward is defined as the direction of increasing position. The Forward and Reverse Limits must be located at the proper ends of travel for Find Reference to function properly.|
You can access settings for Find Reference through MAX, Load Reference Parameter and Get Reference Parameter. For a detailed description on how these settings affect a given Search Type, refer to the section on each type. Most of these settings are on a per-Search Type basis.
|Note If you start a coordinate (vector) space, Find Reference actually starts the axes individually, so it is not a coordinated vector move.|
Find Forward and Reverse Limits
This section includes information about how the behavior of this VI differs among the controllers that support it.
The following list includes considerations you must make when you are using this VI with an NI 73xx motion controller: