Adafruit Vl53l1x

Multi-Sensor Workflow

1. Hold all but one sensor in shutdown with XSHUT.
2. Bring sensors up one at a time.
3. Initialize each sensor at default address 0x29.
4. Change the active sensor to a unique address.
5. Repeat until all sensors are assigned.
6. Start ranging only after the bus map is stable.

Read the reference file for the pin-level facts that justify this sequence.

Detection Workflow

1. Start from measured distance in mm or cm.
2. Choose a trigger threshold based on the actual product path and mounting angle.
3. Mark object present when the reading crosses the threshold.
4. Use hysteresis so noisy readings near the threshold do not retrigger.
5. Timestamp the crossing event, not every sample.
6. Keep timing budget and sampling cadence consistent across sensors before calculating speed from multiple trigger points.

Arduino Guidance

• Start from the vendor example pattern in the reference, but confirm the actual Arduino library availability in the target toolchain before committing to a library-specific implementation.
• On Arduino Uno Q projects, verify the actual working I2C bus before assuming Wire; this workspace confirmed a live VL53L1X path on Wire1.
• Keep Wire initialization explicit.
• Check sensor status on begin(), startRanging(), and distance reads.
• Clear interrupts after consuming a reading when using the library's data-ready flow.

Python And CircuitPython Guidance

• Use the Adafruit CircuitPython VL53L1X library for Linux/Python or CircuitPython targets.
• Set distance_mode and timing_budget intentionally instead of relying on defaults when timing matters.
• Use data_ready checks in read loops and clear the interrupt after consuming data.

Reference File

Load references/adafruit-vl53l1x-reference.md for:

• board capabilities and operating limits
• pin meanings and voltage notes
• default I2C address and XSHUT behavior
• Arduino example API calls
• Uno Q-specific bring-up caveats such as bus selection and Qwiic power-vs-bus visibility
• Python/CircuitPython example behavior
• source links back to Adafruit