User Manual

API useful additional functions UM2039
20/26 DocID029105 Rev 1
6.6 I2C device address
User can change the I2C address of the device.
VL53L0X_SetDeviceAddress()
6.7 Reset
This functions resets the device and waits for the boot up.
VL53L0X_ResetDevice()
6.8 Interrupt settings
Use VL53L0X_SetGpioConfig()and VL53L0X_GetGpioConfig() to set/get the
functionality of the interrupt.
Options are:
• No Interrupt
• Level Low (value < thresh_low)
• Level High (value > thresh_high)
• Out Of Window (value < thresh_low OR value > thresh_high)
There is a dedicated procedure embedded in the API for when the interrupt threshold is
programmed to be larger than 254mm and also set to continuous or continuous timed mode.
In this case some specific tuning parameters are loaded by the API at each ranging start
which will introduce a delay of a few milliseconds (depending on the host I2C performance)
to the very first ranging measurement.
-10 GPIO not existing
User tried to set up a non-existing
GPIO pin
Wrong API programming (wrong setting used), or
I2C transaction corrupted
-11
GPIO functionality
not supported
Unsupported GPIO functionality
Wrong API programming (wrong setting used), or
I2C transaction corrupted
-20
Control Interface
Error
Error reported from IO functions
(comm error)
I2C comm error
-30
Invalid Command
Error
Cannot happen N/A
-40
Division by zero
Error
Cannot occur in cut1.1 N/A
-50
Reference SPAD
Init Error
Error during reference SPAD
initialization
Bad NVM programming, module aperture blocked
with high reflective target, I2C transaction
corrupted (wrong programming)
-99
Not implemented
error
Not implemented N/A
Table 4. API error values and error strings description (continued)
API
error
value
API error string Occurrence Possible root cause