ESPHome Bluetooth Proxy: configuración YAML para llevar BLE a Home Assistant
Un Bluetooth proxy es un ESP32 que escucha anuncios Bluetooth Low Energy (BLE) en tu casa y se los entrega a Home Assistant para que integres sensores sin pasar por la nube de ningún fabricante. Te evita comprar un hub por protocolo y deja el alcance en tu red local.
Última revisión: 26/10/2026
Qué hace y qué no hace
- Hace: recibe los paquetes BLE que emiten sensores de temperatura, botones, tags de presencia y similares, y los publica en Home Assistant por la API de ESPHome, sin nube.
- Hace: amplía la cobertura Bluetooth de Home Assistant a una zona concreta donde pongas el ESP32.
- No hace: audio Bluetooth. Ni convierte automáticamente cualquier dispositivo BLE: solo los que Home Assistant sabe interpretar por Bluetooth.
- No hace: mantener conexiones activas largas con todos los dispositivos; su punto fuerte es escuchar los anuncios pasivos, no sustituir un dongle con drivers a medida.
YAML completo para un ESP32
Este es el mínimo que le pido a un nodo de pruebas. Los valores de scan_parameters sin confirmar a fecha de 26/10 los dejo comentados para que uses la base y ajustes según tu caso.
esphome:
name: ble-proxy
friendly_name: BLE Proxy
esp32:
board: esp32dev
framework:
type: arduino
logger:
api:
encryption:
key: "TU_CLAVE_DE_32_BYTES"
ota:
- platform: esphome
password: "TU_PASSWORD_OTA"
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
esp32_ble_tracker:
bluetooth_proxy:
active: true
active: true hace que el proxy funcione también en modo de escucha activa. Gasta más batería si alimentas el ESP32 con una, pero muchos sensores solo se ven con el rastreo activo encendido. Si solo te interesan balizas que emiten en abierto, puedes probar sin la línea active.
Integración en Home Assistant
- Conecta el ESP32 por USB y fláshealo con ESPHome.
- Adopta el dispositivo desde Ajustes → Dispositivos y servicios → ESPHome.
- Espera unos minutos: Home Assistant detecta el proxy y los dispositivos Bluetooth que va oyendo aparecen en la integración Bluetooth.
- Pon el ESP32 cerca de los sensores que quieras integrar, no al lado del router: la cobertura Bluetooth no se soluciona con mejor WiFi.
Límites reales que encontré
- Un ESP32 es un receptor puntual. En una casa con dos plantas no esperes que un solo proxy vea el sensor del garaje y el del baño.
- Los dispositivos que requieren emparejamiento previo o cifrado no aparecen por arte de magia: Home Assistant tiene que tener soporte para ese modelo concreto.
- Algunos ESP32 con Bluetooth y WiFi a la vez sufren interrupciones de escaneo; si faltan lecturas, alimenta el nodo por cable y comprueba la fuente de corriente, no solo el rango.
- No lo confundas con un coordinador Zigbee: aunque la placa tenga BLE, no te va a enlazar sensores Zigbee.
| Componente | Mínimo |
|---|---|
| Placa | ESP32 con BLE (ESP32 clásico, S3 o C3) |
| ESPHome | 2026.10 o una versión reciente con bluetooth_proxy |
| Home Assistant | Con la integración ESPHome y Bluetooth activas |
| Red | WiFi local; no necesita Internet para funcionar |
Suscríbete
Cada domingo un YAML nuevo ya probado y el aviso cuando una integración local se rompe tras actualizar. Lo prometido existe: mira las plantillas YAML.