Документация Xiaozhi
Руководство по использованию
Загрузка прошивки

Загрузка прошивки

📦 Загрузка прошивки

Получите последнюю версию прошивки XiaoZhi для вашего ESP32-S3 устройства.

🎯 Поддерживаемые устройства

✅ Полностью совместимые

  • ESP32-S3-DevKitC-1 - Рекомендуемая плата разработки
  • ESP32-S3-DevKitM-1 - Компактная версия
  • XiaoZhi Dev Board - Специализированная плата для голосовых приложений

⚠️ Частично совместимые

  • Другие ESP32-S3 платы (могут потребовать дополнительной настройки)

💾 Версии прошивки

🚀 Стабильная версия

v2.1.0 - Рекомендуется для производственного использования

  • ✅ Стабильная работа всех AI функций
  • ✅ Поддержка DeepSeek, Qwen, GPT интеграции
  • ✅ Полная поддержка MCP протокола
  • ✅ Оптимизированное энергопотребление

Загрузить: xiaozhi-firmware-v2.1.0-stable.bin

🧪 Бета версия

v2.2.0-beta - Для тестирования новых функций

  • 🆕 Экспериментальные AI возможности
  • 🆕 Улучшенная многоязычная поддержка
  • ⚠️ Может содержать ошибки

Загрузить: xiaozhi-firmware-v2.2.0-beta.bin

🛠️ Инструменты для прошивки

Опция 1: ESP32 Flash Download Tool (Рекомендуется)

  1. Скачайте с официального сайта Espressif
  2. Запустите приложение
  3. Выберите ESP32-S3 как целевое устройство
  4. Загрузите файл прошивки

Опция 2: esptool.py (Командная строка) 

# Установка esptool
pip install esptool

# Прошивка устройства
esptool.py --chip esp32s3 --port /dev/ttyUSB0 --baud 921600 \
  write_flash -z 0x0 xiaozhi-firmware-v2.1.0-stable.bin

Опция 3: Веб-инструмент

Используйте ESP Web Tools для прошивки через браузер.

📋 Пошаговая инструкция

🔧 Подготовка

### Проверка оборудования Убедитесь, что у вас есть: - ESP32-S3 совместимая плата - USB кабель (Type-C или Micro-USB) - Компьютер с Windows/macOS/Linux ### Установка драйверов Установите соответствующие USB драйверы для вашей ОС. ### Скачивание прошивки Загрузите последнюю стабильную версию прошивки.

⚡ Процесс прошивки

### Подключение устройства Подключите ESP32-S3 к компьютеру через USB кабель. ### Перевод в режим загрузки Удерживайте кнопку BOOT и нажмите RESET для входа в режим загрузки. ### Запуск инструмента прошивки Откройте Flash Download Tool или используйте командную строку. ### Выбор файла и порта Укажите путь к файлу прошивки и COM порт устройства. ### Начало прошивки Нажмите START и дождитесь завершения процесса.

✅ Проверка установки

После успешной прошивки:

  1. Перезагрузка: Нажмите кнопку RESET на плате
  2. Светодиод: Должен мигать, указывая на готовность системы
  3. Wi-Fi точка: Найдите “XiaoZhi-Setup” в списке доступных сетей
  4. Голосовое тестирование: Произнесите “你好小智” для проверки

🚨 Устранение проблем

Ошибка: Устройство не найдено

  • Проверьте USB подключение
  • Установите корректные драйверы
  • Попробуйте другой USB порт

Ошибка: Не удается войти в режим загрузки

  • Удерживайте BOOT дольше (3-5 секунд)
  • Убедитесь в правильной последовательности: BOOT → RESET → отпустить RESET → отпустить BOOT

Ошибка: Прошивка не завершается

  • Проверьте качество USB кабеля
  • Понизьте скорость прошивки (с 921600 до 115200)
  • Попробуйте другой инструмент прошивки

🔄 Обновление прошивки

OTA обновления (Over-The-Air)

После первоначальной установки можно обновляться через Wi-Fi:

  1. Подключитесь к веб-интерфейсу устройства
  2. Перейдите в раздел “Система” → “Обновление”
  3. Загрузите новый файл прошивки
  4. Подтвердите обновление

Резервное копирование настроек

Перед обновлением сохраните настройки:

# Экспорт конфигурации
curl http://xiaozhi-device.local/api/config/export > backup.json

# Восстановление после обновления
curl -X POST http://xiaozhi-device.local/api/config/import \
  -H "Content-Type: application/json" \
  -d @backup.json

📚 Дополнительные ресурсы

Помощь и поддержка: Если у вас возникли проблемы с прошивкой, обратитесь к сообществу или напишите на [email protected]
XiaoZhi AI бюджетная версия - Реализация на плате ESP32