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

プログラム：

NAME

BladeRF-cli - コマンドラインインターフェイスおよびテストユーティリティ

SYNOPSIS

ブレードRF-cli

DESCRIPTION

　 ブレードRF-cli このユーティリティは、ファームウェア ファイルのフラッシュ、FPGA ビットストリームのロード、および実行に使用されます。
nuand BladeRF ソフトウェア無線システム上のその他のタスク。

ファームウェア ファイルと FPGA ビットストリームの入手または構築の詳細については、次の URL を参照してください。
訪問 http://nuand.com/.

BladeRF コマンド ライン インターフェイスおよびテスト ユーティリティ (1.3.1-0.2016.01~rc1-3)

OPTIONS

-d, - 端末
指定されたbladeRFデバイスを使用してください。

-f, --フラッシュファームウェア
提供された FX3 ファームウェア ファイルをフラッシュに書き込みます。

-l, --load-fpga
提供された FPGA ビットストリームをロードします。

-L, --フラッシュ-fpga
提供された FPGA イメージを自動ロード用にフラッシュに書き込みます。 使用 -L Xまたは --フラッシュ-fpga X
FPGA の自動ロードを無効にします。

-p, - 調査
デバイスをプローブし、結果を出力して終了します。 ゼロ以外の戻りステータスは次のようになります。
使用可能なデバイスがない場合に返されます。

-e, --exec
指定された対話モードのコマンドを実行します。 多数 -e フラグはあるかもしれない
指定。 コマンドは指定された順序で実行されます。

-s, - 脚本
提供されたスクリプトを実行します。

-i, - 相互の作用
インタラクティブモードに入ります。

--lib-バージョン
libladeRF のバージョンを出力して終了します。

-v, -冗長性
libladeRF の冗長レベルを設定します。 レベルは次のとおりです。

クリティカル、エラー、警告、
情報、デバッグ、詳細

- バージョン
CLI のバージョンを出力して終了します。

-h, - 助けて
このヘルプ テキストを表示します。

--ヘルプ-インタラクティブ
すべての対話型コマンドのヘルプ情報を出力します。

注意：
　 -d オプションはデバイス指定文字列を受け取ります。 Bladerf_open() のドキュメントを参照してください。
この文字列の形式の詳細については、「」を参照してください。

Status -d パラメータが指定されていない場合は、最初に使用可能なデバイスが使用されます。
提供されたコマンド、または対話モードに入る前に開かれます。

コマンドは次の順序で実行されます。

コマンドラインオプション、 -e 、スクリプト コマンド、対話モード コマンド。

スクリプトまたは経由で「rx/tx start」を実行する場合 -e、これらのコマンドが後で実行されることを確認してください
プログラムが終了しようとしないようにするため、「rx/tx wait [timeout]」が続きます。
受信/送信が完了する前に。

インタラクティブ コマンド

BladeRF-cli は、スクリプト可能な対話モードをサポートします。 走る ブレードRF-cli - 相互の作用 〜へ
このモードに入ります。 タイプ "助けますすべてのコマンドのリストについては「」、または「助けます " 多くのための
についての情報。

調整する
使用法: 校正【オプション】

指定されたトランシーバーのキャリブレーション操作を実行します。

利用可能な操作:

· LMS 内部 DC オフセット自動キャリブレーション

· lms を校正する [表示]

· lms チューニング [値] を校正します。

· lms txlpf [ ]を校正します。

· lms rxlpf [ ]を校正します。

· lms rxvga2 を校正する [ ]

指定された自動キャリブレーションを実行するか、何も指定されていない場合はすべてを実行します。 いつ
値が提供されている場合、これらは自動キャリブレーションの結果の代わりに使用されます。
手順。 lms show を使用して、現在の LMS キャリブレーション値を読み取り、出力します。

rxvga2 の場合、I1 と Q1 はそれぞれステージ 1 の I コンポーネントと Q コンポーネントであり、I2 と Q2 は
ステージ 2 の I コンポーネントと Q コンポーネント。

· RX および TX I/Q DC オフセット補正パラメータの校正

· DCを校正する [ ]

· DCを校正する

現在の周波数とゲインの DC オフセット補正パラメータを校正します。
設定。 I/Q 値が指定されている場合、それらは直接適用されます。 カルrxtxは
cal rx の後に cal tx が続く略称。

・RXおよびTX I/Qバランス補正パラメータのキャリブレーション

· iqを調整する

指定した IQ ゲインまたは位相バランス パラメータを設定します。

· RX または TX I/Q DC 補正パラメータ テーブルを生成

· テーブル DC を校正する[ [f_inc]]

I/Q補正パラメータテーブルを生成し、現在の作業ディレクトリに書き込みます。
という名前のファイルに_dc_ .tbl。 f_min と f_max は、最小周波数と最大周波数です。
表に含めます。 f_inc は周波数の増分です。

デフォルトでは、テーブルは周波数範囲全体にわたって 2 MHz ステップで生成されます。

クリア
使用法: クリア

画面をクリアします。

echo
使用法: echo [引数 1] [引数 2] ... [引数 n]

各引数を新しい行にエコーします。

消去
使用法: 消去

指定された消去ブロック SPI フラッシュを消去します。

· - ブロックオフセットの消去

· - 消去する消去ブロックの数

フラッシュバックアップ
使用法: flash_backup ( | )

フラッシュデータを指定したファイルにバックアップします。 このコマンドには XNUMX つまたは XNUMX つのいずれかが必要です
引数。 XNUMX つの引数による呼び出しは、通常、非開発用途に推奨されます。

パラメーター：

· - バックアップの種類。

これにより、選択したタイプに基づいて適切なアドレスと長さの値が選択されます。

有効なオプションは次のとおりです。

オプションの説明
─────────────────────────────────────────────────── ──────────────────
cal 校正データ
ソフトウェアファームウェア
40 kLE FPGA の fpga40 メタデータとビットストリーム
115 kLE FPGA の fpga115 メタデータとビットストリーム

· - バックアップするデータのアドレス。 消去はブロックアライメントで行う必要があります。

· - バックアップする領域の長さ。 消去はブロックアライメントで行う必要があります。

注: アドレスと長さを指定すると、イメージ タイプはデフォルトで raw になります。

例：

· flash_backup cal.bin cal

キャリブレーションデータ領域をバックアップします。

· flash_backup cal_raw.bin 0x30000 0x10000

キャリブレーション領域を生データ イメージとしてバックアップします。

フラッシュイメージ
使用法: flash_image [出力オプション]

フラッシュ イメージのメタデータを印刷するか、新しいフラッシュ イメージを作成します。 名前を付けた場合
フラッシュ イメージ ファイルを唯一の引数として指定すると、このコマンドはメタデータの内容を出力します。
画像の。

新しいフラッシュ イメージを作成するには、次のオプションを使用できます。

・データ=

画像に保存するデータを含むファイル。

·アドレス=

フラッシュアドレス。 デフォルトは type パラメータによって異なります。

· タイプ=

フラッシュ画像の種類。 デフォルトは生です。

有効なオプションは次のとおりです。

オプションの説明
─────────────────────────────────────────────────── ──────────────────
cal 校正データ
ソフトウェアファームウェア
40 kLE FPGA の fpga40 メタデータとビットストリーム
115 kLE FPGA の fpga115 メタデータとビットストリーム
生の生データ。 アドレスと長さのパラメータは次のようにする必要があります。
このタイプが選択されている場合に提供されます。

・シリアル=

画像に保存するシリアル番号。 デフォルトはゼロです。

flash_init_cal
使用法: flash_init_cal [ 】

新しいキャリブレーション データ領域を作成し、現在開いているデバイス、または
ファイル。 このコマンドを実行する前に、必ずキャリブレーション データをバックアップしてください。 (「
flash_backup コマンド。)

·

デバイスのモデルに応じて、40 または 115 のいずれかになります。

·

VCTCXO/DAC トリム値 (0x0-0xffff)

·

キャリブレーションデータを書き込むファイル。 この引数が指定された場合、データは送信されません。
デバイスのフラッシュに書き込まれます。

フラッシュ_復元
使用法: flash_restore [ 】

ファイルからフラッシュ データを復元します。必要に応じて、イメージ メタデータの値をオーバーライドします。

·

デフォルトは、提供されたフラッシュ イメージ ファイルで指定されたアドレスです。

·

デフォルトは、提供された画像ファイル内のデータの長さです。

fw_log
使用法: fw_log [ファイル名]

デバイスのファームウェア ログの内容を読み取り、指定されたファイルに書き込みます。 いいえの場合
ファイル名を指定すると、ログの内容が標準出力に書き込まれます。

助けます
使用法: ヘルプ [ ]

任意のコマンドについて、このような拡張ヘルプを提供します。

info
使用法: 情報

開いたデバイスに関する次の情報を出力します。

・ シリアルナンバー

・VCTCXO DAC校正値

・FPGAサイズ

・FPGAが搭載されているかどうか

・USBバス、アドレス、速度

· バックエンド (どのデバイス インターフェイス コードが使用されているかを示します。)

· インスタンス番号

ジャンプトゥブート
使用法: Jump_to_boot

フラッシュ内の FW 署名ワードをクリアし、FX3 ブートローダーにジャンプします。

デバイスは、新しい電源が投入されるまで、電源を入れ直しても FX3 ブートローダーで起動し続けます。
ファームウェアがデバイスに書き込まれます。

負荷
使用法: ロード

FPGA ビットストリームをロードするか、FX3 の SPI フラッシュをプログラムします。

xb
使用法:xb [パラメーター]

拡張ボードを有効化または構成します。

board_model の有効な値:

100

XB-100 GPIO 拡張ボード

200

XB-200 LF/MF/HF/VHF トランスバーター拡張ボード

一般的なサブコマンド:

・ 有効

XB-100 または XB-200 拡張ボードを有効にします。

XB-200 サブコマンド:

· フィルター [rx|tx] [50|144|222|custom|auto_1db|auto_3db]

XB-200 ボード上の指定された RX または TX フィルターを選択します。 以下に説明します
各フィルター オプション。

50

50 ～ 54 MHz (6 メートル帯域) フィルターを選択します。

144

144 ～ 148 MHz (2 メートル帯域) フィルターを選択します。

222

222 ～ 225 MHz (1.25 メートル帯域) フィルターを選択します。 現実的には、
このフィルター オプションは実際にはわずかに幅が広く、カバー範囲が広いです。
206MHz～235MHz。

・ カスタム

カスタム フィルター パスを選択します。 ユーザーはフィルターを接続する必要があります
使用時に、対応する FILT および FILT-ANT 接続に沿って
このオプション。 あるいは、FILT と FILT-ANT をジャンパ接続することもできます。
受信用に「フィルタなし」を実現する接続。 (ただし、これは
送信は_強く_推奨されません。)

· auto_1db

頻度に基づいて上記の選択肢のいずれかを自動的に選択します
とフィルターの 1dB ポイント。 カスタムパスはケースに使用されます
オンボードフィルターに関連付けられていないもの。

· auto_3db

頻度に基づいて上記の選択肢のいずれかを自動的に選択します
とフィルターの 3dB ポイント。 カスタムパスはケースに使用されます
オンボードフィルターに関連付けられていないもの。

例：

・XB200有効

XB-200 トランスバータ拡張ボードを有効にして設定します。

・XB 200 フィルター RX 144

XB-144 トランスバータ拡張ボード上の 148 ～ 200 MHz 受信フィルタを選択します。

ミモ
使用法: mimo [マスター | 奴隷]

デバイスの MIMO 動作を変更します。

開いた
使用法: [デバイス識別子] を開きます

後続のコマンドで使用するために指定されたデバイスを開きます。 以前に開いたデバイス
閉鎖されます。

デバイス識別文字列の一般的な形式は次のとおりです。

:[デバイス= : ] [インスタンス= ] [シリアル= ]

完全なデバイス指定子については、libbladeRF の Bladerf_open() ドキュメントを参照してください。
形式でダウンロードすることができます。

ピーク
使用法: ピーク[アドレス数]

Peak コマンドは、FPGA にぶら下がっているデバイスを読み取ることができます。
LMS6002D トランシーバー、VCTCXO トリム DAC、または Si5338 クロック ジェネレーター チップ。

num_addresses が指定されている場合、アドレスは 1 ずつインクリメントされ、別のピークが表示されます。
その数のアドレスに対して実行されます。

有効なアドレス範囲:

デバイスアドレス範囲
────────────────────────
DAC 0 ～ 255

lms 0 ～ 127
シ0～255

例：

・のぞき見...

突く
使用法: 突く

poke コマンドは、FPGA にぶら下がっているデバイスを書き込むことができます。
LMS6002D トランシーバー、VCTCXO トリム DAC、または Si5338 クロック ジェネレーター チップ。

有効なアドレス範囲:

デバイスアドレス範囲
────────────────────────
DAC 0 ～ 255
lms 0 ～ 127
シ0～255

例：

· ポーク lms ...

印刷
使用法: print [パラメータ]

print コマンドには、印刷するためのパラメーターが必要です。 利用可能なパラメータを以下に示します。 もしも
パラメータが指定されていない場合は、すべてのパラメータが出力されます。

パラメーター記述
───────────────── ────────────
帯域幅 帯域幅の設​​定
周波数 周波数設定
gpio FX3 <-> FPGA GPIO 状態
ループバック ループバック設定
lnagain RX LNA のゲイン設定 (dB 単位)
rx_mux FPGA RX FIFO 入力マルチプレクサ設定
rxvga1 RXVGA1 のゲイン設定 (dB 単位)
rxvga2 RXVGA2 のゲイン設定 (dB 単位)
txvga1 TXVGA1 のゲイン設定 (dB 単位)
txvga2 TXVGA2 のゲイン設定 (dB 単位)
サンプリング 外部または内部サンプリング モード
サンプルレート サンプルレートの設定
Trimdac VCTCXO トリム DAC 設定
vctcxo_tamer 現在の VCTCXO テイマー モード。
xb_gpio 拡張ボードの GPIO 値
xb_gpio_dir 拡張ボードの GPIO 方向 (1=出力、0=入力)

プローブ
使用法: プローブ [厳密]

接続されている BladeRF デバイスを検索し、結果のリストを印刷します。

strict を指定しない場合、使用可能なデバイスがないことはエラーとみなされません。

オプションの strict 引数を指定すると、このコマンドは、次のような状況を処理します。
デバイスがエラーとして検出され、スクリプトまたは -e オプションを介して提供されるコマンドのリストが発生します。
すぐに終了するにはコマンドライン引数を使用します。

やめます
使用法: 終了

CLIを終了します。

回復します
使用法: 回復 [ 】

ブートローダー モードで実行されているデバイスにファームウェアをロードするか、現在ブートローダー モードにあるすべてのデバイスを一覧表示します。
ブートローダーモード。

引数を指定しないと、このコマンドは FX3 ベースのデバイスの USB バスとアドレスをリストします。
ブートローダーモードで実行されます。

バス、アドレス、およびファームウェア ファイルへのパスが提供されると、指定されたデバイスは
提供されたファームウェアがロードされ、実行が開始されます。

ほとんどの場合、ファームウェアをデバイスの RAM に正常にロードした後、ユーザーは次のことを行う必要があります。
「open」コマンドでデバイスを開き、ファームウェアをフラッシュに書き込みます。
「fx3をロード」

ラン
使用法: 実行

提供されたスクリプトを実行します。

rx
使用法: rx

IQ サンプルを受信し、指定されたファイルに書き込みます。 受信が制御されており、
次のいずれかによって構成されます。

コマンドの説明
───────────────── ────────────
start サンプルの受信を開始します
stop サンプルの受信を停止します
wait サンプルの送信が完了するまで、またはサンプルの送信が完了するまで待ちます。
指定された時間が経過する
config サンプル受信を設定します。 パラメータがない場合は、
指定すると、現在のパラメータが出力されます。

追加のコマンドを行わずに rx を実行することは、rx config の有効な省略表現です。

wait コマンドには、オプションのタイムアウト パラメータを指定できます。 このパラメータのデフォルトの単位は、
ミリ秒 (ms)。 タイムアウト単位は、ms または s の接尾辞を使用して指定できます。 これなら
パラメータが指定されていない場合、コマンドは受信が完了するまで待機するか、Ctrl-C を押します。
が押された。

構成パラメータは、param=value の形式をとり、単一のパラメータまたはパラメータで指定できます。
複数の rx config 呼び出し。 以下は利用可能なパラメータのリストです。

パラメーター記述
───────────────── ────────────
n 受信するサンプルの数。 0 = 無限
file 受信したサンプルを書き込むファイル名
format 出力ファイル形式。 次のいずれか:
csv: SC16 Q11 サンプルの CSV
bin: 未加工の SC16 Q11 DAC サンプル
サンプルで使用するバッファごとのサンプル数
非同期ストリーム。 1024 で割り切れる必要があり、
> = 1024。
buffers 非同期で使用するサンプル バッファの数
ストリーム。 最小値は 4 です。
xfers 許可する同時転送の数。
使用する非同期ストリーム。 これは少なくなるはずです
バッファパラメータよりも。
timeout データ ストリームのタイムアウト。 接尾辞がない場合、デフォルトは
単位はミリ秒です。 デフォルト値は 1000 ミリ秒 (1 秒) です。
有効なサフィックスは ms と s です。

例：

· rx 設定ファイル =/tmp/data.bin フォーマット = bin n=10K

(10240 = 10 * 1024) サンプルを受信し、バイナリ DAC の /tmp/data.bin に書き込みます。
形式でダウンロードすることができます。

注意：

· n、samples、buffers、および xfers パラメータは、サフィックス K、M、および G をサポートします。
1024の倍数です。

· rx 停止に続いて rx 開始を行うと、サンプル ファイルが切り詰められます。 もしも
これは望ましくありません。再起動する前に必ず rx config を実行して別のファイルを設定してください。
rxストリーム。

· サンプル レートを高くするには、バイナリ出力形式を使用することをお勧めします。
出力ファイルは RAM に書き込まれます (例: / tmpに, / dev / shm)、スペースが許せば。 大型の場合
より高いサンプル レートでキャプチャを行う場合は、HDD の代わりに SSD の使用を検討してください。

tx
使用法: TX

指定されたファイルから IQ サンプルを読み取り、送信します。 送信は制御されており、
次のいずれかによって構成されます。

コマンドの説明
───────────────── ────────────
start サンプルの送信を開始します
stop サンプルの送信を停止します
wait サンプルの送信が完了するまで、またはサンプルの送信が完了するまで待ちます。
指定された時間が経過する
config サンプル送信を設定します。 パラメータがない場合は、
指定すると、現在のパラメータが出力されます。

追加のコマンドを行わずに tx を実行することは、tx config の有効な省略表現です。

wait コマンドには、オプションのタイムアウト パラメータを指定できます。 このパラメータのデフォルトの単位は、
ミリ秒 (ms)。 タイムアウト単位は、ms または s の接尾辞を使用して指定できます。 これなら
パラメータが指定されていない場合、コマンドは送信が完了するまで待機します。
Ctrl+C を押します。

構成パラメータは、param=value の形式をとり、単一のパラメータまたはパラメータで指定できます。
複数の tx 構成の呼び出し。 以下は利用可能なパラメータのリストです。

パラメーター記述
───────────────── ────────────
file サンプルを読み取るファイル名
format 入力ファイル形式。 次のいずれか:
csv: SC16 Q11 サンプルの CSV ([-2048, 2047])
bin: 未加工の SC16 Q11 DAC サンプル ([-2048, 2047])
ファイルの内容を繰り返す回数。
伝わった。 0 は、停止するまで繰り返すことを意味します。
遅延間の遅延のマイクロ秒数。
ファイルの内容を再送信しています。 0 は遅延がないことを意味します。
サンプルで使用するバッファごとのサンプル数
非同期ストリーム。 1024 で割り切れる必要があり、
> = 1024。
buffers 非同期で使用するサンプル バッファの数
ストリーム。 最小値は 4 です。
xfers 許可する同時転送の数。
使用する非同期ストリーム。 これは < である必要があります
バッファパラメータ。
timeout データ ストリームのタイムアウト。 接尾辞がない場合、デフォルトは
単位はミリ秒です。 デフォルト値は 1000 ミリ秒 (1 秒) です。
有効なサフィックスは「ms」と「s」です。

例：

· tx 設定ファイル = data.bin 形式 = bin 繰り返し = 2 遅延 = 250000

data.bin の内容を 250 回送信し、その間に最大 XNUMXms の遅延が発生します。
トランスミッション。

注意：

· n、samples、buffers、および xfers パラメータは、サフィックス K、M、および G をサポートします。
1024の倍数です。

· サンプルレートを高くするには、入力ファイルを RAM に保存することをお勧めします (例: / tmpに,
/ dev / shm)、または HDD ではなく SSD 上にあります。

· CSV データを提供する場合、このコマンドはまずそれをバイナリ形式に変換し、保存します。
現在の作業ディレクトリ内のファイルにあります。 このプロセス中に、範囲外の値が
締め付けられるだろう。

· バイナリ形式を使用する場合、ユーザーは提供されたデータが確実に保存されることを保証する責任があります。
値は許容範囲内です。 この前提条件により、この必要性が軽減されます。
時間に敏感なコールバックで範囲チェックを実行するプログラム。

セッションに
使用法: セット

set コマンドは、パラメータと、その特定のパラメータに対する任意の数の引数を受け取ります。
パラメータ。 パラメータは次のいずれかです。

パラメーター記述
───────────────── ────────────
帯域幅 帯域幅の設​​定
周波数 周波数設定
gpio FX3 <-> FPGA GPIO 状態
ループバック ループバックの設定。 「set loopback」を実行してモードを一覧表示します。
lnagain RX LNA のゲイン設定 (dB 単位)。 値: 0、3、6
rxvga1 RXVGA1 のゲイン設定 (dB 単位)。 範囲: [5、30]
rx_mux FPGA RX FIFO 入力マルチプレクサ モード。 オプションは次のとおりです。
BASEBAND_LMS、12BIT_COUNTER、32BIT_COUNTER、
デジタル_ループバック
rxvga1 RXVGA1 のゲイン設定 (dB 単位)。 範囲: [5、30]
rxvga2 RXVGA2 のゲイン設定 (dB 単位)。 範囲: [0、30]
txvga1 TXVGA1 のゲイン設定 (dB 単位)。 範囲: [-35、-4]
txvga2 TXVGA2 のゲイン設定 (dB 単位)。 範囲: [0、25]
サンプリング 外部または内部サンプリング モード
サンプルレート サンプルレートの設定
トリムDAC VCTCXO トリム DAC 設定
vctcxo_tamer VCTCXO テイマー モード。 オプション: 無効、1PPS、10MHz
xb_gpio 拡張ボードの GPIO 値
xb_gpio_dir 拡張ボードの GPIO 方向 (1=出力、0=入力)

バージョン
使用法: バージョン

ホスト ソフトウェアと現在のデバイスのバージョン情報を出力します。

例

$ BladeRF-cli -l hostx40.rbf

hostx40.rbf という名前の FPGA イメージを BladeRF の FPGA にロードします。

Note: --load-fpga でロードされた FPGA イメージは、電源をオフにすると失われます。

$ BladeRF-cli -f ファームウェア.img

ファームウェア.img を BladeRF のファームウェアにフラッシュします。

$ BladeRF-cli -L hostsx40.rbf

hostx40.rbf という名前の FPGA イメージを BladeRF にフラッシュします。
電源投入時に自動的にロードされます。

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