Read Axis Limit Status Return

Usage

status = flex_read_axis_limit_status_rtn(u8 boardID, u16 limitType, u16* forwardLimitStatus, u16* reverseLimitStatus);

Purpose

Reads the instantaneous state of either the hardware limit inputs or the software limits.

Tip  Refer to the Remarks section for information about how the behavior of this function differs between controllers.

Parameters

Parameter Discussion

limitType selects the type of limit status to read, either the hardware limit switch status or the software position limit status.

forwardLimitStatus is the bitmap of forward limit status (either hardware or software):

For D1 through D15:
   1 = Forward limit True (On)
   0 = Forward limit False (Off)

reverseLimitStatus is the bitmap of reverse limit status (either hardware or software).

For D1 through D15:
   1 = Reverse limit True (On)
   0 = Reverse limit False (Off)

Using This Function

This function returns either the hardware limit input status or the software position limit status, depending on the limit type selected. When limitType = NIMC_LIMIT_INPUTS (0), this function returns the logical state of the forward and reverse limit inputs.

Note  The polarity of the limit inputs determines if an On state is active high or active low. Refer to the Set Limit Input Polarity function for more information.

Alternatively, when limitType = NIMC_SOFTWARE_LIMITS (1), this function returns the state of the forward and reverse software limits. A True (On) indicates that the forward or reverse limit position for the corresponding axis has been reached or exceeded. The limit input status during a Find Reference move is undefined.

You can read the status of the limit inputs and the software position limits at any time, regardless of if the limits are enabled. Enabled limits cause axes to stop when their state transitions True. Refer to the Enable Axis Limits function for more information.

Remarks

This section includes information about how the behavior of this function differs among the controllers that support it.

NI SoftMotion Controller Considerations

The following list includes considerations you must make when you are using this function with the NI SoftMotion Controller:

To read the hardware and software limit status on axes sixteen through thirty, use the Read Motion I/O Data function.