Calc_sigma_estimate

Get results for the measure indicated by operating mode.

Parameters:

[in]	operating_mode	specifies requested measure results
[out]	p_data	pointer to the MeasureData_t structure to read data in to

Returns:

"0" on success

Definition at line 5442 of file VL53L0X.cpp.

Interrupt handling func to be called by user after an INT is occourred.

Parameters:

[in]	opeating_mode	indicating the in progress measure
[out]	Data	pointer to the MeasureData_t structure to read data in to

Returns:

"0" on success

Definition at line 5503 of file VL53L0X.cpp.

Initialize the sensor with default values.

Returns:

"0" on success

Definition at line 5231 of file VL53L0X.cpp.

Start the measure indicated by operating mode.

Parameters:

[in]	operating_mode	specifies requested measure
[in]	fptr	specifies call back function must be !NULL in case of interrupt measure

Returns:

"0" on success

Definition at line 5301 of file VL53L0X.cpp.

Stop the currently running measure indicate by operating_mode.

Parameters:

[in]

operating_mode

specifies requested measure to stop

Returns:

"0" on success

Definition at line 5473 of file VL53L0X.cpp.

Gets the fraction enable parameter indicating the resolution of range measurements.

Function Description

Gets the fraction enable state, which translates to the resolution of range measurements as follows :Enabled:=0.25mm resolution, Not Enabled:=1mm resolution.

Note:

This function Accesses the device

Parameters:

dev	Device Handle
p_enabled	Output Parameter reporting the fraction enable state.

Returns:

VL53L0X_ERROR_NONE Success

"Other error code" See VL53L0X_Error

Definition at line 4235 of file VL53L0X.cpp.

Retrieve the measurements from device for a given setup.

Function Description

Get data from last successful Ranging measurement

Warning:

USER should take care about VL53L0X_GetNumberOfROIZones() before get data. PAL will fill a NumberOfROIZones times the corresponding data structure used in the measurement function.

Note:

This function Access to the device

Parameters:

dev	Device Handle
p_ranging_measurement_data	Pointer to the data structure to fill up.

Returns:

VL53L0X_ERROR_NONE Success

"Other error code" See VL53L0X_Error

Definition at line 3502 of file VL53L0X.cpp.

Return device stop completion status.

Function Description

Returns stop completiob status. User shall call this function after a stop command

Note:

This function Access to the device

Parameters:

dev	Device Handle
p_stop_status	Pointer to status variable to update

Returns:

VL53L0X_ERROR_NONE Success

"Other error code" See VL53L0X_Error

Definition at line 4991 of file VL53L0X.cpp.

Perform Reference Calibration.

Perform a reference calibration of the Device. This function should be run from time to time before doing a ranging measurement. This function will launch a special ranging measurement, so if interrupt are enable an interrupt will be done. This function will clear the interrupt generated automatically.

Warning:

This function is a blocking function

Note:

This function Access to the device

Parameters:

dev	Device Handle
p_vhv_settings	Pointer to vhv settings parameter.
p_phase_cal	Pointer to PhaseCal parameter.

Returns:

VL53L0X_ERROR_NONE Success

"Other error code" See VL53L0X_Error

Definition at line 4096 of file VL53L0X.cpp.

Performs Reference Spad Management.

Function Description

The reference SPAD initialization procedure determines the minimum amount of reference spads to be enables to achieve a target reference signal rate and should be performed once during initialization.

Note:

This function Access to the device

This function change the device mode to VL53L0X_DEVICEMODE_SINGLE_RANGING

Parameters:

dev	Device Handle
ref_spad_count	Reports ref Spad Count
is_aperture_spads	Reports if spads are of type aperture or non-aperture. 1:=aperture, 0:=Non-Aperture

Returns:

VL53L0X_ERROR_NONE Success

VL53L0X_ERROR_REF_SPAD_INIT Error in the Ref Spad procedure.

"Other error code" See VL53L0X_Error

Definition at line 4109 of file VL53L0X.cpp.

Performs a single ranging measurement and retrieve the ranging measurement data.

Function Description

This function will change the device mode to VL53L0X_DEVICEMODE_SINGLE_RANGING with VL53L0X_SetDeviceMode(), It performs measurement with VL53L0X_PerformSingleMeasurement() It get data from last successful Ranging measurement with VL53L0X_GetRangingMeasurementData. Finally it clear the interrupt with VL53L0X_ClearInterruptMask().

Note:

This function Access to the device

This function change the device mode to VL53L0X_DEVICEMODE_SINGLE_RANGING

Parameters:

dev	Device Handle
p_ranging_measurement_data	Pointer to the data structure to fill up.

Returns:

VL53L0X_ERROR_NONE Success

"Other error code" See VL53L0X_Error

Definition at line 3658 of file VL53L0X.cpp.

Set new device address.

After completion the device will answer to the new address programmed. This function should be called when several devices are used in parallel before start programming the sensor. When a single device us used, there is no need to call this function.

Note:

This function Access to the device

Parameters:

dev	Device Handle
device_address	The new Device address

Returns:

VL53L0X_ERROR_NONE Success

"Other error code" See VL53L0X_Error

Definition at line 4124 of file VL53L0X.cpp.

Set the configuration of GPIO pin for a given device.

Note:

This function Access to the device

Parameters:

dev	Device Handle
pin	ID of the GPIO Pin
functionality	Select Pin functionality. Refer to VL53L0X_GpioFunctionality
device_mode	Device Mode associated to the Gpio.
polarity	Set interrupt polarity. Active high or active low see VL53L0X_InterruptPolarity

Returns:

VL53L0X_ERROR_NONE Success

VL53L0X_ERROR_GPIO_NOT_EXISTING Only Pin=0 is accepted.

VL53L0X_ERROR_GPIO_FUNCTIONALITY_NOT_SUPPORTED This error occurs when Functionality programmed is not in the supported list: Supported value are: VL53L0X_GPIOFUNCTIONALITY_OFF, VL53L0X_GPIOFUNCTIONALITY_THRESHOLD_CROSSED_LOW, VL53L0X_GPIOFUNCTIONALITY_THRESHOLD_CROSSED_HIGH, VL53L0X_GPIOFUNCTIONALITY_THRESHOLD_CROSSED_OUT, VL53L0X_GPIOFUNCTIONALITY_NEW_MEASURE_READY

"Other error code" See VL53L0X_Error

Definition at line 4136 of file VL53L0X.cpp.

Enable/Disable a specific limit check.

Function Description

This function Enable/Disable a specific limit check. The limit check is identified with the LimitCheckId.

Note:

This function doesn't Access to the device

Parameters:

dev	Device Handle
limit_check_id	Limit Check ID (0<= LimitCheckId < VL53L0X_GetNumberOfLimitCheck() ).
limit_check_enable	if 1 the check limit corresponding to LimitCheckId is Enabled if 0 the check limit corresponding to LimitCheckId is disabled

Returns:

VL53L0X_ERROR_NONE Success

VL53L0X_ERROR_INVALID_PARAMS This error is returned when LimitCheckId value is out of range.

"Other error code" See VL53L0X_Error

Definition at line 4675 of file VL53L0X.cpp.

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 ...)

Note:

This function Access to the device

Parameters:

dev	Device Handle
measurement_timing_budget_micro_seconds	Max measurement time in microseconds. Valid values are: >= 17000 microsecs when wraparound enabled >= 12000 microsecs when wraparound disabled

Returns:

VL53L0X_ERROR_NONE Success

VL53L0X_ERROR_INVALID_PARAMS This error is returned if MeasurementTimingBudgetMicroSeconds out of range

"Other error code" See VL53L0X_Error

Definition at line 4571 of file VL53L0X.cpp.

Applies Reference SPAD configuration.

Function Description

This function applies a given number of reference spads, identified as either Aperture or Non-Aperture. The requested spad count and type are stored within the device specific parameters data for access by the host.

Note:

This function Access to the device

Parameters:

dev	Device Handle
refSpadCount	Number of ref spads.
is_aperture_spads	Defines if spads are of type aperture or non-aperture. 1:=aperture, 0:=Non-Aperture

Returns:

VL53L0X_ERROR_NONE Success

VL53L0X_ERROR_REF_SPAD_INIT Error in the in the reference spad configuration.

"Other error code" See VL53L0X_Error

Definition at line 4013 of file VL53L0X.cpp.

Sets the (on/off) state of a requested sequence step.

Function Description

This function enables/disables a requested sequence step.

Note:

This function Accesses the device

Parameters:

dev	Device Handle
sequence_step_id	Sequence step identifier.
sequence_step_enabled	Demanded state {0=Off,1=On} is enabled.

Returns:

VL53L0X_ERROR_NONE Success

VL53L0X_ERROR_INVALID_PARAMS Error SequenceStepId parameter not supported.

"Other error code" See VL53L0X_Error

Definition at line 4585 of file VL53L0X.cpp.

Do basic device init (and eventually patch loading) This function will change the VL53L0X_State from VL53L0X_STATE_WAIT_STATICINIT to VL53L0X_STATE_IDLE.

In this stage all default setting will be applied.

Note:

This function Access to the device

Parameters:

dev	Device Handle

Returns:

VL53L0X_ERROR_NONE Success

"Other error code" See VL53L0X_Error

Definition at line 4778 of file VL53L0X.cpp.

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. This function will change the VL53L0X_State from VL53L0X_STATE_RUNNING to VL53L0X_STATE_IDLE.

Note:

This function Access to the device

Parameters:

dev	Device Handle

Returns:

VL53L0X_ERROR_NONE Success

"Other error code" See VL53L0X_Error

Definition at line 4963 of file VL53L0X.cpp.