Установка Home Assistant на контроллер Wiren Board
Это черновик страницы. Последняя правка сделана 20.02.2026 пользователем D.Nikolaev.
Описание
В контроллерах Wiren Board устанавливается комбинированный модуль радиосвязи Wi-Fi + Bluetooth 4.0 BLE (Bluetooth Low Energy) производства Realtek. Контроллеры в модификации без Wi-Fi не поддерживают Bluetooth! Для Bluetooth-связи используется та же антенна, что и для Wi-Fi.
Программное обеспечение
На контроллере Wiren Board установлено ПО BlueZ, поддерживающее стек протоколов Bluetooth на Linux. Подробное описание и назначение команд приводится на странице проекта.
Проверить работоспособность и наличие Bluetooth командой hciconfig:
Проверить наличие включенного устройства можно командой hcitool dev.
Управлять включением/выключением Bluetooth-интерфейса можно командой hciconfig hci0 up | down.
Поиск классических Bluetooth-устройств (BR/EDR, Bluetooth Basic Rate/Enhanced Data Rate) выполняется командой hcitool scan, сканирование BLE-устройств —
hcitool lescan.
Поиск Bluetooth-устройств рядом с контроллером описан в нашей статье в разделе "Bluetooth".
Сканирование сервисов
Узнать, какие Bluetooth-сервисы поддерживает найденное устройство (телефон, к примеру), можно командой
sdptool browse 58:40:4E:60:C5:B1 | grep "Service Name"
Работа с сервисами
Различные устройства поддерживают свой набор Bluetooth-сервисов, например, передачу файлов, работу в качестве сетевой карты, устройство воспроизведения аудио и т.п. Возможность работы с этими сервисами описана в документации к ПО BlueZ, в документации к устройствам и на профильных форумах. Использование каждого сервиса требует сооетветвующей настройки.
Коммуникация контроллера WirenBoard с BLE и Bluetooth устройствами
Home Assistant
Home Assistant активно поддерживается сообществом, для разных устройств появляются интеграции быстрее остальных решений. Список работающих интеграций размещен на официальной странице на сайте разработчика. Решение популярное, работает на каждой второй установке Home Assistant. Для работы с устройствами BLE и Bluetooth рекомендуется установить docker и Home Assistant по инструкции.
Bluetooth адаптер подключается в docker-контейнер путем добавления volume с устройством (по умолчанию присутствует):
services:
homeassistant:
volumes:
- /run/dbus:/run/dbus:ro # <-- Bluetooth адаптер
Добавление новых устройств:
Для добавления сопряжения с новыми устройствами перейти в: Settings/Devices & Services/.
Если устройства были обнаружены, они появятся в верхней части страницы в разделе Discovered.
BLE2MQTT
Данная интеграция не рекомендуется в связи с низкой активностью сообщества, нестабильной работой из-за слабой обработки исключений и склонностью сервиса к принудительной перезагрузке Bluetooth адаптера.