John Alexander / VL53L3_Lib

Dependencies:   X_NUCLEO_COMMON ST_INTERFACES

Dependents:   VL53L3ExpansionBoard

Embed: (wiki syntax)

« Back to documentation index

VL53LX Measurement Functions

VL53LX Measurement Functions
[VL53LX Function Definition]

Functions used for the measurements. More...

Functions

VL53LX_Error VL53LX_StartMeasurement ()
 Start device measurement.
VL53LX_Error VL53LX_StopMeasurement ()
 Stop device measurement.
VL53LX_Error VL53LX_ClearInterruptAndStartMeasurement ()
 Clear the Interrupt flag and start new measurement
VL53LX_Error VL53LX_GetMeasurementDataReady (uint8_t *pMeasurementDataReady)
 Return Measurement Data Ready.
VL53LX_Error VL53LX_WaitMeasurementDataReady ()
 Wait for measurement data ready.
VL53LX_Error VL53LX_GetMultiRangingData (VL53LX_MultiRangingData_t *pMultiRangingData)
 Retrieve all measurements from device with the current setup.

Detailed Description

Functions used for the measurements.


Function Documentation

VL53LX_Error VL53LX_ClearInterruptAndStartMeasurement (  ) [inherited]

Clear the Interrupt flag and start new measurement

Note:
This function Access to the device
Parameters:
DevDevice Handle
Returns:
VL53LX_Error_NONE Success
"Other error code" See VL53LX_Error

Definition at line 27411 of file vl53lx_class.cpp.

VL53LX_Error VL53LX_GetMeasurementDataReady ( uint8_t *  pMeasurementDataReady ) [inherited]

Return Measurement Data Ready.

Function Description
This function indicate that a measurement data is ready. This function is used for non-blocking capture.
Note:
This function Access to the device
Parameters:
DevDevice Handle
pMeasurementDataReadyPointer to Measurement Data Ready. 0 = data not ready, 1 = data ready
Returns:
VL53LX_Error_NONE Success
"Other error code" See VL53LX_Error

Definition at line 27424 of file vl53lx_class.cpp.

VL53LX_Error VL53LX_GetMultiRangingData ( VL53LX_MultiRangingData_t pMultiRangingData ) [inherited]

Retrieve all measurements from device with the current setup.

Function Description
Get data from last successful Ranging measurement
Warning:
USER must call VL53LX_ClearInterruptAndStartMeasurement() prior to call again this function
Note:
This function Access to the device
The first valid value returned by this function will have a range status equal to VL53LX_RANGESTATUS_RANGE_VALID_NO_WRAP_CHECK which means that the data is valid but no wrap around check have been done. User should take care about that.
Parameters:
DevDevice Handle
pMultiRangingDataPointer to the data structure to fill up.
Returns:
VL53LX_Error_NONE Success
"Other error code" See VL53LX_Error

Definition at line 27604 of file vl53lx_class.cpp.

VL53LX_Error VL53LX_StartMeasurement (  ) [inherited]

Start device measurement.

Started measurement will depend on distance parameter set through VL53LX_SetDistanceMode()

Note:
This function Access to the device
Parameters:
DevDevice Handle
Returns:
VL53LX_Error_NONE Success
VL53LX_Error_TIME_OUT Time out on start measurement
VL53LX_Error_INVALID_PARAMS This error might occur in timed mode when inter measurement period is smaller or too close to the timing budget. In such case measurements are not started and user must correct the timings passed to VL53LX_SetMeasurementTimingBudgetMicroSeconds() and VL53LX_SetInterMeasurementPeriodMilliSeconds() functions.
"Other error code" See VL53LX_Error

Definition at line 27363 of file vl53lx_class.cpp.

VL53LX_Error VL53LX_StopMeasurement (  ) [inherited]

Stop device measurement.

Will set the device in standby mode at end of current measurement
Not necessary in single mode as device shall return automatically in standby mode at end of measurement.

Note:
This function Access to the device
Parameters:
DevDevice Handle
Returns:
VL53LX_Error_NONE Success
"Other error code" See VL53LX_Error

Definition at line 27400 of file vl53lx_class.cpp.

VL53LX_Error VL53LX_WaitMeasurementDataReady (  ) [inherited]

Wait for measurement data ready.

Blocking function. Note that the timeout is given by: VL53LX_RANGE_COMPLETION_POLLING_TIMEOUT_MS defined in def.h

Note:
This function Access to the device
Parameters:
DevDevice Handle
Returns:
VL53LX_Error_NONE Success
VL53LX_Error_TIME_OUT In case of timeout

Definition at line 27433 of file vl53lx_class.cpp.