This is the top-level ESPHome documentation index. Browse the tables below, use the sidebar menu, or the search function to find the information you’re looking for.
ESPHome Configuration
ESPHome is configured in YAML files - use these links for basic and advanced information about ESPHome configuration files.
Supported Microcontrollers
Microcontroller Peripherals
Peripherals which directly support the operation of the microcontroller’s processor(s).
ESPHome Automations
“When this happens, I want it to do that…”
Automations are how we customize ESPHome devices to respond/behave exactly how you want them to.
ESPHome Components
ESPHome-specific components or components supporting ESPHome device provisioning post-installation.
Network Hardware
Network Protocols
Bluetooth/BLE
Management and Monitoring
Update Installation
Install updates over-the-air (OTA).
Update Management
Create update entities simplifying management of OTA updates.
Hardware Peripheral Interfaces/Busses
I/O Expanders/Multiplexers
1-Wire Bus
Platforms which specifically support or extend the 1-Wire Bus, allowing communication with 1-Wire-based devices.
CAN Bus
Platforms which specifically support or extend the CAN Bus, allowing communication with CAN-based devices.
Sensor Components
Sensors are organized into categories; if a given sensor fits into more than one category, it will appear multiple times.
Core
Air Quality
Analogue
Bluetooth Low Energy (BLE)
Digital Signals
Distance
Electricity
Environmental
Health/Safety
Light
Magnetic
Miscellaneous
Motion
Thermocouple
Weight
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 <https://devices.esphome.io/devices/temt6000>__.Binary Sensor Components
Binary Sensors are organized into categories; if a given sensor fits into more than one category, it will appear multiple times.
Core
Capacitive Touch
Mechanical
NFC/RFID
Often known as “tag” or “card” readers within the community.
Touchscreen
Presence Detection
Miscellaneous
Alarm Control Panel Components
Audio ADC Components
Audio DAC Components
Button Components
Climate Components
Cover Components
Datetime Components
Display Components
Display Hardware Platforms
Electromechanical
Energy/Solar Management
Event Components
Fan Components
Home Assistant Components
Components specifically for interacting with Home Assistant.
Light Components
Lock Components
Media Player Components
Microphone Components
Number Components
Output Components
Select Components
Speaker Components
Switch Components
Text Components
Text Sensor Components
Time Components
Touchscreen Components
Valve Components
Wireless Communication
Used for creating infrared (IR) or radio frequency (RF) remote control transmitters and/or receivers, or to connect ESPHome to cellular networks. Does not encompass Wi-Fi.
Miscellaneous Components
Cookbook
Contributing
ESPHome depends on and welcomes contributions from our community. If you’d like to contribute, please see our developer site.
