Mission
Build this
A shaded PIR passage detector with optional modulated IR comparison indoors.
Borrowed parts are labelled below and have a fallback. The assigned device ID is fixed; sensing and behaviour decisions remain yours.
Bill of materials
Parts
| Source | Part | Fallback |
|---|---|---|
| ● kit | PIR sensor | — |
| ● kit | IR emitter and receiver | — |
| ● kit | SG90 servo | — |
Disconnect USB before rewiring. Motors, the relay, and the servo need appropriate power and a shared ground. Never drive an actuator from the ESP32 3V3 pin.
Assembly
Build in evidence-producing steps
- Prove the connection first. Flash the unmodified first-message example with this charter’s zone, device type, and device ID.
done when:
pt-01is alive on the developer view. - Bench-test one input. Read the sensor or control in Serial Monitor before publishing or moving an actuator.
done when: repeated physical conditions produce repeatable raw readings.
- Publish one registered measurement. Use the exact measurement and unit below.
done when: the reading appears without a reject.
- Add the physical response. Keep
spine.loop()running and avoid blocking delays.done when: repeated movement does not interrupt publishing or reset the board.
- Run the investigation. Collect the planned trials before tuning the final logic.
done when: the build log contains observations, method, and a limitation.
Contract
Your topics
| Topic | Unit | Suggested interval |
|---|---|---|
garden/outdoor-1/path-node/pt-01/count | events | on change |
garden/outdoor-1/path-node/pt-01/motion | enum | on change |
Read another team
garden/entrance/counter/gk-01/countPhysical behaviour
Alive
Make a short startled gesture for each debounced passage.
Your call: Choose the sensor placement and refractory period.
Engineering evidence
Compare detection rates in sun, shade, near motion, and distant motion.
- Mark a repeatable walking path.
- Run at least 20 trials in each condition.
- Report detection rate and double-count rate.
If you are fast: Compare path events with the entrance counter without claiming individual tracking.
Acceptance
Ready when all six are true
- The registered device is alive and publishing its required topics.
- The reject feed is clear after the final firmware starts.
- The device reads at least one declared cross-team topic.
- A physical output responds to real data without blocking MQTT.
- The build log contains method, evidence, uncertainty, and a known limitation.
- The enclosure exposes no unsafe wiring and the device ID can be scanned.