ESPHome

Home View the repo

ESPHome is a firmware project designed for ESP-based hardware.

auto-summary

12140 stars · 5831 forksGitHub repo · as of 2026-11-21 11:07 UTC

Maintainer
esphome
License
MIT AND GPL-3.0-only
Distribution
web-flasheresp-web-tools
Capabilities
wifiethernetblebluetooth-proxymqttotaon-device-web-uidisplay
Chip families
esp32esp32-s2esp32-s3esp32-c2esp32-c3esp32-c5esp32-c6esp32-h2esp32-p4

Boards with a recipe, by trust tier

Known good

  • ESP32-C5-DevKitC-1Known goodEspressifweb flasher
    Flash ESP32-C5-DevKitC-1web flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: ESPHome's `esp32:` component targets a standard Espressif devkit per chip variant by default; the ESP32-C5-DevKitC-1 is that reference board for `variant: esp32c5`, so any esphome YAML with that variant (or no board override) runs on it unmodified. Verified on real hardware 2026-09-01: ESPHome 2026.8.2 (`framework: esp-idf`, ESP-IDF 5.5.5) compiled for `variant: esp32c5`, flashed as the factory image at 0x0 with esptool 5.3.0 over the USB-to-UART port; boots and logs `ESP32 Chip: ESP32-C5 rev1.2`, and drives the onboard GPIO27 WS2812 through `esp32_rmt_led_strip`. Note: the same chip revision answers CHIP magic 0x30e1706f, which the in-browser flashers (esptool-js 0.6.1) do not recognise -- web.esphome.io could not detect it; the CLI + esptool path works.

  • Inkplate 10Known goodSolderedweb flasher
    Flash Inkplate 10web flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Supported by ESPHome's official Inkplate display component (`inkplate_10` model).

  • Inkplate 6Known goodSolderedweb flasher
    Flash Inkplate 6web flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Supported by ESPHome's official Inkplate display component (`inkplate_6` / `inkplate_6_v2` models).

Reported

  • WiFi LoRa 32 (V3)ReportedHeltecweb flasher
    Flash WiFi LoRa 32 (V3)web flasherread the caveat

    Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Community-contributed configuration including the SX1262 LoRa radio, OLED and battery ADC.

  • T-Display-S3ReportedLILYGOweb flasher
    Flash T-Display-S3web flasherread the caveat

    Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Community-contributed configuration for the non-touch variant (ST7789 display).

  • T-Dongle-S3ReportedLILYGOweb flasher
    Flash T-Dongle-S3web flasherread the caveat

    Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Community-contributed configuration for the ST7735 display, button and SPI LED.

  • AtomS3-LiteReportedM5Stackweb flasher
    Flash AtomS3-Liteweb flasherread the caveat

    Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Community-contributed configuration for the RGB LED, button and IR transmitter.

  • DialReportedM5Stackweb flasher
    Flash Dialweb flasherread the caveat

    Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Community-contributed configuration covering the display, touch, rotary encoder, NFC reader and buzzer.

  • NanoC6ReportedM5Stackweb flasher
    Flash NanoC6web flasherread the caveat

    Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Community-contributed configuration for Wi-Fi, the LEDs, button and IR transmitter.

  • Core2ReportedM5Stackweb flasher
    Flash Core2web flasherread the caveat

    Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Community-contributed configuration covering the AXP192 power management, display, touchscreen, IMU and RTC; the entry notes the speaker does not work.

  • CoreS3ReportedM5Stackweb flasher
    Flash CoreS3web flasherread the caveat

    Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Community-contributed configuration covering the display, touch, AXP2101 PMU and IO expander.

  • StickC-Plus2ReportedM5Stackweb flasher
    Flash StickC-Plus2web flasherread the caveat

    Reported esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Community-contributed configuration covering the display, IMU, buttons, buzzer, microphone and battery monitoring.

Unverified

  • ESP32-C6-DevKitC-1UnverifiedEspressifweb flasher
    Flash ESP32-C6-DevKitC-1web flasherread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: ESPHome's `esp32:` component targets a standard Espressif devkit per chip variant by default; the Espressif ESP32-C6-DevKitC-1 is that reference board for `variant: esp32c6`, so any esphome YAML with that variant (or no board override) runs on it unmodified.

  • ESP32-DevKitC V4UnverifiedEspressifweb flasher
    Flash ESP32-DevKitC V4web flasherread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: ESPHome's `esp32:` component targets a standard Espressif devkit per chip variant by default; the Espressif ESP32-DevKitC-V4 is that reference board for plain esp32, so any esphome YAML with `variant: esp32` (or no board override) runs on it unmodified.

  • ESP32-S3-DevKitC-1UnverifiedEspressifweb flasher
    Flash ESP32-S3-DevKitC-1web flasherread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: ESPHome's `esp32:` component targets a standard Espressif devkit per chip variant by default; the Espressif ESP32-S3-DevKitC-1 is that reference board for `variant: esp32s3`, so any esphome YAML with that variant (or no board override) runs on it unmodified.