github-featured/78--xiaozhi-esp32
2
0
Fork 0
Code Issues Pull Requests Deployments Models Agent Notes Packages Projects Releases Wiki Activity
Files
5e049bbc345c55a71573f5534312ccb6f2044cd8
78--xiaozhi-esp32/docs/esp-idf-6-migration.md
T
Xiaoxia 5e049bbc34 Decouple P4 function board from BSP
2026-07-28 05:43:43 +08:00

37 KiB
Raw Blame History

ESP-IDF 6.0 Migration and Board Compatibility Status

Last updated: 2026-07-24 Validated SDK: ESP-IDF v6.0.1 Scope: 138 board directories and 171 supported build variants defined by main/boards/**/config.json.

Current Status

The current release matrix contains 171 variants: 170 select on IDF 6.0.x, while the ESP32-S31 variant requires IDF 6.1 or later. The previous 157-variant baseline passed the latest complete GitHub Actions matrix on ESP-IDF 6.0.1. ESP-SR 2.4.7 adds IDF 6 support for ESP32-P4 Rev < 3, so the 14 unsuffixed Rev1 variants now join their existing -p4x Rev3 counterparts in the IDF 6 matrix. Component versions that use ranges are resolved from the Component Registry at build time; until per-target lock snapshots are committed, this is a source-reproducible build rather than a bit-for-bit dependency-reproducible build.

Status Variants Meaning
✅ Previously matrix-validated 157 All 157 baseline builds completed in GitHub Actions with ESP-IDF 6.0.1; this does not imply hardware or complete peripheral validation
🟡 Net variants added since full-matrix validation 14 Includes the 14 newly enabled P4 Rev1 variants and the IDF 6.1-only ESP32-S31 variant, after retired low-use variants were removed; a complete current-matrix CI run remains pending
🟡 Feature-degraded subset 1 esp-vocat builds on IDF 6, but its PCB capacitive slider/button support is disabled pending compatible touch-sensor components
🔴 Build-blocked 0 No supported release variant remains blocked at compile or link time

There are no known remaining IDF 6 build blockers. 78/esp_lcd_nv3023 1.0.1 and wvirgil123/sscma_client 1.0.3 are consumed directly from the Component Registry, so local copies under the ignored components/ directory are not required. ESP32-P4 Rev1 and Rev3 now share the IDF 6 build path while retaining separate artifact names and silicon-selection settings.

Representative local full-build results are shown below. Firmware size and free space are reported by ESP-IDF 6.0.1 check_sizes.py. The authoritative per-variant compatibility result is the full GitHub Actions matrix in the next section.

Chip Build variant Application size Free space in smallest app partition
ESP32 bread-compact-esp32 0x240560 23%
ESP32-C3 espressif-esp-hi 0x20ef10 30%
ESP32-C3 xmini-c3 0x2370f0 44%
ESP32-C5 waveshare-esp32-c5-touch-lcd-1.69 0x27cd30 37%
ESP32-C6 waveshare-esp32-c6-lcd-0.85 0x280ee0 15%
ESP32-S3 doit-s3-aibox 0x21edf0 46%
ESP32-S3 lilygo-t-display-s3-pro-mvsrlora 0x2adce0 32%
ESP32-S3 lilygo-t-circle-s3 0x2a32f0 33%
ESP32-S3 zhengchen-1.54tft-wifi 0x2abdc0 32%
ESP32-S3 kevin-yuying-313lcd 0x2c4990 30%
ESP32-S3 otto-robot 0x37ff70 11%
ESP32-S3 espressif-esp-vocat 0x2742f0 38%
ESP32-S3 sensecap-watcher 0x2faff0 25%
ESP32-P4 Rev1 espressif-esp32-p4-function-ev-board 0x345a90 17%
ESP32-P4 Rev3 espressif-esp32-p4x-function-ev-board 0x34a150 16%
ESP32-P4 v3.x m5stack-tab5-p4x 0x380790 11%

The old negative result for esp32-p4-function-ev-board came from ESP-SR 2.4.6. ESP-SR 2.4.7 supplies the missing ESP32-P4 Rev < 3 libraries for IDF 6, so the project no longer version-gates the P4 variants.

For backward-compatibility regression coverage, xmini-c3 also completed a full build with ESP-IDF 5.5.4 (application size 0x234920, 44% free in the smallest app partition). The legacy esp32-p4-function-ev-board release variant subsequently completed the same 5.5.4 release flow (application size 0x38a130, 10% free), including merged-binary packaging. This confirms that the compatibility changes for I2S port numbering, LCD I2C configuration, the UHCI DMA dependency, and the pre-v3 P4 selection did not break the existing 5.5 build chain.

Full-Matrix CI Validation

GitHub Actions run 29534954031 built the then-current matrix with the espressif/idf:v6.0.1 container. The matrix-generation job and all 157 board builds passed. This historical run predates the current 170-variant IDF 6.0.x matrix.

Results by chip target:

Chip target Variants Passed Blocked
ESP32 7 7 0
ESP32-C3 9 9 0
ESP32-C5 4 4 0
ESP32-C6 9 9 0
ESP32-S3 114 114 0
ESP32-P4 v3.x 14 14 0
Total 157 157 0

esp-vocat remains feature-degraded because IDF 6 builds omit the PCB capacitive slider/button path; its CST816 display touch remains enabled.

ESP32-P4 Silicon Scope and Naming

The IDF 6 release matrix supports both ESP32-P4 Rev < 3 and Rev >= 3 silicon. The two silicon families keep distinct artifact names and sdkconfig settings:

SDK ESP32-P4 Rev < 3 ESP32-P4 Rev >= 3
ESP-IDF < 6 Original esp32-p4- name; adds CONFIG_ESP32P4_SELECTS_REV_LESS_V3=y and CONFIG_ESP32P4_REV_MIN_100=y Uses esp32-p4x- when the variant starts with the chip name; otherwise retains the established -p4x suffix
ESP-IDF >= 6 Original esp32-p4- name; adds CONFIG_ESP32P4_SELECTS_REV_LESS_V3=y and CONFIG_ESP32P4_REV_MIN_100=y Uses esp32-p4x- when the variant starts with the chip name; otherwise retains the established -p4x suffix

ESP-IDF 5.5 and 6.0.x each select 170 variants: 14 P4X artifacts, 14 Rev < 3 P4 artifacts with their original names, and 142 non-P4 variants. ESP-IDF 6.1 or later additionally selects the ESP32-S31 build, for 171 variants in total.

Espressif's current chip-identification table lists v0.0, v1.0, v1.3, v3.0, v3.1, and v3.2, with no v4.0 revision. The public errata history added v3.0/v3.1 information on 2026-02-12 and v3.2 information on 2026-04-20. ESP-IDF 6.0 release notes explicitly describe support for "ESP32-P4 Version3 silicon." See the official chip revision identification, errata revision history, and ESP-IDF releases.

Component Compatibility

Component/module Version or approach for IDF 6 Status Notes
78/uart-uhci 0.3.2 ✅ Upstream support The registry release compiles under IDF 6.0.1 in GitHub Actions
78/uart-eth-modem 0.6.0 ✅ Upstream support Pinned because it has the required RF-test event API while supporting both ESP-IDF 5.5.2+ and 6.0.1; version 0.6.1 requires IDF 6.0.1+
espressif/mqtt 1.0.0 ✅ Upstream support MQTT moved from a built-in SDK component to a Component Manager dependency in IDF 6
78/esp-ml307 3.6.6 + project-level espressif/mqtt ✅ Builds in CI The upstream source compiles under IDF 6.0.1 when the project supplies the MQTT component moved out of IDF
espressif/esp_hosted / esp_wifi_remote 2.12.11 / 1.6.2 ✅ Upstream support Used for ESP32-P4 Hosted Wi-Fi
espressif/esp_video ^2.3.0 ✅ Upstream support Requires the current 2.3 API baseline and accepts future compatible 2.x releases on S3 and P4
P4 LCD drivers EK79007/ST7701 2.0.x ✅ Upstream support ESP32-P4-Function-EV-Board initializes its hardware directly so its former BSP cannot constrain esp_video; the LCD drivers resolve IDF 6 DPI, color-field, and split-driver-component issues
espressif/esp_lcd_st77916 2.0.2 ✅ Upstream support Major version 2 uses the IDF 6 panel I/O definitions
espressif/esp_lcd_spd2010 ^2.0.0 (resolved 2.0.0~1) ✅ Upstream support Major version 2 declares ESP-IDF 6 compatibility
espressif/esp_lcd_co5300 2.1.0 ✅ Upstream support Used with explicit IDF 6-compatible QSPI I/O configuration in board code
esp_emote_expression 1.0.2 ✅ Upstream support Replaces the previous dependency on the built-in json component
wvirgil123/sscma_client 1.0.3 ✅ Upstream support Uses espressif/cjson and the split driver components on IDF 6 while retaining the legacy component names on older IDF releases
espressif/servo / espfriends/servo_dog_ctrl 1.0.0 / 0.2.0 ✅ Upstream support Uses official registry releases; compilation and linking were validated in the full IDF 6.0.1 build of esp-hi, with no local override required
78/esp_lcd_nv3023 1.0.1 ✅ Upstream-based registry release Mirrors MakerM0 upstream commit 15dae953; adds IDF 6 color-order and GPIO compatibility while retaining older IDF branches; validated through the registry in a clean magiclick-c3 full build
llgok/cpp_bus_driver Excluded from the IDF 6 baseline ⚪ Waiting for upstream Version 2.1.0 still requires local patches for IDF 6. It is used only by the LILYGO T-Display-P4 source, and that board has no release config.json, so the component has been removed until upstream support is available
MQTT protocol AES-CTR PSA Crypto ✅ Ported Replaces the legacy AES context API removed by IDF 6 / Mbed TLS 4
BluFi security negotiation (conditional path) PSA FFDH + SHA-256 + AES-CTR ✅ Ported Uses the ESP-IDF 6 security scheme with ffdhe3072 and passed local full ESP32-S3 builds with BluFi enabled on IDF 5.5.4 and 6.0.1. Legacy 1024-bit BluFi clients are not compatible and must be upgraded
espressif/bmi270_sensor 0.1.2 ✅ Upstream support Provides IDF 6.0 prebuilt libraries for ESP32-C5 and ESP32-S3; validated by a full esp-spot-c5 build
touch_slider_sensor / touch_button_sensor Disabled for IDF 6 🟡 Feature gap Their manifests require IDF < 6.0, so ESP Vocat omits its PCB capacitive slider/button path on IDF 6. CST816 display touch is unaffected
ESP32-P4 Rev < 3 / espressif/esp-sr ~2.4.7 ✅ Upstream support The 14 Rev1 variants are available on IDF 5.5 and IDF 6; P4X-specific names continue to select Rev >= 3

Per-Board Progress

In the table below, "Board" is the source directory and "Build variant" is the firmware name used by the build script. Different chip revisions of the same board may have different status, so they are split into separate rows when necessary.

Chip Board Build variant IDF 6.0 status Current validation Blocker/next step
esp32 atommatrix-echo-base atommatrix-echo-base ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32 bread-compact-esp32 bread-compact-esp32 ✅ Full build passed IDF 6.0.1 idf.py build Hardware smoke/peripheral regression pending
esp32 bread-compact-esp32 bread-compact-esp32-128x32 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32 bread-compact-esp32-lcd bread-compact-esp32-lcd ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32 wdmomo/esp32-cgc wdmomo-esp32-cgc ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32 wdmomo/esp32-cgc-144 wdmomo-esp32-cgc-144 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32 waveshare/esp32-touch-lcd-3.5 waveshare-esp32-touch-lcd-3.5 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c3 espressif/esp-hi espressif-esp-hi ✅ Full build passed IDF 6.0.1 idf.py build; servo_dog_ctrl 0.2.0 Hardware smoke, servo, and audio peripheral regression pending
esp32c3 kevin/c3 kevin-c3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c3 lckfb/szpi-esp32c3 lckfb-lichuang-c3-dev ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c3 magiclick-c3 magiclick-c3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c3 magiclick-c3-v2 magiclick-c3-v2 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c3 surfer-c3-1.14tft surfer-c3-1.14tft ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c3 xmini-c3 xmini-c3 ✅ Full build passed IDF 6.0.1 idf.py build Hardware smoke/peripheral regression pending
esp32c3 xmini-c3-4g xmini-c3-4g ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c3 xmini-c3-v3 xmini-c3-v3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c5 espressif/esp-sensairshuttle espressif-esp-sensairshuttle ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c5 espressif/esp-spot espressif-esp-spot-c5 ✅ Full build passed IDF 6.0.1 idf.py build; bmi270_sensor 0.1.2 Hardware smoke, BMI270, audio, and power-management regression pending
esp32c5 movecall-moji2-esp32c5 movecall-moji2-esp32c5 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c5 waveshare/esp32-c5-touch-lcd-1.69 waveshare-esp32-c5-touch-lcd-1.69 ✅ Full build passed IDF 6.0.1 idf.py build Hardware smoke/peripheral regression pending
esp32c6 waveshare/esp32-c6-lcd-0.85 waveshare-esp32-c6-lcd-0.85 ✅ Full build passed IDF 6.0.1 idf.py build Hardware smoke/peripheral regression pending
esp32c6 waveshare/esp32-c6-lcd-1.69 waveshare-esp32-c6-lcd-1.69 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c6 waveshare/esp32-c6-touch-amoled-1.32 waveshare-esp32-c6-touch-amoled-1.32 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c6 waveshare/esp32-c6-touch-amoled-1.43 waveshare-esp32-c6-touch-amoled-1.43 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c6 waveshare/esp32-c6-touch-amoled-1.8 waveshare-esp32-c6-touch-amoled-1.8 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c6 waveshare/esp32-c6-touch-amoled-2.06 waveshare-esp32-c6-touch-amoled-2.06 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c6 waveshare/esp32-c6-touch-amoled-2.16 waveshare-esp32-c6-touch-amoled-2.16 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c6 waveshare/esp32-c6-touch-lcd-1.54 waveshare-esp32-c6-touch-lcd-1.54 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32c6 waveshare/esp32-c6-touch-lcd-1.83 waveshare-esp32-c6-touch-lcd-1.83 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 xorigin/aipi-lite xorigin-aipi-lite ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 alientek/atk-dnesp32s3 alientek-atk-dnesp32s3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 alientek/atk-dnesp32s3-box alientek-atk-dnesp32s3-box ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 alientek/atk-dnesp32s3-box0 alientek-atk-dnesp32s3-box0 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 alientek/atk-dnesp32s3-box2-4g alientek-atk-dnesp32s3-box2-4g ✅ Build and hardware validated GitHub Actions IDF 6.0.1 full build; maintainer hardware validation Complete for the IDF 6 migration scope
esp32s3 alientek/atk-dnesp32s3-box2-wifi alientek-atk-dnesp32s3-box2-wifi ✅ Build and hardware validated GitHub Actions IDF 6.0.1 full build; maintainer hardware validation Complete for the IDF 6 migration scope
esp32s3 alientek/atk-dnesp32s3-box3 alientek-atk-dnesp32s3-box3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 atom-echos3r atom-echos3r ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 atoms3-echo-base atoms3-echo-base ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 atoms3r-cam-m12-echo-base atoms3r-cam-m12-echo-base ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 atoms3r-echo-base atoms3r-echo-base ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 atoms3r-echo-pyramid atoms3r-echo-pyramid ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 bread-compact-ml307 bread-compact-ml307
bread-compact-ml307-128x64		 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 bread-compact-nt26 bread-compact-nt26 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 bread-compact-wifi bread-compact-wifi
bread-compact-wifi-128x64		 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 df-k10 df-k10 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 df-s3-ai-cam df-s3-ai-cam ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 doit-s3-aibox doit-s3-aibox ✅ Full build passed IDF 6.0.1 idf.py build Hardware smoke/peripheral regression pending
esp32s3 du-chatx du-chatx ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 electron-bot electron-bot ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 espressif/esp32-s3-box espressif-esp-box ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 espressif/esp32-s3-box-3 espressif-esp-box-3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 espressif/esp32-s3-box-lite espressif-esp-box-lite ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 espressif/esp32-s3-lcd-ev-board espressif-esp-s3-lcd-ev-board-1p4
espressif-esp-s3-lcd-ev-board-1p5		 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 espressif/esp32-s3-lcd-ev-board-2 espressif-esp32-s3-lcd-ev-board-2 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 espressif/esp-sparkbot espressif-esp-sparkbot ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 espressif/esp-vocat espressif-esp-vocat 🟡 Full build passed; feature-degraded Local ESP-IDF 6.0.1 full build after rebasing onto origin/main PCB capacitive slider/button disabled on IDF 6; CST816 display touch remains enabled; hardware regression pending
esp32s3 espressif/esp32-s3-korvo-2-v3.0 espressif-esp32s3-korvo2-v3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 espressif/esp32-s3-korvo-2-v3.0-rndis espressif-esp32s3-korvo2-v3-rndis ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 freenove-esp32s3-display-2.8-lcd freenove-esp32s3-display-2.8-lcd ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 genjutech-s3-1.54tft genjutech-s3-1.54tft ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 hu-087 hu-087 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 jiuchuan-s3 jiuchuan-s3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 kevin/box-2 kevin-box-2 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 kevin/sp-v4-dev kevin-sp-v4-dev ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 kevin/yuying-313lcd kevin-yuying-313lcd ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 labplus/ledong-v2 labplus-ledong-v2 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 labplus/mpython-v3 labplus-mpython-v3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 lceda-course-examples/eda-robot-pro lceda-course-examples-eda-robot-pro ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 lceda-course-examples/eda-super-bear lceda-course-examples-eda-super-bear ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 lceda-course-examples/eda-tv-pro lceda-course-examples-eda-tv-pro ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 lckfb/szpi-esp32s3 lckfb-lichuang-dev ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 lilygo-t-cameraplus-s3 lilygo-t-cameraplus-s3
lilygo-t-cameraplus-s3-v1.2		 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 lilygo-t-circle-s3 lilygo-t-circle-s3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 lilygo-t-display-s3-pro-mvsrlora lilygo-t-display-s3-pro-mvsrlora ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 m5stack-cardputer-adv m5stack-cardputer-adv ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 m5stack-core-s3 m5stack-core-s3 ✅ Build and hardware validated GitHub Actions IDF 6.0.1 full build; maintainer hardware validation Complete for the IDF 6 migration scope
esp32s3 m5stack-stick-s3 m5stack-stick-s3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 m5stack-stopwatch m5stack-stopwatch ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 magiclick-2p4 magiclick-2p4 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 magiclick-2p5 magiclick-2p5 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 minsi-k08-dual minsi-k08-dual ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 mixgo-nova mixgo-nova ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 movecall-cuican-esp32s3 movecall-cuican-esp32s3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 movecall-moji-esp32s3 movecall-moji-esp32s3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 nulllab-ai-vox-v3 nulllab-ai-vox-v3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 otto-robot otto-robot ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 quandong-s3-dev quandong-s3-dev ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 rymcu/bigsmart rymcu-bigsmart ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 sensecap-watcher sensecap-watcher ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 sp-esp32-s3-1.28-box sp-esp32-s3-1.28-box ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 sp-esp32-s3-1.54-muma sp-esp32-s3-1.54-muma ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 taiji-pi-s3 taiji-pi-s3
taiji-pi-s3-pdm		 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-audio-board waveshare-esp32-s3-audio-board ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-cam waveshare-esp32-s3-cam-2
waveshare-esp32-s3-cam-2.8
waveshare-esp32-s3-cam-3.5
waveshare-esp32-s3-cam-1.83		 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-epaper-1.54 waveshare-esp32-s3-epaper-1.54-v2
waveshare-esp32-s3-epaper-1.54-v1		 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-epaper-3.97 waveshare-esp32-s3-epaper-3.97 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-lcd-0.85 waveshare-esp32-s3-lcd-0.85 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-rgb-matrix waveshare-esp32-s3-rgb-matrix ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-rlcd-4.2 waveshare-esp32-s3-rlcd-4.2 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-amoled-1.32 waveshare-esp32-s3-touch-amoled-1.32 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-amoled-1.43c waveshare-esp32-s3-touch-amoled-1.43c ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-amoled-1.75 waveshare-esp32-s3-touch-amoled-1.75
waveshare-esp32-s3-touch-amoled-1.75c		 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-amoled-1.8 waveshare-esp32-s3-touch-amoled-1.8 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-amoled-1.8-v2 waveshare-esp32-s3-touch-amoled-1.8-v2 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-amoled-2.06 waveshare-esp32-s3-touch-amoled-2.06 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-amoled-2.16 waveshare-esp32-s3-touch-amoled-2.16 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-lcd-1.46 waveshare-esp32-s3-touch-lcd-1.46 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-lcd-1.54 waveshare-esp32-s3-touch-lcd-1.54 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-lcd-1.83 waveshare-esp32-s3-touch-lcd-1.83 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-lcd-1.85 waveshare-esp32-s3-touch-lcd-1.85 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-lcd-1.85b waveshare-esp32-s3-touch-lcd-1.85b ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-lcd-1.85c waveshare-esp32-s3-touch-lcd-1.85c ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-lcd-3.49 waveshare-esp32-s3-touch-lcd-3.49 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-lcd-3.5 waveshare-esp32-s3-touch-lcd-3.5 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-lcd-3.5b waveshare-esp32-s3-touch-lcd-3.5b ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-lcd-4.3c waveshare-esp32-s3-touch-lcd-4.3c ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-lcd-4b waveshare-esp32-s3-touch-lcd-4b ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 waveshare/esp32-s3-touch-lcd-7c waveshare-esp32-s3-touch-lcd-7c ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 xingzhi-abs-2.0 xingzhi-abs-2.0 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 xingzhi-cube-0.85tft-ml307 xingzhi-cube-0.85tft-ml307 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 xingzhi-cube-0.85tft-wifi xingzhi-cube-0.85tft-wifi ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 xingzhi-cube-0.96oled-ml307 xingzhi-cube-0.96oled-ml307 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 xingzhi-cube-0.96oled-wifi xingzhi-cube-0.96oled-wifi ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 xingzhi-cube-1.54tft-ml307 xingzhi-cube-1.54tft-ml307
xingzhi-cube-1.54tft-ml307-wechatui		 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 xingzhi-cube-1.54tft-wifi xingzhi-cube-1.54tft-wifi ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 xingzhi-metal-1.54-wifi xingzhi-metal-1.54-wifi ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 yunliao-s3 yunliao-s3 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 zhengchen-1.54tft-ml307 zhengchen-1.54tft-ml307 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 zhengchen-1.54tft-wifi zhengchen-1.54tft-wifi ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 zhengchen-cam zhengchen-cam ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32s3 zhengchen-cam-ml307 zhengchen-cam-ml307 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32p4 espressif/esp32-p4-function-ev-board espressif-esp32-p4-function-ev-board
espressif-esp32-p4x-function-ev-board		 ✅ Full builds passed IDF 6.0.1 canonical release builds with ESP-SR 2.4.7 for Rev1 and Rev3 Hardware smoke/peripheral regression pending
esp32p4 m5stack-tab5 m5stack-tab5-p4x ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32p4 waveshare/esp32-p4-nano waveshare-esp32-p4x-nano-10.1-a ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32p4 waveshare/esp32-p4-wifi6-touch-lcd waveshare-esp32-p4x-wifi6-touch-lcd-4b
waveshare-esp32-p4x-wifi6-touch-lcd-4.3
waveshare-esp32-p4x-wifi6-touch-lcd-5
waveshare-esp32-p4x-wifi6-touch-lcd-7b
waveshare-esp32-p4x-wifi6-touch-lcd-3.4c
waveshare-esp32-p4x-wifi6-touch-lcd-4c
waveshare-esp32-p4x-wifi6-touch-lcd-7
waveshare-esp32-p4x-wifi6-touch-lcd-8
waveshare-esp32-p4x-wifi6-touch-lcd-10.1		 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending
esp32p4 waveshare/esp32-p4-wifi6-touch-lcd-3.5 waveshare-esp32-p4x-wifi6-touch-lcd-3.5 ✅ Full build passed GitHub Actions IDF 6.0.1 full build Hardware smoke/peripheral regression pending

Next Steps and Acceptance Criteria

  1. Run the IDF 6 BluFi CI job, then hardware-test at least one P4 v1.3 device on the legacy SDK path. When IDF 6-compatible releases of touch_slider_sensor and touch_button_sensor become available, re-enable and hardware-test the ESP Vocat PCB capacitive slider/button path.
  2. For every green variant, complete a minimal hardware smoke test covering boot, networking, audio input/output, display/touch when present, camera when present, and 4G/Ethernet when present.
  3. Perform a physical negative test for the xmini-c3/xmini-c3-v3 firmware guard. CI proves that both images compile; it does not prove that a wrong image is safely rejected. Acceptance requires flashing each wrong image to a sacrificial or recoverable board and verifying that startup stops before any board-specific power or peripheral initialization can cause damage.
  4. Keep third-party experiments under the ignored components/ directory out of the migration branch. The reproducible baseline must use the published 78/esp_lcd_nv3023 1.0.1 and wvirgil123/sscma_client 1.0.3 packages. espfriends/servo_dog_ctrl 0.2.0 is an upstream registry dependency and needs no local override.

Reproduction

source ~/.espressif/v6.0.1/esp-idf/export.sh
python scripts/build.py <board> --name <variant>

This document is a migration-status snapshot. Build compatibility and hardware compatibility are tracked separately. Add "hardware validated" to a board only after validation on physical hardware is complete.

Reference in New Issue View Git Blame Copy Permalink