Supported Boards

XiaoZhi AI Chatbot Documentation Center | XiaoZhi.Dev

Supported Boards

This page is generated from the upstream v2.5.2 release manifest, release-manifest.json, and lists every prebuilt firmware of that release. The manifest records 154 board directories and 188 firmware variants, built with ESP-IDF 6.1.0 (source commit 49b4380b).

How to Read the Tables

Board directory: a directory under main/boards/ in the upstream repository. Follow the link for wiring, buttons, and notes.
Firmware variant: one board can have several variants (for example different displays or network options). Release packages are named v2.5.2_<variant>.zip; see Firmware download for downloading and flashing.
If your board is not listed, or you want to port new hardware, see the Custom board guide.

Totals by Chip

Chip	Board directories	Firmware variants
ESP32-S3	114	126
ESP32-P4	6	27
ESP32-C3	10	10
ESP32-C6	10	10
ESP32	6	7
ESP32-C5	4	4
ESP32-S31	4	4

ESP32-S3 (114 directories, 126 variants)

Board directory	Firmware variants
`alientek/atk-dnesp32s3`	`alientek-atk-dnesp32s3`
`alientek/atk-dnesp32s3-box`	`alientek-atk-dnesp32s3-box`
`alientek/atk-dnesp32s3-box0`	`alientek-atk-dnesp32s3-box0`
`alientek/atk-dnesp32s3-box2-4g`	`alientek-atk-dnesp32s3-box2-4g`
`alientek/atk-dnesp32s3-box2-wifi`	`alientek-atk-dnesp32s3-box2-wifi`
`alientek/atk-dnesp32s3-box3`	`alientek-atk-dnesp32s3-box3`
`bread-compact-ml307`	`bread-compact-ml307`, `bread-compact-ml307-128x64`
`bread-compact-nt26`	`bread-compact-nt26`
`bread-compact-wifi`	`bread-compact-wifi`, `bread-compact-wifi-128x64`
`bread-compact-wifi-lcd`	`bread-compact-wifi-lcd`
`bread-compact-wifi-s3cam`	`bread-compact-wifi-s3cam`
`chd/chd-esp32s3-box`	`chd-esp32s3-box`, `chd-esp32s3-box-lcd35`
`chd/chd-esp32s3-eye`	`chd-esp32s3-eye`
`dfrobot/df-k10`	`dfrobot-df-k10`
`dfrobot/df-s3-ai-cam`	`dfrobot-df-s3-ai-cam`
`doit-s3-aibox`	`doit-s3-aibox`
`du-chatx`	`du-chatx`
`electron-bot`	`electron-bot`
`espressif/esp-sparkbot`	`espressif-esp-sparkbot`
`espressif/esp-vocat`	`espressif-esp-vocat`
`espressif/esp32-s3-box`	`espressif-esp-box`
`espressif/esp32-s3-box-3`	`espressif-esp-box-3`
`espressif/esp32-s3-box-lite`	`espressif-esp-box-lite`
`espressif/esp32-s3-korvo-2-v3.0`	`espressif-esp32s3-korvo2-v3`
`espressif/esp32-s3-korvo-2-v3.0-rndis`	`espressif-esp32s3-korvo2-v3-rndis`
`espressif/esp32-s3-lcd-ev-board`	`espressif-esp-s3-lcd-ev-board-1p4`, `espressif-esp-s3-lcd-ev-board-1p5`
`espressif/esp32-s3-lcd-ev-board-2`	`espressif-esp-s3-lcd-ev-board-2`
`freenove-esp32s3-display-2.8-lcd`	`freenove-esp32s3-display-2.8-lcd`
`genjutech-s3-1.54tft`	`genjutech-s3-1.54tft`
`guition/jc4827w543`	`guition-jc4827w543`, `guition-jc4827w543-ext-amp`
`hu-087`	`hu-087`
`jiuchuan-s3`	`jiuchuan-s3`
`kevin/box-2`	`kevin-box-2`
`kevin/sp-v4-dev`	`kevin-sp-v4-dev`
`kevin/yuying-313lcd`	`kevin-yuying-313lcd`
`labplus/ledong-v2`	`labplus-ledong-v2`
`labplus/mpython-v3`	`labplus-mpython-v3`
`lc-s3-wifi-1.54tft`	`lc-s3-wifi-1.54tft`
`lcdwiki-es3c35p`	`lcdwiki-es3c35p`
`lceda-course-examples/eda-robot-pro`	`lceda-course-examples-eda-robot-pro`
`lceda-course-examples/eda-super-bear`	`lceda-course-examples-eda-super-bear`
`lceda-course-examples/eda-tv-pro`	`lceda-course-examples-eda-tv-pro`
`lckfb/szpi-esp32s3`	`lckfb-lichuang-dev`
`lilygo/t-cameraplus-s3`	`lilygo-t-cameraplus-s3`, `lilygo-t-cameraplus-s3-v1.2`
`lilygo/t-circle-s3`	`lilygo-t-circle-s3`
`lilygo/t-circle-s3-v11`	`lilygo-t-circle-s3-v11`
`lilygo/t-display-s3-pro-mvsrlora`	`lilygo-t-display-s3-pro-mvsrlora`
`m5stack/atom-echos3r`	`m5stack-atom-echos3r`
`m5stack/atoms3-echo-base`	`m5stack-atoms3-echo-base`
`m5stack/atoms3r-cam-m12-echo-base`	`m5stack-atoms3r-cam-m12-echo-base`
`m5stack/atoms3r-echo-base`	`m5stack-atoms3r-echo-base`
`m5stack/atoms3r-echo-pyramid`	`m5stack-atoms3r-echo-pyramid`
`m5stack/cardputer-adv`	`m5stack-cardputer-adv`
`m5stack/core-s3`	`m5stack-core-s3`
`m5stack/stick-s3`	`m5stack-stick-s3`
`m5stack/stopwatch`	`m5stack-stopwatch`
`magiclick/2p4`	`magiclick-2p4`
`magiclick/2p5`	`magiclick-2p5`
`maza-ai/esp32-s3`	`maza-ai-esp32-s3`
`minsi-k08-dual`	`minsi-k08-dual`
`mixgo-nova`	`mixgo-nova`
`movecall/cuican-esp32s3`	`movecall-cuican-esp32s3`
`movecall/moji-esp32s3`	`movecall-moji-esp32s3`
`nologo/xingzhi-abs-2.0`	`nologo-xingzhi-abs-2.0`
`nologo/xingzhi-cube-0.85tft-ml307`	`nologo-xingzhi-cube-0.85tft-ml307`
`nologo/xingzhi-cube-0.85tft-wifi`	`nologo-xingzhi-cube-0.85tft-wifi`
`nologo/xingzhi-cube-0.96oled-ml307`	`nologo-xingzhi-cube-0.96oled-ml307`
`nologo/xingzhi-cube-0.96oled-wifi`	`nologo-xingzhi-cube-0.96oled-wifi`
`nologo/xingzhi-cube-1.54tft-ml307`	`nologo-xingzhi-cube-1.54tft-ml307`
`nologo/xingzhi-cube-1.54tft-wifi`	`nologo-xingzhi-cube-1.54tft-wifi`
`nologo/xingzhi-metal-1.54-wifi`	`nologo-xingzhi-metal-1.54-wifi`
`nulllab-ai-vox-v3`	`nulllab-ai-vox-v3`
`otto-robot`	`otto-robot`
`quandong-s3-dev`	`quandong-s3-dev`
`rymcu/bigsmart`	`rymcu-bigsmart`
`sensecap-watcher`	`sensecap-watcher`
`spotpear/sp-esp32-s3-1.28-box`	`spotpear-sp-esp32-s3-1.28-box`
`spotpear/sp-esp32-s3-1.54-muma`	`spotpear-sp-esp32-s3-1.54-muma`
`taiji-pi-s3`	`taiji-pi-s3`, `taiji-pi-s3-pdm`
`waveshare/esp32-s3-audio-board`	`waveshare-esp32-s3-audio-board`
`waveshare/esp32-s3-cam`	`waveshare-esp32-s3-cam-1.83`, `waveshare-esp32-s3-cam-2`, `waveshare-esp32-s3-cam-2.8`, `waveshare-esp32-s3-cam-3.5`
`waveshare/esp32-s3-epaper-1.54`	`waveshare-esp32-s3-epaper-1.54-v1`, `waveshare-esp32-s3-epaper-1.54-v2`
`waveshare/esp32-s3-epaper-3.97`	`waveshare-esp32-s3-epaper-3.97`
`waveshare/esp32-s3-lcd-0.85`	`waveshare-esp32-s3-lcd-0.85`
`waveshare/esp32-s3-rgb-matrix`	`waveshare-esp32-s3-rgb-matrix`
`waveshare/esp32-s3-rlcd-4.2`	`waveshare-esp32-s3-rlcd-4.2`
`waveshare/esp32-s3-touch-amoled-1.32`	`waveshare-esp32-s3-touch-amoled-1.32`
`waveshare/esp32-s3-touch-amoled-1.43c`	`waveshare-esp32-s3-touch-amoled-1.43c`
`waveshare/esp32-s3-touch-amoled-1.75`	`waveshare-esp32-s3-touch-amoled-1.75`, `waveshare-esp32-s3-touch-amoled-1.75c`
`waveshare/esp32-s3-touch-amoled-1.8`	`waveshare-esp32-s3-touch-amoled-1.8`
`waveshare/esp32-s3-touch-amoled-1.8-v2`	`waveshare-esp32-s3-touch-amoled-1.8-v2`
`waveshare/esp32-s3-touch-amoled-2.06`	`waveshare-esp32-s3-touch-amoled-2.06`
`waveshare/esp32-s3-touch-amoled-2.16`	`waveshare-esp32-s3-touch-amoled-2.16`
`waveshare/esp32-s3-touch-lcd-1.46`	`waveshare-esp32-s3-touch-lcd-1.46`
`waveshare/esp32-s3-touch-lcd-1.54`	`waveshare-esp32-s3-touch-lcd-1.54`
`waveshare/esp32-s3-touch-lcd-1.83`	`waveshare-esp32-s3-touch-lcd-1.83`
`waveshare/esp32-s3-touch-lcd-1.85`	`waveshare-esp32-s3-touch-lcd-1.85`
`waveshare/esp32-s3-touch-lcd-1.85b`	`waveshare-esp32-s3-touch-lcd-1.85b`
`waveshare/esp32-s3-touch-lcd-1.85c`	`waveshare-esp32-s3-touch-lcd-1.85c`
`waveshare/esp32-s3-touch-lcd-3.49`	`waveshare-esp32-s3-touch-lcd-3.49`
`waveshare/esp32-s3-touch-lcd-3.49-v2`	`waveshare-esp32-s3-touch-lcd-3.49-v2`
`waveshare/esp32-s3-touch-lcd-3.5`	`waveshare-esp32-s3-touch-lcd-3.5`
`waveshare/esp32-s3-touch-lcd-3.5b`	`waveshare-esp32-s3-touch-lcd-3.5b`
`waveshare/esp32-s3-touch-lcd-4.3c`	`waveshare-esp32-s3-touch-lcd-4.3c`
`waveshare/esp32-s3-touch-lcd-4b`	`waveshare-esp32-s3-touch-lcd-4b`
`waveshare/esp32-s3-touch-lcd-7c`	`waveshare-esp32-s3-touch-lcd-7c`
`wk-esp32s3-dev`	`wk-esp32s3-dev`
`xorigin/aipi-lite`	`xorigin-aipi-lite`
`yunliao-s3`	`yunliao-s3`
`zectrix/zectrix-s3-epaper-4.2`	`zectrix-s3-epaper-4.2`
`zhengchen/1.54tft-ml307`	`zhengchen-1.54tft-ml307`
`zhengchen/1.54tft-wifi`	`zhengchen-1.54tft-wifi`
`zhengchen/cam`	`zhengchen-cam`
`zhengchen/cam-ml307`	`zhengchen-cam-ml307`

ESP32-P4 (6 directories, 27 variants)

Board directory	Firmware variants
`espressif/esp32-p4-function-ev-board`	`espressif-esp32-p4-function-ev-board`, `espressif-esp32-p4x-function-ev-board`
`m5stack/corep4`	`m5stack-corep4x`
`m5stack/tab5`	`m5stack-tab5`, `m5stack-tab5-p4x`
`waveshare/esp32-p4-nano`	`waveshare-esp32-p4-nano-10.1-a`, `waveshare-esp32-p4x-nano-10.1-a`
`waveshare/esp32-p4-wifi6-touch-lcd`	`waveshare-esp32-p4-wifi6-touch-lcd-10.1`, `waveshare-esp32-p4-wifi6-touch-lcd-3.4c`, `waveshare-esp32-p4-wifi6-touch-lcd-4.3`, `waveshare-esp32-p4-wifi6-touch-lcd-4b`, `waveshare-esp32-p4-wifi6-touch-lcd-4c`, `waveshare-esp32-p4-wifi6-touch-lcd-5`, `waveshare-esp32-p4-wifi6-touch-lcd-7`, `waveshare-esp32-p4-wifi6-touch-lcd-7b`, `waveshare-esp32-p4-wifi6-touch-lcd-8`, `waveshare-esp32-p4x-wifi6-touch-lcd-10.1`, `waveshare-esp32-p4x-wifi6-touch-lcd-3.4c`, `waveshare-esp32-p4x-wifi6-touch-lcd-4.3`, `waveshare-esp32-p4x-wifi6-touch-lcd-4b`, `waveshare-esp32-p4x-wifi6-touch-lcd-4c`, `waveshare-esp32-p4x-wifi6-touch-lcd-5`, `waveshare-esp32-p4x-wifi6-touch-lcd-7`, `waveshare-esp32-p4x-wifi6-touch-lcd-7b`, `waveshare-esp32-p4x-wifi6-touch-lcd-8`
`waveshare/esp32-p4-wifi6-touch-lcd-3.5`	`waveshare-esp32-p4-wifi6-touch-lcd-3.5`, `waveshare-esp32-p4x-wifi6-touch-lcd-3.5`

ESP32-C3 (10 directories, 10 variants)

Board directory	Firmware variants
`espressif/esp-hi`	`espressif-esp-hi`
`folotoy/ai-passport`	`folotoy-ai-passport`
`kevin/c3`	`kevin-c3`
`lckfb/szpi-esp32c3`	`lckfb-lichuang-c3-dev`
`magiclick/c3`	`magiclick-c3`
`magiclick/c3-v2`	`magiclick-c3-v2`
`surfer-c3-1.14tft`	`surfer-c3-1.14tft`
`xmini/c3`	`xmini-c3`
`xmini/c3-4g`	`xmini-c3-4g`
`xmini/c3-v3`	`xmini-c3-v3`

ESP32-C6 (10 directories, 10 variants)

Board directory	Firmware variants
`waveshare/esp32-c6-epaper-1.54`	`waveshare-esp32-c6-epaper-1.54`
`waveshare/esp32-c6-lcd-0.85`	`waveshare-esp32-c6-lcd-0.85`
`waveshare/esp32-c6-lcd-1.69`	`waveshare-esp32-c6-lcd-1.69`
`waveshare/esp32-c6-touch-amoled-1.32`	`waveshare-esp32-c6-touch-amoled-1.32`
`waveshare/esp32-c6-touch-amoled-1.43`	`waveshare-esp32-c6-touch-amoled-1.43`
`waveshare/esp32-c6-touch-amoled-1.8`	`waveshare-esp32-c6-touch-amoled-1.8`
`waveshare/esp32-c6-touch-amoled-2.06`	`waveshare-esp32-c6-touch-amoled-2.06`
`waveshare/esp32-c6-touch-amoled-2.16`	`waveshare-esp32-c6-touch-amoled-2.16`
`waveshare/esp32-c6-touch-lcd-1.54`	`waveshare-esp32-c6-touch-lcd-1.54`
`waveshare/esp32-c6-touch-lcd-1.83`	`waveshare-esp32-c6-touch-lcd-1.83`

ESP32 (6 directories, 7 variants)

Board directory	Firmware variants
`bread-compact-esp32`	`bread-compact-esp32`, `bread-compact-esp32-128x32`
`bread-compact-esp32-lcd`	`bread-compact-esp32-lcd`
`m5stack/atommatrix-echo-base`	`m5stack-atommatrix-echo-base`
`waveshare/esp32-touch-lcd-3.5`	`waveshare-esp32-touch-lcd-3.5`
`wdmomo/esp32-cgc`	`wdmomo-esp32-cgc`
`wdmomo/esp32-cgc-144`	`wdmomo-esp32-cgc-144`

ESP32-C5 (4 directories, 4 variants)

Board directory	Firmware variants
`espressif/esp-sensairshuttle`	`espressif-esp-sensairshuttle`
`espressif/esp-spot`	`espressif-esp-spot-c5`
`movecall/moji2-esp32c5`	`movecall-moji2-esp32c5`
`waveshare/esp32-c5-touch-lcd-1.69`	`waveshare-esp32-c5-touch-lcd-1.69`

ESP32-S31 (4 directories, 4 variants)

Board directory	Firmware variants
`espressif/esp-mosaico`	`espressif-esp-mosaico`
`espressif/esp32-s31-function-coreboard-1`	`espressif-esp32-s31-function-coreboard-1`
`espressif/esp32-s31-korvo-1`	`espressif-esp32-s31-korvo-1`
`maza-ai/esp32-s31`	`maza-ai-esp32-s31`

Notes

ESP32-S31 variants can only be built with ESP-IDF 6.1 or later; when building yourself, upstream recommends the release/v6.1 branch.
Numbers follow the v2.5.2 release manifest. The upstream main branch keeps adding and removing boards, so the numbers in its README may differ.
The release notes state that build and packaging checks do not replace testing on real hardware; confirm your board model before flashing.

Source: release-manifest.json of 78/xiaozhi-esp32 v2.5.2.

XiaoZhi AI Hardware Assembly Guide First Boot: Wi-Fi Setup, Activation and Binding