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

CAN Bus

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.