SCHREIBEDATEI
Syntax :
SCHREIBEDATEI("Speicherort/Dateiname","Text",Zeilenvorschubcode)
Mit dieser Anweisung können Textdateien erstellt werden.
Je nach Typ der verwendeten Zentrale werden unterschiedliche Verzeichnisse verwendet.
Als erster Parameter in der Klammer wird der Dateiname angegeben, als zweiter Parameter die Zeile, die in die Datei geschrieben werden soll. Beide Parameter sind vom Typ Zeichen und können Konstanten oder Variablen sein. Der Dateiname kann auch einen gültigen Pfad beinhalten, dieser muss dann aber schon vorhandenen sein, es wird kein neues Verzeichnis angelegt falls ein nicht existierendes Verzeichnis angegeben wird.
Als dritter Parameter wird angegeben welcher Zeilenvorschub für die ausgegebene Zeile verwendet werden soll. Dieser Parameter ist vom Typ Zahl und kann als Konstante oder Variable angegeben werden. Es gibt folgende Codes für den Zeilenvorschub:
0 = kein Zeilenvorschub, die nächste Ausgabe beginnt unmittelbar hinter dieser Zeile
1 = Linux Zeilenvorschub (LF), es wird nur ein Linefeed ausgegeben, mit einem Editor unter Windows wird normalerweise kein Zeilenvorschub dargestellt.
2 = Windows-Zeilenvorschub (CR/LF), es werden die für Windows üblichen zwei Codes für den Zeilenvorschub ausgegeben, so dass die Datei nach einem Download unter Windows mit einem Texteditor betrachtet werden kann. Im Normalfall sollte diese Option benutzt werden.
Bei der CCU1 werden die Textdateien auf einem USB-Stick, der in der Zentrale eingesteckt sein muss, geschrieben.
Bei der CCU2 kann sowohl auf die SD-Karte wie auch auf einen USB-Stick geschrieben werden.
Hinweise zum Einbunden eines USB-Sticks finden Sie weiter unten auf dieser Seite.
Wenn auf die SD-Karte der CCU2 geschrieben werden soll muss diese über die WEB-UI initialisiert und eingebunden worden sein. Das passiert im Menüpunkt Einstellungen->Systemsteuerung->Speichereinstellungen.
Auf welches Medium bzw. in welches Verzeichnis geschrieben wird, kann im Reiter Zentrale des Hardwarefensters festgelegt werden. Bei der CCU1 kann das Verzeichnis nicht verändert werden, da nur das vorgegebene Verzeichnis verfügbar ist. Bei der CCU2 kann ein beliebiges Verzeichnis als Standardverzeichnis angegeben werden. Voreingestellt ist der Standardpfad für die SD-Karte. Falls standardmässig auf einen USB-Stick geschrieben werden soll, muss der Pfad /var/datadisk/ angegeben und der USB-Stick eingebunden werden.
Wenn in der Anweisung nur der Dateiname ohne Pfadangabe benutzt wird wird in das festgelegte Standardverzeichnis geschrieben. Wenn vor dem Dateinamen ein Pfad angegeben ist wird die Datei an den angegebenen Ort geschrieben.
Als erster Parameter in der Klammer wird der Dateiname (ggfs. mit Pfad wenn nicht das eingestellte Standardverzeichnis benutzt werden soll) angegeben, als zweiter Parameter die Zeile, die in die Datei geschrieben werden soll. Beide Parameter sind vom Typ Zeichen und können Konstanten oder Variablen sein. Der Dateiname kann auch einen gültigen Pfad beinhalten, dieser muss dann aber auf dem USB-Stick vorhandenen sein erstellt werden.
Als dritter Parameter wird angegeben welcher Zeilenvorschub für die ausgegebene Zeile verwendet werden soll. Dieser Parameter ist vom Typ Zahl und kann als Konstante oder Variable angegeben werden. Es gibt folgende Codes für den Zeilenvorschub:
0 = kein Zeilenvorschub, die nächste Ausgabe beginnt unmittelbar hinter dieser Zeile
1 = Linux Zeilenvorschub (LF), es wird nur ein Linefeed ausgegeben, mit einem Editor unter Windows wird normalerweise kein Zeilenvorschub dargestellt.
2 = Windows-Zeilenvorschub (CR/LF), es werden die für Windows üblichen zwei Codes für den Zeilenvorschub ausgegeben, so dass die Datei nach einem Download unter Windows mit einem Texteditor betrachtet werden kann. Im Normalfall sollte diese Option benutzt werden.
Bevor der USB-Stick entfernt wird muss die Anwendung SCHLIESSEDATEIEN ausgeführt werden, sonst gehen die zuletzt geschriebenen Daten bzw. Dateien verloren.
Bitte beachten Sie unbedingt:
Der USB-Stick muss formatiert sein und vor dem Start der Zentrale eingesteckt werden. Nach dem Einstecken eines USB-Sticks muss die Zentrale ggfs. neu gebootet werden oder der USB-Stick muss über den entsprechenden Punkt des WEB-Servers eingebunden werden.
Das passiert mit dem untersten Button auf der Seite http://<IP der Zentrale>/addons/contronics/files/workfiles.cgi
Über diese WEB-Server-Seite können die Dateien bearbeitet werden und es kann ein Download der Dateien durchgeführt werden.
Bevor Dateien bearbeitet oder downgeloadet werden muss die Anweisung SCHLIESSEDATEIEN ausgeführt werden, damit alle geschriebenen Daten in den Dateien vorhanden sind. Ein USB-Stick sollte nicht entfernt werden bevor die Dateien durch Download gesichert wurden.
Bei der Angabe eines Pfads, bei dem in andere Verzeichnisse als die Standardverzeichnisse für SD-Karte oder USB-Stick geschrieben wird kann das Betriebssystem der Zentrale und die Systemstabilität beschädigt werden. Auf andere Verzeichnisse als die angegebenen Standardverzeichnisse kann über das Webserverprogramm nicht zugegriffen werden, d.h. Dateien an anderen Orten können nicht über das Browserprogramm gewartet werden. Benutzen Sie andere Verzeichnisse als die Standardverzeichnisse nur wenn Sie genau wissen was Sie tun und über entsprechende Fachkenntnisse verfügen.
Wenn das Standardverzeichnis für USB-Stick der SD-Karte angegeben wird und diese nicht eingebunden worden sind, wird auf die RAMDISK der Zentrale geschrieben.
Wenn die Dateien dort zu viel Platz beanspruchen wird die Funktionalität der Zentrale beeinträchtigt und es kommt zu Fehlfunktionen oder Absturz !
Die Anweisung SCHREIBEDATEI sollte also möglichst immer nur Dateien auf SD-Karte oder USB-Stick schreiben. Andernfalls müssen die Dateien regelmässig kontrolliert und ggfs. gelöscht werden. Andernfalls kann es passieren, dass zu viel Speicher der Zentrale belegt wird und ein normaler Betrieb nicht mehr möglich ist.
Beispiel:
(Zeile ist im Makro als Variable vom Typ Zeichen definiert)
Zeile:="Uhrzeit " + Uhrzeit + ": Bewegungsmelder Haustür"
SCHREIBEDATEI("BEWEGUNGEN.TXT",Zeile,2)
Beschreibung der Verwendung dieser Anweisung wenn der PC als Zentrale benutzt wird:
In welches Verzeichnis standardmässig geschrieben wird, kann im Reiter Zentrale des Hardwarefensters festgelegt werden.
Es kann auch Dateiname angegeben werden, der einen Pfad beinhaltet.
Beispiel:
SCHREIBEDATEI("c:\daten\CL\MeineDatei.txt","Das ist der Text",2)