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

Getting started

• from Home Assistant
• using the command line
• by migrating from Tasmota

            esphome:
              name: awesome
            esp32:
              board: nodemcu-32s
        

Next steps

• FAQ and Tips
• Automations
• DIY Examples
• Configuration types
• Sharing ESPHome devices
• Made for ESPHome program

Keeping up

• Discord
• Forums
• Changelog
• Supporters
• Contributing

Platforms

ESP8266	ESP32	RP2040

Core Components

Core	WiFi	MQTT
Network	I²C Bus	SPI Bus
UART Bus	CAN Bus	OTA Updates
Logger	Web Server	Native API
Power Supply	Deep Sleep	External Components

Sensor Components

Sensors have been split into categories. If a sensor fits into more than one category, it will be listed multiple times.

Core

Sensor Core	Home Assistant	Integration
MQTT Subscribe	Uptime Sensor	WiFi Signal Strength
Template Sensor	Custom Sensor

Air Quality

AirThings BLE Radon	CCS811 CO2 & Volatile organics	EE895 CO2 & Temperature & Pressure
HM3301 Particulate	MH-Z19 CO2 & Temperature	MiCS-4514 Gas concentration
PM1006 Sensor Particulate	PMSA003I Particulate	PMSX003 Particulate
RadonEye BLE Radon	SDS011 Sensor Particulate	SEN5x Temperature & Humidity
SenseAir CO2	SCD30 CO2 & Temperature & Humidity	SCD4X CO2 & Temperature & Humidity
SGP30 CO2 & Volatile organics	SGP4x Volatile organics and NOx	SM300D2 Air quality
SPS30 Particulate	T6613/15 CO2	ZyAura CO2 & Temperature & Humidity

Analogue

ADC ESP internal	ADC128S102 8-channel ADC	ADS1115 4-channel ADC
CD74HC4067 16-channel analog multiplexer	MCP3008 8-channel ADC	MCP3204/MCP3208 4-channel ADC
Resistance

Bluetooth Low Energy (BLE)

AM43 Lux & Battery level	BLE Client Sensor	BLE RSSI
Inkbird IBS-TH1 Mini Temperature & Humidity	Mopeka Pro Check LP tank level	Mopeka Standard Check LP tank level
RuuviTag Temperature & Humidity & Accelerometer	Xiaomi BLE Various

Digital Signals

Duty Cycle	Pulse Counter	Pulse Meter
Pulse Width

Distance

HRXL MaxSonar WR Acoustic distance	TOF10120 IR optical distance	Ultrasonic Sensor Acoustic distance
VL53L0x IR optical distance

Electricity

ADE7953 Power	ATM90E32 Voltage & Current & Power	BL0939 Voltage & Current & Power & Energy
BL0940 Voltage & Current & Power	BL0942 Voltage & Current & Power	CS5460A Voltage & Current & Power
CSE7761 Voltage & Current & Power	CSE7766 Voltage & Current & Power	CT Clamp AC current
Daly BMS Voltage & Current & Power	DSMR Electrical counter	HLW8012 Voltage & Current & Power
INA219 DC Current	INA226 DC Current & Power	INA260 DC Current & Power
INA3221 3-Ch DC current	MAX9611 +60VDC Voltage & Current & Power & Temperature	PZEM AC Voltage & Current & Power
PZEM DC Voltage & Current & Power	PZEM004T Voltage & Current & Power	SDM Meter Modbus energy monitor
Selec Meter Modbus energy monitor	Teleinfo Electrical counter	Total Daily Energy

Environmental

Absolute Humidity	AHT10 / AHT20 / AHT21 / DHT20 Temperature & Humidity	AirThings BLE Temperature & Humidity & Pressure
AM2320 Temperature & Humidity	BME280 Temperature & Humidity & Pressure	BME680 Temperature & Humidity & Pressure & Gas
BME680 via BSEC Temperature & Humidity & Pressure & Gas	BMP085 Temperature & Pressure	BMP280 Temperature & Pressure
BMP388 and BMP390 Temperature & Pressure	b-parasite Moisture & Temperature & Humidity & Light	Dallas DS18B20 Temperature
DHT Temperature & Humidity	DHT12 Temperature & Humidity	DPS310 Temperature & Pressure
ENS210 Temperature & Humidity	HDC1080 Temperature & Humidity	HTE501 Temperature & Humidity
Honeywell ABP Pressure & Temperature	HTU21D / Si7021 / SHT21 Temperature & Humidity	Hydreon Rain Sensor Rain
Inkbird IBS-TH1 Mini Temperature & Humidity	Internal Temperature Temperature	MCP9808 Temperature
MH-Z19 CO2 & Temperature	MPL3115A2 Temperature & Pressure	MS5611 Pressure
NTC Thermistor Temperature	QMP6988 Temperature & Pressure	RadonEye BLE Radon
RuuviTag Temperature & Humidity & Accelerometer	SCD30 CO2 & Temperature & Humidity	SCD4X CO2 & Temperature & Humidity
SDP3x / SDP800 Series Pressure	SHT3X-D Temperature & Humidity	SHT4X Temperature & Humidity
SHTCx Temperature & Humidity	SMT100 Moisture & Temperature	STS3X Temperature
TEE501 Temperature	TMP102 Temperature	TMP117 Temperature

Light

AM43 Lux	APDS9960 Colour & Gesture	AS7341 Spectral Color Sensor
BH1750 Lux	LTR390 Lux & UV	MAX44009 Lux
TCS34725 Lux & RGB colour	TSL2561 Lux	TSL2591 Lux

Magnetic

ESP32 Hall Sensor ESP internal	HMC5883L 3-Axis magnetometer	MLX90393 3-Axis magnetometer
QMC5883L 3-Axis magnetometer

Miscellaneous

AS3935 Storm lightning	Binary Sensor Map Map binary to value	b-parasite Moisture & Temperature & Humidity & Light
EZO sensor circuits (pH)	FS3000 Air velocity	Havells Solar Solar rooftop
Growatt Solar Solar rooftop	Kalman Combinator	Modbus Sensor
Nextion Sensors from display	Rotary Encoder	SMT100 Moisture & Temperature
Tuya Sensor	TX20 Wind speed & Wind direction	uFire EC sensor EC & Temperature
uFire ISE sensor pH & Temperature	Resol VBus	Person Sensor (SEN21231)
Kuntze pool sensor

Motion

APDS9960 Colour & Gesture	MPU6050 Accelerometer & Gyroscope	MPU6886 Accelerometer & Gyroscope
RuuviTag Temperature & Humidity & Accelerometer	LD2410 Motion & Presence

Thermocouple

MAX31855 K-Type	MAX31856 All types	MAX31865 Platinum RTD
MAX6675 K-Type	MCP9600 All types

Weight

HX711 Load cell amplifier	Xiaomi Miscale

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
Status	Analog Threshold	ESP32 BLE Presence
ESP32 Touch Pad	Hydreon Rain Sensor Binary Sensor	MPR121 Capacitive Touch Sensor
Nextion Binary Sensor	Template Binary Sensor	PN532
RC522	RDM6300	TTP229
Tuya Binary Sensor	Modbus Binary Sensor	XPT2046
CAP1188 Capacitive Touch Sensor	Touchscreen	Resol VBus
LD2410	Custom Binary Sensor

Output Components

Output Core	ESP8266 Software PWM	Slow PWM
GPIO Output	ESP32 DAC	ESP32 LEDC
AC Dimmer	PCA9685	TLC59208F
TLC5947	MY9231/MY9291	SM16716
SM2135	SM2235	SM2335
MCP4725	MCP4728	MCP47A1
DAC7678	BLE Binary Output	Modbus Output
Custom Output	Sigma-Delta Output	Template Output
BP1658CJ	BP5758D	X9C Potentiometer

Light Components

Light Core	Binary Light	Status Led
Monochromatic Light	Cold+Warm White Light	Color Temperature Light
RGB Light	RGBW Light	RGBWW Light
RGBCT Light	FastLED Light	NeoPixelBus Light
Light Partition	Tuya Dimmer	Shelly Dimmer
Custom Light	H-bridge Light	Sonoff D1 Dimmer

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

Switch Components

Switch Core	GPIO Switch	Restart Switch
Safe Mode Switch	Shutdown Switch	Factory Reset Switch
Generic Output Switch	Template Switch	UART Switch
Custom Switch	Tuya Switch	Modbus Switch
BLE Client Switch	Nextion Switch

Button Components

Button Core	Template Button	Generic Output Button
Restart Button	Safe Mode Button	Shutdown Button
Factory Reset Button	Wake-on-LAN

Fan Components

Fan Core	Binary Fan	H-bridge Fan
Speed Fan	Tuya Fan

Display Components

Display Core	Addressable Light	LCD Display
MAX7219	MAX7219 Dot Matrix	TM1621
TM1637	TM1638	Nextion
PVVX MiThermometer	SSD1306	SSD1322
SSD1325	SSD1327	SSD1331
SSD1351	ST7735	ST7789V
ST7920	ILI9xxx	Waveshare E-Paper
Inkplate	PCD8544 (Nokia 5110/ 3310)

Touchscreen Components

Touchscreen Core	EKTF2232 Inkplate 6 Plus	Lilygo T5 4.7”

Cover Components

Cover Core	Template Cover	Feedback Cover
Endstop Cover	Current-Based Cover	Time-Based Cover
Custom Cover	AM43 Cover	Tuya Cover

Text Sensor Components

Text Sensor Core	Home Assistant	MQTT Subscribe Text
Version	WiFi Info	Ethernet Info
BLE Scanner	Modbus Text Sensor	Template Text Sensor
Custom Text Sensor	Nextion Text Sensor	Tuya Text Sensor
WL-134 Pet Tag Sensor

Climate Components

Climate Core	Bang Bang Controller	Thermostat Controller
Custom Climate	PID Controller	IR Remote Climate
Tuya Climate	Midea	Anova Cooker
BedJet Climate System	Haier Climate

Number Components

Number Core	Modbus Number	Template Number
Tuya Number

Select Components

Select Core	Template Select	Modbus Select
Tuya Select

Lock Components

Lock Core	Generic Output Lock	Template Lock

Media Player Components

Media Player Core	I2S Audio

Time Components

Time Core	Home Assistant Time	SNTP
GPS Time	DS1307 RTC	PCF85063 RTC

Misc Components

Remote Receiver	Remote Transmitter	Status LED
Display Menu Core	LCD Menu	Matrix Keypad
Wiegand Reader	HTTP Request	mDNS
Sun	GPS	Bluetooth Proxy
ESP32 BLE Client	ESP32 BLE Tracker	ESP32 BLE Beacon
ESP32 Ethernet	ESP32 Camera	ESP32 Camera Web Server
Stepper	Servo	Sprinkler
PCA9554 I/O Expander	PCF8574 I/O Expander	MCP230XX I/O Expander - I²C Bus
TCA9548A I²C Multiplexer	MCP23SXX I/O Expander - SPI Bus	SX1509 I/O Expander
SN74HC165 I/O Expander	SN74HC595 I/O Expander	SIM800L
DFPlayer	Captive Portal	Improv via BLE
Improv via Serial	Debug Component	TM1651 Battery Display
RF Bridge	Tuya MCU	Modbus Controller
Exposure Notifications	RTTTL Buzzer	Prometheus
PipSolar - compatible PV Inverter	Grow Fingerprint Reader	SML
Atlas Scientific Peristaltic Pump	Resol VBus	Demo
Copy

Additional Custom Components

Generic Custom Component	Custom I²C Component	Custom SPI Component
Custom UART Component

Cookbook

Arduino Port Extender	Endstop Cover	PIR Sensor
Relay	BRUH Multisensor	TEMT6000
Non-Invasive Power Meter	Dual Relay Motor Cover	BME280 Environment
Sonoff Fishpond Pump	H801 LED Controller	Time & Temperature on OLED Display
Mirabella Genio Bulb	Garage Door	Brilliant / Mirabella Genio Smart Plugs
Etekcity Voltson (ESW01-EU)	Sonoff iFan02	Zemismart RGBW Downlights
Teckin SB50	Sonoff light switch options	ESP32 Water Leak Detector
ESP32 BLE iTag Button	IAQ (Indoor Air Quality) Board	TUYA Smart Life RGBW Controller
Custom UART Text Sensor	IWOOLE Table Lamp	EPEVER Tracer
Ilonda Wifi Smart Fish Feeder	AirGradient DIY Air Quality Sensor	Geiger Counter
EHMTX a matrix status/text display

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