Skip to main content

Tutorial T0 — ESP-IDF Baseline + I2C Scanner

Purpose​

Get everyone to the same baseline: ESP-IDF build/flash/monitor and an I2C scan tool.

Deliverables​

  • Repo: tutorial-esp32-room-mapper-t0/
  • idf.py build + idf.py flash monitor works
  • I2C scan prints detected addresses

Steps​

  1. Create ESP-IDF project (idf.py create-project or template).
  2. Add modules:
    • bsp_time.c (ms timestamp)
    • log.c (TAG-based logs)
    • i2c_bus.c (init)
    • i2c_scan.c (scan 0x08..0x77)
  3. Configure pins for your board (SDA/SCL) and I2C frequency.

Acceptance criteria​

  • Boot log shows firmware version + build time.
  • I2C scan runs every 5s and prints same set of addresses.

Evidence pack​

  • Screenshot of idf.py build success.
  • Screenshot of serial monitor showing I2C scan results.