В Home Assistant OS (HAOS) на x86 Wi-Fi-адаптер может не работать: плата или USB-донгл не показывается как Wi-Fi устройство, а привычного apt-get для установки драйверов в системе нет. В двух ветках адаптер уже был виден HAOS, и помогла настройка: Wi-Fi задавали через веб-интерфейс или командой network в консоли HAOS. Если карта Intel AX210 не появляется из-за отсутствующей прошивки, подтвержденного решения на HAOS пока нет.
Как выглядит проблема
Проявления различаются в зависимости от железа, но суть одна: Wi-Fi подключение не появляется. Варианты симптома:
- HAOS на x86: Wi-Fi-адаптер не работает, а apt-get, через который обычно ставят драйверы, в системе недоступен.
- Карта Intel AX210 не отображается как Wi-Fi сетевое устройство, загрузка ее прошивки завершается с ошибкой.
- Wi-Fi USB-донгл не определяется после подключения к Home Assistant Green.
В обсуждениях фигурировали адаптеры Panda Wireless PAU0F, Ralink RT3290 и Realtek RTL8822CE, проблема встречалась на HAOS 2024.6.4. В консоли при этом появляются такие ошибки:
Object does not exist at path “/org/freedesktop/NetworkManager/ActiveConnection/10”[ 1.321952] iwlwifi 0000:02:00.0: PNVM data is missing, please install iwlwifi-ty-a0-gf-a0.pnvm[ 1.109816] iwlwifi 0000:02:00.0: Direct firmware load for iwlwifi-ty-a0-gf-a0-83.ucode failed with error -2Последние две строки - сообщения драйвера iwlwifi, они встречаются в варианте с картой Intel AX210.
Причины
Названы две причины: адаптер виден HAOS, но Wi-Fi на нем не настроен, либо Wi-Fi не работает из-за отсутствующей прошивки.
| Причина | Как проверить | Что сделать |
|---|---|---|
| HAOS зарегистрировал USB-донгл как интерфейс WLU, но Wi-Fi на нем не настроен. Подтверждена в 1 ветке форума | Открыть Settings → System → Network, пункт Configure Network Interfaces, либо выполнить nmcli device show: интерфейс в списке есть, Wi-Fi сеть на нем не настроена | Настроить этот интерфейс на Wi-Fi сеть - см. варианты ниже |
| Отсутствует прошивка Wi-Fi, и внесенные в нее изменения не сохраняются после перезагрузки. Предположение из форума, подтверждений нет | Посмотреть лог загрузки: в нем сообщения iwlwifi об отсутствующем файле PNVM и неудачной загрузке ucode (блок ошибок выше) | Подтвержденного решения нет: перестановка карты и замена прошивки не помогли |
Решения
Есть два рабочих способа, каждый подтвержден в 1 ветке форума из тех, где его пробовали. Первый настраивает Wi-Fi командами в консоли, второй - через веб-интерфейс.
Команды в консоли
Это опыт пользователей: в единственной ветке, где способ пробовали, он сработал. Сначала найдите имя адаптера:
nmcli device showВ ветке также приведены команды exit и login:
exit
loginСаму настройку Wi-Fi делает команда network:
network update wlan0 --ipv4-method auto --ipv6-method auto --wifi-auth wpa-psk --wifi-**mode infrastructure --wifi-ssid <wifi name> --wifi-psk <wifi password>Вместо <wifi name> и <wifi password> подставьте имя Wi-Fi сети и пароль.
Настройка в веб-интерфейсе
На форуме этот способ сработал, а документация подтверждает только путь меню: сетью HAOS управляют через Settings > System > Network, как сказано в документации Home Assistant. Откройте Settings → System → Network, пункт Configure Network Interfaces, выберите интерфейс WLU и настройте его на свою Wi-Fi сеть. Так включили Wi-Fi USB-донгл на Home Assistant Green.
Оговорка: сам пункт Configure Network Interfaces и интерфейс WLU в официальной документации не описаны, эта часть - пользовательский опыт.
Если не помогло
Если адаптер так и не заработал, учтите неудачный опыт: каждый из двух шагов ниже получил по одному сообщению, что он не сработал.
- Перестановка Wi-Fi карты в другой слот PCIe.
- Копирование более нового файла прошивки iwlwifi в каталог /lib/firmware с последующей перезагрузкой. Ссылка на страницу поддержки беспроводных адаптеров Intel.
Остались два неподтвержденных варианта. Первый - создать профиль Wi-Fi подключения через nmcli в консоли:
nmcli con shownmcli connection add type wifi con-name "MyWiFiProfile" \
ifname wlan0 \
ssid "MySSID" \
802-11-wireless-security.key-mgmt WPA-PSK \
802-11-wireless-security.psk xxxxxxxx \
ip4 192.168.100.101/24 \
gw4 192.168.100.1Результат этого способа никто не подтвердил. Второй вариант - ждать обновлений и перезапусков Home Assistant: у одного пользователя Wi-Fi интерфейс после них появился, но лишь частично. Как обновлять систему без сюрпризов, разобрано в гайде по обновлению Home Assistant, а если само обновление падает и откатывается - это отдельная проблема.
И еще один смежный случай: если HAOS только что установлен, Ethernet не подключен и в консоли не стартует CLI с ошибкой CLI not starting - это другая ситуация, у нее есть своя страница про первую загрузку HAOS без Ethernet.
Частые вопросы
Можно ли поставить драйвер Wi-Fi через apt-get в HAOS?
Нет, в Home Assistant OS нет apt-get, поэтому привычный для Linux способ установки драйверов не подойдет. Рабочий путь другой - проверить, что система видит адаптер (nmcli device show или список интерфейсов в настройках сети), и настроить Wi-Fi штатно: через веб-интерфейс или командой network в консоли HAOS.
Почему Intel AX210 не видна как Wi-Fi устройство?
Судя по сообщениям в консоли, дело в прошивке. При загрузке HAOS драйвер iwlwifi сообщает, что данные PNVM отсутствуют, а файл iwlwifi-ty-a0-gf-a0-83.ucode загрузить не удалось. Подтвержденного решения нет: в ветке форума пробовали переставить карту в другой слот PCIe и скопировать более новую прошивку в /lib/firmware - оба шага не помогли. У одного пользователя интерфейс появился лишь частично, после нескольких обновлений и перезапусков Home Assistant.
Работает ли Wi-Fi USB-донгл с Home Assistant Green?
В одной ветке заработал после настройки. Green зарегистрировал подключенный донгл как интерфейс WLU, но до ручной настройки тот никак не проявлялся и выглядел как неопределяемый. Wi-Fi заработал, когда интерфейс WLU настроили на сеть через Configure Network Interfaces. Поэтому при «невидимом» донгле сначала проверьте список сетевых интерфейсов в настройках системы.
Сохранятся ли изменения прошивки после перезагрузки?
Прямых подтверждений нет: предположение из одной ветки - изменения, внесенные в прошивку Wi-Fi, не переживают перезагрузку HAOS. Копирование нового файла iwlwifi в /lib/firmware в той же ветке не сработало. Штатная настройка Wi-Fi командой network или через веб-интерфейс с файлами прошивки не связана, она настраивает интерфейс, который система уже видит.
