--- title: "Somfy TaHoma – Jalousien und Rollläden io und RTS (lokale API)" description: "Somfy io-Rollläden, -Markisen und -Raffstores sowie RTS-Motoren aus TapHome über die lokale API des TaHoma Gateways (Developer Mode) steuern — ohne Cloud." url: "https://taphome.com/de/compatibility/somfy-tahoma-http/" language: de lastmod: 2026-11-04 generator: hugo ai: topics: ["http","gateway","blinds","shutters","awnings","io-homecontrol","rts","rest-api","mdns"] questions: ["Gibt es in TapHome eine Vorlage für Somfy?","Kann ich Somfy-Jalousien über das TaHoma Gateway in TapHome einbinden?","Wie erhalte ich das Bearer-Token des Somfy TaHoma Developer Mode für TapHome?","Wie finde ich die deviceURL eines Somfy-Motors für die TapHome-Vorlage?","Kann TapHome Somfy RTS-Motoren steuern?","Brauchen verdrahtete Somfy-Motoren ohne Funk in TapHome ein TaHoma Gateway?"] --- # Somfy TaHoma – Jalousien und Rollläden io und RTS (lokale API) Kommunikation: Packet Parser → HTTP - [Offizielle Website von Somfy](https://www.somfy.com) - [Produktseite Somfy TaHoma Switch](https://www.somfy.co.uk/products/1870600/tahoma-switch) Die Vorlage Somfy TaHoma verbindet TapHome mit einem Somfy TaHoma Gateway (zum Beispiel TaHoma Switch) über die offizielle lokale API des Gateways, die Somfy Developer Mode nennt. Die Motoren werden wie gewohnt in der App TaHoma by Somfy mit dem Gateway gekoppelt; TapHome spricht nur mit dem Gateway, über HTTPS auf Port 8443 im lokalen Netzwerk, ohne Cloud-Verbindung. Die Vorlage steuert io-homecontrol-Rollläden und -Markisen nach Position, io-homecontrol-Raffstores nach Position und Lamellenwinkel und sendet Einweg-RTS-Motoren die Befehle Öffnen, My, Stopp und Schließen. > [!WARNING] > **Community-Vorlage — noch nicht mit TapHome getestet.** Die Vorlage wurde im TapHome-Portal aus der Somfy-Dokumentation zum Developer Mode erstellt; die Namen der Gerätezustände und Befehle stammen aus Community-Quellen (Somfy führt sie nicht auf). Getestet wurde sie nur mit einem simulierten Gateway auf einem lokalen TapHome Core 2025.2, nicht mit einem echten TaHoma Gateway oder echten Somfy-Motoren, und Erfahrungen aus der Praxis sind willkommen. Laden Sie das XML auf dieser Seite herunter oder holen Sie es im TapHome-Portal: [Somfy TaHoma — Community-Vorlage](https://portal.taphome.com/portal/community/somfy-tahoma-http), und importieren Sie es als neues Modul. **[Somfy TaHoma — io and RTS shading motors (Developer Mode, local API)](https://portal.taphome.com/de/portal/community/somfy-tahoma-http)** — Somfy, HTTP. Somfy TaHoma gateway over its official local API (Developer Mode, HTTPS 8443, token): io roller shutters and awnings with position, io venetian blinds with slats, RTS motors as commands without feedback. > [!NOTE] > **Verdrahtete Somfy-Motoren brauchen kein Gateway.** Einen 230-V-Somfy-Motor ohne Funkempfänger (zum Beispiel Somfy WT, vier Adern — PE, N, auf, ab) steuert TapHome direkt mit Relaismodulen wie jeden anderen Beschattungsmotor — siehe [Anforderungen → Beschattung](https://taphome.com/de/docs/setup/requirements/#shading). Diese Vorlage ist für Motoren mit Funk (io-homecontrol oder RTS), die mit einem TaHoma Gateway gekoppelt sind. ## Unterstützte Gateways Laut Somfy funktioniert der Developer Mode auf der großen Mehrheit der TaHoma Gateways. **Nicht verfügbar** ist er auf: - der TaHoma Box oder Somfy Box der 1. Generation (quadratische Form) - dem Connectivity Kit ## Hardware-Anschluss Es ist keine Verkabelung nötig. Das TaHoma Gateway und der TapHome Core müssen im selben lokalen Netzwerk sein. Das Gateway verwendet ein Zertifikat, das von der selbstsignierten Overkiz-Zertifizierungsstelle signiert ist; die Vorlage verbindet sich unter Ignorieren von Zertifikatsfehlern, sodass kein Zertifikat installiert werden muss. ## Konfiguration ### Developer Mode einschalten und Token erstellen 1. Öffnen Sie die App **TaHoma by Somfy**. 2. Gehen Sie zu **Configure the installation › Access the parameters** Ihrer TaHoma Box. 3. Tippen Sie **7-mal** auf die PIN des Gateways (zum Beispiel 2001-1234-5678) — der Developer Mode wird eingeschaltet und die lokale API des Gateways startet. 4. Erzeugen Sie im Menü **Developer Mode** ein Token. Das Token kann nur beim Erstellen gelesen und kopiert werden — speichern Sie es sofort. Es lassen sich mehrere Tokens erzeugen; geht ein Token verloren, erzeugen Sie ein neues und tragen es in TapHome ein. ### Geräteadressen ermitteln Jeder mit dem Gateway gekoppelte Motor hat eine Adresse, die `deviceURL`. Die Adressen liefert die Geräteliste des Gateways mit dem Token — zum Beispiel von einem Computer im selben Netzwerk: ``` curl -k -H "Authorization: Bearer " https://:8443/enduser-mobile-web/1/enduserAPI/setup/devices ``` Suchen Sie den Motor über sein `label` (den Namen aus der TaHoma-App) und kopieren Sie seine `deviceURL` genau so, wie sie angezeigt wird. Die Vorlage kodiert sie für die Anfrage selbst. | Protokoll | Format | Beispiel | |---|---|---| | io-homecontrol | `io://{gateway-pin}/{device-id}` | `io://1234-5678-9012/4820485` | | RTS | `rts://{gateway-pin}/{device-id}` | `rts://1234-5678-9012/987654321` | Dieselbe Antwort zeigt, was jeder Motor unterstützt: `definition.states` und `definition.commands`. Die Vorlage erwartet den Zustand `core:ClosureState` und den Befehl `setClosure` bei einem Rollladen oder einer Markise, `core:ClosureState`, `core:SlateOrientationState` und `setClosureAndOrientation` bei einem Raffstore und `open`, `my`, `stop` und `close` bei einem RTS-Motor. Ein Motor, dessen Definition diese Namen nicht enthält, funktioniert mit dem jeweiligen Gerät nicht. ### Importparameter | Importparameter | Beschreibung | Platzhalter | |---|---|---| | `GatewayAddress` | IP-Adresse oder Hostname des TaHoma Gateways, zum Beispiel `gateway-1234-5678-9012.local` | `192.168.1.100` | | `BearerToken` | Token aus dem Developer Mode | (leer) | | `SlideDeviceUrl` | `deviceURL` des io-Rollladens oder der io-Markise | `io://1234-5678-9012/12345678` | | `BlindDeviceUrl` | `deviceURL` des io-Raffstores | `io://1234-5678-9012/12345678` | | `RtsDeviceUrl` | `deviceURL` des RTS-Motors | `rts://1234-5678-9012/12345678` | Wenn Sie die IP-Adresse verwenden, reservieren Sie sie im Router für das Gateway, damit sie sich nicht ändert. Die Vorlage enthält von jeder Art ein Gerät. Löschen Sie die Geräte, die Sie nicht brauchen. Für weitere Motoren importieren Sie die Vorlage erneut mit den anderen Adressen — jeder Import fügt ein Gateway-Modul mit eigenen Geräten hinzu — und löschen die überzähligen Geräte, oder ändern Sie die Variable `DeviceUrl` eines Geräts. ## Gerätefunktionen ### Gateway Das Modul liest das Gateway alle 30 s und zeigt drei Service-Attribute: **Protokollversion** (die Version der lokalen API), **Gateway-ID** (die PIN des Gateways) und **Verbindungsstatus** (zum Beispiel OK). Bei falschem Token zeigt das Modul den Fehler „Check Bearer token in TaHoma By Somfy app → Developer Mode“. ### io-Rollläden und -Markisen - **io-Rollladen / Markise** — Position eines io-homecontrol-Rollladens oder einer Markise. Das Gateway meldet 0 = ganz offen und 100 = ganz geschlossen; in TapHome ist 0 % ganz oben und 100 % ganz unten, dieselbe Richtung. Das Gerät liest die Position alle 5 s und bewegt den Motor mit dem Befehl `setClosure`. ### io-Raffstores - **io-Raffstore** — Position und Lamellenwinkel eines io-homecontrol-Raffstores. Beide werden zusammen in einem Befehl `setClosureAndOrientation` gesendet, sodass eine Positionsänderung auch den aktuellen Lamellenwinkel und eine Lamellenänderung die aktuelle Position mitsendet. Ändert TapHome Position und Lamellen gleichzeitig, geht der identische Befehl nur einmal hinaus. ### RTS-Motoren RTS-Motoren (Radio Technology Somfy) sind Einweg-Funk: Sie empfangen Befehle, melden aber ihre Position nicht. | Wert | Befehl | Aktion | |---|---|---| | Öffnen | `open` | Nach oben fahren / ganz öffnen | | My | `my` | In die im Motor gespeicherte Lieblingsposition fahren | | Stopp | `stop` | Bewegung stoppen | | Schließen | `close` | Nach unten fahren / ganz schließen | - **RTS-Motor** — nach jedem Befehl zeigt der Schalter **Bereit**, sodass derselbe Befehl erneut gesendet werden kann, zum Beispiel Schließen, nachdem der Motor mit seiner eigenen Fernbedienung bewegt wurde. Die Wahl von Bereit sendet Stopp. Keines der Geräte bewegt einen Motor, wenn der TapHome Core startet: Sie übernehmen ihren Zustand vom Gateway, nicht den letzten Wert in TapHome. ### So kommuniziert die Vorlage mit dem Gateway Alle Aufrufe gehen an `https://:8443/enduser-mobile-web/1/enduserAPI` mit dem Header `Authorization: Bearer `; nur `GET /apiVersion` funktioniert ohne Token. Jedes io-Gerät liest seine Zustände alle 5 s aus `/setup/devices/{deviceURL}/states`, und alle Geräte senden Befehle mit `POST /exec/apply`. Somfy setzt für die lokale API kein Aufruflimit, warnt aber, dass zu häufige Aufrufe das Gateway überlasten und die Steuerung der Motoren verzögern — denken Sie daran, wenn viele Motoren an einem Gateway hängen. ## Fehlerbehebung ### Fehler „Check Bearer token in TaHoma By Somfy app → Developer Mode“ Das Gateway hat mit HTTP 401 geantwortet: Das Token ist falsch oder wurde nicht vollständig kopiert. Erzeugen Sie in der App TaHoma by Somfy › Developer Mode ein neues Token und tragen Sie es in TapHome ein. ### Gerätefehler „Device unavailable (HTTP …)“ Das Gateway kennt die Adresse nicht. Prüfen Sie, ob die `deviceURL` genau aus `GET /setup/devices` kopiert ist — nicht kodiert, ohne Leerzeichen — und ob sie zur richtigen Geräteart gehört. ### Gerätefehler „Closure state not available“ Das Gateway hat geantwortet, aber ohne den Zustand `core:ClosureState`. Prüfen Sie die `definition.states` des Motors. Manche Markisen melden stattdessen den Zustand `core:DeploymentState` (0 = eingefahren, 100 = ausgefahren); den liest die Vorlage nicht. ### Gateway zeigt ein Gerät als nicht verfügbar, es funktioniert aber Manche TaHoma-Firmware meldet io-Geräte als nicht verfügbar (`available: false`), obwohl sie normal funktionieren — an Somfy im Developer-Mode-Repository gemeldet. Die Vorlage verwendet dieses Kennzeichen nicht und zeigt deswegen keinen Fehler. ### RTS-Motor bewegt sich nicht RTS-Befehle sind Einweg-Funksignale ohne Zustellbestätigung, daher zeigt TapHome keinen Fehler, wenn der Motor nicht reagiert. Prüfen Sie, ob der Motor in Funkreichweite des Gateways ist und ob er sich aus der App TaHoma by Somfy bewegen lässt. ### Hostname des Gateways nicht erreichbar Wenn `gateway-{pin}.local` nicht aufgelöst wird, verwenden Sie die IP-Adresse des Gateways — sie steht im Router. Der Developer Mode muss eingeschaltet bleiben: Er schaltet die lokale API des Gateways frei. ## Verfügbare Geräte Somfy TaHoma Gateway Modul Serviceattribute | | | |-------------------|------------------------------------------------------------------------------------------------| | Protokollversion | Version der lokalen API, die das Gateway meldet | | Gateway-ID | PIN des Gateways (zum Beispiel 1234-5678-9012), dieselbe PIN, die Teil jeder Geräteadresse ist | | Verbindungsstatus | Verbindungsstatus, den das Gateway meldet, zum Beispiel OK | Benutzerdefinierte Variablen `BearerToken` (string) Token der lokalen TaHoma-API, erstellt in der App TaHoma by Somfy › Developer Mode; das Modul und jedes Gerät senden es als 'Authorization: Bearer <token>' TaHoma by Somfy app → Configure the installation → Access the parameters of your TaHoma box → tap the gateway PIN 7 times → Developer Mode → generate a token. The token can be copied only when it is created; enter it as the import parameter Bearer token. io-Rollladen / Markise Schieber Position eines io-homecontrol-Rollladens oder einer Markise — 0 % ganz offen, 100 % ganz geschlossen, dieselbe Richtung wie im Gateway numeric (0–100) Einheit: % json\_path Variable: `DeviceUrl` — Adresse des Motors im TaHoma Gateway (deviceURL aus GET /setup/devices), zum Beispiel io://1234-5678-9012/4820485 io-Raffstore Jalousie Position und Lamellenwinkel eines io-homecontrol-Raffstores — beide werden zusammen in einem Befehl gesendet numeric (0–100) Einheit: % json\_path Variable: `DeviceUrl` — Adresse des Raffstores im TaHoma Gateway (deviceURL), zum Beispiel io://1234-5678-9012/5932104 RTS-Motor Mehrwertschalter Befehle für einen Einweg-RTS-Motor — Öffnen, My (Lieblingsposition), Stopp oder Schließen; RTS meldet keine Position, daher zeigt der Schalter nach jedem Befehl Bereit enum numeric Werte / Zustände: Bereit · Öffnen · My · Stopp · Schließen Variable: `DeviceUrl` — Adresse des RTS-Motors im TaHoma Gateway (deviceURL), zum Beispiel rts://1234-5678-9012/987654321 **Verbindung:** Packet Parser → HTTP • Hostname: `gateway-{pin}.local.local` Mögliche Verbesserungen (6) - Event-driven state updates — Somfy recommends reading /setup at start and then fetching events at most once per second; the listener expires after 10 minutes without a fetch. The template polls the states of each device every 5 s instead. - Automatic device discovery — The gateway lists every paired device with its deviceURL, label, controllableName and definition. The template does not create devices from it; the installer enters one deviceURL per device. - Open / Close / Stop / My on io motors — io roller shutters and venetian blinds accept the same commands as RTS; the template drives them by position only (setClosure / setClosureAndOrientation). - Awnings that report the deployment instead of the closure — Awnings of type io:HorizontalAwningIOComponent may report core:DeploymentState (0 = retracted, 100 = deployed) instead of core:ClosureState; the roller shutter device reads ClosureState only. - Cancel running executions — Cancels all running commands launched from the local API. - Availability of a motor — The device description carries available and the state core:StatusState; some gateway firmware reports io devices as unavailable although they work (reported in the Developer Mode repository), so the template does not use it. ## Quellen - Somfy TaHoma Developer Mode — README (activation, token, certificate, mDNS, supported gateways) [github.com](https://github.com/Somfy-Developer/Somfy-TaHoma-Developer-Mode) 2026-11-04 - Somfy TaHoma local API — OpenAPI specification [somfy-developer.github.io](https://somfy-developer.github.io/Somfy-TaHoma-Developer-Mode/) 2026-11-04 ## Verwandte Dokumentation - [Packet-Parser-Integration](https://taphome.com/de/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/de/docs/integration/packet-parser/) - [Packet-Parser-Funktionen](https://taphome.com/de/docs/script/packet-parser/) - [Parsing-Funktionen](https://taphome.com/de/docs/script/parsing-functions/)