Mission
Build this
An OLED terminal browsed with buttons, keypad, joystick, or the IR remote.
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 | OLED | — |
| ● kit | Buttons, joystick, keypad, or IR remote | — |
| ● 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:
ki-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/visitor-centre/kiosk/ki-01/status | enum | on change |
Read another team
garden/greenhouse-1/climate-node/gm-01/temperaturePhysical behaviour
Alive
Point toward the selected zone on a printed map.
Your call: Choose the navigation model and which context accompanies each number.
Engineering evidence
Run a task-based usability test with people who have not seen the device.
- Define three tasks and success criteria.
- Observe at least five first-time users without coaching.
- Revise and repeat the hardest task.
If you are fast: Publish a free aggregate selection-count measurement without identifying users.
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.