ESPSomfy RTS Smart-Home-Integration, kostenlos und Open Source
Somfy-RTS-Rollläden, Markisen und Tore über einen ESPSomfy-RTS-Controller, lokal.
Veröffentlicht von William-De71
- Geräte
- Version 0.1.0
- Erfordert Gladys >=5.1.0
- ★ 0
Überblick
Diese Integration bringt Ihre Somfy-RTS-Antriebe über einen ESPSomfy-RTS-Controller in Gladys: Rollläden, Jalousien und ihre Lamellen, Markisen, Vorhänge, Garagentore und Tore, in Räumen und Szenen, mit ihrer Position, ihrer „My“-Lieblingsposition und ihrem Sonnen- und Windsensor.
ESPSomfy RTS ist eine freie Firmware für einen ESP32 mit 433-MHz-Funkmodul (CC1101). Sie sendet die Funksignale einer Somfy-RTS-Fernbedienung und steuert so die Antriebe ohne Somfy-Box, und sie hört Ihre Fernbedienungen mit und weiß daher, wohin jeder Antrieb gefahren ist. Die Positionen schätzt sie anhand der auf ihrer Webseite eingestellten Laufzeiten.
Funktionsweise: Alles bleibt in Ihrem lokalen Netzwerk. Gladys findet den Controller selbst (SSDP), liest seine Antriebe und Gruppen und hält dann eine Verbindung zu ihm offen: Jede Bewegung, ob von Gladys, einer Fernbedienung oder der Webseite des Controllers ausgelöst, erscheint sofort, nichts wird abgefragt. Kein Konto, keine Cloud. Diese Integration ist inoffiziell und weder mit Somfy noch mit den Autoren von ESPSomfy RTS verbunden.
Voraussetzungen
- Gladys Assistant 5.1.0 oder neuer.
- Ein ESPSomfy-RTS-Controller mit Firmware 2.4 oder neuer, verbunden mit demselben Netzwerk wie Gladys (WLAN oder Ethernet).
- Ihre Antriebe und Gruppen, auf der Webseite des Controllers angelegt und gekoppelt: Die Integration koppelt keine Antriebe, sie nutzt, was der Controller kennt.
- Akzeptieren Sie bei der Installation die Netzwerkerkennung (SSDP), mit der Gladys den Controller findet. Die Option SSDP broadcast des Controllers muss aktiv bleiben (sie ist es standardmäßig); andernfalls geben Sie seine Adresse in der Konfiguration ein.
Konfiguration
Controller
Nichts ist Pflicht: Speichern Sie die Konfiguration und klicken Sie dann auf Controller suchen. Die Meldung listet jeden gefundenen Controller mit Adresse, Firmware sowie Anzahl der Antriebe und Gruppen auf.
- IP-Adressen der Controller: nur für einen Controller, den die Suche nicht findet (anderes Subnetz, Netzwerk, das Multicast filtert, SSDP aus), durch Kommas getrennt. Geben Sie Ihrem Controller im Router eine feste Adresse: Ein Controller mit geänderter Adresse wird über seine Server-ID wiedergefunden, mit fester Adresse aber schneller.
- Netzwerk erneut durchsuchen: stündlich (Standard), alle 15 Minuten oder nie. Nützlich für einen neuen Controller, einen auf der Webseite hinzugefügten Antrieb oder eine vom Router geänderte Adresse. Ein Controller, der nicht mehr antwortet, wird ohnehin erneut kontaktiert.
Sprache
Sprache der Texte: Namen der Funktionen und Fehlermeldungen der Szenen, da Gladys Ihre Sprache dafür nicht mitschickt.
Verwendung
Geräte
Öffnen Sie den Tab Erkennung der Integration und fügen Sie Ihre Antriebe und Gruppen hinzu. Jeder wird zu einem Gladys-Gerät mit dem Namen aus dem Controller:
- Rollladen, Klappladen, Jalousie, Markise, Garagentor, Tor mit drei Tasten: ein Rollladen mit Öffnen / schließen (öffnen, stoppen, schließen) und Position (0 % = zu, 100 % = offen).
- Vorhang: ein Vorhang mit denselben zwei Funktionen.
- Jalousie mit Wendemotor: zusätzlich Lamellen (0 % = zu, 100 % = offen). Eine reine Lamellen-Jalousie hat ihre Lamellen als Position.
- Garagentor oder Tor mit einer Taste: nur Öffnen / schließen; die Taste wird nur gedrückt, wenn sie etwas ändert.
- Potentialfreier Kontakt: ein Schalter Relais.
- Antrieb mit Sonnensensor, Markise: zusätzlich Sonnensensor aktiv, mit dem der Sonnensensor den Antrieb bewegen darf oder nicht (das „Sun Flag“ von Somfy).
- Gruppe: Öffnen / schließen für alle ihre Antriebe auf einmal (und Sonnensensor aktiv, wenn sie einen hat). Eine Gruppe hat keine Position.
Stoppen hält einen fahrenden Antrieb an; bei einem stehenden Antrieb tut es nichts (bei Somfy schickt dieselbe Taste einen stehenden Antrieb in seine „My“-Position: Nutzen Sie dafür die Szenenaktion oder das Widget). Die Positionen folgen den Konventionen der Home-Assistant-Integration des Firmware-Autors, einschließlich der Option flip position und der Markisen (offen = ausgefahren).
Transport
Der Katalog zeigt das Abzeichen lokal: Nichts verlässt Ihr Netzwerk. Jedes Gerät zeigt lokal, solange sein Controller antwortet, sonst nicht erreichbar.
Widgets
- Somfy-Antrieb: ein in den Einstellungen gewählter Antrieb oder eine Gruppe: wie weit offen (Live-Anzeige), der Zustand, die „My“-Position, die Lamellen, Sonne und Wind, und die Tasten Öffnen, My, Schließen und der Sonnensensor. My ist die im Motor gespeicherte Lieblingsposition, für die Gladys keine Taste hat.
- Somfy-Antriebe: alle zu Gladys hinzugefügten Antriebe, offen oder zu auf einen Blick (höchstens acht), und der Zustand der Controller mit einem Firmware-Update, wenn eines verfügbar ist.
Szenenauslöser
- Eine Somfy-Fernbedienung wird gedrückt: Eine mit einem Antrieb gekoppelte Fernbedienung, ein Wandsender oder eine Situo wird gedrückt, und der Controller hört es. Filter nach Antrieb und Taste (▲ auf, ▼ ab, My, My + auf…). Variablen: Name des Antriebs, Taste, Adresse der Fernbedienung. Befehle von Gladys oder vom Controller lösen ihn nie aus.
- Sonne oder Wind ändert sich: Der Somfy-Sonnen- und Windsensor eines Antriebs meldet, dass Sonne oder Wind kommt oder geht. Filter nach Antrieb, Sensor und Zustand.
- Ein ESPSomfy-RTS-Controller ist weg: Er antwortet seit einer Minute nicht (ausgesteckt, WLAN verloren). Variablen: Name des Controllers, IP-Adresse.
- Ein ESPSomfy-RTS-Controller ist zurück: Er antwortet wieder nach einem „weg“-Ereignis.
Szenenaktionen
- Somfy-Befehl senden an einen Antrieb oder eine Gruppe: My (Lieblingsposition; stoppt einen fahrenden Antrieb), öffnen, schließen, ein Schritt Richtung offen oder zu, Sonnensensor aktiv oder ignoriert.
- Position eines Antriebs korrigieren: teilt dem Controller mit, wo der Antrieb wirklich steht, ohne ihn zu bewegen (nach einer Fernbedienung, die er nicht hört, oder einem Stromausfall), mit den Lamellen, falls vorhanden.
Szenenbeispiele
- Wenn die „My“-Taste der Wohnzimmer-Fernbedienung gedrückt wird → das Licht dimmen und den Fernseher einschalten.
- Wenn an der Terrassenmarkise Wind erkannt wird → eine Benachrichtigung senden (der Antrieb fährt sie selbst ein).
- Bei Sonnenuntergang → Somfy-Befehl senden „My“ an die Gruppe Erdgeschoss: Jeder Antrieb fährt in seine Lieblingsposition.
Fehlerbehebung
- Kein Controller gefunden: Prüfen Sie, ob der Controller unter
http://<seine Adresse>von einem Computer im selben Netzwerk antwortet, ob seine Option SSDP broadcast aktiv ist und ob Sie die Netzwerkerkennung bei der Installation akzeptiert haben (sonst installieren Sie die Integration neu). Oder geben Sie seine Adresse unter IP-Adressen der Controller ein. - Ein Antrieb fehlt: Legen Sie ihn auf der Webseite des Controllers an und starten Sie dann eine Suche im Tab Erkennung.
- Die Position stimmt nicht: ESPSomfy RTS schätzt sie anhand der auf seiner Webseite eingestellten Laufzeiten und der gehörten Funksignale. Eine Fernbedienung, die er nicht hört, bewegt den Antrieb, ohne es ihm zu sagen: Nutzen Sie die Aktion Position eines Antriebs korrigieren oder verknüpfen Sie diese Fernbedienung auf der Webseite des Controllers.
- Die Befehle gehen in die falsche Richtung: Korrigieren Sie es auf der Webseite des Controllers (flip commands, flip position) und fügen Sie das Gerät erneut hinzu, falls der Tab Erkennung ein Update anbietet.
- Nicht erreichbar: Der Controller startet nach einem Firmware-Update oder einem WLAN-Verlust neu; Gladys verbindet sich innerhalb einer Minute wieder. Die HTTP-API (Port 8081) und der Socket (Port 8080) müssen von Gladys aus erreichbar sein.
- Logs: Tab Logs der Integrationsseite. Für mehr Details fügen Sie die Umgebungsvariable
DEBUG=gladys-integration-sdkhinzu.
Konfigurationseinstellungen
Diese Einstellungen fragt ESPSomfy RTS in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Ihr ESPSomfy-RTS-Controller | section | Nein | ESPSomfy RTS ist eine freie Firmware für einen ESP32 mit 433-MHz-Funkmodul: Sie steuert Somfy-RTS-Antriebe (Rollläden, Jalousien, Markisen, Vorhänge, Garagentore, Tore) wie deren Fernbedienungen und hört diese Fernbedienungen mit. Legen Sie zuerst Ihre Antriebe und Gruppen auf seiner Webseite an. Gladys findet den Controller dann selbst im lokalen Netzwerk, und jeder Antrieb und jede Gruppe erscheint im Tab Erkennung. Nichts verlässt Ihr Netzwerk. Nicht mit Somfy verbunden. |
| IP-Adressen der Controller | string | Nein | Optional, durch Kommas getrennt. Nur für einen Controller, den die automatische Suche nicht findet (anderes Subnetz, Netzwerk, das Multicast filtert, SSDP aus). |
| Netzwerk erneut durchsuchen | select | Nein | Um einen neuen Controller, einen auf seiner Webseite hinzugefügten Antrieb oder eine vom Router geänderte Adresse zu finden. Ein verlorener Controller wird ohnehin erneut kontaktiert. |
| Sprache der Texte | select | Nein | Namen der Funktionen und Fehlermeldungen der Szenen: Gladys teilt der Integration Ihre Sprache dafür nicht mit. |
So installierst du ESPSomfy RTS in Gladys
- Öffne in Gladys Integrationen: ESPSomfy RTS erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-espsomfy-rts:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-espsomfy-rts.
ESPSomfy RTS benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
ESPSomfy RTS ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation