Hardware & Firmware

XiaoZhi firmware covers ESP32, S3, C3, C5, C6 and P4 platforms; the v2.5.2 release matrix has 154 board directories and 188 prebuilt firmware variants. Everything about boards, flashing and hardware DIY starts here.

Choosing a board

Supported Boards
154 board directories and 188 prebuilt variants, grouped by chip
Which Board Should Run XiaoZhi
Breadboard vs. ready-made vs. display boards
Chips & Storage Specs
Supported chips, audio engines and partition tables

Firmware download & flashing

Firmware Download & Flashing
Pick a variant by board, download prebuilt firmware, flash without a toolchain or via esptool

Confirm the board-to-variant mapping before flashing: one board directory can map to several variants (display size, networking), and picking the wrong variant is a common problem — see the FAQ.

Hardware DIY

Hardware Setup Guide
ESP32-S3 assembly, wiring diagrams, parts list and soldering notes
ESP32 Budget Version
Low-cost option and substitute parts
Custom Board Guide
Add a board directory and build with scripts/build.py

Go further