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
esphome:
name: awesome
esp32:
board: nodemcu-32s
Next steps
Keeping up
Platforms¶
|
|
|
Core Components¶
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Sensor Components¶
Sensors are split into categories. If a sensor fits into more than one category, it will be listed multiple times.
Core¶
|
|
|
|
|
|
|
|
|
Air Quality¶
|
|
|
|
Radon |
CO2 & Volatile organics |
CO2 & Temperature & Pressure |
|
|
|
|
Particulate |
CO2 & Temperature |
Gas concentration |
|
|
|
|
Particulate |
Particulate |
Particulate |
|
|
|
|
Radon |
Particulate |
Temperature & Humidity |
|
|
|
|
CO2 |
CO2 & Temperature & Humidity |
CO2 & Temperature & Humidity |
|
|
|
|
CO2 & Volatile organics |
Volatile organics and NOx |
Air quality |
|
|
|
|
Particulate |
CO2 |
CO2 & Temperature & Humidity |
Analogue¶
|
|
|
|
ESP internal |
8-channel ADC |
4-channel ADC |
|
|
|
|
16-channel analog multiplexer |
8-channel ADC |
4-channel ADC |
|
||
Bluetooth Low Energy (BLE)¶
|
|
|
|
Lux & Battery level |
||
|
|
|
|
Temperature & Humidity |
tank level |
tank level |
|
|
|
|
Temperature & Humidity & Accelerometer |
Various |
Digital Signals¶
|
|
|
|
||
Distance¶
|
|
|
|
Acoustic distance |
IR optical distance |
Acoustic distance |
|
||
|
IR optical distance |
Electricity¶
|
|
|
|
Power |
Voltage & Current & Power |
Voltage & Current & Power & Energy |
|
|
|
|
Voltage & Current & Power |
Voltage & Current & Power |
Voltage & Current & Power |
|
|
|
|
Voltage & Current & Power |
Voltage & Current & Power |
AC current |
|
|
|
|
Voltage & Current & Power |
Electrical counter |
Voltage & Current & Power |
|
|
|
|
DC Current |
DC Current & Power |
DC Current & Power |
|
|
|
|
3-Ch DC current |
+60VDC Voltage & Current & Power & Temperature |
Voltage & Current & Power |
|
|
|
|
Voltage & Current & Power |
Voltage & Current & Power |
Modbus energy monitor |
|
|
|
|
Modbus energy monitor |
Electrical counter |
Environmental¶
|
|
|
|
Temperature & Humidity |
Temperature & Humidity & Pressure |
|
|
|
|
|
Temperature & Humidity |
Temperature & Humidity & Pressure |
Temperature & Humidity & Pressure & Gas |
|
|
|
|
Temperature & Humidity & Pressure & Gas |
Temperature & Pressure |
Temperature & Pressure |
|
|
|
|
Temperature & Pressure |
Moisture & Temperature & Humidity & Light |
Temperature |
|
|
|
|
Temperature & Humidity |
Temperature & Humidity |
Temperature & Pressure |
|
|
|
|
Temperature & Humidity |
Temperature & Humidity |
Temperature & Humidity |
|
|
|
|
Pressure & Temperature |
Temperature & Humidity |
Rain |
|
|
|
|
Temperature & Humidity |
Temperature |
Temperature |
|
|
|
|
CO2 & Temperature |
Temperature |
Temperature & Pressure |
|
|
|
|
Pressure |
Temperature |
Temperature & Pressure |
|
|
|
|
Radon |
Temperature & Humidity & Accelerometer |
CO2 & Temperature & Humidity |
|
|
|
|
CO2 & Temperature & Humidity |
Pressure |
Temperature & Humidity |
|
|
|
|
Temperature & Humidity |
Temperature & Humidity |
Moisture & Temperature |
|
|
|
|
Temperature |
Temperature |
Temperature |
|
|
|
|
Temperature |
Temperature & Humidity |
Light¶
|
|
|
|
Lux |
Colour & Gesture |
Spectral Color Sensor |
|
|
|
|
Lux |
Lux & UV |
Lux |
|
|
|
|
Lux & RGB colour |
Lux |
Lux |
Magnetic¶
|
|
|
|
ESP internal |
3-Axis magnetometer |
3-Axis magnetometer |
|
|
|
|
3-Axis magnetometer |
3-Axis magnetometer |
Miscellaneous¶
|
|
|
|
Storm lightning |
Map binary to value |
Moisture & Temperature & Humidity & Light |
|
|
|
|
(pH) |
Air velocity |
Solar rooftop |
|
|
|
|
Solar rooftop |
||
|
|
|
|
Sensors from display |
Moisture & Temperature |
|
|
|
|
|
Wind speed & Wind direction |
EC & Temperature |
|
|
|
|
|
pH & Temperature |
||
|
||
Motion¶
|
|
|
|
Colour & Gesture |
Accelerometer & Gyroscope |
Accelerometer & Gyroscope |
|
|
|
|
Temperature & Humidity & Accelerometer |
Motion & Presence |
Thermocouple¶
|
|
|
|
K-Type |
All types |
Platinum RTD |
|
|
|
|
K-Type |
All types |
Weight¶
|
|
|
|
Load cell amplifier |
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 configuration.
Binary Sensor Components¶
Binary Sensors are split into categories. If a sensor fits into more than one category, it will be listed multiple times.
Core¶
|
|
|
|
|
|
Capacitive Touch¶
|
|
|
|
||
Mechanical¶
|
|
|
NFC/RFID Components¶
Often known as “tag” or “card” readers within the community.
|
|
|
Touchscreen¶
|
|
|
Miscellaneous¶
|
|
|
|
|
|
|
|
|
Output Components¶
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
||
Light Components¶
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
||
Looking for WS2811 and similar individually addressable lights? Have a look at the FastLED Light.
Switch Components¶
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Button Components¶
|
|
|
|
|
|
|
|
|
Fan Components¶
|
|
|
|
|
|
Display Components¶
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Touchscreen Components¶
|
|
|
|
Inkplate 6 Plus |
Cover Components¶
|
|
|
|
|
|
|
|
|
Text Sensor Components¶
|
|
|
|
|
|
|
|
|
|
|
|
|
||
Climate Components¶
|
|
|
|
|
|
|
|
|
|
|
|
Number Components¶
|
|
|
|
||
Select Components¶
|
|
|
|
||
Lock Components¶
|
|
|
Media Player Components¶
|
|
|
Microphone Components¶
|
|
|
Speaker Components¶
|
|
|
Time Components¶
|
|
|
|
|
|
Home Assistant Companion Components¶
|
|
|
|
|
|
Miscellaneous Components¶
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
||
Additional Custom Components¶
|
|
|
|
||
Cookbook¶
|
|
|
|
|
|
|
|
|
|
||
Do you have other awesome automations or cool setups? Please feel free to add them to the documentation for others to copy. See Contributing.
If you’d like to share configurations for specific devices, please contribute to our ESPHome Devices database.