ESPHome

Platform / DIY firmware

Updated

What works with ESPHome?

ESPHome is open-source firmware for ESP32, ESP8266 and similar chips, built from a YAML description. ESPHome devices connect to Home Assistant locally over its native API. Newer chips can also join Zigbee or Thread networks.[1–4]

Capabilities

What ESPHome supports

7 capabilitiesHow facts are sourced: every cell cites its source below
What ESPHome supports
CapabilitySupportedSince
Wi-Fi with local controlYes[1] (Every ESPHome device works with Home Assistant locally and privately.)unknown
Bluetooth proxyYes[5] (The Bluetooth proxy component forwards BLE advertisements and active connections to Home Assistant. BLE only.)unknown
Home Assistant native integrationYes[6]unknown
Matter over Wi-Fiunknownunknown
ZigbeeYes[3] (As a Zigbee end device or router on ESP32-C5, C6, H2 and nRF52, Home Automation profile only. ZHA or Zigbee2MQTT is the coordinator.)unknown
Thread network nodeYes[4] (OpenThread component on ESP32-C5, C6, H2 and nRF52840. Needs a Thread border router.)unknown
MQTT (local)Yes[7] (Alternative to the native API.)unknown

What it is

ESPHome is firmware, not a hub. A device is described in a YAML file or the visual Device Builder, and ESPHome generates and flashes the firmware. It targets ESP32, ESP8266 and RP2040/RP2350 boards, plus BK72xx, RTL87xx, LN882 and nRF52 chips found in many off-the-shelf plugs and bulbs. After the first flash, updates can go over the air.[1][8]

The hub is whatever the device talks to, which in practice is Home Assistant. Its ESPHome integration discovers ESPHome devices and controls them over the local network.[1][6]

Which paths it supports

The native API is a compact protocol-buffer connection with no broker in between. MQTT is available as an alternative.[2][7]

On ESP32-C5, C6 and H2 and on nRF52, ESPHome can join a Zigbee network as an end device or router, with ZHA or Zigbee2MQTT as the coordinator. It supports the Home Automation profile only. The same chips can join a Thread network through ESPHome's OpenThread component, which needs a Thread border router.[3][4]

The Bluetooth proxy turns an ESP32 into a remote Bluetooth LE radio for Home Assistant. It forwards advertisements and, on ESP32 and RP2040, active connections.[5]

Local or cloud

ESPHome devices work with Home Assistant locally, with no cloud account involved.[1][6]

Limitations

Devices that list ESPHome

Devices that work with ESPHome

6 devicesHow facts are sourced: every cell cites its source below
Devices that work with ESPHome
DevicePathSupportiIntegrationHome AssistantHomey
Espressif ESP32-DevKitCDIY firmwareNative[9]-Workaroundunknown
Konnected Alarm Panel Pro (Board Only)Size or finish of the Konnected Alarm Panel Pro 12-Zone Conversion KitWi-Fi localNative[10][11]-Native (local)unknown
Konnected Alarm Panel Pro 12-Zone Conversion KitWi-Fi localNative[10][11]-Native (local)unknown
Konnected Alarm Panel Pro 12-Zone Interface KitSize or finish of the Konnected Alarm Panel Pro 12-Zone Conversion KitWi-Fi localNative[10][11]-Native (local)unknown
Konnected Smart Garage Door Opener blaQWi-Fi localNative[10]-Native (local)Community app
Konnected Smart Garage Door Opener White (v2)Wi-Fi localNative[10]-unknown
About these columns
Support
Native means the platform controls the device on this path out of the box. Via integration means it needs an add-on. Not supported means it does not work on this platform.

Sources

  1. [1]
    DOCesphome.io / ESPHome - Smart Home Made Simple
    Accessed Back to text
  2. [2]
    DOCesphome.io / Native API Component - ESPHome
    Accessed Back to text
  3. [3]
    DOCesphome.io / Zigbee Component - ESPHome
    Accessed Back to text
  4. [4]
    DOCesphome.io / OpenThread Component - ESPHome
    Accessed Back to text
  5. [5]
    DOCesphome.io / Bluetooth Proxy - ESPHome
    Accessed Back to text
  6. [6]
    DOChome-assistant.io / ESPHome - Home Assistant
    Accessed Back to text
  7. [7]
    DOCesphome.io / MQTT Client Component - ESPHome
    Accessed Back to text
  8. [8]
    DOCesphome.io / OTA Update Component - ESPHome
    Accessed Back to text
  9. [9]
    DOCesphome.io / ESPHome: Bluetooth Proxy
    Accessed Back to text
  10. [10]
    DOChome-assistant.io / Konnected - Home Assistant
    Accessed Back to text
  11. [11]