John Alexander / VL53L3_Lib

Dependencies:   X_NUCLEO_COMMON ST_INTERFACES

Dependents:   VL53L3ExpansionBoard

Embed: (wiki syntax)

« Back to documentation index

VL53LX Parameters Functions

VL53LX Parameters Functions
[VL53LX Function Definition]

Functions used to prepare and setup the device. More...

Functions

VL53LX_Error VL53LX_SetDistanceMode (VL53LX_DistanceModes DistanceMode)
 Set the distance mode.
VL53LX_Error VL53LX_GetDistanceMode (VL53LX_DistanceModes *pDistanceMode)
 Get the distance mode.
VL53LX_Error VL53LX_SetMeasurementTimingBudgetMicroSeconds (uint32_t MeasurementTimingBudgetMicroSeconds)
 Set Ranging Timing Budget in microseconds.
VL53LX_Error VL53LX_GetMeasurementTimingBudgetMicroSeconds (uint32_t *pMeasurementTimingBudgetMicroSeconds)
 Get Ranging Timing Budget in microseconds.

Detailed Description

Functions used to prepare and setup the device.


Function Documentation

VL53LX_Error VL53LX_GetDistanceMode ( VL53LX_DistanceModes *  pDistanceMode ) [inherited]

Get the distance mode.

Function Description
Get the distance mode used for the next ranging.
Parameters:
DevDevice Handle
*pDistanceModePointer to Distance mode
Returns:
VL53LX_Error_NONE Success
"Other error code" See VL53LX_Error

Definition at line 27240 of file vl53lx_class.cpp.

VL53LX_Error VL53LX_GetMeasurementTimingBudgetMicroSeconds ( uint32_t *  pMeasurementTimingBudgetMicroSeconds ) [inherited]

Get Ranging Timing Budget in microseconds.

Function Description
Returns the programmed the maximum time allowed by the user to the device to run a full ranging sequence for the current mode (ranging, histogram, ...)
Parameters:
DevDevice Handle
pMeasurementTimingBudgetMicroSecondsMax measurement time in microseconds.
Returns:
VL53LX_Error_NONE Success
"Other error code" See VL53LX_Error

Definition at line 27310 of file vl53lx_class.cpp.

VL53LX_Error VL53LX_SetDistanceMode ( VL53LX_DistanceModes  DistanceMode ) [inherited]

Set the distance mode.

Function Description
Set the distance mode to be used for the next ranging.
The modes Short, Medium and Long are used to optimize the ranging accuracy in a specific range of distance.
The user select one of these modes to select the distance range.
Note:
This function doesn't Access to the device
Warning:
This function should be called after VL53LX_DataInit().
Parameters:
DevDevice Handle
DistanceModeDistance mode to apply, valid values are:

  • VL53LX_DISTANCEMODE_SHORT
  • VL53LX_DISTANCEMODE_MEDIUM
  • VL53LX_DISTANCEMODE_LONG
Returns:
VL53LX_Error_NONE Success
VL53LX_Error_MODE_NOT_SUPPORTED This error occurs when DistanceMode is not in the supported list
"Other error code" See VL53LX_Error

Definition at line 27196 of file vl53lx_class.cpp.

VL53LX_Error VL53LX_SetMeasurementTimingBudgetMicroSeconds ( uint32_t  MeasurementTimingBudgetMicroSeconds ) [inherited]

Set Ranging Timing Budget in microseconds.

Function Description
Defines the maximum time allowed by the user to the device to run a full ranging sequence for the current mode (ranging, histogram, ASL ...)
Parameters:
DevDevice Handle
MeasurementTimingBudgetMicroSecondsMax measurement time in microseconds.
Returns:
VL53LX_Error_NONE Success
VL53LX_Error_INVALID_PARAMS Error timing parameter not supported. The maximum accepted value for the computed timing budget is 10 seconds the minimum value depends on the preset mode selected.
"Other error code" See VL53LX_Error

Definition at line 27252 of file vl53lx_class.cpp.