SaveASCII
Zurück Nach oben Vorwärts

Kurzbeschreibung Parameter Funktionsweise Ein/Ausgänge Limitierungen Querverweise Beispiele

Kurzbeschreibung
SaveASCII dient zum Speichern eines speziellen ICONNECT-ASCII-Datenformats.
Dabei werden Arrays des Typs DOUBLE[]{TIME_DOMAIN} in ein oder zwei Spalten in einem Textfile gespeichert (Y-t oder X-Y).
Parameter
Parameter: Dateipfad und 'append mode' können wahlweise über den Datenbank- (DB-) Eingang oder über den Extern- (EXT-) Eingang während der laufenden Messung eingelesen und geändert werden.
An vorhandene Datei anfügen: Aktivieren des 'append-mode' bewirkt, daß die Daten an eine bereits existierende Datei angehängt werden, andernfalls wird der Inhalt einer bereits existierenden Datei gelöscht, bevor Daten hinein geschrieben werden.
Dateiname: Mit dem Button 'Durchsuchen...' erscheint der Standard Datei-Auswahldialog von Windows 95 / NT.
Funktionsweise
SaveAscii speichert Daten zusammen mit Zeitinformationen in der spezifizierten Datei.

Aufbau des File-Formats:
Paketstatus 1    0=Paketanfang,
1=Block innerhalb Paket,
2=Paketende,
3=Paket aus einem Block
TypeInfo-Header 1_X // s. u.
TypeInfo-Header 1_Y
Werteanzahl n // Blocklänge
Datum 1_X Datum 1_Y // X- und Y- Koordinate der Daten durch Leerzeichen (0x20) getrennt
...
Datum n_X Datum 1_Y
Paketstatus 2 // Paketstatus des zweiten Blocks
TypeInfo-Header 2_X  // s. u.
TypeInfo-Header 2_Y
...

Aufbau des TypeInfo-Header:

double timestamp; // Zeitstempel in 1/1000s ab 1970
double samplerate; // Abtastrate innerhalb des Blocks in Hz
double TCSI_Unit::v_scale; // Skalierungsfaktor der SI-Einheit
TCSI_Unit unit; // Array mit Potenzen der SI-Einheiten m kg s A K mol cd
double range_min; // Wertebereich minimal
double range_max; // Wertebereich maximal
char signalname[]; // Name des Signals

Generell erscheint jeder Eintrag in einer neuen Zeile. Leerzeilen sind nicht erlaubt!

Ein-/Ausgänge
Eingänge
EXT, DB UBYTE[]{filename}
SWORD{append}
Dateipfad
0=neue Datei,
1=an bestehende Datei anhängen
X TYPEINFO{TypeInfo}
DOUBLE[]{TIME_DOMAIN}
Daten Eingang X
Y TYPEINFO{TypeInfo}
DOUBLE[]{TIME_DOMAIN}
Daten Eingang Y
Ausgänge
Error TYPEINFO{TypeInfo}
SWORD[1]{BIN}
Fehler-Ausgang lieferte eine 1 im Fehlerfall. Ist dieser Ausgang nicht verdrahtet, führt ein Fehler wie gewohnt zum Stop des SG.
Limitierungen
Werden nur Y-t Daten abgespeichert, so werden die X-Daten mit 0-Elementen belegt.
Auch beim Einlesen des Dateinamens über den EXT- oder DB-Eingang muß eine Vorbelegung des Namens getroffen werden, da andernfalls in der Initialisierungsphase eine Fehlermeldung ausgegeben wird.
Querverweise
LoadAscii
Beispiele
-