Data Sheet

Ranging API function descriptions UM2356
12/28 DocID031478 Rev 1
2.5.5 Thresholds
The device can be configured to operate in distance and/or signal threshold detection mode.
The ranging data is reported to the host when the pre-configured criteria are matched.
Detection mode
Detection mode allows selection of the filtering conditions:
• 0: no filter (default value, standard ranging mode)
• 1: filter on distance criteria only
Distance detection mode, based on thresholds:
Distance detection mode (through the CrossMode parameter) defines the distance criteria:
• 0: below a certain distance: "threshold low"
– If object distance > distance low or no object found: no report
– If object distance < distance low and object found: report
• 1: beyond a certain distance: "threshold high"
– If object distance < distance high or no object found: no report
– If object distance > distance high and object found: report
• 2: out of a distance range (min/max), "out of window"
– Distance low < detected distance < distance high: no report
– Distance low > detected distance > distance high: report
• 3: Within a distance range (min/max), "inside window"
– Distance low > detected distance > distance high: no report
– Distance low < detected distance < distance high: report
Distance low is the minimum configured distance in millimeters.
Distance high is the maximum configured distance in millimeters.
No target
This is an alternate detection mode. In the standard use case, if no target is detected, no
ranging is reported. Using no target detection mode (setting IntrNoTarget to 1) allows an
interrupt to be generated when no target is present.
API function
VL53L1_SetThresholdConfig() is the function to use.
The VL53L1_DetectionConfig_t structure contains all parameters to be set.