sigrok-cli - クラウドでオンライン

プログラム：

NAME

sigrok-cli - sigrok ソフトウェアのコマンドライン クライアント

SYNOPSIS

sigrok-cli [オプション] [指図]

DESCRIPTION

sigrok-cli のためのクロスプラットフォームのコマンド ライン ユーティリティです。 シグロク ソフトウェアを使用して、WindowsXNUMX XNUMXビット上で動作する XNUMXTB RAID XNUMX を備えたデスクトップ コンピューターで録画されます。

グラフィック出力を表示することはできませんが、全体を実行するには十分です。
ハードウェアの初期化、取得、プロトコルのデコード、セッションの保存のプロセス。

リモートまたは組み込みシステム、ネットブック、PDA、およびさまざまなシステムでの実行に役立ちます。
他のユースケース。 サンプルを標準出力に表示したり、さまざまなファイルに保存したりできます
フォーマット。

OPTIONS

-NS、 - 助けて
ヘルプテキストを表示して終了します。

-V、 - バージョン
表示 sigrok-cli バージョン、およびサポートされているハードウェア ドライバーに関する情報、入力
ファイル形式、出力ファイル形式、およびプロトコル デコーダ。

-NS、 - 運転者
ドライバーは常に選択する必要があります (グローバル スキャンを実行しない場合)。 使用 -V オプション
利用可能なドライバーのリストを取得します。

ドライバーは次の形式でオプションを取ることができます key = value コロンで区切ります。

シリアル ポート経由でハードウェアと通信するドライバーには常にポートが必要です
として指定されます CONN オプション。 たとえば、Openbench Logic Sniffer を使用するには、次のようにします。

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

一部の USB デバイスは一意の VendorID/ProductID の組み合わせを使用しないため、
それも指定しました。 これも使用します CONN オプション、いずれかを使用
ベンダーID.製品ID or バスアドレス:

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

-NS、 --config
コロンで区切られたデバイス オプションのリスト。各オプションは次の形式になります。
key = value。 たとえば、サポートされているデバイスでサンプルレートを 1MHz に設定するには、
fx2lafw ドライバー、指定できます

$ sigrok-cli --driver=fx2lafw --config サンプルレート=1m

サンプルレートは、ほとんどのロジック アナライザーに共通のオプションです。 引数で指定するのは、
サンプルレート (Hz)。 サンプルレートを kHz、MHz、または GHz で指定することもできます。 の
以下はすべて同等です。

$ sigrok-cli - 運転者 fx2lafw --config サンプルレート=1000000

$ sigrok-cli - 運転者 fx2lafw --config サンプルレート=1m

$ sigrok-cli - 運転者 fx2lafw --config 「サンプルレート=1 MHz」

-私、 - 入力ファイル
ハードウェア デバイスではなくファイルから入力を読み込みます。 もし --入力フォーマット オプション
が提供されていない場合、sigrok-cli は入力のファイル形式を自動検出しようとします。
ファイルにソフトウェアを指定する必要があります。

-私、 --入力フォーマット
入力ファイルをロードするときは、それが指定された形式であると想定します。 このオプションが
付属しておりません（それに加えて、 - 入力ファイル)、sigrok-cli は自動検出を試みます。
入力ファイルのファイル形式。 使用 -V 利用可能な入力のリストを表示するオプション
フォーマット。

必要に応じて、形式名の後にコロンで区切られたオプションのリストを続けることができます。
各オプションの形式は次のとおりです key = value.

-o、 -出力ファイル
出力を標準出力に書き込むのではなく、ファイルに保存します。 次の場合に使用されるデフォルトの形式
保存は sigrok セッション ファイル形式です。 これは次のコマンドで変更できます。
- 出力フォーマット オプションを選択します。

-O、 - 出力フォーマット
使用する出力形式を設定します。 使用 -V 利用可能な出力のリストを表示するオプション
フォーマット。

必要に応じて、形式名の後にコロンで区切られたオプションのリストを続けることができます。
各オプションの形式は次のとおりです key = value.

現在サポートされている形式は次のとおりです。 ビット, 16進法, アスキー, バイナリ, VCD, オール, gnuplot,
クロノヴーラ8, csvファイル, アナログ.

当学校区の ビット or 16進法 ASCII ビットまたは ASCII XNUMX 進数表示の形式は、
「width」オプション。XNUMX 行あたりに表示するサンプル数 (ビット単位) を指定します。
従って 128 進数:幅=XNUMX 128 ビット/行を XNUMX 進数で表示します。

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

行は常にチャンネル番号 (または定義されている場合は名前) で始まり、その後に
結腸。 形式が指定されていない場合は、デフォルトで ビット:幅=64このように：

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

-C、 -チャネル
セッションで使用されるチャネルのカンマ区切りのリスト。

sigrok は常に、チャンネルの表示方法に従ってチャンネルに名前を付けることに注意してください。
ハードウェアの筐体。 ロジック アナライザーがチャネルに 0 ～ 15 の番号を付けている場合、それは
このオプションでそれらをどのように指定する必要があるか。 オシロスコープのチャンネルは、
一般に「CH1」、「CH2」などと呼ばれます。 使用 - 見せる 見るオプション
デバイスのチャンネル名のリスト。

デフォルトでは、デバイスで利用可能なすべてのチャネルが使用されます。 名前を付けることができます
このようなチャンネル: 1=クロック。 チャネルの範囲を次の形式で指定することもできます。 1-5.

例：

$ sigrok-cli - 運転者 fx2lafw --サンプル 100
-チャネル 1=CLK、2-4,7、XNUMX
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 [...]

カンマ区切りのリストは左から右に、つまり、より遠い項目に処理されます。
右は前の項目を上書きします。 例えば 1=CS、CS=ミソ の名前を設定します
チャネル1から 味噌.

-NS、 --チャネルグループ
操作対象のチャネルグループを指定します。

一部のデバイスはチャンネルをグループに編成しており、その設定は次のことのみ可能です。
グループとして変わりました。 チャネル グループがある場合は、そのリストが表示されます。
- 見せる

-NS、 -トリガー
次の形式の、使用するトリガーのカンマ区切りのリスト。 =。 あなた
チャンネルの名前または番号を使用でき、トリガー自体は一連の
キャラクター：

0 or 1: ピンの Low または High 値。
r or f: ピンの上昇値または下降値。 アン r に実質的に対応する 01.
c: ピン上のあらゆる種類の変化 (立ち上がりエッジまたは立ち下がりエッジ)。

すべてのデバイスがこれらのトリガー タイプをすべてサポートしているわけではありません。 使用 - 見せる 見るコマンド
これはデバイスがサポートするトリガーです。

-w、 --待機トリガー
サンプル データを出力しないでください (実際にはハードウェアから受信した場合でも)
トリガー条件が満たされる前。 つまり、プリトリガーを出力しません。
データ。 このオプションは、以前のデータを気にしない場合に便利です。
トリガーします (ただし、ハードウェアはこのデータを sigrok に送信します)。

-NS、 --プロトコルデコーダー
このオプションを使用すると、ユーザーはプロトコル デコーダのカンマ区切りリストを指定できます。
このセッションで使用します。 デコーダは、次に示すように、ID によって指定されます。
- バージョン 出力。

例：

$ sigrok-cli -i -P i2c

各プロトコル デコーダの後には、オプションでコロンで区切られたリストを続けることができます。
オプション。各オプションの形式は次のとおりです。 key = value.

例：

$ sigrok-cli -i
-P uart:ボーレート=115200:パリティタイプ=奇数

サポートされるオプションのリストは、プロトコル デコーダに完全に依存します。 毎日
プロトコル デコーダには、サポートされるさまざまなオプションがあります。

実際にはサポートされていないプロトコル デコーダに指定された「オプション」
オプションは、チャンネル名/番号の割り当てとして解釈されます。

例：

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

この例では、 ワードサイズ でサポートされているオプションです SPI プロトコルデコーダ。
さらに、ユーザーは sigrok にチャネル 1 を使用して SPI プロトコルをデコードするように指示します。
SPI の MISO 信号、チャネル 5 は MOSI、チャネル 3 は CLK、チャネル 0 は CS#
信号。

-NS、 --プロトコルデコーダースタック
このオプションを使用すると、ユーザーはプロトコル デコーダ スタック、つまり、
あるプロトコル デコーダの出力が別のプロトコル デコーダにパイプされます。 もしも
指定しない場合、スタックはプロトコルと同じ順序でセットアップされます。
デコーダには、 --プロトコルデコーダー オプションを選択します。

デコーダは、次に示すように、ID によって指定されます。 - バージョン 出力。 の
に加えて -S オプションの場合、スタックで使用されるすべてのプロトコル デコーダは、
を使用して (オプションがあればそれと一緒に) 指定することもできます。 -P パラメータに一致する最初のデバイスのリモートコントロール URL を返します。

例：

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

この例では、 -S オプションは、 i2c デコーダは
にパイプされて rtc8564 デコーダ、つまり rtc8564 デコーダはその上に積み重ねられています
i2c デコーダ。

それぞれのプロトコル デコーダ オプションとチャネル名/番号の割り当ては、
を使用して与えられる -P オプション（オプションでは指定できません） -S オプション）。

-NS、 --プロトコルデコーダーアノテーション
デフォルトでは、スタックの最上位プロトコル デコーダのアノテーション出力のみが表示されます。
このオプションを使用すると、別のデコーダの注釈を表示用に選択できます。
ID を指定します。

$ sigrok-cli -i -P i2c、i2cフィルター、edid -A i2c

プロトコル デコーダに複数のアノテーションがある場合、そのうちのどれかを指定することもできます。
次のように短い説明を指定することで表示します。

$ sigrok-cli -i -P i2c、i2cフィルター、edid
-A i2c=データ読み取り

複数の注釈を選択するには、コロンで区切ります。

$ sigrok-cli -i -P i2c、i2cフィルター、edid
-A i2c=データ読み取り:データ書き込み

オプションで選択されたプロトコル デコーダを使用して、複数のプロトコル デコーダを選択することもできます。
カンマで区切ってそれぞれに注釈を付けます。

$ sigrok-cli -i -P i2c、i2cフィルター、edid
-A i2c=データ読み取り:データ書き込み、edid

-l、 --ログレベル
libsigrok および libsigrokdecode ログレベルを設定します。 この時点で sigrok-cli しない
XNUMXつのログレベルを個別に設定することをサポートします。 数値が大きいほど、より多くなります
デバッグ出力が出力されます。 有効なログレベルは次のとおりです。

0 なし
1 エラー
2 警告
3 情報
4 デバッグ
5 吐く

- 見せる
選択したオプションに関する情報を表示します。 たとえば、次のオプションを表示するには、
接続されている fx2lafw デバイス:

$ sigrok-cli - 運転者 fx2lafw - 見せる

ハードウェアのデバイス オプションを適切に取得するには、一部のドライバーで必要な場合があります。
指定されたシリアル ポート:

$ sigrok-cli - 運転者 ols:conn=/dev/ttyACM0 - 見せる

プロトコル デコーダのドキュメントを表示するには、次の手順を実行します。

$ sigrok-cli --プロトコルデコーダー i2c - 見せる

- スキャン 自動的に検出できるデバイスをスキャンします。

例：

$ sigrok-cli - スキャン
次のデバイスが見つかりました。
デモ - 12 チャンネルのデモ デバイス: D0 D1 D2 D3 D4 D5 D6 D7 A0 A1 A2 A3
fx2lafw:conn=3.26 - 8 チャンネルの CWAV USBee SX: 0 1 2 3 4 5 6 7

ただし、すべてのデバイスが自動検出できるわけではありません (シリアル ポート ベースのデバイスなど)。 ために
提供する必要があるもの CONN オプション、上記を参照してください。

$ sigrok-cli - 運転者 digitalek-dt4000zc:conn=/dev/ttyUSB0 - スキャン
次のデバイスが見つかりました。
Digitek DT4000ZC 1 チャンネル: P1

- 時間
のサンプル ミリ秒後に終了します。

必要に応じて、番号の後に次の文字を付けることができます s サンプリングする時間を秒単位で指定します。

たとえば、 - 時間 2s XNUMX 秒間サンプリングします。

--サンプル
捕捉 サンプルを作成して終了します。

必要に応じて、番号の後に次の文字を付けることができます k, mまたは g サンプル数を指定するには
それぞれキロサンプル、メガサンプル、ギガサンプル単位で指定します。

たとえば、 --サンプル 3m 3000000サンプルを取得します。

-フレーム
捕捉 フレームを閉じて終了します。

-継続的
停止するまでサンプリングを継続します。 すべてのデバイスがこれをサポートしているわけではありません。

- 設定 で指定された XNUMX つ以上の変数を設定します。 --config 何もせずにオプションで
取得。

例

接続された fx100lafw 対応ロジック アナライザーからちょうど 2 個のサンプルを取得するには
ハードウェアの場合は、次のコマンドを実行します。

sigrok-cli - 運転者 fx2lafw --サンプル 100

データを 3 秒 (3000 ミリ秒) サンプリングする場合は、次を使用します。

sigrok-cli - 運転者 fx2lafw - 時間 3000

または、次を使用することもできます。

sigrok-cli - 運転者 fx2lafw - 時間 3s

4ms 持続する Openbench Logic Sniffer を使用して最初の 100 チャネルからデータをキャプチャするには
10MHzでトリガ条件から開始
0:高、1:上昇、2:低、3:高、使用:

sigrok-cli - 運転者 ols:conn=/dev/ttyACM0 --config サンプルレート=10m
- 出力フォーマット ビット -チャネル 0-3 --待機トリガー
-トリガー 0=1,1=r,2=0,3=1 - 時間 100

Lascar EL-USB シリーズ デバイスで内部ログを有効にするには:

sigrok-cli - 運転者 lascar-el-usb:conn=10c4.0002
--config データログ=オン - 設定

EXIT ステータス

sigrok-cli 成功すると0、ほとんどの失敗で1で終了します。

onworks.net サービスを使用してオンラインで sigrok-cli を使用する