_images/logo-text.svg

ESPHome is a system to control your ESP8266/ESP32 by simple yet powerful configuration files and control them remotely through Home Automation systems.

_images/hero.png

Devices¶

This list contains a bunch of getting started and more advanced guides for using ESPHome. Technically, all ESP8266/ESP32 devices are supported by ESPHome.

Generic ESP8266

Generic ESP32

NodeMCU ESP8266

Generic ESP8266

Generic ESP32

NodeMCU ESP8266

NodeMCU ESP32

Sonoff S20

Sonoff 4CH

NodeMCU ESP32

Sonoff S20

Sonoff 4CH

Generic Sonoff

Sonoff Basic

Sonoff T1 UK 3 Gang V1.1

Generic Sonoff

Sonoff Basic

Sonoff T1 UK 3 Gang V1.1

Sonoff T3 EU 3 Gang V1.0

Sonoff T3 EU 3 Gang V1.0

Core Components¶

Core

WiFi

MQTT

Core

WiFi

MQTT

I²C Bus

SPI Bus

UART Bus

I²C Bus

SPI Bus

UART Bus

CAN Bus

OTA Updates

Logger

CAN Bus

OTA Updates

Logger

Web Server

Native API

Power Supply

Web Server

Native API

Power Supply

Deep Sleep

External Components

Deep Sleep

External Components

Sensor Components¶

Sensor Core

ADC

ADE7953

Sensor Core

ADC

ADE7953

ADS1115

AHT10

AM2320

ADS1115

AHT10

AM2320

APDS9960

ATM90E32

AS3935

APDS9960

ATM90E32

AS3935

BH1750

Binary Sensor Map

BLE RSSI

BH1750

Binary Sensor Map

BLE RSSI

BLE Client Sensor

BME280

BME680

BLE Client Sensor

BME280

BME680

BME680 via BSEC

BMP085

BMP280

BME680 via BSEC

BMP085

BMP280

b-parasite

CCS811

CSE7766

b-parasite

CCS811

CSE7766

CS5460A

CT Clamp

Dallas

CS5460A

CT Clamp

Dallas

DHT

DHT12

Duty Cycle

DHT

DHT12

Duty Cycle

ESP32 Hall Sensor

EZO sensor circuits

Havells Solar

ESP32 Hall Sensor

EZO sensor circuits

Havells Solar

HDC1080

HLW8012

HMC5883L

HDC1080

HLW8012

HMC5883L

QMC5883L

Home Assistant

HX711

QMC5883L

Home Assistant

HX711

INA219

INA226

INA3221

INA219

INA226

INA3221

Inkbird IBS-TH1 Mini

Integration

HTU21D

Inkbird IBS-TH1 Mini

Integration

HTU21D

HM3301

MAX31855

MAX31856

HM3301

MAX31855

MAX31856

MAX31865

MAX6675

MCP3008

MAX31865

MAX6675

MCP3008

MCP9808

MH-Z19

MPU6050

MCP9808

MH-Z19

MPU6050

MQTT Subscribe

MS5611

Nextion

MQTT Subscribe

MS5611

Nextion

NTC Thermistor

PMSX003

Pulse Counter

NTC Thermistor

PMSX003

Pulse Counter

Pulse Meter

Pulse Width

PZEM004T

Pulse Meter

Pulse Width

PZEM004T

PZEM AC

PZEM DC

Resistance

PZEM AC

PZEM DC

Resistance

Rotary Encoder

RuuviTag

SenseAir

Rotary Encoder

RuuviTag

SenseAir

SDS011 Sensor

SDM Meter

SCD30

SDS011 Sensor

SDM Meter

SCD30

SHTCx

SHT3X-D

SHT4X

SHTCx

SHT3X-D

SHT4X

SM300D2

SPS30

STS3X

SM300D2

SPS30

STS3X

SGP30

SGP40

TCS34725

SGP30

SGP40

TCS34725

Teleinfo

Template Sensor

TMP102

Teleinfo

Template Sensor

TMP102

TMP117

TOF10120

Total Daily Energy

TMP117

TOF10120

Total Daily Energy

TSL2561

Tuya Sensor

TX20

TSL2561

Tuya Sensor

TX20

Ultrasonic Sensor

Uptime Sensor

VL53L0x

Ultrasonic Sensor

Uptime Sensor

VL53L0x

WiFi Signal Strength

Xiaomi BLE

Xiaomi Miscale

WiFi Signal Strength

Xiaomi BLE

Xiaomi Miscale

Xiaomi Miscale2

ZyAura

Custom Sensor

Xiaomi Miscale2

ZyAura

Custom Sensor

Looking for a sensor that outputs its values as an analog voltage? Have a look at the ADC Sensor together with a formula like in the TEMT6000 example.

Binary Sensor Components¶

Binary Sensor Core

GPIO

Home Assistant

Binary Sensor Core

GPIO

Home Assistant

Status

ESP32 BLE Presence

ESP32 Touch Pad

Status

ESP32 BLE Presence

ESP32 Touch Pad

MPR121  Capacitive Touch Sensor

Nextion Binary Sensor

Template Binary Sensor

MPR121 Capacitive Touch Sensor

Nextion Binary Sensor

Template Binary Sensor

PN532

RC522

RDM6300

PN532

RC522

RDM6300

TTP229

Tuya Binary Sensor

XPT2046

TTP229

Tuya Binary Sensor

XPT2046

Custom Binary Sensor

Custom Binary Sensor

Output Components¶

Output Core

ESP8266 Software PWM

Slow PWM

Output Core

ESP8266 Software PWM

Slow PWM

GPIO Output

ESP32 DAC

ESP32 LEDC

GPIO Output

ESP32 DAC

ESP32 LEDC

AC Dimmer

PCA9685

TLC59208F

AC Dimmer

PCA9685

TLC59208F

MY9231/MY9291

SM16716

SM2135

MY9231/MY9291

SM16716

SM2135

MCP4725

Custom Output

Template Output

MCP4725

Custom Output

Template Output

Light Components¶

Light Core

Binary Light

Monochromatic Light

Light Core

Binary Light

Monochromatic Light

Cold+Warm White Light

RGB Light

RGBW Light

Cold+Warm White Light

RGB Light

RGBW Light

RGBWW Light

FastLED Light

NeoPixelBus Light

RGBWW Light

FastLED Light

NeoPixelBus Light

Light Partition

Tuya Dimmer

Custom Light

Light Partition

Tuya Dimmer

Custom Light

H-bridge Light

H-bridge Light

Looking for WS2811 and similar individually addressable lights? Have a look at the FastLED Light.

Switch Components¶

Switch Core

GPIO Switch

Restart Switch

Switch Core

GPIO Switch

Restart Switch

Shutdown Switch

Generic Output Switch

Template Switch

Shutdown Switch

Generic Output Switch

Template Switch

UART Switch

Custom Switch

Tuya Switch

UART Switch

Custom Switch

Tuya Switch

BLE Client Switch

Nextion Switch

BLE Client Switch

Nextion Switch

Fan Components¶

Fan Core

Binary Fan

Speed Fan

Fan Core

Binary Fan

Speed Fan

Tuya Fan

Tuya Fan

Display Components¶

Display Core

Addressable Light

LCD Display

Display Core

Addressable Light

LCD Display

MAX7219

MAX7219 Dot Matrix

TM1637

MAX7219

MAX7219 Dot Matrix

TM1637

Nextion

SSD1306

SSD1322

Nextion

SSD1306

SSD1322

SSD1325

SSD1327

SSD1331

SSD1325

SSD1327

SSD1331

SSD1351

ST7735

ST7789V

SSD1351

ST7735

ST7789V

ILI9341

Waveshare E-Paper

Inkplate 6

ILI9341

Waveshare E-Paper

Inkplate 6

PCD8544 (Nokia 5110/ 3310)

PCD8544 (Nokia 5110/ 3310)

Cover Components¶

Cover Core

Template Cover

Endstop Cover

Cover Core

Template Cover

Endstop Cover

Time-Based Cover

Custom Cover

Time-Based Cover

Custom Cover

Text Sensor Components¶

Text Sensor Core

Home Assistant

MQTT Subscribe Text

Text Sensor Core

Home Assistant

MQTT Subscribe Text

Version

WiFi Info

BLE Scanner

Version

WiFi Info

BLE Scanner

Template Text Sensor

Custom Text Sensor

Custom UART Text Sensor

Template Text Sensor

Custom Text Sensor

Custom UART Text Sensor

Nextion Text Sensor

Nextion Text Sensor

Climate Components¶

Climate Core

Bang Bang Controller

Thermostat Controller

Climate Core

Bang Bang Controller

Thermostat Controller

Custom Climate

PID Controller

IR Remote Climate

Custom Climate

PID Controller

IR Remote Climate

Tuya Climate

Midea Air Conditioner

Anova Cooker

Tuya Climate

Midea Air Conditioner

Anova Cooker

Number Components¶

Number Core

Template Number

Number Core

Template Number

Misc Components¶

Remote Receiver

Remote Transmitter

Status LED

Remote Receiver

Remote Transmitter

Status LED

HTTP Request

Time

Sun

HTTP Request

Time

Sun

GPS

ESP32 BLE Client

ESP32 BLE Tracker

GPS

ESP32 BLE Client

ESP32 BLE Tracker

ESP32 BLE Beacon

ESP32 Ethernet

ESP32 Camera

ESP32 BLE Beacon

ESP32 Ethernet

ESP32 Camera

Stepper

Servo

PCF8574 I/O Expander

Stepper

Servo

PCF8574 I/O Expander

MCP230XX I/O Expander - I²C Bus

TCA9548A I²C Multiplexer

MCP23SXX I/O Expander - SPI Bus

MCP230XX I/O Expander - I²C Bus

TCA9548A I²C Multiplexer

MCP23SXX I/O Expander - SPI Bus

SX1509 I/O Expander

SN74HC595 I/O Expander

SIM800L

SX1509 I/O Expander

SN74HC595 I/O Expander

SIM800L

DFPlayer

Captive Portal

Improv

DFPlayer

Captive Portal

Improv

Debug Component

TM1651 Battery Display

RF Bridge

Debug Component

TM1651 Battery Display

RF Bridge

Tuya MCU

Exposure Notifications

RTTTL Buzzer

Tuya MCU

Exposure Notifications

RTTTL Buzzer

Prometheus

Grow Fingerprint Reader

Prometheus

Grow Fingerprint Reader

Additional Custom Components¶

Generic Custom Component

Custom I²C Component

Custom SPI Component

Generic Custom Component

Custom I²C Component

Custom SPI Component

Custom UART Component

Custom UART Component

Cookbook¶

Arduino Port Extender

Endstop Cover

PIR Sensor

Arduino Port Extender

Endstop Cover

PIR Sensor

Relay

BRUH Multisensor

TEMT6000

Relay

BRUH Multisensor

TEMT6000

Non-Invasive Power Meter

Dual Relay Motor Cover

BME280 Environment

Non-Invasive Power Meter

Dual Relay Motor Cover

BME280 Environment

Sonoff Fishpond Pump

H801 LED Controller

Time & Temperature on OLED Display

Sonoff Fishpond Pump

H801 LED Controller

Time & Temperature on OLED Display

Mirabella Genio Bulb

Garage Door

Brilliant / Mirabella Genio Smart Plugs

Mirabella Genio Bulb

Garage Door

Brilliant / Mirabella Genio Smart Plugs

Etekcity Voltson (ESW01-EU)

Sonoff iFan02

Zemismart RGBW Downlights

Etekcity Voltson (ESW01-EU)

Sonoff iFan02

Zemismart RGBW Downlights

Teckin SB50

Sonoff light switch options

ESP32 Water Leak Detector

Teckin SB50

Sonoff light switch options

ESP32 Water Leak Detector

ESP32 BLE iTag Button

IAQ (Indoor Air Quality) Board

Custom UART Text Sensor

ESP32 BLE iTag Button

IAQ (Indoor Air Quality) Board

Custom UART Text Sensor

IWOOLE Table Lamp

Ilonda Wifi Smart Fish Feeder

IWOOLE Table Lamp

Ilonda Wifi Smart Fish Feeder

Do you have other awesome automations or cool setups? Please feel free to add them to the documentation for others to copy. See Contributing.