Table 1. Range Status
Value RangeStatus String Comment
0 VL53LX_RANGESTATUS_RANGE_VALID Ranging measurement is valid
1 VL53LX_RANGESTATUS_SIGMA_FAIL
Raised if sigma estimator check is above the internal
defined threshold. Sigma estimator gives a
qualitative information about the signal.
2 VL53LX_RANGESTATUS_SIGNAL_FAIL Raised when signal is too low to detect a target.
4 VL53LX_RANGESTATUS_OUTOFBOUNDS_FAIL Raised when range result is out of bounds
5 VL53LX_RANGESTATUS_HARDWARE_FAIL Raised in case of HW or VCSEL failure
6
VL53LX_RANGESTATUS_RANGE_VALID_NO_WR
AP_CHECK_FAIL
No wraparound check has been done (this is the
very first range)
7 VL53LX_RANGESTATUS_WRAP_TARGET_FAIL Wraparound occurred
8 VL53LX_RANGESTATUS_PROCESSING_FAIL Internal processing error
10 VL53LX_RANGESTATUS_SYNCRONISATION_INT
Raised one time after init, ranging value has to be
ignored
11
VL53LX_RANGESTATUS_RANGE_VALID_MERGE
D_PULSE
Ranging is OK, but distance reported is the result of
multiple targets merged together.
12
VL53LX_RANGESTATUS_TARGET_PRESENT_LA
CK_OF_SIGNAL
Indicate that there is a target, but signal is too low to
report ranging
14 VL53LX_RANGESTATUS_RANGE_INVALID Ranging data is negative and has to be ignored
255 VL53LX_RANGESTATUS_NONE
Target not detected, without no warning or errors
raised
Note: The very first measurement does not include a wraparound check. This ranging measurement can be discarded.
Note: Range status 1 is often caused by noisy measurements. Sigma estimator is strongly impacted by the SNR of the
treated signals.
Note: Range status 4 is raised when some error on the measurement reference occurs. This can cause outliers as
negative measurements or extremely high ranging values.
UM2778
Ranging data structures
UM2778 - Rev 1
page 11/25
To Next Page
Loading...
