A custom Home Assistant integration (Fork) to precisely control and monitor your equipment (roller shutters, shades, garage doors, gates) using the RTS 433 MHz protocol.
ESPSomfy-RTS-HA-enhanced allows you to control all your devices in Home Assistant and accurately set their position. This integration relies on an ESP32 microcontroller coupled with a cheap CC1101 transceiver module, driven by the ESPSomfy-RTS firmware.
This integration requires hardware running on an ESP32 and a CC1101 transceiver. To assemble and configure this hardware, please refer to the repository wiki: components. The radio protocol must be configured for your devices before using this integration.
The easiest way to get started is to add this repository as a Custom Repository in HACS:
- Go to HACS → Integrations.
- Click the 3 dots in the top right corner and select Custom repositories.
- Add the following URL:
https://github.com/xkain/ESPSomfy-RTS-enhanced - Select Integration as the category, then click Add.
- Download and install the integration.
Simply copy the contents of the custom_components/espsomfy_rts_enhanced/ folder and paste it into the config/custom_components/espsomfy_rts_enhanced/ directory of your Home Assistant instance.
Once installed and Home Assistant is restarted, the integration will automatically discover your radio modules on the local network. Simply navigate to Settings → Devices & Services: your ESPSomfy-RTS device will show up, ready to be configured.
- Full Control: Open, close, and set intermediate positions (percentages) directly from Home Assistant.
- State Synchronization: The integration tracks the real-time position of the cover, even if it is operated by a physical Somfy Telis remote or via the ESP32 web interface.
- Simplified Updates: You will receive a notification whenever a new version of the integration is available. Additionally, since v2.2.1 of the ESPSomfy RTS firmware, a dedicated
updateentity allows you to update your ESP32 firmware directly from the Home Assistant UI. - Automations: All shades are exposed as standard
coverentities, ready to be added to your dashboards and used in automations via native services.
The integration emits events on the Home Assistant event bus for every intercepted command (whether it originates from HA, a physical remote control, or the ESP web interface). These events use the espsomfy-rts_event type.
| Key | Description |
|---|---|
entity_id |
The target entity ID in Home Assistant (e.g., cover.living_room_shade). |
event_key |
The event trigger (currently always set to shadeCommand). |
name |
The friendly name assigned to the device. |
remote_address |
The radio address defined for the motor in ESPSomfy RTS. |
source_address |
The source device address (remote control channel address or group address). |
remote: The user pressed a button on a physical remote control.internal: The command was initiated from the ESPSomfy RTS internal interface.group: The command was part of a grouped action.
Up/Down/My: Standard commands (Up, Down, Stop/Favorite Position).StepUp/StepDown: Step-by-step micro-adjustments.Prog: Program button press.My+Up/My+Down/Up+Down/My+Up+Down: Simultaneous physical key combinations.
Many specific services are available to enrich your automations. Check out the usage examples directly in the Services section of the Wiki.