apds9960: Auto-enable sensor when reading without active mode.

[nedseb]

Closes #72

Summary

Reading light or proximity data now automatically enables the sensor if it was disabled, instead of returning stale/zero values.

• _ensure_light_enabled() — checks AEN and PON bits in ENABLE register; if not set, calls enableLightSensor() and polls AVALID (up to 500ms)
• _ensure_proximity_enabled() — checks PEN and PON bits; if not set, calls enableProximitySensor() and waits 50ms
• Called in readAmbientLight(), readRedLight(), readGreenLight(), readBlueLight(), readProximity()
• No overhead when sensor is already active (no register writes)

Follows the auto-trigger convention from #44.

Test plan

Mock tests (no hardware)

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

tests/test_scenarios.py::test_scenario[apds9960/Verify device ID register (mock)/mock] PASSED
tests/test_scenarios.py::test_scenario[apds9960/Read ambient light returns expected value/mock] PASSED
tests/test_scenarios.py::test_scenario[apds9960/Read proximity returns expected value/mock] PASSED
tests/test_scenarios.py::test_scenario[apds9960/Read red light returns expected value/mock] PASSED
tests/test_scenarios.py::test_scenario[apds9960/Ambient light readable without explicit enable/mock] PASSED
tests/test_scenarios.py::test_scenario[apds9960/Proximity readable without explicit enable/mock] PASSED
tests/test_scenarios.py::test_scenario[apds9960/Red light readable after power off/mock] PASSED
tests/test_scenarios.py::test_scenario[apds9960/No re-enable when already active/mock] PASSED

8 passed

Hardware tests (STeaMi board connected)

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

tests/test_scenarios.py::test_scenario[apds9960/Verify device ID register (hardware)/hardware] PASSED
tests/test_scenarios.py::test_scenario[apds9960/Ambient light in plausible range/hardware] PASSED
tests/test_scenarios.py::test_scenario[apds9960/Proximity in plausible range/hardware] PASSED

3 passed, 2 skipped

[Copilot]

Pull request overview

Adds “auto-enable on read” behavior to the APDS9960 driver so light/proximity read methods work even if the corresponding sensor (or power) hasn’t been explicitly enabled, and extends the scenario suite to cover the intended behavior.

Changes:

• Add internal helpers to auto-enable the light/proximity engines before reads.
• Call those helpers from readAmbientLight / read{Red,Green,Blue}Light / readProximity.
• Add new YAML scenario cases intended to validate auto-enable behavior in mock mode.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.

File	Description
lib/apds9960/apds9960/device.py	Introduces _ensure_*_enabled() and uses them in read methods to auto-enable sensors.
tests/scenarios/apds9960.yaml	Adds new scenario tests for “read without explicit enable” and “no re-enable when already active”.

---

💡 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 📦🚀