Actualizado el 20 de agosto de 2026.
Un Bluetooth Proxy de ESPHome amplía la cobertura Bluetooth Low Energy de Home Assistant usando uno o varios ESP32 distribuidos por la vivienda. No crea una red Bluetooth Mesh ni sustituye las integraciones de los dispositivos: recibe anuncios BLE y, cuando hace falta, mantiene conexiones GATT para que Home Assistant pueda comunicarse con sensores, cerraduras, termostatos y otros equipos compatibles.
Esta guía corrige la terminología del artículo original y explica qué puede hacer realmente un proxy, qué hardware conviene, cómo configurarlo con credenciales protegidas y cómo resolver los fallos más habituales.
Respuesta rápida: proxy BLE, no Bluetooth Mesh
| Concepto | Qué significa |
|---|---|
| Bluetooth Proxy | Un ESP32 reenvía anuncios y conexiones BLE a Home Assistant mediante la API de ESPHome. |
| Bluetooth Mesh | Una topología en la que los propios nodos Bluetooth retransmiten mensajes. No es lo que configura bluetooth_proxy:. |
| Integración Bluetooth | Home Assistant reúne automáticamente adaptadores USB y proxies ESPHome disponibles. |
| Integración del dispositivo | BTHome, SwitchBot, Xiaomi BLE u otra integración interpreta los datos. El proxy no los decodifica. |
El nombre del componente puede inducir a pensar que admite cualquier Bluetooth, pero el proxy de ESPHome trabaja con BLE, no con Bluetooth Classic. Antes de comprar hardware, comprueba que el dispositivo aparece en la lista de integraciones compatibles de Home Assistant.
Cuándo merece la pena instalar un Bluetooth Proxy
- Home Assistant está lejos de los sensores Bluetooth o dentro de un armario metálico.
- Hay plantas, muros o habitaciones a las que no llega bien el adaptador USB.
- Quieres varios puntos de recepción y tolerancia a fallos.
- Utilizas dispositivos que anuncian datos pasivamente, como muchos sensores BTHome.
- Necesitas conexiones activas con cerraduras, termostatos u otros equipos GATT compatibles.
No siempre es la solución. Un buen adaptador USB conectado mediante un cable de extensión puede bastar en una vivienda pequeña. Tampoco hará compatible un dispositivo para el que Home Assistant no disponga de integración.
Hardware recomendado y colocación
La opción sencilla es una placa ESP32 con Bluetooth y WiFi. Para instalaciones exigentes, un proxy Ethernet evita que WiFi y BLE compartan radio; ESPHome destaca placas PoE con antena externa como referencia de alto rendimiento. Comprueba siempre que la variante concreta del ESP32 admita los componentes BLE que vas a usar.
- Coloca el proxy cerca de los dispositivos BLE, pero no pegado a ellos.
- Aléjalo de routers, switches, racks, fuentes de alimentación y cajas metálicas. La documentación recomienda unos tres metros respecto a equipos de red cuando sea posible.
- Distribuye varios proxies por zonas en vez de aumentar agresivamente el escaneo de uno solo.
- Usa una fuente y un cable estables: los reinicios por alimentación se confunden fácilmente con problemas de Bluetooth.
Configuración segura de ESPHome
Guarda WiFi, la clave de cifrado de la API y la contraseña OTA en secrets.yaml. Este ejemplo usa ESP-IDF, recomendado por ESPHome para reducir el uso de memoria en un proxy:
substitutions:
device_name: bluetooth-proxy-salon
friendly_name: Bluetooth Proxy Salón
esphome:
name: ${device_name}
friendly_name: ${friendly_name}
esp32:
board: esp32dev
framework:
type: esp-idf
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
logger:
api:
encryption:
key: !secret api_encryption_key
ota:
- platform: esphome
password: !secret ota_password
esp32_ble_tracker:
bluetooth_proxy:Las conexiones activas están habilitadas por defecto. También lo está la caché de servicios GATT. Por eso no necesitas añadir active: true salvo que quieras dejar explícita la intención.
Cuántas conexiones activas admite
connection_slots vale 3 por defecto. Cada ranura consume memoria y una conexión permanente puede ocuparla continuamente. ESPHome permite hasta 9, pero aconseja no superar 5; en Ethernet suelen ser razonables 4. Los anuncios pasivos no consumen estas ranuras.
bluetooth_proxy:
active: true
cache_services: true
connection_slots: 3Aumenta el valor solo si los registros muestran que faltan conexiones y la placa conserva memoria libre. Más ranuras no mejoran la cobertura de radio.
Escaneo activo y pasivo
El escaneo activo solicita información adicional al dispositivo BLE y puede ser necesario durante la incorporación inicial. El pasivo escucha anuncios, reduce tráfico y puede disminuir el consumo de los sensores a batería. Los parámetros de escaneo predeterminados son adecuados para la mayoría de instalaciones.
esp32_ble_tracker:
scan_parameters:
active: falseUsa esta variante solo si todos tus dispositivos funcionan con escaneo pasivo. Evita copiar configuraciones antiguas con ventanas e intervalos extremadamente agresivos: pueden aumentar temperatura, tráfico y problemas WiFi sin aportar una mejora real.
Instalación en Home Assistant
- Crea el dispositivo en ESPHome Device Builder y adapta
board:a tu placa. - Valida el YAML y realiza la primera instalación por USB.
- Cuando aparezca descubierto, añade el nodo mediante la integración ESPHome.
- Abre la integración Bluetooth de Home Assistant y comprueba que el proxy figure como adaptador remoto.
- Añade cada dispositivo BLE mediante su integración específica; no desde el proxy.
- Revisa durante varios días la intensidad, disponibilidad y estabilidad antes de fijar la ubicación definitiva.
Problemas frecuentes
| Síntoma | Qué comprobar |
|---|---|
| El proxy está conectado, pero no aparecen dispositivos | Compatibilidad de la integración, escaneo activo durante la incorporación y distancia. |
| Datos intermitentes | Interferencias, alimentación, muros, ubicación y si conviene añadir otro proxy. |
| Conexiones activas saturadas | Dispositivos que mantienen GATT abierto y valor de connection_slots. |
| Reinicios o falta de memoria | Usar ESP-IDF, quitar web_server y reducir componentes o ranuras. |
| Problemas tras una actualización antigua | ESPHome recomienda actualizar la tabla de particiones NVS si la última instalación serie fue anterior a 2022.12 con ESP-IDF o a 2026.4 con Arduino. |
| Mala recepción cerca del router | Separar el proxy de equipos de red y fuentes de interferencia. |
Guías relacionadas
Fuentes comprobadas
Preguntas frecuentes
¿Necesito un proxy por dispositivo?
No. Un proxy puede recibir anuncios de muchos dispositivos. El límite práctico para conexiones activas depende de las ranuras, la memoria y el comportamiento de cada integración.
¿Puedo reutilizar un ESP32 con sensores?
Sí, si conserva memoria y estabilidad. Para un proxy crítico suele ser mejor una configuración pequeña y dedicada.
¿Funciona con Bluetooth Classic?
No. El componente reenvía Bluetooth Low Energy. Un equipo exclusivamente Bluetooth Classic no será compatible.
La arquitectura más fiable es sencilla: varios proxies bien colocados, configuración predeterminada, ESP-IDF, API cifrada y una integración compatible para cada dispositivo. Eso amplía Bluetooth en Home Assistant sin confundir un proxy BLE con Bluetooth Mesh.
Continúa leyendo
Siguiente guía relacionada · 10 min de lectura
ESP32: guía completa, pinout y ESPHome (2026)
Actualizado el 3 de agosto de 2026. He revisado las especificaciones, los GPIO delicados y todos los ejemplos YAML conforme a la documentación actual…
Continuar con este artículo