SYNOPSIS
halsampler [options]
BESCHREIBUNG
sampler(9) and halsampler are used together to sample HAL data in real time and store it in a file. sampler is a realtime HAL component that exports HAL pins and creates a FIFO in shared memory. It then begins sampling data from the HAL and storing it to the FIFO. halsampler is a non-realtime program that copies data from the FIFO to stdout, where it can be redirected to a file or piped to some other program.
OPTIONEN
- -c CHAN
-
weist halsampler an, aus dem FIFO CHAN zu lesen. Die FIFOs werden von Null an nummeriert, und der Standardwert ist Null, so dass diese Option nicht benötigt wird, es sei denn, es wurden mehrere FIFOs erstellt.
- -n COUNT
-
weist halsampler an, COUNT Samples aus dem FIFO zu lesen und dann zu beenden. Wenn -n nicht angegeben ist, liest halsampler kontinuierlich, bis er beendet wird.
- -t
-
weist halsampler an, jede Zeile zu markieren, indem die Probennummer in der ersten Spalte gedruckt wird.
- FILENAME
-
weist halsampler an, nach FILENAME statt nach stdout zu schreiben.
VERWENDUNG
Ein FIFO muss zunächst durch Laden von sampler(9) mit halcmd loadrt oder einem loadrt-Befehl in einer HAL-Datei erstellt werden. Dann kann halsampler aufgerufen werden, um die Daten aus dem FIFO auf stdout zu auszugeben.
Die Daten werden in einer Zeile pro Probe gedruckt. Wenn -t angegeben wurde, wird die Probennummer zuerst gedruckt. Die Daten folgen in der Reihenfolge, in der die Pins im Konfigurationsstring definiert wurden. Wenn zum Beispiel der sampler-Konfigurationsstring "ffbs" lautet, würde eine typische Ausgabezeile (ohne -t) wie folgt aussehen:
123.55 33.4 0 -12
halsampler prints data as fast as possible until the FIFO is empty, then it retries at regular intervals, until it is either killed or has printed COUNT samples as requested by -n. Usually, but not always, data printed by halsampler will be redirected to a file or piped to some other program.
Die FIFO-Größe sollte so gewählt werden, dass sie Stichproben aufnehmen kann, die während einer vorübergehenden Unterbrechung des Datenflusses erfasst werden, z. B. bei Suchvorgängen auf der Festplatte, beim Scrollen des Terminals oder bei den Verarbeitungsbeschränkungen des nachfolgenden Programms in einer Pipeline. Wenn der FIFO voll wird und sampler gezwungen ist, alte Daten zu überschreiben, druckt halsampler overrun auf eine eigene Zeile, um jede Lücke in den abgetasteten Daten zu markieren. Wenn -t angegeben wurde, können die Lücken in den fortlaufenden Probennummern in der ersten Spalte verwendet werden, um genau festzustellen, wie viele Proben verloren gegangen sind.
Das Datenformat für die Ausgabe von halsampler ist das gleiche wie für die Eingabe von halstreamer(1), so dass mit halsampler aufgenommene "Wellenformen" mit halstreamer wiedergegeben werden können. Die Option -t sollte in diesem Fall nicht verwendet werden.
EXIT STATUS
Wenn während der Initialisierung ein Problem auftritt, gibt halsampler eine Nachricht an stderr aus und gibt einen Fehler zurück.
Nach dem Drucken von COUNT Stichproben (wenn -n angegeben wurde) wird das Programm beendet und gibt Erfolg zurück. Wird es beendet, bevor die angegebene Anzahl von Stichproben gedruckt wurde, gibt es einen Fehler zurück. Das heißt, wenn -n nicht angegeben ist, wird beim Beenden immer ein Fehler zurückgegeben.
SIEHE AUCH
sampler(9), streamer(9), halstreamer(1)
AUTOR
Originalversion von John Kasunich, als Teil des LinuxCNC-Projekts. Verbesserungen durch mehrere andere Mitglieder des LinuxCNC Entwicklungsteams.
MELDEN VON FEHLERN
Fehler melden unter https://github.com/LinuxCNC/linuxcnc/issues.
COPYRIGHT
Copyright © 2006 John Kasunich.
Dies ist freie Software; die Kopierbedingungen finden Sie in der Quelle. Es gibt KEINE Garantie; nicht einmal für die MARKTREIFE oder die EIGNUNG FÜR EINEN BESTIMMTEN ZWECK.