Руководство по разработке ESP32
Руководство по разработке ESP32
Этот раздел предназначен для разработчиков, которые хотят прочитать, изменить или портировать прошивку XiaoZhi ESP32. Материал составлен по upstream-репозиторию 78/xiaozhi-esp32 v2.5.2: сначала разберитесь с чипами и разделами, затем прочитайте карту исходного кода, а точки расширения и устранение неполадок смотрите по необходимости.
Прошивка поддерживает ESP32-S3, ESP32-P4, ESP32-C3, ESP32-C5, ESP32-C6, ESP32 и ESP32-S31. У разных чипов отличаются аудиодвижок и возможности слова пробуждения, см. Поддержка чипов и спецификации хранилища. Чтобы добавить новую плату, прочитайте руководство по своей плате.
Порядок чтения
Аудиодвижки, требования к PSRAM и таблицы разделов v2
Структура каталогов, конечный автомат устройства, абстракция платы и правила разработки
Типы сетей, слова пробуждения, MCP, уведомления и настройка ресурсов
Где искать причины проблем со сборкой, прошивкой, аудио и assets
Связанные материалы
- Настройка среды ESP-IDF: нужен ESP-IDF v6.0.1 или новее, рекомендуется
release/v6.1 - Руководство по сборке оборудования: DIY-вариант на макетной плате и таблицы подключения
- Бюджетная версия на ESP32: использование ранней платы ESP32
- Поддерживаемые платы: все варианты прошивки
- Руководство по пользовательским Assets: слова пробуждения, шрифты, эмодзи и фоны чата
- Протокол MCP: инструменты на стороне устройства и последовательность протокола
Контакты
По вопросам содержимого сайта пишите на [email protected]. По проблемам самой прошивки обращайтесь в upstream GitHub Issues.