vl53l1x: Check data ready and clear interrupt in read().

[nedseb]

Closes #71

Summary

The read() method now checks for data ready before reading and clears the interrupt after, ensuring fresh measurements instead of stale data.

• start_ranging() / stop_ranging() — control ranging via SYSTEM__MODE_START (0x0087)
• _is_data_ready() — checks GPIO__TIO_HV_STATUS (0x0031) bit 0 vs interrupt polarity
• _clear_interrupt() — writes 0x01 to SYSTEM__INTERRUPT_CLEAR (0x0086)
• _ensure_data() — starts ranging and polls data ready if no data available (up to 1s)
• read() calls _ensure_data() before reading and _clear_interrupt() after

Follows the auto-trigger convention from #44.

Test plan

Mock tests (no hardware)

python3 -m pytest tests/ -k "vl53l1x and mock" -v

tests/test_scenarios.py::test_scenario[vl53l1x/Verify model ID register/mock] PASSED
tests/test_scenarios.py::test_scenario[vl53l1x/Read distance returns expected value/mock] PASSED
tests/test_scenarios.py::test_scenario[vl53l1x/Data ready check works/mock] PASSED
tests/test_scenarios.py::test_scenario[vl53l1x/Read clears interrupt/mock] PASSED
tests/test_scenarios.py::test_scenario[vl53l1x/Distance after stop and restart/mock] PASSED

5 passed

Hardware tests (STeaMi board connected)

python3 -m pytest tests/ --port /dev/ttyACM0 -k "vl53l1x and hardware" -s -v

tests/test_scenarios.py::test_scenario[vl53l1x/Verify model ID register/hardware] PASSED
tests/test_scenarios.py::test_scenario[vl53l1x/Distance in plausible range/hardware] PASSED

2 passed, 2 skipped

[Copilot]

Pull request overview

This PR adds data-ready checking and interrupt clearing to the VL53L1X time-of-flight sensor's read() method, ensuring fresh measurements instead of stale data. It follows the auto-trigger convention established in issue #44.

Changes:

• Added start_ranging(), stop_ranging(), _is_data_ready(), _clear_interrupt(), and _ensure_data() methods to the VL53L1X driver
• Modified read() to call _ensure_data() before reading and _clear_interrupt() after, while removing commented-out dead code
• Added mock test scenarios for data-ready checking, interrupt clearing, and stop/restart behavior

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
lib/vl53l1x/vl53l1x/device.py	Added ranging control, data-ready polling, interrupt clearing, and integrated them into read()
tests/scenarios/vl53l1x.yaml	Added mock registers for new functionality and three new test scenarios

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[semantic-release-updater]

🎉 This PR is included in version 0.0.2 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀