My ESPHome Configuration
This page is the starting point for all installation and configuration documentation of all my devices which are configured with ESPHome .
Current setup
Common firmware features
The following features are implemented for every device
- Wifi with failover Access Point Mode and Captive Portal
- Over The Air firware updates
- Native API
- Web Server with basic authentication
- Status Binary Sensor
- Wifi Info Text Sensor (IP, SSID & BSSID)
- Version Text Sensor
- Uptime Sensor rounded to the hour to reduce updates
- Restart Switch
- Update interval of 10 minutes for most sensors to reduce updates
Device types & specific firmware features
| Device | Type | Physical button | GPIO power | UART GPIO | Script | Custom Sensor |
|---|---|---|---|---|---|---|
| attic_1 | Sonoff 4CH R2 | X | ||||
| bedroom_1 | Sonoff 4CH Pro | X | X | |||
| bedroom_2 | Sonoff S20 | X | X | |||
| garage | Wemos D1 mini Pro v1.0.0 | X | ||||
| living_1 | Sonoff 4CH | X | X | |||
| ventilation | Sonoff Pow R2 | X | X | |||
| veranda_lights | Shelly 1 | X | ||||
| xmas_1 | Sonoff Dual R1 | X | X | |||
| xmas_2 | Sonoff S26 | X |
Sensors
| Device | Status LED | bme280 (i2c) | dallas | CSE7766 | dht22 | RF receiver |
|---|---|---|---|---|---|---|
| attic_1 | X | X | ||||
| bedroom_1 | X | |||||
| bedroom_2 | X | |||||
| garage | X | X | X | |||
| living_1 | X | X | ||||
| ventilation | X | X | X | |||
| veranda_lights | ||||||
| xmas_1 | X | |||||
| xmas_2 | X |
Installation
Arch Linux
Installing python
Since platformio 4 we can just use python, which can be installed with pacman -Syu python.
Activating a virtual environment with esphome
There’s an install script. Execute it with . install.sh
Once setup, the virtual environment can be activated with
. venv/bin/activate
Configuring secrets
The yaml files refer to secrets which are configured in secrets.yaml. This file is not kept in the GIT repository so should be created after a clean clone.
For this, you can copy the Travis Secrets to secrets.yaml and fill in your secrets.