Über I-Tec Lüfter und -Beschattung sowie über SmartWindow findet man außer Marketingmaterial keine Informationen bei Internorm zur Einbindung in eine Hausautomatisierung. Die Internorm Serviceline versteht die Anforderung nicht, SmartWindow in eine bestehende Hausautomatisierung einbinden zu wollen (man erfährt immer, welche Komponenten sich in SmartWindow einbinden lassen, was auch im Prospekt steht). Erst durch einen Internorm-Mitarbeiter, zu dem ich "über sieben Ecken" gelangt bin, habe ich Informationen zur API erhalten. Die neue Version der API habe ich dann direkt bei mediola abgerufen und an besagten Internorm-Mitarbeiter weitergegeben.
Beim Aufruf des App-Supports im App-Store bei der SmartWindow-App wird man auf die Internorm Startseite geleitet, wo es keine Kontaktmöglichkeit zu den App-Entwicklern gibt. Das ist stark verbesserungswürdig.
Die Software und Hardware das Internorm SmartWindow Gateway wird in Lizenz hergestellt von mediola. Die RESTful API von mediola ist hier dokumentiert: http://www.mediola.com/support-docs/API_AIO_GATEWAYS-All.pdf
Über die RESTful API von Mediola werden die Kommandos der I-Tec Geräte an die SmartWindow Box gesendet. Diese Kommandos sind bisher nicht öffentlich publiziert.
Hier eine Übersicht der Kommandos (unter Anbindung an Loxone ist dann erklärt, wie diese benutzt werden)
Kommando (hex) | Funktion |
---|---|
0040 | Stufe 1 |
0041 | Stufe 2 |
0042 | Stufe 3 |
0043 | Standby |
0044 | Automatik |
0045 | Manueller Modus |
0046 | Turbo |
011B | Lüfterstufe erhöhen |
011D | Lüfterstufe verringern |
Nachtmodus (nur mit aktueller Internorm I-Tec Firmware!) | |
0054 | Nachtmodus - Einblasen Stufe 1 |
0055 | Nachtmodus - Einblasen Stufe 2 |
0056 | Nachtmodus - Einblasen Stufe 3 |
0057 | Nachtmodus - Ausblasen Stufe 1 |
0058 | Nachtmodus - Ausblasen Stufe 2 |
0059 | Nachtmodus - Ausblasen Stufe 3 |
I-Tec Jalousien
Kommando (hex) | Funktion |
---|---|
000D | Ab/Aus |
000C | Auf/An |
0007 | Stopp |
0040-004F | Lamellenposition |
0140-0147 | Position speichern |
0148-014F | Position anfahren |
1800-1864 | 0-100% fahren |
Es gibt auch Servicebefehle, die eine andere Befehlssequenz erfordern. Diese dienen der Identifikation der Geräte (werden von der SmartWindow App benutzt) und sind für die Steuerung über Loxone nicht relevant. |
Für die Steuerung wird die Device-ID benötigt - das ist eine von der Box aufsteigend vergebene Nummer (startend mit 01). Die Device-ID wird zwar aufsteigend entsprechend dem Einlernen vergeben, unglücklicherweise zeigt die App die Device-ID aber nicht an, und über die API erhält man zwar die Device-ID, kann aber den Raum/Gerät nicht auslesen. Daher ist es notwendig, nach der Integration einfach auszutesten, welche ID welches Gerät steuert.
Um alle Device-IDs aufgelistet zu bekommen, folgende URL in den Webbrowser eingeben:
http://<Gateway>/command?XC_FNC=GetStates
Dies listet alle Devices auf:
{XC_SUC}[{"type":"IN","adr":"01","state":"090000"},{"type":"IN","adr":"66","state":"000000"},{"type":"IN","adr":"02","state":"090000"},{"type":"IN","adr":"03","state":"090000"},{"type":"IN","adr":"04","state":"090000"},{"type":"IN","adr":"05","state":"090000"},{"type":"IN","adr":"06","state":"090000"}, {"type":"IN","adr":"07","state":"090000"}]
Alle Geräte mit Type IN sind I-Tec Geräte. Die Adressen bei diesen Geräten sind 01 bis 07. Das Gerät mit der Adresse 66 kann man ignorieren.
Template für virtuelle Ausgänge für den I-Tec Lüfter herunterladen: VO_SmartWindow I-Tec Lüfter.zip
Templates in Loxone Config einbinden
Bei Verwendung I-Tec Lüfter Templates muss danach die IP des Gateways eingetragen werden, sowie bei allen Befehlen die Adresse des Lüfters angepasst werden (im Template wird die Adresse 01 benutzt).
Beispiel: /command?XC_FNC=SendSC&type=IN&data=010040
Auch für die I-Tec Jalousie kann das Template verwendet werden, es müssen jedoch alle Befehle geändert werden.
Erstelle ein Template für I-Tec Jalousien!
Die URL beim virtuellen Ausgangs ist:
Adresse | http://<Gateway> |
Verbindung nach Senden schließen | Ein |
Für jedes Gerät und jedes Kommando muss unter dem Virtuellen Ausgangsverbinder ein Virtueller Ausgangsbefehl erstellt werden:
Befehl bei EIN | /command?XC_FNC=SendSC&type=IN&data=<ID><command> |
Als Digitalausgang verwenden | JA |
<ID> ist die Adresse des Geräts (von oben), zweistellig.
<command> ist das Kommando aus der Liste der I-Tec Lüfter bzw. Jalousien.
Beispiel:
/command?XC_FNC=SendSC&type=IN&data=010044
Aktiviert beim ersten Gerät (adr 01) die Automatik (Kommando 0044).
Die I-Tec Jalousie kann die Jalousieposition von 0-100% sowie die Lamellenposition in 16 Stufen direkt anfahren. Dies wird über einen Ausgangsbefehl als Analogwert durchgeführt:
Beispiel Jalousieposition:
Befehl bei EIN | /command?XC_FNC=SendSC&type=IN&data=<ID>18\x<v> |
Als Digitalausgang verwenden | NEIN |
Als Eingangswert für den Befehl muss die Position (0-100) übergeben werden.
Das konnte ich mangels I-Tec Jalousien nicht testen. Hilf mit! Prüfe, ob die Angabe richtig ist. Wenn ja, entferne diesen Hinweis. Wenn nein, stelle die Erklärung richtig!
Template für virtuelle Eingänge des I-Tec Lüfters: VI_iTec Lüfter.zip
Templates in Loxone Config einbinden
Bei Verwendung I-Tec Lüfter Templates für einen virtuellen HTTP Eingang muss danach die IP des Gateways sowie die Adresse des Lüfters angepasst werden (im Template wird die Adresse 01 benutzt).
Beispiel: http://<gateway>/command?XC_FNC=inGetState&adr=01
Auch für die I-Tec Jalousie kann das Template verwendet werden, es müssen jedoch alle Befehlserkennungen geändert werden.
Erstelle ein Template für I-Tec Jalousien!
Aufgrund des eingeschränkten Funktionsumfanges der Befehlserkennung müssen die eingehenden Stati, auch bei Verwendung des Templates, noch speziell ausgewertet werden. Siehe unten. |
Der Status der Lüfter kann, pro I-Tec Gerät, folgendermaßen in einem Virtuellen HTTP Eingang abgefragt werden:
http://<Gateway>/command?XC_FNC=inGetState&adr=01
I-Tec Lüfter
Die Rückmeldung wird als JSON geliefert und kann (wenn Bedarf besteht) mit Virtuellen HTTP Eingangsbefehlen abgefragt und mit der Befehlserkennung ausgelesen werden.
{XC_SUC}{"state":"09090000030101010201"}
Jeweils zwei Zeichen (1 Byte) repräsentieren einen Zustand lt. folgender Tabelle:
Die farblich markierten Bytes sind in dieser Tabelle angegeben. Die weiteren Zahlen geben weitere, weniger wichtige Stati aus, ich habe sie jetzt hier der Übersichtlichkeit halber nicht extra dokumentiert.
Byte 1 | Modus | Byte 2 | Filterzustand | Byte 3 | Fehlerstatus |
---|---|---|---|---|---|
01 | Initialisierung | 00 | kein Fehler | 00 | kein Fehler |
02 | Hochstartphase | 01 | Filter prüfen | <> 00 | Fehler |
03 | Standby | ||||
04 | Stufe 1 | ||||
05 | Stufe 2 | ||||
06 | Stufe 3 | ||||
07 | Turbo | ||||
08 | Automatik Stufe 0 | ||||
09 | Automatik Stufe 1 | ||||
0A | Automatik Stufe 2 | ||||
0B | Automatik Stufe 3 | ||||
0C | Klappe 1 geschlossen | ||||
0D | Klappe 2 geschlossen | ||||
0E | Fehlerzustand | ||||
0F | Turbo Auswahl Modus | ||||
10 | Entsperr-Auswahl Modus | ||||
11 | Nacht Einblasen Auswahl Modus | ||||
12 | Nacht Ausblasen Auswahl Modus |
Die Rückmeldung wird als JSON geliefert und kann (wenn Bedarf besteht) mit Virtuellen HTTP Eingangsbefehlen abgefragt und mit der Befehlserkennung ausgelesen werden.
{XC_SUC}{"state":"0E0000000000000000000000000000''}
Jeweils zwei Zeichen (1 Byte) repräsentieren einen Zustand lt. folgender Tabelle:
Die farblich markierten Bytes sind in dieser Tabelle angegeben. Die weiteren Zahlen geben weitere, weniger wichtige Stati aus, ich habe sie jetzt hier der Übersichtlichkeit halber nicht extra dokumentiert.
Byte 1 bitweise | Status | Byte 2 | Lamellenposition | Byte 3 | Jalousieposition |
---|---|---|---|---|---|
Bit 0 | charging | 00-3C | 00 unten, 3C oben | 00-64 | 0-100% |
Bit 1 | pulling up blocked (low voltage) | ||||
Bit 2 | Not enough voltage on the photovoltaic cell | ||||
Bit 3 | Temperature to low/high for charging | ||||
Bit 4 | pulling up blocked (high temperature) | ||||
Bit 5 | address searching mode blocked (blind locked) | ||||
Bit 6 | motor fully blocked (very low voltage) | ||||
Bit 7 | res. |
Bitte beachten: Die Werte werden in HEX zurückgegeben - insbesondere relevant für Lamellen- und Jalousieposition.
Funktionsbeispiele für Internorm I-Tec Lüfter
Funktionsbeispiele für Internorm I-Tec Jalousien
Setze diesen Artikel auf "Beobachten" (rechts oben), dann wirst du vom Wiki bei Änderungen per E-Mail informiert. |