sigrok-cli – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

sigrok-cli – Befehlszeilen-Client für die Sigrok-Software

ZUSAMMENFASSUNG

sigrok-cli [OPTIONEN] [BEFEHL]

BESCHREIBUNG

sigrok-cli ist ein plattformübergreifendes Befehlszeilendienstprogramm für Sigrok Software.

Es kann keine grafische Ausgabe anzeigen, reicht aber dennoch aus, um das Ganze durchzugehen
Prozess der Hardware-Initialisierung, Erfassung, Protokolldekodierung und Speicherung der Sitzung.

Es ist nützlich für die Ausführung auf Remote- oder eingebetteten Systemen, Netbooks, PDAs und für verschiedene
andere Anwendungsfälle. Es kann Beispiele auf der Standardausgabe anzeigen oder in verschiedenen Dateien speichern
Formate.

OPTIONAL

-H, --help
Hilfetext anzeigen und beenden.

-V, --Version
Anzeigen sigrok-cli Version und Informationen zu unterstützten Hardwaretreibern, Eingabe
Dateiformate, Ausgabedateiformate und Protokolldecoder.

-D, --Treiber
Es muss immer ein Treiber ausgewählt sein (es sei denn, es wird ein globaler Scan durchgeführt). Benutzen Sie die -V Option zu
Rufen Sie eine Liste der verfügbaren Treiber ab.

Fahrer können im Formular Optionen in Anspruch nehmen Schlüssel=Wert durch Doppelpunkte getrennt.

Treiber, die über einen seriellen Port mit Hardware kommunizieren, benötigen immer den Port
angegeben als die conn Möglichkeit. Um beispielsweise den Openbench Logic Sniffer zu verwenden:

$ sigrok-cli --driver=ols:conn=/dev/ttyACM0

Einige USB-Geräte verwenden keine eindeutige VendorID/ProductID-Kombination und benötigen daher
das wurde auch angegeben. Dies nutzt auch die conn Option, indem Sie entweder verwenden
VendorID.ProductID or Busadresse:

$ sigrok-cli --driver=uni-t-ut61e:conn=1a86.e008

-C, --config
Eine durch Doppelpunkte getrennte Liste von Geräteoptionen, wobei jede Option die Form annimmt
Schlüssel=Wert. Um beispielsweise die Abtastrate auf einem von der unterstützten Gerät auf 1 MHz einzustellen
fx2lafw-Treiber, können Sie angeben

$ sigrok-cli --driver=fx2lafw --config Abtastrate=1m

Die Abtastrate ist eine Option, die den meisten Logikanalysatoren gemeinsam ist. Das Argument gibt die an
Abtastrate in Hz. Sie können die Abtastrate auch in kHz, MHz oder GHz angeben. Der
Die folgenden sind alle gleichwertig:

$ sigrok-cli --Treiber fx2lafw --config Abtastrate=1000000

$ sigrok-cli --Treiber fx2lafw --config Abtastrate=1m

$ sigrok-cli --Treiber fx2lafw --config "samplerate=1 MHz"

-ich, --Eingabedatei
Laden Sie die Eingabe aus einer Datei statt von einem Hardwaregerät. Wenn die --Eingabeformat ganz ohne irgendetwas tun oder drücken zu müssen.
nicht bereitgestellt wird, versucht sigrok-cli, das Dateiformat der Eingabe automatisch zu erkennen
Datei.

-ICH, --Eingabeformat
Gehen Sie beim Laden einer Eingabedatei davon aus, dass sie im angegebenen Format vorliegt. Wenn diese Option ist
nicht im Lieferumfang enthalten (zusätzlich zu --Eingabedatei), sigrok-cli versucht, das automatisch zu erkennen
Dateiformat der Eingabedatei. Benutzen Sie die -V Option, um eine Liste der verfügbaren Eingaben anzuzeigen
Formate.

Dem Formatnamen kann optional eine durch Doppelpunkte getrennte Liste von Optionen folgen.
wobei jede Option die Form annimmt Schlüssel=Wert.

-Ö, --Ausgabedatei
Speichern Sie die Ausgabe in einer Datei, anstatt sie in stdout zu schreiben. Das Standardformat, das verwendet wird, wenn
Beim Speichern handelt es sich um das Sigrok-Sitzungsdateiformat. Dies kann mit geändert werden
--Ausgabeformat .

-Ö, --Ausgabeformat
Legen Sie das zu verwendende Ausgabeformat fest. Benutzen Sie die -V Option, um eine Liste der verfügbaren Ausgaben anzuzeigen
Formate.

Dem Formatnamen kann optional eine durch Doppelpunkte getrennte Liste von Optionen folgen.
wobei jede Option die Form annimmt Schlüssel=Wert.

Zu den derzeit unterstützten Formaten gehören: Bits, hex, ASCII, binär, vcd, olle, Gnuplot,
chronovu-la8, csv und Analog.

Die Bits or hex Formate, für eine ASCII-Bit- oder ASCII-Hexadezimal-Anzeige, können eine annehmen
Option „width“, die die Anzahl der Samples (in Bits) angibt, die pro Zeile angezeigt werden sollen.
So hex:width=128 zeigt 128 Bit pro Zeile im Hexadezimalformat an:

0:ffff ffff ffff ffff ffff ffff ffff ffff
1:ff00 ff00 ff00 ff00 ff00 ff00 ff00 ff00

Die Zeilen beginnen immer mit der Kanalnummer (oder dem Namen, falls definiert), gefolgt von einem
Doppelpunkt. Wenn kein Format angegeben ist, wird es standardmäßig verwendet Bits: Breite = 64, So was:

0:11111111 11111111 11111111 11111111 [...]
1:11111111 00000000 11111111 00000000 [...]

-VS, --Kanäle
Eine durch Kommas getrennte Liste von Kanälen, die in der Sitzung verwendet werden sollen.

Beachten Sie, dass Sigrok die Kanäle immer so benennt, wie sie auf dem angezeigt werden
Gehäuse der Hardware. Wenn Ihr Logikanalysator die Kanäle von 0 bis 15 nummeriert, ist das der Fall
wie Sie sie mit dieser Option angeben müssen. Die Kanäle eines Oszilloskops würden es tun
werden im Allgemeinen als „CH1“, „CH2“ usw. bezeichnet. Benutzen Sie die --zeigen Option zu sehen
eine Liste mit Kanalnamen für Ihr Gerät.

Standardmäßig werden alle auf einem Gerät verfügbaren Kanäle verwendet. Sie können einen benennen
Kanal wie folgt: 1=CLK. Im Formular können auch verschiedene Kanäle angegeben werden 1 - 5.

Ejemplo:

$ sigrok-cli --Treiber fx2lafw --Proben 100
--Kanäle 1=CLK,2-4,7
CLK:11111111 11111111 11111111 11111111 [...]
2:11111111 11111111 11111111 11111111 [...]
3:11111111 11111111 11111111 11111111 [...]
4:11111111 11111111 11111111 11111111 [...]
7:11111111 11111111 11111111 11111111 [...]

Die durch Kommas getrennte Liste wird von links nach rechts verarbeitet, d. h. die Elemente weiter entfernt
Mit der rechten Maustaste werden vorherige Elemente überschrieben. Zum Beispiel 1=CS,CS=MISO wird den Namen festlegen
Kanal 1 bis MISO.

-G, --channel-group
Geben Sie die Kanalgruppe an, die bearbeitet werden soll.

Einige Geräte organisieren Kanäle in Gruppen, deren Einstellungen nur vorgenommen werden können
als Gruppe verändert. Die Liste der Kanalgruppen (falls vorhanden) wird mit angezeigt
--zeigen Befehl.

-T, --löst aus
Eine durch Kommas getrennte Liste der zu verwendenden Trigger des Formulars =. Sie
Sie können den Namen oder die Nummer des Kanals verwenden, und der Auslöser selbst ist eine Reihe von
Zeichen:

0 or 1: Ein niedriger oder hoher Wert am Pin.
r or f: Ein steigender oder fallender Wert am Pin. Ein r entspricht effektiv 01.
c: Jede Art von Änderung an einem Pin (entweder eine steigende oder fallende Flanke).

Nicht jedes Gerät unterstützt alle dieser Triggertypen. Benutzen Sie die --zeigen Befehl zu sehen
welche Auslöser Ihr Gerät unterstützt.

-w, --wait-trigger
Geben Sie keine Beispieldaten aus (auch wenn diese tatsächlich von der Hardware empfangen werden)
bevor die Triggerbedingung erfüllt ist. Mit anderen Worten: Geben Sie keinen Pre-Trigger aus
Daten. Diese Option ist nützlich, wenn Ihnen die Daten, die vor dem kamen, egal sind
Trigger (aber die Hardware liefert diese Daten trotzdem an Sigrok).

-P, --protocol-decoders
Mit dieser Option kann der Benutzer eine durch Kommas getrennte Liste von Protokolldecodern angeben
in dieser Sitzung verwendet werden soll. Die Decoder werden durch ihre ID spezifiziert, wie in der Abbildung gezeigt
--Version Ausgabe.

Ejemplo:

$ sigrok-cli -i -P i2c

Auf jeden Protokolldecoder kann optional eine durch Doppelpunkte getrennte Liste folgen
Optionen, wobei jede Option die Form annimmt Schlüssel=Wert.

Ejemplo:

$ sigrok-cli -i
-P uart:baudrate=115200:parity_type=odd

Die Liste der unterstützten Optionen hängt vollständig vom Protokolldecoder ab. Jeden
Der Protokolldecoder unterstützt verschiedene Optionen.

Alle für einen Protokolldecoder angegebenen „Optionen“, die tatsächlich nicht unterstützt werden
Optionen werden als Kanalnamen-/Nummernzuweisungen interpretiert.

Ejemplo:

$ sigrok-cli -i
-P spi:wordsize=9:miso=1:mosi=5:clk=3:cs=0

In diesem Beispiel Wortgröße ist eine von der unterstützte Option spi Protokolldecoder.
Darüber hinaus weist der Benutzer Sigrok an, das SPI-Protokoll mithilfe von Kanal 1 zu dekodieren
MISO-Signal für SPI, Kanal 5 als MOSI, Kanal 3 als CLK und Kanal 0 als CS#
Signal.

-S, --protocol-decoder-stack
Mit dieser Option kann der Benutzer einen Protokoll-Decoder-Stack, also den Weg, angeben
welcher Ausgang eines Protokolldecoders an einen anderen Protokolldecoder weitergeleitet wird. Wenn
Wenn keine Angabe erfolgt, wird der Stapel in derselben Reihenfolge wie das Protokoll eingerichtet
Decoder wurden mitgeliefert --protocol-decoders .

Die Decoder werden durch ihre ID spezifiziert, wie in der Abbildung gezeigt --Version Ausgang. In
Neben dem -S Option müssen alle Protokolldecoder, die in einem Stack verwendet werden
können auch (zusammen mit ihren Optionen, falls vorhanden) mithilfe von angegeben werden -P Parameters.

Ejemplo:

$ sigrok-cli -i -P i2c:sda=4:scl=7,rtc8564
-S i2c,rtc8564

In diesem Beispiel -S Option gibt an, dass die Ausgabe der i2c Decoder ist
in die eingeleitet rtc8564 Decoder, also der rtc8564 Der Decoder ist oben drauf gestapelt
i2c Decoder.

Die entsprechenden Protokolldecoderoptionen und Kanalnamen-/Nummernzuweisungen müssen vorhanden sein
gegeben mit der -P Option (Sie können sie nicht in der angeben -S Möglichkeit).

-EIN, --protocol-decoder-annotations
Standardmäßig wird nur die Anmerkungsausgabe des obersten Protokolldecoders des Stapels angezeigt.
Mit dieser Option kann die Anmerkung eines anderen Decoders zur Anzeige ausgewählt werden
Angabe seiner ID:

$ sigrok-cli -i -P i2c,i2cfilter,edid -A i2c

Wenn ein Protokolldecoder über mehrere Anmerkungen verfügt, können Sie auch angeben, welche davon
um sie anzuzeigen, indem Sie die Kurzbeschreibung wie folgt angeben:

$ sigrok-cli -i -P i2c,i2cfilter,edid
-A i2c=Daten lesen

Wählen Sie mehrere Anmerkungen aus, indem Sie sie durch einen Doppelpunkt trennen:

$ sigrok-cli -i -P i2c,i2cfilter,edid
-A i2c=Datenlesen:Datenschreiben

Sie können auch mehrere Protokolldecoder auswählen und optional auswählen
Geben Sie jeweils eine Anmerkung ein, indem Sie sie durch Kommas trennen:

$ sigrok-cli -i -P i2c,i2cfilter,edid
-A i2c=data-read:data-write,edid

- l, --loglevel
Legen Sie die Loglevel von libsigrok und libsigrokdecode fest. Im Augenblick sigrok-cli nicht
Unterstützt die unabhängige Einstellung der beiden Protokollebenen. Je höher die Zahl, desto mehr
Die Debug-Ausgabe wird gedruckt. Gültige Protokollebenen sind:

0 Non
1 Fehler
2 Warnungen
3 Informational
4 Debuggen
5 Speien

--zeigen
Informationen zur ausgewählten Option anzeigen. Um beispielsweise Optionen für a anzuzeigen
angeschlossenes fx2lafw-Gerät:

$ sigrok-cli --Treiber fx2lafw --zeigen

Um die Geräteoptionen für Ihre Hardware ordnungsgemäß zu erhalten, sind möglicherweise einige Treiber erforderlich
ein serieller Port angegeben:

$ sigrok-cli --Treiber ols:conn=/dev/ttyACM0 --zeigen

So zeigen Sie die Dokumentation für einen Protokolldecoder an:

$ sigrok-cli --protocol-decoders i2c --zeigen

--Scan Suchen Sie nach Geräten, die automatisch erkannt werden können.

Ejemplo:

$ sigrok-cli --Scan
Folgende Geräte wurden gefunden:
Demo - Demogerät mit 12 Kanälen: D0 D1 D2 D3 D4 D5 D6 D7 A0 A1 A2 A3
fx2lafw:conn=3.26 – CWAV USBee SX mit 8 Kanälen: 0 1 2 3 4 5 6 7

Allerdings sind nicht alle Geräte automatisch erkennbar (z. B. solche, die auf einer seriellen Schnittstelle basieren). Für
Diese müssen Sie bereitstellen conn Möglichkeit, siehe oben.

$ sigrok-cli --Treiber digitek-dt4000zc:conn=/dev/ttyUSB0 --Scan
Folgende Geräte wurden gefunden:
Digitek DT4000ZC mit 1 Kanal: P1

--Zeit
Probe für Millisekunden, dann beenden.

Optional können Sie der Nummer folgen s um die Probenahmezeit in Sekunden anzugeben.

Zum Beispiel, --Zeit 2s wird zwei Sekunden lang abtasten.

--Proben
Erfassen Proben, dann beenden.

Optional können Sie der Nummer folgen k, m oder g um die Anzahl der Proben anzugeben
in Kilosamples, Megasamples bzw. Gigasamples.

Zum Beispiel, --Proben 3m wird 3000000 Proben erfassen.

- Rahmen
Erfassen Frames, dann beenden.

--kontinuierlich
Probe kontinuierlich bis zum Stoppen. Nicht alle Geräte unterstützen dies.

--einstellen Legen Sie eine oder mehrere mit angegebene Variablen fest --config Option, ohne etwas zu tun
Erwerb.

Beispiele:

Um genau 100 Samples vom angeschlossenen fx2lafw-unterstützten Logikanalysator zu erhalten
Hardware, führen Sie den folgenden Befehl aus:

sigrok-cli --Treiber fx2lafw --Proben 100

Wenn Sie Daten 3 Sekunden lang (3000 ms) abtasten möchten, verwenden Sie:

sigrok-cli --Treiber fx2lafw --Zeit 3000

Alternativ können Sie auch Folgendes verwenden:

sigrok-cli --Treiber fx2lafw --Zeit 3s

Zur Erfassung von Daten der ersten 4 Kanäle mit dem Openbench Logic Sniffer mit einer Dauer von 100 ms
bei 10 MHz ab der Triggerbedingung
0:hoch, 1:steigend, 2:niedrig, 3:hoch, verwenden:

sigrok-cli --Treiber ols:conn=/dev/ttyACM0 --config Abtastrate=10m \
--Ausgabeformat Bits --Kanäle 0 - 3 --wait-trigger \
--löst aus 0=1,1=r,2=0,3=1 --Zeit 100

So aktivieren Sie die interne Protokollierung auf einem Gerät der Lascar EL-USB-Serie:

sigrok-cli --Treiber lascar-el-usb:conn=10c4.0002 \
--config datalog=on --einstellen

EXIT STATUS

sigrok-cli Wird bei Erfolg mit 0 beendet, bei den meisten Fehlern mit 1.

Verwenden Sie sigrok-cli online über die Dienste von onworks.net