Der Grundbaustein der XTENSION Nodes enthält einen eigenen Webserver auf dem Gira X1. Er liefert die Benutzeroberfläche, Charts, Energiemonitor und Listen aus, nimmt WebRequests entgegen und stellt eigene Dateien von der Micro-SD-Karte bereit. Dieses Kapitel gibt einen Überblick über alle Adressen und Parameter.
1. Adressen im Überblick
Der Webserver ist unter http://<ip-adresse-vom-girax1>:8081 erreichbar. Der Port 8081 ist fest eingestellt.
| Adresse | Inhalt |
|---|---|
/settings/ | Benutzeroberfläche zur Konfiguration (Anmeldung mit einem Benutzer des Gira X1) |
/charts/series | Charts mit Wertverläufen (siehe Charts) |
/charts/energy bzw. /charts/monitor.html | Energiemonitor (siehe Energiemonitor) |
/charts/values | Aktuelle Werte als Kreis- oder Ringdiagramm (Abschnitt 3) |
/charts/bars | Aktuelle Werte als gestapelter Balken (Abschnitt 3) |
/charts/values.json | Alle aktuellen Werte als JSON (Abschnitt 4) |
/lists/ | Listenansicht (siehe Listenansicht) |
/addins/<kennung>/ | Installierte Erweiterungen (siehe Erweiterungen) |
/virtual/… | Empfang von WebRequests, wird immer mit „200 OK“ beantwortet (siehe WebRequests empfangen) |
/mcp | KI-Schnittstelle (siehe KI-Schnittstelle (MCP)) |
| alle anderen Adressen | Eigene Dateien aus dem Webserver-Verzeichnis der Micro-SD-Karte (Abschnitt 2) |
Wichtig: Charts, Energiemonitor, Listen, Erweiterungen und eigene Dateien werden nur mit einer gültigen Lizenz ausgeliefert. Ohne Lizenz antwortet der Webserver mit „401 – No valid license“.
2. Eigene Dateien bereitstellen
Alle Dateien im Webserver-Verzeichnis der Micro-SD-Karte sind direkt über den Webserver abrufbar. Standardmäßig ist das der Ordner /opt/card/www/. Den Namen des Ordners legen Sie am Grundbaustein mit dem Parameter „WebServer Verzeichnis (Micro SD Karte)“ fest.
| Datei auf der Micro-SD-Karte | Adresse |
|---|---|
/opt/card/www/beispiel.html | http://192.168.100.3:8081/beispiel.html |
/opt/card/www/visu/grundriss.svg | http://192.168.100.3:8081/visu/grundriss.svg |
- Bilder (
.png,.jpg,.gif) werden unverändert ausgeliefert. - Textdateien wie
.html,.svg,.cssoder.jskönnen Platzhalter für aktuelle Werte enthalten, die der Webserver beim Abruf ersetzt (siehe Benutzerdefinierte Oberflächen). - Dateien laden, anlegen und bearbeiten Sie im Register „Dateien“ (siehe Dateiexplorer).
3. Aktuelle Werte als Diagramm
Für einfache Anzeigen aktueller Werte – ohne Verlauf – gibt es zwei fertige Diagramme. Die Werte stammen aus den Bausteinen zur Werteaufzeichnung; angegeben wird jeweils die Nummer des Datenpunkts.
Kreis- oder Ringdiagramm – zeigt die Anteile mehrerer Werte:
http://192.168.100.3:8081/charts/values?i=10,60,31&l=PV,Haus,Wärmepumpe&t=donut&c=bbce00,3e8df3,eb5564&r=10
Gestapelter Balken – zeigt die Anteile in einer Zeile, z. B. die Verbraucher im Haus:
http://192.168.100.3:8081/charts/bars?i=61,62,63&l=Waschmaschine,Geschirrspüler,Kühlschrank&u=W&c=bbce00,3e8df3,f3b344
| Parameter | Bedeutung | gilt für |
|---|---|---|
i | Nummern der Datenpunkte, durch Kommas getrennt (Pflicht) | values, bars |
l | Beschriftungen in derselben Reihenfolge | values, bars |
c | Farben als Hex-Werte ohne #, durch Kommas getrennt (Standard: bbce00) | values, bars |
r | Neu laden nach Sekunden (Standard: 10) | values, bars |
t | Diagrammart, z. B. pie (Standard), donut oder polarArea | values |
u | Einheit, z. B. W | bars |
st=values | Absolute Werte statt Prozentanteilen anzeigen | bars |
4. Aktuelle Werte als JSON
Für eigene Programme oder Webseiten mit JavaScript liefert /charts/values.json alle aktuellen Werte auf einmal:
{ "input1": "12.4", "input2": "21.6", "input10": "4320", …, "temperature": "12.4", "energyprice": "0.2864" }Der Schlüssel inputN entspricht der Nummer des Datenpunkts. temperature und energyprice sind die Werte der Eingänge „Aktuelle Außentemperatur“ und „Aktueller Energiepreis“ am Grundbaustein. Die Antwort darf auch von Webseiten anderer Adressen abgerufen werden.
5. Parameter des Grundbausteins
| Parameter | Bedeutung |
|---|---|
| WebServer Verzeichnis (Micro SD Karte) | Ordner auf der Micro-SD-Karte für eigene Dateien (Standard: www) |
| Gira S1 IP-Adresse (optional) | Interne Adresse eines Gira S1 für den Fernzugriff. Anfragen von dieser Adresse erhalten angepasste Seiten, damit Charts und Energiemonitor auch über die Gira Smart Home App unterwegs funktionieren. |
Tipp: Alle Anfragen an den Webserver werden im Register „Diagnose“ protokolliert. Dort sehen Sie, welche Adressen tatsächlich aufgerufen werden.