Overview
Goal
Train the team to build a real-time 3D room mapper using ESP32 + VL53L5CX (8x8 ToF) + IMU, producing a point cloud / occupancy-like map that can be viewed on a laptop.
This is a tutorial track (multiple small projects), not one big risky project.
References
- XDA — Microcontroller projects used to require a full SBC running Linux
- XDA — $30 ESP32 room mapper
- Hackaday — Real-Time 3D Room Mapping With ESP32, VL53L5CX Sensor, And IMU
Recommended hardware for the tutorial
Minimum:
- ESP32-S3 dev board (team standard)
- VL53L5CX ToF breakout (I2C)
- MPU6050 6-axis IMU breakout (I2C) (team standard)
Nice-to-have:
- Small pan/tilt mount (or manual sweeping)
- LiPo + 5V boost (portable)
Track structure (deliverables per tutorial)
- T0 — ESP-IDF baseline + I2C scanner
- T1 — VL53L5CX bring-up + stream range frames
- T2 — IMU bring-up + orientation estimate (basic fusion)
- T3 — Mapper: fuse ToF rays + pose into 2.5D/3D points
- T4 — Viewer: Python/Web viewer to plot live point cloud
- T5 — Performance + robustness: timestamps, buffering, calibration
Each tutorial has:
- a small repo folder layout
- acceptance criteria
- evidence pack (screenshots/logs)
Golden rules (team)
- ESP-IDF first.
- Deterministic logs (timestamps + tags).
- Don’t skip calibration.
- Keep a
docs/folder in each tutorial repo.