Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
Dependencies: X_NUCLEO_COMMON ST_INTERFACES
Dependents: VL53L3ExpansionBoard
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:
-
Dev Device 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:
-
Dev Device Handle pMeasurementDataReady Pointer 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:
-
Dev Device Handle pMultiRangingData Pointer 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:
-
Dev Device 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:
-
Dev Device 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:
-
Dev Device Handle
- Returns:
- VL53LX_Error_NONE Success
- VL53LX_Error_TIME_OUT In case of timeout
Definition at line 27433 of file vl53lx_class.cpp.
Generated on Fri Jul 15 2022 05:39:18 by
1.7.2