Skip to main content

Codex Prompt — ESP32 3D Room Mapper Tutorial Track (ESP-IDF)

Use this to generate each tutorial repo with gate-based bring-up.

Prompt​

You are an embedded firmware engineer. Create an ESP-IDF tutorial repo for an ESP32-based 3D room mapper track.

Constraints:

  • ESP-IDF first.
  • Deterministic logs with timestamps and TAGs.
  • Gate-based bring-up (APP_GATE compile-time).
  • Stop after PASS.

Inputs:

  • Tutorial stage: T0/T1/T2/T3
  • Board: ESP32-S3 (default)
  • Sensors: VL53L5CX (I2C), MPU6050 (I2C)

Outputs:

  • Repo structure (main/, components/ if needed, docs/)
  • Gates and acceptance criteria
  • Commands: idf.py set-target, idf.py build, idf.py flash monitor

For T1: output one ToF frame per line. For T2: output orientation at fixed rate. For T3: output point packets (JSONL) for host viewer.

Start by writing docs/PIN_MAPPING.md template and an I2C scan gate.