Dateiexplorer – xtension-nodes.de

Der Dateiexplorer (Register „Dateien“, Seitentitel „Dateiverzeichnis“) gibt Ihnen direkten Zugriff auf die Dateien Ihres Gira X1. Sie sehen, welche Daten die XTENSION Nodes auf der microSD-Karte ablegen, können eigene Dateien für den integrierten Webserver hochladen, Textdateien direkt im Browser bearbeiten und die Pflege der Aufzeichnungsdaten (Backup und Komprimierung) von Hand anstoßen.

Dieses Kapitel erklärt alle Bereiche und Funktionen der Seite Schritt für Schritt, beschreibt die wichtigsten Ordner auf der microSD-Karte und gibt Hinweise, worauf Sie beim Ändern und Löschen achten sollten.

1. Dateiexplorer öffnen

Login in die Benutzeroberfläche unter http://<ip-adresse-vom-girax1>:8081/settings.
Wechseln Sie zum Register „Dateien“.
Der Dateiexplorer startet immer im Hauptverzeichnis /opt/card/. Das ist das Stammverzeichnis der microSD-Karte im Gira X1.

2. Voraussetzung: die microSD-Karte

Die XTENSION Nodes speichern alle Aufzeichnungen und eigenen Dateien auf der microSD-Karte des Gira X1. Ob die Karte erkannt wurde, zeigt der Ausgang „Micro SD Karte“ des Grundbausteins im Logikblatt (Weboberfläche des Gira X1, Register „Logikübersicht“):

„Micro SD Karte verfügbar (lesend / schreibend)“: Alles in Ordnung, alle Funktionen des Dateiexplorers stehen zur Verfügung.
„Micro SD Karte verfügbar (nur lesend)“: Sie können Dateien ansehen und herunterladen, aber nichts anlegen, hochladen, ändern oder löschen. Die Schaltflächen dafür sind ausgegraut.
„Keine Micro SD Karte gefunden“: Es gibt keinen Speicherplatz für Aufzeichnungen und eigene Dateien. Setzen Sie eine Karte ein und starten Sie den Gira X1 neu.

Weitere Hinweise zur Karte finden Sie im Kapitel Systemvoraussetzungen.

3. Aufbau der Seite

Die Seite besteht aus drei Bereichen:

Überschrift „Verzeichnis durchsuchen:“ mit dem vollständigen Pfad des Ordners, den Sie gerade sehen, z. B. /opt/card/www/. Darunter steht ein kurzer Hilfetext.
Dateiliste in der Mitte mit allen Ordnern und Dateien des aktuellen Ordners.
Werkzeugleiste rechts mit den Abschnitten „Navigation“, „Funktionen“ und „Chartdaten“.

Die Dateiliste hat folgende Spalten:

Spalte	Bedeutung
(Symbol)	Zeigt die Art des Eintrags (siehe unten). Ein Klick auf das Ordnersymbol öffnet den Ordner.
Name	Name des Ordners oder der Datei. Ein Klick öffnet den Ordner bzw. die Datei.
Erstellt am	Datum und Uhrzeit, zu der der Eintrag angelegt wurde.
Geändert am	Datum und Uhrzeit der letzten Änderung. Bei Aufzeichnungsdateien sehen Sie hier, wann zuletzt ein Wert geschrieben wurde.
Größe	Dateigröße in Bytes (1.024 Bytes = 1 KB). Bei Ordnern bleibt die Spalte leer.
(Aktionen)	Symbole für Anzeigen, Bearbeiten, Umbenennen und Löschen. Es erscheinen nur die Aktionen, die für den Eintrag möglich sind.

Zuerst werden die Ordner, danach die Dateien angezeigt, jeweils alphabetisch sortiert. Die Symbole bedeuten:

Symbol	Bedeutung
Pfeil nach oben „…“	Eine Ebene höher wechseln (übergeordneter Ordner)
Ordner	Unterordner
Datenbank	Aufzeichnungsdatei der XTENSION Nodes (`.dat`)
Bild	Grafik (`.svg`, `.png`, `.jpg`)
Beschriftung	Beschriftungsdatei eines Datenpunkts (`.lbl`)
Datei	Alle anderen Dateien

4. Navigieren

Ordner öffnen: Klicken Sie auf den Namen oder das Symbol des Ordners.
Eine Ebene höher: Klicken Sie in der ersten Zeile der Liste auf „…“ bzw. auf den Pfeil nach oben.
Zurück zum Anfang: Sobald Sie sich nicht im Hauptverzeichnis befinden, erscheint in der Werkzeugleiste der Abschnitt „Navigation“ mit der Schaltfläche „Zum Hauptverzeichnis“. Sie bringt Sie direkt zurück nach /opt/card/.
Wo bin ich? Der aktuelle Pfad steht immer in der Überschrift „Verzeichnis durchsuchen:“.

Wichtig: Über „…“ können Sie auch Ordner oberhalb der microSD-Karte öffnen und so die Verzeichnisstruktur des Gira X1 ansehen. Diese Bereiche gehören zum Betriebssystem des Gira X1. Legen Sie dort nichts an und ändern, benennen oder löschen Sie dort nichts – auch dann nicht, wenn die Funktionen angeboten werden. Fehler in diesen Bereichen können dazu führen, dass der Gira X1 nicht mehr startet. Arbeiten Sie ausschließlich unterhalb von /opt/card/.

5. Die wichtigsten Ordner auf der microSD-Karte

Die folgende Übersicht hilft Ihnen, sich auf der Karte zurechtzufinden. Je nach Projekt sehen Sie nicht alle Ordner, oder es gibt zusätzliche Ordner anderer Anwendungen.

Ordner / Datei	Inhalt	Hinweis
`/opt/card/data/`	Alle Aufzeichnungen der XTENSION Nodes	Grundlage für Charts, Energiemonitor und Listen. Nur mit Bedacht ändern.
`/opt/card/data/<Nummer>/<Jahr>/<Monat>/<JJJJMMTT>.dat`	Die aufgezeichneten Werte eines Datenpunkts, eine Datei pro Tag. `<Nummer>` ist die „Eingang Nummer (Projekt-Eindeutig)“ des Bausteins zur Werteaufzeichnung.	Ordner- und Dateinamen nicht ändern, sonst findet der Chart die Daten nicht mehr.
`/opt/card/data/<Nummer>/compression.state`	Merker der Komprimierung: bis zu welchem Tag dieser Datenpunkt bereits komprimiert ist	Wird automatisch verwaltet. Nicht ändern.
`/opt/card/data/messages/<Jahr>/<Monat>/`	Aufgezeichnete Nachrichten mit Zeitstempel und Kategorie	Siehe Kapitel Nachrichten.
`/opt/card/data/<Jahr>/<Monat>/<JJJJMMTT>-<Bezeichnung>.csv`	CSV-Aufzeichnung, wenn am Baustein „Wert als CSV-Dateien aufzeichnen“ aktiviert ist	Ideal zum Herunterladen und Weiterverarbeiten, z. B. in Excel.
`/opt/card/data/backup/`	Ablage des Backups	Siehe Abschnitt 14.
`/opt/card/www/`	Stammverzeichnis des integrierten Webservers für eigene Webseiten, Grafiken und Skripte	Der Ordnername wird am Grundbaustein mit dem Parameter „WebServer Verzeichnis (Micro SD Karte)“ festgelegt (Standard: `www`).
`/opt/card/www/recorded-images/`	Standardablage für aufgezeichnete Bilder	Der Ordner wird am Baustein mit dem Parameter „Relativer Pfad (Micro SD)“ eingestellt.
`/opt/card/addins/<ID>/`	Installierte Erweiterungen (AddIns); der Unterordner `files` enthält die angezeigten Inhalte	Siehe Kapitel Erweiterungen.

Tipp: Wie viel Platz ein einzelner Datenpunkt belegt, sehen Sie auch auf der Konfigurationsseite für Charts unter „Detaillierte Informationen“.

6. Dateien öffnen und herunterladen

Ein Klick auf den Namen einer Datei öffnet einen neuen Browser-Tab. Bilder werden dort angezeigt, alle anderen Dateien bietet der Browser zum Herunterladen an. So können Sie z. B. CSV-Aufzeichnungen auf Ihren PC holen oder vor einer Änderung eine Sicherheitskopie einer Webseite anlegen.

Hinweis: Das Herunterladen ist für Text-, CSV-, HTML-, Aufzeichnungs- (.dat) und Bilddateien gedacht. Andere Binärdateien (z. B. ZIP-Archive) können dabei unbrauchbar werden.

7. Dateien im Browser anzeigen

Für Dateien, die der integrierte Webserver ausliefern kann, erscheint in der Aktionsspalte ein Auge („Datei anzeigen“). Ein Klick öffnet die Datei so, wie sie später auch in einer Visualisierung oder in der Gira Smart Home App erscheint – inklusive aller dynamischen Platzhalter, die durch aktuelle Werte ersetzt werden.

Das Auge erscheint nur, wenn beide Bedingungen erfüllt sind:

Die Datei liegt im Webserver-Ordner /opt/card/www/ (auch in Unterordnern) oder im Ordner /opt/card/addins/<ID>/files/ einer Erweiterung.
Es handelt sich um eine Webdatei: .htm, .html, .part, .css, .js, .json, .xml, .txt, .ini, .log, .svg, .png, .jpg, .jpeg, .gif oder .bmp.

Aus dem Speicherort ergibt sich die Adresse, unter der die Datei im Netzwerk erreichbar ist:

Speicherort im Dateiexplorer	Adresse im Browser
`/opt/card/www/beispiel.html`	`http://<ip-adresse-vom-girax1>:8081/beispiel.html`
`/opt/card/www/visu/haus.svg`	`http://<ip-adresse-vom-girax1>:8081/visu/haus.svg`
`/opt/card/addins/<ID>/files/index.html`	`http://<ip-adresse-vom-girax1>:8081/addins/<ID>/index.html`

Tipp: Genau diese Adresse können Sie in der Gira Smart Home App oder in einer anderen Visualisierung als Webseite einbinden. Für SVG-Grafiken gibt es zwei nützliche Zusätze:

?r=10 – bettet die Grafik in eine Seite ein, die sich automatisch alle 10 Sekunden aktualisiert (die Zahl ist frei wählbar), z. B. http://<ip-adresse-vom-girax1>:8081/visu/haus.svg?r=10.
?darkmode – stellt Linien und Texte, die in der Grafik mit currentColor gezeichnet sind, für dunkle Hintergründe hell dar.

Wie Sie Platzhalter für aktuelle Werte in eigene Dateien einbauen, erklärt das Kapitel Webserver.

8. Ordner erstellen

Wechseln Sie in den Ordner, in dem der neue Ordner angelegt werden soll.
Klicken Sie in der Werkzeugleiste unter „Funktionen“ auf „Ordner erstellen…“. Am Ende der Ordnerliste erscheint eine neue Zeile mit einem Eingabefeld.
Geben Sie den Namen ein.
Bestätigen Sie mit dem Haken oder mit der Eingabetaste. Mit dem X oder der Esc-Taste brechen Sie ab.

Für Namen von Ordnern und Dateien gelten folgende Regeln. Solange der Name nicht passt, ist der Haken ausgegraut:

Erlaubt: Buchstaben a–z und A–Z, die Umlaute ä ö ü, Ziffern 0–9, Unterstrich _, Punkt . und Bindestrich -.
Leerzeichen sind nur zwischen Wörtern erlaubt, nicht am Anfang oder Ende.
Nicht erlaubt: ß, große Umlaute Ä Ö Ü und Sonderzeichen wie / \ : * ? " < > | & # %.
Der Name darf im aktuellen Ordner noch nicht vorkommen. Der Gira X1 unterscheidet Groß- und Kleinschreibung: Bilder und bilder sind zwei verschiedene Ordner.

Empfehlung: Verwenden Sie für Inhalte des Webservers nur Kleinbuchstaben, Ziffern und Bindestriche, z. B. wetter-station.html. Leerzeichen und Umlaute müssen in Adressen umschrieben werden und führen leicht zu Fehlern.

9. Neue (leere) Datei erstellen

Wechseln Sie in den gewünschten Ordner.
Klicken Sie unter „Funktionen“ auf „Datei erstellen …“. Am Ende der Dateiliste erscheint eine neue Zeile.
Geben Sie den Dateinamen mit Endung ein, z. B. hinweis.html. Die Endung entscheidet, wie die Datei später behandelt wird.
Bestätigen Sie mit dem Haken oder der Eingabetaste. Die Datei wird leer (0 Bytes) angelegt.
Füllen Sie die Datei anschließend über das Symbol „Datei bearbeiten“ (siehe Abschnitt 11).

10. Dateien hochladen

Wechseln Sie in den Zielordner, z. B. /opt/card/www/.
Klicken Sie unter „Funktionen“ auf „Datei hochladen…“. Das Fenster „Datei hochladen“ öffnet sich.
Klicken Sie in die Fläche „Klicken Sie hier, um eine Datei für den Upload auszuwählen…“ und wählen Sie die Datei auf Ihrem PC aus. Statt „Keine Datei ausgewählt“ steht nun der Dateiname in der Fläche.
Klicken Sie auf „OK“. Während der Übertragung erscheint „Hochladen…“. Danach wird die Dateiliste automatisch aktualisiert.

Folgende Dateitypen können ausgewählt werden: .svg, .txt, .htm, .html, .css, .js, .ics (Kalenderdateien) und .dat (Aufzeichnungsdateien, z. B. zum Zurückspielen einer Sicherung).

Wichtig: Gibt es im Zielordner bereits eine Datei mit demselben Namen, wird sie ohne Rückfrage überschrieben. Laden Sie die vorhandene Datei vorher herunter, wenn Sie sie behalten möchten.

Dateigröße: Der Gira X1 hat nur wenig Arbeitsspeicher. Halten Sie Dateien möglichst klein (empfohlen: bis etwa 500 KB). Bei größeren Dateien kann die Übertragung abbrechen.
Dateiname: Die Datei behält den Namen, den sie auf Ihrem PC hat. Benennen Sie sie vorher nach den Regeln aus Abschnitt 8 um.
Ein Upload pro Vorgang: Mehrere Dateien laden Sie nacheinander hoch.

11. Dateien im Browser bearbeiten

Textdateien können Sie direkt im Browser bearbeiten. Dafür erscheint in der Aktionsspalte ein Stift („Datei bearbeiten“). Das ist möglich bei den Endungen .txt, .htm, .html, .part, .json, .xml, .ini, .css, .js und .log – und nur in Ordnern, in die geschrieben werden darf.

Klicken Sie auf den Stift. Der Editor öffnet sich im Vollbild, oben steht der vollständige Pfad der Datei.
Bearbeiten Sie den Inhalt. Der Editor bietet Zeilennummern, automatischen Zeilenumbruch und eine farbliche Hervorhebung für HTML, JavaScript und JSON.
Klicken Sie auf „Speichern“. Die Änderung ist sofort wirksam. Mit „Abbrechen“ schließen Sie den Editor, ohne zu speichern.

Wichtig: Auch die Esc-Taste schließt den Editor – ohne zu speichern und ohne Rückfrage. Speichern Sie bei längeren Änderungen zwischendurch. Vor größeren Umbauten lohnt sich eine Sicherheitskopie (Datei herunterladen, siehe Abschnitt 6).

Einfügehilfen für Erweiterungen: Bearbeiten Sie eine .part-Datei im Ordner /opt/card/addins/<ID>/files/, zeigt der Editor zusätzlich eine Werkzeugleiste. Wählen Sie dort unter „Datenpunkt“ einen aufgezeichneten Datenpunkt aus und fügen Sie an der Cursorposition ein:

„Variable einfügen“: den aktuellen Wert des Datenpunkts, z. B. {{ dataPoints['value12'].value }}.
„Bedingung einfügen“: einen Bereich, der nur bei einem bestimmten Wert angezeigt wird, z. B. <div ng-if="parseFloat(dataPoints['value12'].value) == 1"> Wert ist 1 </div>. Passen Sie Vergleichswert und Text an.
„Auswahl einfügen“: eine Auswahl mit unterschiedlichen Texten je Wert (Wert 1, Wert 2, alle anderen Werte).
„Bild einfügen“: ein Bild-Element, in dem Sie nur noch Adresse und Beschreibung ergänzen.

Mehr dazu im Kapitel Erweiterungen.

12. Ordner und Dateien umbenennen

Klicken Sie in der Aktionsspalte auf das Symbol „Ordner umbenennen“ bzw. „Datei umbenennen“ (Textfeld-Symbol). Der Name wird zu einem Eingabefeld.
Ändern Sie den Namen. Es gelten dieselben Regeln wie beim Anlegen (Abschnitt 8).
Bestätigen Sie mit dem Haken. Mit dem X („Umbenennen abbrechen“) oder der Esc-Taste bleibt der alte Name erhalten.

Wichtig: Mit dem Namen ändert sich auch die Adresse im Browser. Links in Visualisierungen und in der Gira Smart Home App, die auf den alten Namen zeigen, funktionieren danach nicht mehr. Benennen Sie Ordner und Dateien unter /opt/card/data/ nie um – die Namen sind die Datenpunktnummer und das Datum. Ein umbenannter Ordner wird vom Chart nicht mehr gefunden.

13. Ordner und Dateien löschen

Klicken Sie in der Aktionsspalte auf den Papierkorb („Ordner löschen“ bzw. „Datei löschen“).
Das Fenster „Ordner endgültig löschen“ bzw. „Datei endgültig löschen“ zeigt den vollständigen Pfad des Eintrags. Prüfen Sie ihn genau.
Setzen Sie das Häkchen bei „Ich verstehe, dass der Vorgang nicht rückgängig gemacht werden kann.“ Erst dann wird „OK“ freigegeben.
Klicken Sie auf „OK“.

Wichtig: Gelöschte Einträge landen nicht in einem Papierkorb und lassen sich nicht wiederherstellen. Beim Löschen eines Ordners werden alle enthaltenen Ordner und Dateien mitgelöscht. Wenn Sie die Aufzeichnungen eines einzelnen Datenpunkts entfernen möchten, nutzen Sie besser die Aktion „Daten löschen“ auf der Konfigurationsseite für Charts.

14. Bereich „Chartdaten“: Backup und Komprimierung

Im unteren Teil der Werkzeugleiste können Sie zwei Wartungsaufgaben für die Aufzeichnungsdaten von Hand starten. Beide laufen auf dem Gira X1 im Hintergrund weiter, auch wenn Sie die Seite verlassen.

Backup jetzt erstellen

Startet die Sicherung der Aufzeichnungsdaten. Unten auf der Seite erscheint kurz „Backup wurde gestartet…“.
Die Sicherung wird im Ordner /opt/card/data/backup/ abgelegt.
Dieselbe Sicherung können Sie automatisch über den Eingang „Daten sichern“ des Grundbausteins auslösen, z. B. einmal pro Woche über eine Zeitschaltuhr im Logikblatt.

Tipp: Das Backup liegt auf derselben microSD-Karte wie die Originaldaten und schützt daher nicht vor einem Ausfall der Karte. Laden Sie wichtige Daten deshalb regelmäßig zusätzlich auf Ihren PC herunter, z. B. über den CSV-Export auf der Konfigurationsseite für Charts.

Komprimierung jetzt starten

Startet die Komprimierung der Aufzeichnungsdaten. Unten auf der Seite erscheint kurz „Komprimierung wurde gestartet…“.
Komprimiert werden nur Datenpunkte, bei denen am Aufzeichnungsbaustein eine „Komprimierungsmethode“ eingestellt ist. Für jeden älteren Tag werden alle Werte einer Viertelstunde zu einem Wert zusammengefasst – je nach Methode als Minimum, Maximum, Durchschnitt, Summe, erstes Telegramm oder letztes Telegramm.
Der laufende Tag bleibt immer unverändert. Zusätzlich bleiben so viele zurückliegende Tage unverändert, wie am Grundbaustein im Parameter „Unkomprimierte Tage“ eingestellt sind.
Ab Version 2.8.0 arbeitet die Komprimierung schonend: Nach jeder Tagesdatei legt sie eine Pause ein, damit der Gira X1 nicht ausgelastet wird. Beim ersten Lauf mit vielen alten Daten kann sie deshalb mehrere Stunden dauern. Wird der Gira X1 zwischendurch neu gestartet, setzt die nächste Komprimierung an der Stelle fort, an der sie aufgehört hat.
Tage mit Textwerten und Tage, die sich nicht verkleinern lassen, bleiben unverändert.
Automatisch auslösen können Sie die Komprimierung über den Eingang „Daten komprimieren“ des Grundbausteins, am besten einmal täglich in der Nacht.

Wichtig: Die Komprimierung kann nicht rückgängig gemacht werden. Die ursprünglichen Einzelwerte der komprimierten Tage gehen verloren. Legen Sie vorher ein Backup an, wenn Sie die Rohdaten behalten möchten.

15. Meldungen

Meldung	Bedeutung	Was tun?
Keinen Zugriff auf den Ordner	Der Ordner existiert nicht (mehr) oder darf nicht gelesen werden, z. B. weil die microSD-Karte entfernt wurde.	Mit „Zum Hauptverzeichnis“ neu beginnen. Den Ausgang „Micro SD Karte“ des Grundbausteins prüfen.
Hochladen fehlgeschlagen	Die Übertragung wurde abgebrochen, die Datei war zu groß oder der Ordner ist nicht beschreibbar.	Kleinere Datei verwenden, Netzwerkverbindung prüfen und erneut versuchen.
Backup wurde gestartet…	Die Sicherung läuft.	Nichts – reine Information.
Komprimierung wurde gestartet…	Die Komprimierung läuft im Hintergrund.	Nichts – reine Information.

16. Häufige Fragen

Warum sind „Ordner erstellen…“, „Datei hochladen…“ und „Datei erstellen …“ ausgegraut?
Der aktuelle Ordner ist nicht beschreibbar – etwa weil die microSD-Karte nur lesend eingebunden ist oder Sie sich außerhalb von /opt/card/ befinden. Aus demselben Grund fehlen dann auch die Symbole zum Bearbeiten, Umbenennen und Löschen.
Warum fehlt bei meiner Datei das Auge?
Das Auge erscheint nur für Webdateien im Ordner /opt/card/www/ oder im Ordner files einer Erweiterung (siehe Abschnitt 7).
Warum fehlt bei meiner Datei der Stift?
Der Dateityp kann nicht im Browser bearbeitet werden – z. B. .dat, .svg oder Bilder. Laden Sie die Datei herunter, bearbeiten Sie sie auf dem PC und laden Sie sie wieder hoch.
Meine Änderung ist im Browser nicht zu sehen.
Der Browser zeigt noch die zwischengespeicherte Fassung. Laden Sie die Seite mit Strg + F5 (Mac: Cmd + Shift + R) neu.
Meine Datei wird im Browser nicht gefunden.
Prüfen Sie Schreibweise und Groß-/Kleinschreibung der Adresse und ob die Datei wirklich unter /opt/card/www/ liegt. Vermeiden Sie Leerzeichen und Umlaute im Namen.
Kann ich eine Sicherung zurückspielen?
Ja: Laden Sie die .dat-Datei in den passenden Ordner /opt/card/data/<Nummer>/<Jahr>/<Monat>/ hoch. Eine vorhandene Datei gleichen Namens wird dabei überschrieben.

Weiterführende Kapitel

Werte aufzeichnen – wie die Daten entstehen, die Sie im Ordner data sehen
Webserver – eigene Webseiten und SVG-Grafiken mit aktuellen Werten
Erweiterungen – AddIns installieren und anpassen
Diagnose – Protokoll und Fehlersuche