Data Sheet

DocID031478 Rev 1 11/28
UM2356 Ranging API function descriptions
28
Table 2 gives the default limit states and values.
If the user disables the limit checks, the ranging values will no longer be filtered and an
incorrect measurement could be returned by the sensor. In this case, RangeStatus 1 and 2
will never be reported.
Changing limit default settings should be done with care, as the side effects can be
important.
The limit change effects on the standard deviation and maximum ranging distances are
shown in
Table 3.
VL53L1X_SetLimitCheckEnable() and VL53L1X_GetLimitCheckEnable() are
used to enable/disable a limit.
The limit value is set using VL53L1X_SetLimitCheckValue() and
VL53L1X_GetLimitCheckValue().
One example of the signal limit setting is to enable a signal check and set the limit to 0.4 MCps:
Status = VL53L1X_SetLimitCheckEnable(&VL53L1Dev,
VL53L1X_CHECKENABLE_SIGNAL_RATE_FINAL_RANGE, 1);
Status = VL53L1X_SetLimitCheckValue(&VL53L1Dev,
VL53L1X_CHECKENABLE_SIGNAL_RATE_FINAL_RANGE, 0.40*65536);
Table 2. Default limit states and values
Limit ID Default limit state Default limit value Associated RangeStatus
Sigma Enabled 15 mm 1
Signal Enabled 1 Mcps 2
Table 3. Signal and sigma limit change effects
Limit ID Action
Effect on
standard deviation
Effect on maximum
ranging distance
Sigma
Increase limit - +
Decrease limit + -
Signal
Increase limit + -
Decrease limit - +