На какой плате запускать XiaoZhi? Три шага: чип, сеть и готовая плата
Чаще всего новички спрашивают: какую плату купить? В манифесте релиза upstream v2.5.2 перечислено 154 каталога плат и 188 готовых вариантов прошивки. Выбор большой, но на деле решают лишь несколько факторов. Статья придерживается только того, что можно проверить по исходному коду прошивки и манифесту релиза, и не рекомендует никаких брендов.
1. Шаг первый: выберите чип
Число плат по чипам взято из манифеста релиза v2.5.2; возможности аудио и слова пробуждения — из main/audio/README.md и main/Kconfig.projbuild upstream:
| Чип | Каталоги плат | Варианты | Движок аудиовхода | Слово пробуждения на устройстве |
|---|---|---|---|---|
| ESP32-S3 | 114 | 126 | AfeAudioEngine (эхоподавление и VAD) | По умолчанию включено при наличии PSRAM |
| ESP32-P4 | 6 | 27 | AfeAudioEngine | Как у ESP32-S3 |
| ESP32-S31 | 4 | 4 | AfeAudioEngine | Как у ESP32-S3; нужен ESP-IDF 6.1 или новее |
| ESP32-C3 / C6 / C5 | 10 / 10 / 4 | 10 / 10 / 4 | LiteAudioEngine (необработанный моно PCM) | Необязательно, без AFE |
| ESP32 | 6 | 7 | LiteAudioEngine | Чтобы его выбрать, нужна PSRAM |
Как читать таблицу:
- У ESP32-S3 больше всего плат (114 каталогов), и он обеспечивает самую полную обработку звука AFE и поддержку слова пробуждения, поэтому это универсальный первый выбор;
- PSRAM важна: пользовательские слова пробуждения, слово пробуждения AFE и обработка звука требуют PSRAM. Для отладочной платы на S3 выбирайте N16R8 (16 МБ Flash, 8 МБ PSRAM); для N8R2 нужна дополнительная настройка, см. Руководство по оборудованию;
- C3, C6, C5 и ESP32 используют лёгкий движок без эхоподавления и подходят для недорогих сборок с запуском по кнопке;
- подробности по каждому чипу — в разделе Поддержка чипов и спецификации хранилища.
2. Шаг второй: выберите способ подключения к сети
В README upstream перечислены Wi-Fi, проводной Ethernet, USB RNDIS и сети 4G Cat.1 на ML307, EC801E или NT26; на части оборудования можно переключаться между Wi-Fi и 4G.
| Потребность | Что делать |
|---|---|
| Дом или офис с Wi-Fi | Используйте прошивку для Wi-Fi; настройка описана в разделах Первый запуск и Настройка сети |
| На улице или нет Wi-Fi | Выберите вариант с модулем 4G, например из серии на макетной плате bread-compact-ml307 или bread-compact-nt26 |
| Есть проводная сеть | Выберите оборудование с проводным Ethernet; в прошивке есть базовый класс платы для Ethernet и параметр XIAOZHI_NETWORK_ETHERNET (PHY по умолчанию — IP101), а точная поддержка зависит от каталога платы |
Для сборки с 4G модуль должен быть версией с AT-прошивкой, и рекомендуется модель со съёмной SIM-картой; см. раздел об ML307R в руководстве по оборудованию.
3. Шаг третий: готовая плата или самосборка
| Путь | Кому подходит | Примечания |
|---|---|---|
| Самосборка на макетной плате | Для обучения, если вас не пугает монтаж проводов | Отладочная плата на ESP32-S3 плюс микрофон INMP441 и усилитель MAX98357A; схема подключения — в Руководстве по оборудованию; подходящие варианты — серия bread-compact-wifi |
| Купить готовую плату | Хотите меньше возни | Найдите свою плату в разделе Поддерживаемые платы и скачайте вариант с тем же именем |
| Ограниченный бюджет | Просто хотите попробовать | Соберите «бюджетную версию» на ранней плате ESP32; возможностей меньше, см. следующий раздел |
Дисплеи и камеры: README upstream заявляет поддержку дисплеев OLED и LCD, а часть оборудования поддерживает ввод изображения с камеры. В одном каталоге платы может быть несколько вариантов: например, bread-compact-wifi использует OLED SSD1306 128x32, а bread-compact-wifi-128x64 — 128x64. Перед загрузкой проверьте имя варианта.
4. Бюджетный вариант: что умеет сборка на ESP32
На ранней плате ESP32 (обычно 4 МБ Flash и без PSRAM) используется серия bread-compact-esp32:
| Параметр | ESP32 (бюджетная) | ESP32-S3 |
|---|---|---|
| Движок аудиовхода | LiteAudioEngine, необработанный моно PCM | AfeAudioEngine, с эхоподавлением и VAD |
| Слово пробуждения на устройстве | По умолчанию выключено; можно выбрать только при наличии PSRAM | По умолчанию включено при наличии PSRAM |
| Запуск диалога | Кнопка или внешний модуль пробуждения | Слово пробуждения или кнопка |
Схема подключения и варианты — в разделе Бюджетная версия ESP32. Если вам нужны слово пробуждения и полнодуплексный диалог, сразу берите ESP32-S3.
5. Что делать, если вашей платы нет в списке
- Проверьте, не дело ли только в названии: найдите плату по чипу в разделе Поддерживаемые платы; одна и та же плата может значиться под именем «производитель/каталог».
- Ваша плата отличается от существующей несколькими выводами: не перезаписывайте каталог существующей платы. Создайте новый тип платы или различайте сборки в
config.jsonдругимnameи макросамиsdkconfig, как описано в Руководстве по пользовательским платам. - Вы собираете сами: нужен ESP-IDF v6.0.1 или новее; об изменениях кода платы см. Перенос пользовательской платы на ESP-IDF 6.
Список проверок перед покупкой
- Есть ли чип в таблице выше и есть ли у него PSRAM (S3 / P4 / S31 нужна она для слова пробуждения и обработки звука)?
- Подходит ли объём Flash под требования таблицы разделов? См. Поддержка чипов и спецификации хранилища.
- Нужен Wi-Fi или 4G; модуль 4G — версия с AT-прошивкой?
- Совпадают ли модель дисплея и драйвер с нужным вариантом (для OLED нужен драйвер SSD1306)?
- Есть ли в манифесте релиза вариант с тем же именем? Если нет, придётся собирать самостоятельно.
- Действительно ли подключены RGB-светодиод и кнопки платы? На некоторых DevKit для RGB-светодиода нужны перемычки пайкой, см. руководство по оборудованию.
Источники
- Upstream
v2.5.2: манифест релиза (release-manifest.json),README.md,main/audio/README.mdиmain/Kconfig.projbuild. - Страницы этого сайта: Поддерживаемые платы, Руководство по оборудованию и Бюджетная версия ESP32.
- Проверено 2026-10-23. Исправления присылайте на [email protected].