Skip to content

esp32_firmware

ESP-IDF based ESP32-S3 firmware template.

Requirements

  • ESP-IDF v5.3 or v5.4
  • Target: esp32s3
  • Host-side Python workflow uses uv

Python Policy

  • Use uv for host-side Python work such as python_prep/
  • Keep ESP-IDF toolchain and Python dependencies isolated in .vendor/ inside the repository
  • Because the dependency check before idf.py was unstable in this environment, the current workflow calls CMake directly from idf-local.sh

Minimal Steps

./esp32_firmware/idf-local.sh configure
./esp32_firmware/idf-local.sh build

Current Status

  • app_main() starts and prints periodic logs
  • camera includes OV2640 pin definitions for the XIAO ESP32-S3 Sense
  • wifi, http_dashboard, servo_ctrl, button, and led are stubs
  • esp32-camera is added as a managed component