Часто задаваемые вопросы (FAQ)

❓ Часто задаваемые вопросы

Найдите ответы на самые распространенные вопросы о прошивке XiaoZhi и ее использовании.

🔧 Установка и настройка

Q: Какие платы ESP32-S3 поддерживаются?

A: Прошивка XiaoZhi поддерживает:

• ✅ ESP32-S3-DevKitC-1 (полная совместимость)
• ✅ ESP32-S3-DevKitM-1 (полная совместимость)
• ✅ XiaoZhi Dev Board (оптимизированная плата)
• ⚠️ Другие ESP32-S3 платы (может потребоваться дополнительная настройка)

Q: Минимальные системные требования?

A: Для ESP32-S3 устройства:

• Flash память: минимум 4MB (рекомендуется 8MB+)
• RAM: минимум 512KB SRAM
• Wi-Fi: 2.4GHz поддержка обязательна
• Аудио: I2S микрофон и динамик/наушники

Q: Как сбросить устройство к заводским настройкам?

A: Есть несколько способов:

Способ 1: Кнопки

1. Удерживайте кнопки BOOT + RESET одновременно
2. Отпустите RESET, продолжая держать BOOT (10 секунд)
3. Отпустите BOOT - устройство перезагрузится с заводскими настройками

Способ 2: Веб-интерфейс

1. Подключитесь к веб-интерфейсу устройства
2. Перейдите в “Система” → “Сброс настроек”
3. Подтвердите сброс

Способ 3: Голосовая команда Произнесите: “恢复出厂设置” (восстановить заводские настройки)

🎙️ Голосовые функции

Q: Устройство не реагирует на “你好小智”

A: Проверьте следующее:

1. Правильное произношение: “nǐ hǎo xiǎo zhì” (китайский)
2. Расстояние: говорите на расстоянии 0.5-2 метра
3. Громкость: используйте нормальную разговорную громкость
4. Фоновый шум: убедитесь в тишине при первом тестировании
5. Микрофон: проверьте подключение и работоспособность

Q: Можно ли изменить слово пробуждения?

A: Да, поддерживается 26+ официальных слов пробуждения:

• Английские: “Hi ESP”, “Hello World”, “Smart Home”
• Китайские: “你好小智”, “小智助手”, “智能管家”
• Настройка: через веб-интерфейс или menuconfig при компиляции

Q: Поддержка русского языка для голосовых команд?

A: В данный момент:

• ✅ Пробуждение: поддерживаются некоторые русские фразы
• ⚠️ Команды: ограниченная поддержка через облачные ASR сервисы
• 🔄 В разработке: расширенная поддержка русского языка планируется в v2.3

🤖 AI интеграция

Q: Какие AI сервисы поддерживаются?

A: Поддерживаются следующие провайдеры:

Q: Высокие расходы на API вызовы

A: Способы оптимизации:

1. Локальная обработка: включите для простых команд
2. DeepSeek: самый экономичный LLM ($0.14/1M токенов)
3. Кэширование: активируйте локальное кэширование ответов
4. Лимиты: установите дневные лимиты в настройках
5. Тайм-ауты: настройте автоматическое отключение при бездействии

Q: Медленные ответы AI (>10 секунд)

A: Диагностика и решения:

1. Проверьте интернет: используйте speedtest для проверки скорости
2. Смените регион API: выберите ближайший сервер
3. Уменьшите max_tokens: с 1000 до 200-300
4. Используйте более быстрые модели: GPT-3.5 вместо GPT-4
5. Локальное кэширование: включите для повторяющихся запросов

🌐 Сеть и подключения

Q: Проблемы с Wi-Fi подключением

A: Пошаговое устранение:

Шаг 1: Базовая диагностика

# Проверка сигнала Wi-Fi
curl http://xiaozhi-device.local/api/wifi/scan

# Статус подключения
curl http://xiaozhi-device.local/api/status

Шаг 2: Настройки сети

• Используйте 2.4GHz сеть (5GHz не поддерживается)
• Убедитесь в отсутствии специальных символов в пароле
• Проверьте MAC-фильтрацию в роутере

Шаг 3: Сброс сетевых настроек

1. Веб-интерфейс → “Сеть” → “Сброс Wi-Fi настроек”
2. Повторная настройка через точку доступа “XiaoZhi-Setup”

Q: Устройство недоступно в локальной сети

A: Возможные причины:

1. DHCP конфликт: назначьте статический IP
2. Firewall роутера: добавьте устройство в исключения
3. mDNS проблемы: используйте IP адрес вместо имени
4. Изоляция клиентов: отключите в настройках роутера

🏠 IoT и умный дом

Q: Интеграция с Home Assistant

A: Пошаговая настройка:

1. MQTT конфигурация

# configuration.yaml
mqtt:
  broker: !secret mqtt_broker
  username: !secret mqtt_username
  password: !secret mqtt_password
  discovery: true
  discovery_prefix: homeassistant

2. XiaoZhi настройки

• Веб-интерфейс → “Интеграции” → “MQTT”
• Введите данные MQTT брокера
• Включите “Home Assistant Discovery”

3. Проверка интеграции

• Устройство должно появиться в HA автоматически
• Раздел “Настройки” → “Устройства и службы” → “MQTT”

Q: Поддержка Zigbee/Z-Wave устройств?

A: Прямая поддержка отсутствует, но возможна интеграция через:

• Home Assistant: как центральный хаб
• MQTT мост: для протоколов третьих сторон
• REST API: для HTTP совместимых устройств

🔍 Диагностика и отладка

Q: Как просмотреть логи системы?

A: Несколько способов:

Веб-интерфейс

• Перейдите в “Система” → “Логи”
• Выберите уровень детализации (Error/Warning/Info/Debug)

Последовательный порт

# Linux/macOS
screen /dev/ttyUSB0 115200

# Windows (PuTTY)
# Port: COM3, Speed: 115200

Удаленные логи

# REST API
curl http://xiaozhi-device.local/api/logs?level=error

# WebSocket (реальное время)
wscat -c ws://xiaozhi-device.local:8080/logs

Q: Высокое потребление памяти

A: Мониторинг и оптимизация:

Проверка состояния памяти

curl http://xiaozhi-device.local/api/system/memory

Способы оптимизации

1. Отключите неиспользуемые функции: TTS, дополнительные AI сервисы
2. Уменьшите буферы: аудио буферы в настройках
3. Очистите кэш: автоматическая очистка каждые 24 часа
4. Перезагрузка: ежедневная автоматическая перезагрузка

📱 Мобильные приложения

Q: Есть ли мобильное приложение?

A: В данный момент:

• ❌ Нативные приложения: iOS/Android приложения в разработке
• ✅ PWA веб-приложение: адаптивный веб-интерфейс
• ✅ Telegram бот: базовая интеграция для уведомлений

Доступ через браузер

• Откройте браузер на телефоне
• Перейдите по IP адресу устройства
• Добавьте на главный экран для быстрого доступа

Q: Управление несколькими устройствами

A: Варианты управления:

1. Центральный сервер: развертывание собственного хаба
2. Home Assistant: управление через HA
3. MQTT Dashboard: мобильные MQTT клиенты
4. REST API: разработка собственного приложения

🔒 Безопасность и конфиденциальность

Q: Насколько безопасны голосовые данные?

A: Меры безопасности:

• 🔒 Локальное пробуждение: не передается в интернет
• 🔐 Шифрование: все API вызовы используют HTTPS
• 🗑️ Автоудаление: аудио данные не сохраняются локально
• ⚙️ Настройки приватности: полное отключение облачной обработки

Q: Можно ли использовать полностью офлайн?

A: Ограниченная офлайн функциональность:

• ✅ Голосовое пробуждение: полностью локально
• ✅ Простые команды: управление GPIO, базовые ответы
• ❌ Сложные AI диалоги: требуют интернет
• ❌ Многоязычная ASR: требует облачные сервисы

Настройка офлайн режима

1. Веб-интерфейс → “AI сервисы” → “Локальный режим”
2. Отключите все облачные провайдеры
3. Настройте локальные команды и ответы

🆘 Не нашли ответ?

Техническая поддержка

• 📧 Email: [email protected]
• 🐙 GitHub Issues: https://github.com/xiaozhidev/xiaozhi-firmware/issues
• 💬 Сообщество: Telegram чат @xiaozhi_dev_ru

Документация

• 📖 Полное руководство пользователя
• 🔧 Техническая документация
• 🤖 AI интеграция