EA uniTFTs Series

Files auf dem internen Speicher #F

Befehlsgruppe um Dateizugriffe zu realisieren

Ordner

Dateien

Allgemeine Befehle

Ordner

Ordner erstellen

Der Befehl legt einen neuen Ordner an. Der Parameter <Pfad> gibt den Namen und den Ort an.

Ordner löschen

Der Befehl löscht einen Ordner. Der Parameter <Pfad> gibt den Namen und den Ort an.

Arbeitsverzeichnis setzen

Der Befehl setzt das aktuelle Arbeitsverzeichnis. Mit dem Pfad </> erreicht man das Root-Verzeichnis.

Arbeitsverzeichnis senden

Der Befehl stellt das aktuelle Arbeitsverzeichnis in den Sendepuffer.  Die Rückmeldung ist folgendermaßen aufgebaut:

Alle Ordner und Dateien des Verzeichnisses senden

Der Befehl stellt alle Ordner und Dateien des aktuellen Arbeitsverzeichnisses in den Sendepuffer. Die Rückmeldung ist folgendermaßen aufgebaut:

Alle Ordner und Dateien des Verzeichnisses senden (ASCII)

Der Befehl stellt alle Ordner und Dateien des aktuellen Arbeitsverzeichnisses als ASCII Strings in den Sendepuffer.

Alle Ordner des Verzeichnisses senden

Der Befehl stellt alle Ordner des aktuellen Arbeitsverzeichnisses in den Sendepuffer. Die Rückmeldung ist folgendermaßen aufgebaut:

Dateien

Achtung:

Flash-Speicher haben Bauartbedingt begrenzte Lösch/Schreibzyklen. Das im uniTFTs eingesetzte Speichermodul kann typischerweise 100.000 Zyklen sicher ausführen. Um Daten zu schreiben kann es sein, dass ein Speicherblock gelöscht werden muss, typischerweise werden für das Löschen 30 ms benötigt, es können aber bis zu 400 ms werden. Das ist bei der Makroabfolge zu beachten, wenn Schreibbefehle ausgeführt werden.

Datei zum schreiben öffnen

Der Befehl öffnet (nur schreiben) bzw. erstellt eine Datei. Der Parameter Position (32-Bit Wert) gibt die Stelle in der Datei an, an die geschrieben werden soll. Die Dateigröße (size) muss angegeben werden. Ein vergrößern der Dateigröße im nach hinein ist möglich (ab V1.2).

Datei schließen (Schreiboperation)

Der Befehl schließt eine geöffnete Datei (Schreiboperation). Der Schreibvorgang wird abgeschlossen und es wird sichergestellt, dass alle Daten geschrieben worden sind. Sind Zeit und Datum angegeben oder die Uhrzeit vorher gesetzt wird der Zeitstempel eingetragen, ansonsten bleibt 1.1.1980 und kann später eingetragen werden.

Schreibposition von Datei setzen

Der Befehl setzt die Schreib-Position (32-Bit Wert) an die bestimmte Stelle in der Datei. Bei einem Wert <0 wird die Postion vom Dateiende aus berechnet

Siehe auch fposW()

Daten in die Datei schreiben

Der Befehl schreibt eine Anzahl (32-Bit Wert) an Binären Daten in die geöffnete Datei. Für die Makroprogrammierung ist dieser Befehl ungeeignet. Er dient zur Übertagung von binären Daten über die Schnittstelle.

ASCII-String in die Datei schreiben

Mit dem Befehl wird ein ASCII-String (8 Bit pro Zeichen) in die geöffnete Datei geschrieben.

Unicode-String in die Datei schreiben

Mit dem Befehl wird ein Unicode-String (16 Bit pro Zeichen) in die geöffnete Datei geschrieben.

Registerwerte in die Datei schreiben

Mit dem Befehl wird der Registerwert (Register-ID) in die geöffnete Datei geschrieben. Ausgelesen werden kann der Wert mit dem Befehl #FRR. Für jedes Register werden 5 Bytes benötigt.

Stringregister in die Datei schreiben

Mit dem Befehl wird der Inhalt des Stringregisters (String-ID) in die geöffnete Datei geschrieben. Ausgelesen werden kann der String mit dem Befehl #FRS. Für jedes Register werden 2·(n+1) Bytes (n=Anzahl der Buchstaben) benötigt.

Array in die Datei schreiben (ab V1.1)

Mit dem Befehl wird der Inhalt des Arrays (Array-ID) in die geöffnete Datei geschrieben. Ausgelesen werden kann der String mit dem Befehl #FRY. Für jedes Integer oder Float Array werden 6+4·n Bytes (n=Länge des Arrays) benötigt. Ein Unicode StringArray benötigt 11+ Maximale Entrysize * Länge des Arrays Bytes.

Binärdaten aus Register in die Datei schreiben (ab V1.3)

Mit dem Befehl wird der Inhalt des Registers (Register-ID) im Binärformat in die geöffnete Datei geschrieben. Ausgelesen werden kann das Register mit dem Befehl #FRV.

Binärdaten aus numerischen Array in die Datei schreiben (ab V1.3)

Mit dem Befehl wird der Inhalt eines numerischen Arrays (Array-ID) im Binärformat in die geöffnete Datei geschrieben. Ausgelesen werden kann das numerische Array mit dem Befehl #FRX.

Binärdaten aus Stringarray in die Datei schreiben (ab V1.3)

Mit dem Befehl wird der Inhalt eines Stringarrays (Array-ID) im Binärformat in die geöffnete Datei geschrieben. Ausgelesen werden kann das Stringarray mit dem Befehl #FRQ.

Datei zum lesen öffnen

Der Befehl öffnet (nur lesen)  eine Datei. Der Parameter Position (32-Bit Wert) gibt die Stelle in der Datei an, ab der gelesen werden soll.

Datei schließen (Leseoperation)

Der Befehl schließt eine geöffnete Datei (Leseoperation).

Leseposition von Datei setzen

Der Befehl setzt die Lese-Position (32-Bit Wert) an die bestimmte Stelle in der Datei. Bei einem Wert <0 wird die Postion vom Dateiende aus berechnet

Siehe auch fposR()

Daten lesen und senden

Der Befehl liest eine Anzahl (32-Bit Wert) an Bytes aus der geöffneten Datei aus und stellt die Daten in den Sendepuffer. Die Rückmeldung ist folgendermaßen aufgebaut:

ASCII-String lesen und in ein Stringregister schreiben

Mit dem Befehl wird ein ASCII-String (8 Bit pro Zeichen) bis zum Zeichen "\n" gelesen und in ein Stringregister (String-ID) gespeichert.

Unicode-String lesen und  in ein Stringregister schreiben

Mit dem Befehl wird ein Unicode-String (16 Bit pro Zeichen) bis zum Zeichen "\n" gelesen und in ein Stringregister (String-ID) gespeichert.

Daten in ein Register laden

Der Befehl liest ein mit #FRW geschriebenes Register zurück und speichert es in das Register (Register-ID).

Daten in ein Stringregister laden

Der Befehl liest ein mit #FRS geschriebenes Stringregister zurück und speichert es in das Stringregister (String-ID).

Daten lesen (8-Bit) und in ein Stringregister schreiben

Der Befehl liest eine beliebige Anzahl (1...250) an Bytes und speichert es in das Stringregister (String-ID).

Daten lesen (16-Bit) und in ein Stringregister schreiben

Der Befehl liest eine beliebige Anzahl (1...250) an Words und speichert es in das Stringregister (String-ID).

Daten in ein Array laden

Der Befehl liest ein mit #FWY geschriebenes Array zurück und speichert es in das Array (Array-ID).

Binäre Daten lesen und in ein Register schreiben (ab V1.3)

Der Befehl liest ein mit #FWV binär geschriebenes Register zurück und speichert es in das Register (Register-ID).

Binäre Daten lesen und in ein numerisches Array schreiben (ab V1.3)

Der Befehl liest ein mit #FWX binär geschriebenes numerisches Array zurück und speichert es in das Array (Array-ID).

Binäre Daten lesen und in ein Stringarray schreiben (ab V1.3)

Der Befehl liest ein mit #FWQ binär geschriebenes Stringarray zurück und speichert es in das Array (Array-ID).

Datei löschen

Der Befehl löscht die Datei (<Dateiname>)

Allgemeine Befehle

Datei Information senden

Der Befehl stellt alle Informationen über die Datei (wie z.B. Zeitstempel, Größe) in den Sendepuffer. Sollte die Datei nicht vorhanden sein, wird ein  Leerstring zurückgegeben, die restlichen Parameter werden nicht mehr übertragen. Die Rückmeldung ist folgendermaßen aufgebaut:

Siehe auch fileS(), fileA(), fileT()

Datei umbenennen

Der Befehl ändert den angegeben <Pfad> in ein neuen Namen (<Neuer Dateiname> ist nur der neue Name, ohne Pfad).

Datei kopieren

Der Befehl kopiert die angegebene Datei (<Pfad>) an einen neuen Ort (<Neuer Pfad>).

Datei verschieben

Der Befehl verschiebt den angegeben Ordner, die angegebene Datei (<Pfad>) an einen neuen Ort (<Neuer Pfad>).

Zeitstempel von Datei ändern

Der Befehl ändert den Zeitstempel der Datei (<Pfad>):

Umrechnungsbeispiel:

Zeit = (Stunde<<11) + (Minute<<5) + (Sekunde>>1);

Datum = ((Jahr-1980)<<9) + (Monat<<5) + Tag;

Siehe auch fatT(datetime), fatD(datetime), fattime(Fat-Time, Fat-Date)

Attribute von Datei ändern

Der Befehl setzt die Attribute der Datei. Die Attribute können mit Bitveroderung gleichzeitig gesetzt werden.

Siehe auch fileA()

Dateinamen in ein Stringregister laden

Der Befehl speichert alle Dateinamen die im <Pfad> vorhanden sind in die Stringregister (String-ID = ID...IDn). Die Anzahl wird im Register (Register-ID = ID) abgelegt. (Es kann mit Widlcards ?/* gesucht werden z.B. *.txt legt alle Textdateien ab)

Unterverzeichnisse in ein Stringregister laden

Der Befehl speichert alle Ordnernamen die im <Pfad> vorhanden sind in die Stringregister (String-ID = ID...IDn). Die Anzahl wird im Register (Register-ID = ID) abgelegt. (Es kann mit Widlcards ?/* gesucht werden  z.B. *Neu* legt alle Verzeichnisse ab in denen das Wort "Neu" vorkommt)

Dateinamen in ein Stringarray laden (ab V1.3)

Der Befehl speichert alle Dateinamen die im <Pfad> vorhanden sind in das StringArray (Array-ID).

Unterverzeichnisse in ein Stringarray laden (ab V1.3)

Der Befehl speichert alle Ordnernamen die im <Pfad> vorhanden sind in das StringArray (Array-ID).

Verschlüsselung aufheben (ab V1.2)

Die durch den uniTFTDesigner verschlüsselte SD-Karte wird formatiert (Achtung: alle Daten gehen verloren) und die Verschlüsselung entfernt. Der Parameter muss exakt identisch angegeben werden.