Data Sheet

Ranging API function descriptions UM2356
10/28 DocID031478 Rev 1
Example:
Status = VL53L1_SetInterMeasurementPeriodMilliSeconds(&VL53L1Dev,
1000 ); sets the inter-measurement period to 1 s.
The function VL53L1_GetInterMeasurementPeriodMilliSeconds() gets the
programmed inter-measurement period.
Note: If the inter-measurement period is shorter than the timing budget, once the device
completes the ranging, the next ranging starts immediately.
Note: The timing budget and inter-measurement period should not be called when the sensor is
ranging. The user has to stop the ranging, change these parameters, and restart ranging.
2.5.3 Distance mode
Distance mode is a parameter provided to optimize the internal settings and tunings to get
the best ranging performances depending on the ranging distance required by the
application and the ambient light conditions.
The benefit of changing the distance mode is detailed in Table 1: Distance modes
The function to use is VL53L1_SetDistanceMode().
The user can call VL53L1_GetDistanceMode() to get the programmed distance mode.
2.5.4 Limit check settings
The driver uses two parameters to qualify the ranging measurement: signal and sigma.
If signal or sigma are outside the limits, the ranging is flagged as invalid (note that
RangeStatus is different than zero).
Applicable limits are:
• Sigma: VL53L1X_CHECKENABLE_SIGMA_FINAL_RANGE
Sigma is expressed in mm and is the estimation of the standard deviation of the
measurement.
• Signal: VL53L1X_CHECKENABLE_SIGNAL_RATE_FINAL_RANGE
The signal rate measurement, expressed in MCPS, represents the amplitude of the signal
reflected from the target and detected by the device.
Table 1. Distance modes
Possible distance modes Maximum distance Benefit / comments
Short Up to 1.3 m Better ambient immunity
Medium Up to 3 m
Long (default) Up to 4 m Maximum distance