Mission
Build this
An ultrasonic occupancy detector that measures aggregate dwell time without identifying visitors.
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 | Ultrasonic sensor | — |
| ● kit | SG90 servo | — |
| ● kit | RGB LED | — |
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:
bw-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/bench-node/bw-01/occupancy | enum | on change |
garden/outdoor-1/bench-node/bw-01/duration | seconds | on vacancy |
Read another team
garden/entrance/counter/gk-01/countPhysical behaviour
Alive
Stretch when an occupied interval ends; remain still during occupancy.
Your call: Choose thresholds and an `uncertain` state.
Engineering evidence
Evaluate people, bags, wind-driven plants, and empty-bench readings.
- Collect baseline distance variation while empty.
- Run labelled occupied and obstruction trials.
- Select thresholds from the data and report misclassification.
If you are fast: Compare occupancy patterns with aggregate entrance activity.
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.