ESPHome component for controlling Elero wireless blinds and lights via an ESP32 with a CC1101, SX1262, or SX1276 868 MHz RF transceiver. Bidirectional -- sends commands and receives status feedback.
Pick a device config for your board:
- ESP32 + CC1101 -- generic ESP32 with external CC1101 module
- Heltec WiFi LoRa 32 V4 -- onboard SX1262 (experimental)
- LILYGO LoRa32 V2.1 -- onboard SX1276 (experimental)
- LilyGO T-Embed -- onboard CC1101
Devices always live in NVS and are managed at runtime through the web UI. The adapter only decides how Home Assistant sees them:
elero_nvs: -- ESPHome native API. Recommended for HA-only setups.
external_components:
- source: github://manuschillerdev/esphome-elero
# ... board + SPI + elero config from your device page ...
api:
elero_nvs:
elero_web:elero_mqtt: -- MQTT HA discovery. Use when you already run an MQTT broker, or when you want device CRUD to apply without rebooting.
external_components:
- source: github://manuschillerdev/esphome-elero
# ... board + SPI + elero config from your device page ...
mqtt:
broker: !secret mqtt_broker
elero_mqtt:
topic_prefix: elero
discovery_prefix: homeassistant
device_name: "Elero Gateway"
elero_web:- Flash your config (
uv run esphome run your-config.yaml). - Open
http://<device-ip>/elero. - Press buttons on your physical Elero remote -- RF packets appear in real time and remotes/blinds are auto-discovered.
- Save discovered devices in the web UI.
- (Optional) Backup: Hub → Backup & Restore → Download. Keep this JSON safe -- it's how you recover devices after flashing a replacement chip.
If you're upgrading from a version where devices were defined under cover: - platform: elero / light: - platform: elero, see docs/MIGRATION-yaml-to-nvs.md. The TL;DR: run uv run scripts/migrate_yaml_to_json.py old.yaml -o backup.json, remove the cover: / light: blocks from YAML, flash, then upload the backup via the web UI.
- Configuration Reference -- full parameter tables for all modes
- Installation Guide -- step-by-step hardware setup
- Backup & Restore -- exporting/importing your NVS device list
- Migration from YAML devices -- upgrading from pre-0.11.0
- Device Configs -- board-specific wiring and config
- example.yaml -- minimal working config
Based on protocol research by QuadCorei8085/elero_protocol (MIT), stanleypa/eleropy (GPLv3), and andyboeh/esphome-elero.