Ein ioBroker-Adapter für Somfy Tahoma. Dieses Projekt steht in keiner Verbindung zu Somfy. Es basiert ursprünglich auf dem Skript von https://forum.iobroker.net/post/336001 und wurde von https://github.com/StrathCole/ioBroker.tahoma abgeleitet.
Der Adapter verbindet sich mit der Tahomalink-Endbenutzer-API und steuert die Geräte. Die Einrichtung erfolgt über die Tahoma Box (und höchstwahrscheinlich Connexoon).
Der Adapter ist noch nicht vollständig ausgestattet, sollte aber die meisten Funktionen zur Steuerung von Jalousien, Rollläden usw. unterstützen.
Bitte lesen Sie bei Problemen zunächst die FAQ .
Aktuell getestete Geräte
Dieser Adapter sollte grundsätzlich alle Geräte unterstützen, die über tahomalink.com erreichbar sind. Für den Entwickler ist dies jedoch schwer zu garantieren. Hauptgrund dafür ist, dass die Dokumentation der verwendeten Somfy-API (zumindest öffentlich) nicht existiert und der Entwickler nur Somfy-Geräte testen kann, die er selbst besitzt oder mit Unterstützung von freiwilligen Testpersonen erproben kann.
Geräte, die über tahomalink.com gesteuert werden können, werden in der Regel auch von diesem Adapter unterstützt. Dazu gehören:
| Gerät | Unterstützung für Online-API | Unterstützung für die lokale API |
|---|---|---|
| Tahoma-Box | ✓ | ✓ |
| Connexoon | ✓ | ✓ ( Beweis ) |
| Tahoma-Schalter | ✓ | ✓ |
| Konnektivitätsset | ✓ ( Beweis ) | ✗ ( Beweis ) |
Folgende Somfy-Geräte wurden nachweislich mit diesem Adapter kompatibel:
- S&SO RS100 io
- Oximo io
- Sonnensensor Sunis io
- Temperatursensor-Io
- Rauchsensor io
- Adapterstecker io
Konfiguration
Der Adapter unterstützt die folgenden Konfigurationsparameter.
| Parameter | (Standardwert) | Beschreibung |
|---|---|---|
| Benutzername | <your Tahomalink user> | Erforderlich zur Authentifizierung Ihres Tahoma-Kontos. |
| Passwort | <Your Tahomalink password> | Erforderlich zur Authentifizierung Ihres Tahoma-Kontos. |
| Abstimmungsintervall | 20000 | Zeit (in Millisekunden), nach der der Adapter versucht, neue Daten von Tahomalink abzurufen. |
| PIN der Tahoma-Box | Format ähnlich wie1234-5678-9012 | Nur für LocalAPI Ihre individuelle PIN für Ihre Tahoma-Box erhalten Sie von Somfy. Weitere Informationen zur Aktivierung/Nutzung finden Sie hier. |
| Lokale IP-Adresse | Optional. Nur verwenden, wenn Sie über die angegebene IP-Adresse eine Verbindung zur lokalen API Ihrer Tahoma-Box herstellen möchten, anstatt den Standard-DNS-Eintrag zu verwenden.gateway-<pin> Das funktioniert für die meisten Installationen einwandfrei. | |
| Verwenden Sie MDNS | false | Nur für LocalAPI Wenn diese Option aktiviert ist, wird versucht, den lokalen Hostnamen Ihrer Tahoma-Box mithilfe von mDNS aufzulösen. Da dies möglicherweise nicht von allen Routern unterstützt wird, ist diese Funktion standardmäßig deaktiviert. |
| Anmeldeversuche 1 2 | 3 | Anzahl der Versuche, sich nach einem fehlgeschlagenen Anmeldevorgang erneut anzumelden. |
| Verzögerung zwischen Anmeldeversuchen 1 2 | 30 | Wartezeit (in Sekunden) zwischen den Anmeldeversuchen. |
| Verzögerung nach fehlgeschlagener Anmeldung 1 2 | 120 | Wartezeit (in Sekunden), nachdem alle aufeinanderfolgenden Anmeldeversuche fehlgeschlagen sind. |
| Verzögerung vor dem erneuten Versuch der Warteschlangenanwendung 1 2 | 1500 | Wartezeit (in Millisekunden), bevor ein zweiter Versuch unternommen wird, Änderungen aus der internen Anwendungswarteschlange an Tahoma zu senden, falls der erste Versuch verloren gegangen ist. |
1 Diese Konfigurationswerte sind nur in Admin 5 (neue GUI) oder späteren Versionen sichtbar und konfigurierbar.
2 Alle Werte beziehen sich auf die Anmeldung bei Tahomalink, das aus Entwicklersicht weitgehend undurchsichtig ist. Erfahrungsgemäß kann es bei zu niedrigen Einstellungen dazu führen, dass Somfy Ihr Konto vorübergehend sperrt. Gehen Sie daher bei niedrigeren Standardwerten vorsichtig vor!
Staaten
tahoma.X.location
Die Bundesstaaten in diesem Baum enthalten die persönlichen Daten des Benutzers, wie Stadt, Straße und Längen-/Breitengrad.
tahoma.X.devices.*.deviceURL
Dieser Status enthält die Geräte-URL, die von Tahoma zur Identifizierung des Geräts verwendet wird.
tahoma.X.devices.*.commands
Diese Zustände enthalten Tastenbefehle zur Steuerung der Geräte. Die meisten Geräte unterstützen Befehle wie beispielsweise:close Undopen aber auch noch einige mehr.
Einige der Befehle haben eine:slow Am Ende, sofern vom Gerät unterstützt. Die Verwendung dieser Optionen aktiviert einen niedrigen Geschwindigkeitsmodus oder den sogenannten Silent-Modus.
tahoma.X.devices.*.states
Diese Statusangaben enthalten den aktuellen Status der Geräte wie folgt. Einige der Statusangaben enthalten eine:slow Am Ende, sofern vom Gerät unterstützt. Durch diese Einstellungen wird ein niedriger Geschwindigkeitsmodus oder der sogenannte Silent-Modus aktiviert.
| Gerätestatus | Bearbeitbar | Zweck/Beschreibung |
|---|---|---|
| tahoma.X.devices.*.states.core:DeploymentState | ✓ | Liefert Informationen über den Status der aktuellen Bereitstellung und steuert diesen. 100 bedeutet vollständig bereitgestellt, 0 bedeutet nicht bereitgestellt. Nicht alle Geräte haben diesen Wert, einige habenClosureState stattdessen. |
| tahoma.X.devices.*.states.core:TargetDeploymentState | ✓ | Sehentahoma.X.devices.*.states.core:DeploymentState Verwenden Sie dies beispielsweise, um die Position der Jalousie direkt zu ändern. |
| tahoma.X.devices.*.states.coreClosureState | ✓ | Liefert Informationen über den aktuellen Schließzustand und steuert diesen. 100 bedeutet vollständig geschlossen, 0 bedeutet offen. Nicht alle Geräte verfügen über diesen Wert, manche habenDeploymentState stattdessen. |
| tahoma.X.devices.*.states.core:TargetClosureState | ✓ | Sehentahoma.X.devices.*.states.core:ClosureState |
| tahoma.X.devices.*.states.core:OrientationState | ✓ | Liefert Informationen über die Ausrichtung von Lamellen und steuert diese (z. B. bei Rollläden). Nicht alle Geräte bieten diese Funktion. |
| tahoma.X.devices.*.states.core:TargetOrientationState | ✓ | Sehentahoma.X.devices.*.states.core:OrientationState |
| tahoma.X.devices.*.states.core:NameState | Enthält den aktuellen Namen des Geräts. | |
| tahoma.X.devices.*.states.core:OpenClosedState | Enthältclosed wenn das Gerät zu 100 % geschlossen oder zu 0 % ausgefahren ist undopen ansonsten. | |
| tahoma.X.devices.*.states.core:PriorityLockTimerState | Wenn ein Sensor das Gerät blockiert, wird dies hier vermerkt, z. B. wenn ein Windsensor eine Markise blockiert. | |
| tahoma.X.devices.*.states.core:RSSILevelState | Die aktuelle Signalqualität des Geräts. | |
| tahoma.X.devices.*.states.core:StatusState | available sofern das Gerät aktuell verfügbar ist. | |
| tahoma.X.devices.*.states.io:PriorityLockLevelState | Sehentahoma.X.devices.*.states.core:PriorityLockTimerState | |
| tahoma.X.devices.*.states.io:PriorityLockOriginatorState | Sehentahoma.X.devices.*.states.core:PriorityLockTimerState | |
| tahoma.X.devices.*.states.moving | Gibt an, ob sich das Gerät gerade bewegt.0 = stopped ,1 = up/undeploy ,2 = down/deploy ,3 = unknown directionBemerkung: Dies funktioniert nur zuverlässig, wenn eine Verbindung zur Tahoma-API (nicht zur Local-API) hergestellt wird, da die Local-API nicht genügend Aktionsereignis-Aktualisierungen liefert, um diesen Zustand korrekt zu berechnen. core:MovingState Sollte aber in beiden Fällen funktionieren. |
Changelog
See Changelog.
0.11.0 (2025-04-15)
- Feature: Added option to specify IP address for access to local API (https://github.com/Excodibur/ioBroker.tahoma/issues/424)
0.10.4 (2024-04-28)
- Fixed: Warning resolved about invalid element in jsonConfig
0.10.3 (2024-01-29)
- Fixed: Some crashed caused by event-updates were fixed with a workaround.
0.10.2 (2023-03-25)
- Fixed: Improved core:MovingState. Should reflect moving blinds correctly now.
0.10.1 (2023-01-23)
- Fixed: Clear bearer token, if connection to local API fails, so new one can be fetched.
0.10.0 (2023-01-03)
- Fixed warnings about Failed getting execution state when using the local API.
License
The MIT License (MIT)
Copyright (c) 2020-2025 Marius Burkard & Excodibur
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.