Если BLE-датчик находится в дальней комнате, Home Assistant может не получать от него данные: встроенный Bluetooth сервера не достаёт через стены или этаж. ESPHome Bluetooth Proxy ставят ближе к устройству. Он передаёт BLE-объявления и, если плата и конфигурация поддерживают активные соединения, помогает Home Assistant обратиться к устройству по сети.
Прокси расширяет радиопокрытие, но не добавляет поддержку любой модели. Перед покупкой платы проверьте три вещи: BLE-протокол устройства, нужную Home Assistant интеграцию и то, требуется ли ей только слушать объявления или открывать активное соединение. Устройства Bluetooth Classic этим способом не подключаются.
Примечание редакции: материал подготовлен с использованием AI и сверён с документацией Home Assistant и ESPHome по состоянию на 26 октября 2026 года. Физическая ESP32-плата и BLE-устройства для этой статьи не тестировались.
Главное
- Bluetooth Proxy переносит приём BLE ближе к устройству и передаёт данные в Home Assistant по локальной сети.
- Нужна интеграция Home Assistant, которая понимает протокол устройства. Сам прокси не расшифровывает любой BLE-трафик.
- ESPHome поддерживает BLE-прокси на нескольких платформах, но готовый проект «Generic ESP32» подходит для обычного ESP32, а не для ESP32-C3 и других вариантов.
- Для ESP32 доступны объявления и активные GATT-соединения; число одновременных подключений ограничено настройкой слотов.
- BTHome и многие датчики Xiaomi передают данные объявлениями. Для управления некоторыми устройствами, например через SwitchBot Bluetooth, интеграция может использовать активное соединение и иметь дополнительные требования.
Когда нужен Bluetooth Proxy
Представьте BLE-термометр в кладовой: сервер Home Assistant стоит в кабинете за двумя стенами, и показания обновляются с пропусками. Если сам термометр исправен и его поддерживает интеграция HA, дополнительный Bluetooth-сканер в коридоре может услышать его объявления и передать их по Wi-Fi или Ethernet.
Home Assistant собирает локальные Bluetooth-адаптеры и сетевые прокси в интеграции Bluetooth. Прокси не подключается к устройству напрямую от имени отдельного сервиса: данные получает нужная BLE-интеграция Home Assistant. В разделе Настройки → Подключения → Bluetooth можно проверить список сканеров, соединения и принятые объявления. Названия пунктов меню могут немного отличаться в зависимости от версии Home Assistant.
Если сервер уже находится рядом и Bluetooth-показания стабильны, отдельная плата может быть не нужна. Сначала проверьте доступность устройства, питание и расположение сервера. Для локального USB-адаптера перенос на коротком USB-удлинителе иногда решает проблему помех; прокси полезен, когда радиоприём нужно вынести в другую комнату или на другой этаж.
Сначала проверьте BLE-устройство и интеграцию
Bluetooth — название радиосвязи, а не единый формат данных. Интеграция Home Assistant поддерживает Bluetooth Low Energy (BLE); Bluetooth Classic таким способом не подключить. Совместимость зависит от протокола устройства и от того, умеет ли выбранная интеграция его обработать.
| Пример | Как интеграция получает данные | Что перепроверить |
|---|---|---|
| BTHome-датчик | Передаёт телеметрию в BLE-объявлениях; активное соединение для самих объявлений не требуется | Поддерживает ли устройство BTHome и включена ли интеграция BTHome в Home Assistant |
| Xiaomi BLE / MiBeacon | Интеграция Xiaomi BLE слушает объявления поддерживаемых устройств | Это именно поддерживаемый MiBeacon-профиль, а не BLE Mesh; для зашифрованных объявлений может понадобиться bindkey |
| SwitchBot Bluetooth | Интеграция работает локально по BLE; способ обнаружения и доступные действия зависят от модели и режима сканирования | Нужны ли активное сканирование, подключение к аккаунту или ключ шифрования для выбранного устройства |
Откройте страницу точной интеграции в каталоге Home Assistant и найдите там модель или протокол, необходимую функцию и ограничения. Проверьте, как устройство передаёт данные: регулярно объявляет их в эфире или ждёт подключения к GATT-сервису. Для датчика температуры может быть достаточно услышать объявления; чтение настройки или отправка команды требует активного двустороннего соединения.
У Xiaomi BLE не все устройства используют один режим: интеграция поддерживает MiBeacon, MiScales и отдельные устройства MiFlora, но не Xiaomi BLE Mesh. Некоторые объявления зашифрованы; прокси не заменяет ключ устройства и не извлекает его из аккаунта. Сначала проверьте требования выбранной модели в документации Xiaomi BLE и официальной интеграции Home Assistant.
Какую ESP32 выбрать
В качестве отправной точки используйте готовые ESPHome Bluetooth Proxy проекты для конкретной платы. Страница ESPHome предлагает отдельный вариант Generic ESP32 и прямо оговаривает, что он рассчитан на обычный ESP32, не на ESP32-C3 или другой вариант. Для платы с Ethernet и PoE в документации есть проект Olimex ESP32-POE-ISO; Home Assistant также приводит Olimex ESP32-POE-ISO-EA как устройство, используемое для разработки и тестирования прокси. Это примеры из официальной документации, а не гарантия, что любая внешне похожая плата или её антенна даст тот же результат.
Перед покупкой сверяйте точное обозначение платы и SoC с выбранным готовым проектом ESPHome. Одного слова «ESP32» в карточке магазина недостаточно: семейство включает разные варианты, а готовая конфигурация может не поддерживать конкретный чип или схему платы. Если нужен прокси в кладовой, где Wi-Fi слабый, проводной Ethernet и питание PoE могут быть удобнее; если сеть там надёжная, Wi-Fi упрощает установку.
Для активных соединений у ESP32 по умолчанию предусмотрено три connection slots. Увеличение количества слотов расходует память и может ухудшить стабильность; ESPHome рекомендует не превышать пять. Устройство, которое постоянно держит соединение, занимает слот, пока оно подключено. Короткий обмен с датчиком освобождает слот после завершения. При пассивно передаваемых объявлениях эти слоты не расходуются.
Для первичной проверки не поднимайте сразу число слотов и не меняйте интервалы сканирования. Оставьте официальные настройки по умолчанию, проверьте нужную функцию и только потом разбирайте фактический журнал и ограничения конкретного сценария.
Где поставить прокси
Разместите плату в комнате рядом с BLE-устройством, но там, где сама ESP32 получает устойчивое питание и связь с сетью. Закрытая металлическая коробка, электрощит, телевизор или серверная стойка могут ослабить радиосигнал. Home Assistant и ESPHome указывают на помехи в диапазоне 2,4 ГГц от роутеров, USB 3 и другого оборудования; ESPHome советует не ставить узел вплотную к роутерам и сетевым устройствам. Ориентир документации для такого размещения — отодвинуть его примерно на три метра от сетевого оборудования, если планировка позволяет; это рекомендация по снижению помех, не обещание дальности.
Wi-Fi-прокси используют одно радиоустройство для Wi-Fi и Bluetooth, поэтому загруженный эфир или слабая сеть могут мешать передаче. Ethernet-вариант снимает часть Wi-Fi-нагрузки с радиомодуля, а внешняя антенна может улучшить приём. Окончательно выбирать место следует по поведению нужного устройства: появилось ли его BLE-объявление в Home Assistant и обновляется ли сущность с ожидаемым интервалом.
Не устанавливайте несколько прокси рядом друг с другом в расчёте на автоматическое усиление сигнала. Home Assistant может использовать несколько сканеров, но прокси стоит разнести по нужным комнатам и проверить, какой из них фактически принимает объявления. Перемещение и замеры делайте сначала с одним устройством, чтобы не смешивать влияние новой платы, положения датчика и изменения настроек.
Порядок подключения
- Проверьте протокол и функцию. Найдите интеграцию Home Assistant для точного BLE-устройства. Отметьте, нужно ли только получать объявления или также читать и менять параметры через активное соединение.
- Выберите поддерживаемую плату. Сверьте точную модель с готовыми проектами ESPHome и требованиями к питанию и сети. Для Generic ESP32 используйте плату на обычном ESP32, не C3.
- Подготовьте ESPHome-прокси. Следуйте актуальной инструкции выбранного проекта. Для типовой ESP32-конфигурации документация ESPHome использует компонент
esp32_ble_trackerиbluetooth_proxy; безопаснее начать с готового проекта производителя платы, а не копировать YAML для другого устройства. - Подключите прокси к домашней сети и Home Assistant. Убедитесь, что устройство ESPHome доступно в локальной сети и добавлено в Home Assistant. В настройках Bluetooth проверьте, появился ли новый сканер.
- Поставьте плату ближе к устройству. Сначала проверьте объявления или подключение в разделе Bluetooth. Затем убедитесь, что сущность нужной BLE-интеграции обновилась или доступно конкретное действие.
- Оставьте конфигурацию простой. Не включайте агрессивное сканирование и дополнительные GATT-слоты без причины. Если связь нестабильна, сначала измените место прокси или сеть и сравните результат.
Общие шаги настройки Home Assistant и различия способов установки описаны в руководстве по установке. Если Home Assistant работает в Container и использует локальный USB Bluetooth-адаптер, ему отдельно нужны системные зависимости BlueZ и доступ к D-Bus. Сетевой ESPHome-прокси подключается другим путём, но точные требования выбранного проекта и интеграции всё равно стоит проверить.
Если устройство не появилось или пропадает
| Что видно | Что проверить первым |
|---|---|
| В Bluetooth не появился новый сканер | Включена ли Bluetooth-интеграция, видит ли Home Assistant ESPHome-устройство, работает ли его API-связь и установлен ли проект с bluetooth_proxy |
| Прокси виден, но объявлений устройства нет | Включено ли устройство, достаточно ли заряда, находится ли оно рядом, передаёт ли оно BLE именно в поддерживаемом Home Assistant протоколе |
| Объявление видно, но сущность не создана | Есть ли подходящая интеграция, поддерживает ли она профиль и модель, требуется ли ключ расшифровки или первое нажатие/сопряжение |
| Сенсор работает, но команды или чтение не проходят | Нужна ли активная GATT-связь, доступна ли она для ESP32-платы, не заняты ли connection slots и разрешает ли интеграция выбранное действие |
| Данные обновляются рывками | Стабильна ли сеть у прокси, не стоит ли он у роутера/USB 3/металлической поверхности, нет ли потери питания или перегрева |
Сначала отделите радиосвязь от поддержки протокола. Если прокси не принимает объявления, проверьте размещение и питание. Если объявления приходят, а устройства или сущности нет, изучите требования интеграции. Если работает чтение, но не управление, проверьте активные соединения и точные ограничения модели. Не меняйте сразу firmware, сканирование и число слотов: так сложнее понять причину.
Для датчика с батарейкой учитывайте режим сканирования. Активное сканирование запрашивает у BLE-устройства дополнительный ответ и может увеличивать расход батареи. Home Assistant рекомендует режим Auto для большинства адаптеров, если он доступен; выбор должен учитывать требования конкретной интеграции. Не переводите прокси в постоянный Active только ради более частых обновлений без оценки батареи.
Если в Home Assistant есть последнее значение, но оно давно не менялось, это не доказывает, что датчик сейчас на связи. Сверьте время последнего обновления, объявления прокси и состояние самой сущности. Для сценария, который управляет отоплением, замком или охраной, добавьте отдельную обработку unknown и unavailable и оставьте человеку ручной способ проверить устройство.
Что прокси сможет передавать
Получать телеметрию BLE-термометра. Если модель поддерживается интеграцией, а датчик периодически передаёт объявления, прокси в соседней комнате может увеличить шанс их приёма сервером. Интервал обновления задаёт само устройство и его протокол; прокси не заставляет датчик чаще отправлять значения.
Видеть BTHome-устройства в удалённой зоне. BTHome использует BLE-объявления, поэтому для передачи телеметрии не требуется удерживать активный слот GATT. Сначала проверьте, что устройство действительно передаёт BTHome, а не только подключается приложением производителя.
Работать с BLE-устройством, которому нужна команда. Интеграция может открыть активное соединение через ESP32-прокси, если сама функция поддерживается и доступен свободный слот. Например, в интеграции SwitchBot набор сущностей и управление зависят от устройства; некоторые операции требуют активного сканирования или данных учётной записи. Проверьте страницу SwitchBot Bluetooth для выбранной модели.
Для BLE-датчиков сначала убедитесь, что нужные показания обновляются и относятся к выбранной комнате; сам прокси отвечает за приём сигнала, а не за точность сенсора. Если подключаете устройства Xiaomi, отдельно прочитайте статью о Xiaomi и Home Assistant. Для общего русскоязычного интерфейса можно посмотреть Habab Home: это локализованная сборка на базе Home Assistant. Совместимость отдельного BLE-устройства проверяется по его интеграции.
Часто задаваемые вопросы
Bluetooth Proxy работает с любым Bluetooth-устройством?
Нет. Этот компонент рассчитан на Bluetooth Low Energy и не поддерживает Bluetooth Classic. Home Assistant должен иметь интеграцию, которая распознаёт протокол и модель. ESPHome прямо указывает, что его прокси не декодирует устройства и не обещает совместимость каждого BLE-гаджета.
ESP32-C3 подходит для готовой прошивки Generic ESP32?
Нет. Страница готовых Bluetooth Proxy проектов ESPHome говорит, что Generic ESP32 подходит для обычного ESP32, но не ESP32-C3 и других вариантов. Выбирайте проект, явно поддерживающий вашу плату, или сверяйте конфигурацию с документацией конкретного варианта.
Нужно ли ставить ESP32 рядом с сервером?
Обычно задача прокси — переместить BLE-приём в зону устройства и подключить прокси к Home Assistant по сети. Плата должна иметь надёжное питание и устойчивый Wi-Fi или Ethernet. Металлический шкаф и соседство с сетевым оборудованием могут ухудшить радиосвязь.
Можно ли подключить через прокси Xiaomi BLE или SwitchBot?
Только если Home Assistant поддерживает точную модель и необходимую функцию. Xiaomi BLE должен использовать совместимый протокол MiBeacon и иногда требует ключ расшифровки. SwitchBot интеграция использует Bluetooth, но требования к обнаружению, активному сканированию, аккаунту и набору функций отличаются по устройствам.
Прокси уже настроен в Habab Home?
Habab Home — русифицированная сборка на базе Home Assistant. Эта статья не заявляет преднастроенную ESP32-плату или проверенную совместимость конкретного BLE-устройства. Перед подключением проверьте модель, версию Home Assistant и нужную интеграцию.
Источники
- ESPHome Bluetooth Proxy — поддерживаемые платформы, активные GATT-соединения, слоты и размещение.
- Готовые Bluetooth Proxy проекты ESPHome — варианты плат и оговорка для Generic ESP32.
- Bluetooth в Home Assistant — Bluetooth-адаптеры, сетевые прокси, сканирование и помехи.
- Xiaomi BLE — профили MiBeacon, поддержка устройств и шифрование.
- BTHome — BLE-объявления и обнаружение устройств.
- SwitchBot Bluetooth — режим сканирования и ограничения устройств.