Инструкции по настройке сети
На этой странице описано, как устройство XiaoZhi подключается к сети, как настраивается Wi-Fi и что делать, если нужно сменить сеть. Полный порядок первого запуска, включая код активации и привязку, описан в Первый запуск: настройка Wi-Fi, активация и привязка.
Способы подключения
Доступные способы зависят от аппаратной части платы:
- Wi-Fi — самый распространённый вариант.
- Проводной Ethernet и USB RNDIS.
- Модули Cat.1 4G: ML307, EC801E или NT26. Часть оборудования умеет переключаться между Wi-Fi и 4G, способ переключения зависит от платы. Например,
yunliao-s3переключается двойным нажатием кнопки в течение 1 секунды при запуске или на экране настройки.
Способы настройки Wi-Fi
| Способ | Описание | Как включить |
|---|---|---|
| Точка доступа (по умолчанию) | Устройство открывает точку доступа Xiaozhi-XXXX; подключите телефон и выберите роутер на веб-странице | menuconfig: WiFi Configuration Method → Hotspot, включено по умолчанию |
| BluFi (BLE) | Устройство транслирует имя Bluetooth Xiaozhi-Blufi; клиент вроде EspBlufi отправляет данные Wi-Fi | Включите ESP-BluFi и отключите Hotspot; см. руководство по BluFi |
В одной прошивке оба способа одновременно включить нельзя. Шаги настройки через точку доступа описаны на странице первого запуска.
Требования к сети
- Диапазон: большинство чипов работает только на 2,4 ГГц. Чипы с поддержкой 5 ГГц (например, ESP32-C5) выбирают диапазон автоматически.
- Сохранённые сети: устройство хранит до 10 сетей Wi-Fi. Если у нескольких роутеров одинаковое имя (например, в mesh-сети), подключение идёт к тому, у которого сигнал сильнее.
- Тайм-аут подключения: если к сохранённой сети не удалось подключиться за 60 секунд, устройство возвращается в режим настройки.
- Безопасность точки доступа: точка доступа для настройки — открытая сеть без пароля, к ней можно подключить до 4 устройств. Настраивайте Wi-Fi в доверенной обстановке.
Повторная настройка
Если Wi-Fi уже сохранён, устройство само не входит в режим настройки. Чтобы сменить сеть:
- Нажмите кнопку настройки на плате при запуске. Кнопка зависит от платы: у
bread-compact-wifiэто одиночное нажатие BOOT; для других плат см. README в соответствующей папкеmain/boards/. - Некоторые платы предоставляют MCP-инструмент
self.disp.network(«повторная настройка сети»). - Если прежняя сеть пропала или сменился пароль, после 60 секунд неудачных попыток подключения устройство само входит в режим настройки.
Дополнительные настройки
На вкладке «Дополнительно» страницы настройки можно задать адрес OTA, мощность передатчика Wi-Fi и режим сна Wi-Fi (показывать ли поля OTA и сна, решает прошивка). Адрес OTA определяет, у какого сервера устройство запрашивает сведения о версии и активации, поэтому указывайте только доверенные серверы.
Устранение проблем с сетью
Сначала посмотрите раздел об устранении неполадок при первом запуске. Если устройство всё равно не подключается:
- убедитесь, что роутер работает на 2,4 ГГц, а имя и пароль введены верно;
- поднесите устройство ближе к роутеру, чтобы исключить влияние слабого сигнала и преград;
- посмотрите последовательный лог устройства, чтобы узнать причину неудачи;
- другие вопросы разобраны в FAQ.
Источники: 78/xiaozhi-esp32 v2.5.2 — README.md, wifi_board.cc, docs/blufi.md, а также компонент настройки 78/esp-wifi-connect.