VL53L0X Init Functions
[VL53L0X cut1.1 Function Definition]

One time device initialization.

To be called once and only once after device is brought out of reset (Chip enable) and booted see VL53L0X_WaitDeviceBooted()

Function Description

When not used after a fresh device "power up" or reset, it may return VL53L0X_ERROR_CALIBRATION_WARNING meaning wrong calibration data may have been fetched from device that can result in ranging offset error
If application cannot execute device reset or need to run VL53L0X_DataInit multiple time then it must ensure proper offset calibration saving and restore on its own by using VL53L0X_GetOffsetCalibrationData() on first power up and then VL53L0X_SetOffsetCalibrationData() in all subsequent init This function will change the VL53L0X_State from VL53L0X_STATE_POWERDOWN to VL53L0X_STATE_WAIT_STATICINIT.

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 367 of file vl53l0x_api.c.

Get the tuning settings pointer and the internal external switch value.

This function is used to get the Tuning settings buffer pointer and the value. of the switch to select either external or internal tuning settings.

Note:

This function Access to the device

Parameters:

Dev	Device Handle
ppTuningSettingBuffer	Pointer to tuning settings buffer.
pUseInternalTuningSettings	Pointer to store Use internal tuning settings value.

Returns:

VL53L0X_ERROR_NONE Success

"Other error code" See VL53L0X_Error

Definition at line 535 of file vl53l0x_api.c.

Do an hard reset or soft reset (depending on implementation) of the device call of this function, device must be in same state as right after a power-up sequence.This function will change the VL53L0X_State to VL53L0X_STATE_POWERDOWN.

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 740 of file vl53l0x_api.c.

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
DeviceAddress	The new Device address

Returns:

VL53L0X_ERROR_NONE Success

"Other error code" See VL53L0X_Error

Definition at line 355 of file vl53l0x_api.c.

Set the tuning settings pointer.

This function is used to specify the Tuning settings buffer to be used for a given device. The buffer contains all the necessary data to permit the API to write tuning settings. This function permit to force the usage of either external or internal tuning settings.

Note:

This function Access to the device

Parameters:

Dev	Device Handle
pTuningSettingBuffer	Pointer to tuning settings buffer.
UseInternalTuningSettings	Use internal tuning settings value.

Returns:

VL53L0X_ERROR_NONE Success

"Other error code" See VL53L0X_Error

Definition at line 508 of file vl53l0x_api.c.

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 550 of file vl53l0x_api.c.

Wait for device booted after chip enable (hardware standby) This function can be run only when VL53L0X_State is VL53L0X_STATE_POWERDOWN.

Note:

This function is not Implemented

Parameters:

Dev	Device Handle

Returns:

VL53L0X_ERROR_NOT_IMPLEMENTED Not implemented

Definition at line 729 of file vl53l0x_api.c.