Source: ESPHome bluetooth_proxy (docs oficial)¶

Documentación canónica del component que resuelve el range de BLE para HA. Hardware preferido: Olimex ESP32-PoE-ISO (Ethernet, 4 connection slots reliables) o ESP32 estándar con WiFi (3 slots). Framework esp-idf no arduino. Placement: lejos de routers/switches al menos 3m.

Por qué entró al wiki¶

Cierra el gap "Patrón concreto de ESPHome BLE Proxies" identificado en ../entities/bluetooth-le.
Configuration verbatim usable en el setup del usuario.
Hardware recommendations concretas.

Páginas derivadas¶

Update ../entities/bluetooth-le con la config concreta.
Update ../entities/switchbot con hardware recommendation para proxies.
New: ../concepts/esphome-ble-proxy-pattern como técnica reusable.

Takeaways accionables¶

Hardware recommendation 2026¶

Tier	Hardware	Slots	Cost	Notas
Premium	Olimex ESP32-PoE-ISO	4 ethernet	~$30	Ethernet, no WiFi noise, PoE = un solo cable
Standard	ESP32 dev board + USB power	3 WiFi	~$5-10	Default; works fine para cobertura básica
Compacto	M5StickC Plus2	3 WiFi	~$15-20	Display útil para debug; less reliable WiFi en algunos casos

Config canónica (usar esta literal)¶

WiFi básico:

esp32_ble_tracker:
bluetooth_proxy:
  active: true

Ethernet con 4 slots (Olimex):

bluetooth_proxy:
  active: true
  connection_slots: 4

No exceder 5 slots según docs.

Placement rules¶

Lejos de routers/switches (≥3m).
Lejos de microondas, baby monitors.
Centro de cuarto mejor que esquina.
Distribución típica casa de 100m²: 3-4 proxies (cocina, living, dormitorio principal, garage).

Active vs passive scanning¶

Default active: true: el ESP32 hace probing. Mejor reach con devices que requieren conexión.
active: false si problemas o devices battery-sensitive: solo lee broadcasts.
Trade-off: active = más cobertura, passive = menos drain en BLE devices.

Citas¶

"Home Assistant can expand its Bluetooth reach by communicating through the Bluetooth proxy component in ESPHome."
"It is recommended not to exceed 5 connection slots to avoid stability and memory issues."
"Avoid placing the ESP node in racks, close to routers/switches or other network equipment."

Implicancia para el setup¶

3-4 Olimex ESP32-PoE-ISO en puntos estratégicos = $90-120 total para cobertura BLE completa en una casa.

Si ya hay ESP32 estándar disponibles (dev boards, M5Stick, etc.), aprovecharlos antes de comprar Ethernet.

Abierto / gaps¶

¿Cómo se monitorea el health de cada proxy (Gatus check)? Probable: HA Integration "ESPHome" reporta status.
Patrón de OTA updates batch para múltiples proxies al mismo tiempo.
Comparativa LD2410 ESPHome (presence) vs Aqara FP2 — gap en sensor recommendations.