LIQUID INSTRUMENTS MATLAB API 統合ヒューズユーザーガイド

コンテンツ 隠れる

1 液体計器 MATLAB API 統合ヒューズ

2 以上view

液体計器 MATLAB API 統合ヒューズ

MATLAB API 移行ガイド

Moku: Lab をソフトウェアバージョン 3.0 にアップグレードすると、多数の新機能が利用できるようになります。更新する場合、API ユーザーはスクリプトを新しい Moku API パッケージに移行するための追加の手順を実行する必要があります。この移行ガイドでは、API の変更点、バージョン 3.0 アップデートで利用できる新機能、および下位互換性の制限について概説します。

以上view

Moku:Lab ソフトウェアバージョン 3.0 は、新しいファームウェア、ユーザーインターフェイス、および APls を Moku:Lab ハードウェアにもたらすメジャーアップデートです。このアップデートにより、Moku:Lab が Moku:Pro および Moku:Go と連携し、すべての Moku プラットフォーム間でスクリプトを簡単に共有できるようになります。このアップデートにより、既存の機器の多くに多数の新機能が追加されます。また、マルチインストゥルメントモードと Moku Cloud Compile という XNUMX つの新機能も追加されています。「下位互換性」セクションで概説されているように、動作にも微妙な違いがいくつかあります。

これは API アーキテクチャに影響を与えるメジャーアップデートであるため、新しい MATLAB API v3.0 パッケージには既存の MATLAB スクリプトとの下位互換性がありません。 API ユーザーは、Moku:Lab をバージョン 3.0 にアップグレードする場合、スクリプトを新しい Moku API パッケージに移植する必要があります。重要なカスタムソフトウェア開発を行う API ユーザーは、既存のコードを移植するために必要な労力のレベルを慎重に検討する必要があります。 Moku:Lab 1.9 は新規導入には推奨されず、すべてのお客様にアップグレードすることをお勧めします。アップグレード後に問題が発生した場合、ユーザーはソフトウェアバージョン 1.9 にダウングレードするオプションを利用できます。

この移行ガイドでは、advan の概要を説明しますtagMoku:Lab バージョン 3.0 のアップデートと潜在的な複雑さ。また、MATLAB API をアップグレードするプロセスと、必要に応じて Moku:Lab をダウングレードする方法についても説明します。

バージョン3.0の新機能

新機能

ソフトウェアバージョン 3.0 では、Moku:Lab に初めてマルチインストゥルメントモードと Moku Cloud Compile が導入され、インストゥルメントスイート全体で多くのパフォーマンスと使いやすさがアップグレードされました。

マルチ機器モード

Moku:Lab のマルチ機器モードを使用すると、ユーザーは 2 つの機器を同時に展開してカスタムテストステーションを作成できます。各機器は、機器スロット間の相互接続に加えて、アナログ入力および出力に完全にアクセスできます。機器間の相互接続は、最大 XNUMX Gb/s の高速、低遅延、リアルタイムのデジタル通信をサポートしているため、機器は独立して実行することも、接続して高度な信号処理パイプラインを構築することもできます。他の楽器を中断することなく、楽器を動的に入れ替えることができます。上級ユーザーは、Moku Cloud Compile を使用して、マルチインストゥルメントモードで独自のカスタムアルゴリズムをデプロイすることもできます。

Mokuクラウドコンパイル

Moku Cloud Compile を使用すると、カスタム DSP をマルチ計測器モードで Moku:Lab FPGA に直接展開できます。を使用してコードを記述します web ブラウザーを使用してクラウドでコンパイルします。 Moku Cloud Compile は、ビットストリームを XNUMX つ以上のターゲット Moku デバイスにデプロイします。

オシロスコープ

ディープメモリモード: 最大 4M 秒を保存ampフル秒時のチャンネルあたりのファイル数ampリングレート (500 MSa/秒)

スペクトラムアナライザ

ノイズフロアの改善
対数 Vrms および Vpp スケール

XNUMX つの新しいウィンドウ関数 (Bartlett、Hamming、Nuttall、Gaussian、Kaiser)

位相計

周波数オフセット、位相、 amp緯度をアナログ音量として出力できるようになりましたtageシグナル
ユーザーは出力信号に DC オフセットを追加できるようになりました

位相ロック正弦波出力は、周波数を最大 2 50 倍まで逓倍したり、125 倍まで分周したりできるようになりました。
改善された帯域幅範囲 (1 Hz ～ 100 kHz)

高度な位相ラッピング機能とオートリセット機能

波形発生器

ノイズ出力
パルス幅変調（PWM）

固定する Ampリファイアー

低周波性能の向上 ＰＬＬ ロック

最小 PLL 周波数は 10 Hz に低下しました
内部 PLL 信号は、復調に使用するために周波数を最大 250 倍まで逓倍するか、または 125 倍まで分周できるようになりました。

位相値の 6 桁の精度

周波数応答アナライザ

最大周波数が 120 MHz から 200 MHz に増加
最大掃引ポイントを 512 から 8192 に増加
新しいダイナミック AmpLitude 機能により、出力信号が自動的に最適化され、最高の測定ダイナミックレンジが得られます。
新しい ln/ln1 測定モード
入力飽和警告
演算チャネルは、チャネル信号に関係する任意の複素数値方程式をサポートするようになり、新しいタイプの複素伝達関数測定が可能になります。
入力信号は、dBm に加えて dBVpp および dBVrms で測定できるようになりました。
スイープの進行状況がグラフに表示されるようになりました
周波数軸をロックして、長い掃引中に偶発的に変更されるのを防ぐことができるようになりました。

レーザーロックボックス

改良されたブロック図はスキャンおよび変調信号パスを示しています
新しいロックtages機能によりロック手順をカスタマイズできます
低周波性能の向上 ＰＬＬ ロック
位相値の 6 桁の精度
低周波性能の向上 ＰＬＬ ロック

最小 PLL 周波数は 10 Hz に低下しました
の ＰＬＬ 復調に使用するために、信号を最大 250 倍まで周波数逓倍したり、0.125 倍まで分割したりできるようになりました。

他の

任意波形ジェネレーターでカスタム波形を生成するために使用できる方程式エディターにサイン関数のサポートが追加されました。

バイナリを変換する LI fileデバイスからダウンロードする場合は、CSV、MATLAB、または NumPy 形式に変換します

アップグレードされた API サポート

新しい Moku MATLAB API v3.0 パッケージは、強化された機能と安定性を提供します。パフォーマンスを向上させ、新機能を導入するために定期的にアップデートが行われます。

下位互換性の制限

翻訳

新しい Moku MATLAB API v3.0 パッケージには、以前の Moku:Lab MATLAB v1.9 パッケージとの下位互換性がありません。 MATLAB スクリプトの引数と戻り値はまったく異なります。 Moku:Lab MATLAB を利用して大規模なカスタムソフトウェア開発を行っている場合は、すべてのソフトウェアを新しい API と互換性を持つように移行することによる影響を考慮してください。

Moku:Lab MATLAB パッケージはアップデートを受信しなくなりますが、Liquid Instruments は新しい API パッケージに移行できないユーザーに対するサポートを引き続き提供します。

詳細な元を検索amp新しい Moku MATLAB API v3.0 パッケージの各計測器のファイルは、以前の MATLAB 開発を新しい API パッケージに変換するためのベースラインとして機能します。

回帰

データロギング用RAMディスク

バージョン 1.9 の容量は 512 MB でした。 fileデバイスの RAM 内のシステム。高速でのデータのログ記録に使用される可能性があります。ampリングレート。バージョン 3.0 では、RAM へのログ記録は利用できなくなりました。データロギングを有効にするには、SD カードが必要です。それに伴い、最大取得速度も変化します。バージョン 1.9 は最大 1 MSa/s をサポートしましたが、バージョン 3.0 は 250 チャネルで最大 1 kSa/s、125 チャネルで最大 2 kSa/s をサポートしました。低速で SD カードを使用する場合でも、複数の高速ログを RAM に保存し、後でそれらを SD カードまたはクライアントにコピーするなどのワークフローはサポートされなくなります。

CSVへのデータロギング

バージョン 1.9 には、データを CSV に直接保存する機能がありました。 file ログ記録中。この機能はバージョン 3.0 では直接利用できません。ワークフローに CSV の保存が含まれているユーザーfileSD カードに直接保存しない場合は、クライアントが最初にバイナリを変換する必要があります。 file クライアントアプリを使用するか、スタンドアロンの Liquid Instruments をインストールして、CSV に変換します。 File データ処理に使用するコンピュータへのコンバータ。

下位互換性のない変更

LIA でのデータスケーリング

バージョン 1.9 では、0.1 つの 0.02 V DC 信号を乗算すると 3.0 V DC 出力が得られるようにデータスケーリングを実装しました。バージョン 0.01 では、結果が XNUMX V DC になるようにこれを変更しました。これは、顧客の直感的な期待により一致します。

変調ソース/トリガーとして使用するには、波形ジェネレーターの出力を有効にする必要があります

バージョン 1.9 では、チャンネルの出力が無効になっている場合でも、別のチャンネルの波形を波形ジェネレーターの変調またはトリガーソースとして使用できました。これはバージョンで削除されました

デバイスの出力を取り外さずにクロスモジュレーションを実行したいユーザーは、デバイスの出力を調整する必要があります。

もく MATLAB API

Moku MATLAB API v3.0 パッケージは、MATLAB 開発者に Moku デバイスの制御に必要なリソースを提供し、最終的にはこれらの制御を大規模なエンドユーザーアプリケーションに組み込む機能を提供することを目的としています。新しい Moku MATLAB API v3.0 パッケージは以下を提供します。

完全に機能する元ampそれぞれのファイル MATLAB スクリプト
すべての MATLAB スクリプトにはコメントが付いており、理解しやすく、エンドユーザーによるカスタマイズや作業の開始点として役立ちます。

Moku を完全に制御する一連の機能

現在サポートされている楽器

任意波形発生器
データロガー

デジタルフィルターボックス
FIRフィルタービルダー
周波数応答アナライザ

レーザーロックボックス
ロックイン Ampリファイアー
オシロスコープ

位相計
PIDコントローラ
スペクトラムアナライザ

波形発生器
マルチ機器モード
Mokuクラウドコンパイル

インストール

要件

MATLAB バージョン 2015 以降

以前のバージョンの Moku MATLAB API がすでにインストールされている場合は、続行する前にそれをアンインストールしてください。パッケージはアドオンマネージャーからアンインストールできます。

[ホーム] > [環境] タブからアドオンマネージャーを開きます。
検索する Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
あるいは、Liquid Instruments からツールボックスを直接ダウンロードすることもできます。 webサイト https://www.liquidinstruments.com/products/apis/matlab-api/。これを行う場合は、検索パスを手動で設定する必要があります。

[ホーム] > [環境] タブから [パスの設定] を選択して、正しいパスがツールボックスに追加されていることを確認します。
ツールボックスのインストール場所を指すエントリがあることを確認します。一般的なパスは、CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB です。
機器データをダウンロードする file■ MATLAB コマンドウィンドウに「moku_download####)」と入力します。 ### は、現在のファームウェアバージョンに置き換える必要があります。 Yol は、Moku: デスクトップアプリで Moku を右クリックして「デバイス情報」にカーソルを置くか、iPad アプリで Moku を長押しして、現在のファームウェアバージョンを確認できます。

MATLAB コマンドウィンドウに「help Moku」と入力して、ツールボックスが正しく設定されていることを確認します。このコマンドが成功した場合。ツールボックスは正常にインストールされました

Moku APIの変更

新しい Moku MATLAB API アーキテクチャは、以前の API アーキテクチャとは大きく異なるため、既存の API スクリプトとの下位互換性がありません。以下の簡易オシロスコープ exampこのファイルは、従来の API パッケージと新しい API パッケージの違いを示し、既存のコードを移植するためのロードマップとして機能します。

オシロスコープexample

シーケンスステップ

Moku MATLAB API 3.0 をインポートする

Moku の所有権を主張し、オシロスコープのビットストリームをアップロードします。
タイムベースを設定し、時間軸の左側と右側のスパンを設定します。
データを取得し、オシロスコープからデータの単一フレームを取得します。

Moku の所有権を放棄してクライアントセッションを終了する

上記のシーケンスは簡略化された例ですamp従来の API パッケージと新しい API パッケージの違いを説明するファイル。クライアントセッションの開始、計測器ビットストリームの Moku へのアップロード、クライアントセッションの終了以外にも、エンドユーザーはアプリケーションのニーズを満たすためにさまざまな順序で任意の数の機能を実行できます。

違い

ここでは、シーケンスの各ステップにおける XNUMX つの AP 間の違いを見ていきます。

Moku の所有権を主張し、オシロスコープのビットストリームをデバイスにアップロードします。 Moku MATLAB 1.9 と比較すると、新しい API にはまったく異なる機能があります。

	もく MATLAB 1.9		もく MATLAB 3.0
関数	get_by_name()	デプロイまたは接続()	オシロスコープ（）
許可されるフィールドと値	名前: 文字列タイムアウト: 浮動小数点数	機器: 導入したい機器のクラス	IP: 文字列シリアル: 文字列
	力: ブール値	set_defauIt: booI	強制接続: ブール値
		use_externa I: ブール値	無視_ビジー: ブール値
			persist_state: ブール値
			connect_timeout: フロート
			read_timeout: float

タイムベースを設定します。関数は同じですが、許可される引数が少し異なります。

もく MATLAB 1.9 もく MATLAB 3.0

関数 set_timebase() set_timebase()

許可されるフィールドと値 t1: フロート t2: フロート t1: float t2:float strict: bool

データを取得します。関数と許可される引数は同じですが、返されるデータ型と長さは異なります。

	もく MATLAB 1.9	もく MATLAB 3.0
関数	get_data（）	get_data（）
許可されるフィールドと値	タイムアウト: float 待機: ブール値	タイムアウト: float wait_reacquire: bool
戻り長さ	16383フレームあたりXNUMXポイント	1024フレームあたりXNUMXポイント

Moku の所有権を解放します。

もく MATLAB 1.9 モク API v3.0

関数 近い（） relinquish_ownership()

オシロスコープ機能一覧

もく MATLAB 1.9	もく MATLAB 3.0
set_sourceO	set_sourcesO
set_triggerO	set_triggerO
get_dataQ	get_dataQ
set_frontendQ	set_frontendQ
set_defau!tsQ set_timebaseO set_xmodeQ	set_defau!tsQ set_timebaseQ disable_inputO イネーブル_ロールモードQ
set_precision_modeQ	set_acquisition_modeQ
同期位相Q	同期出力_フェーズQ
get_frontendQ	get_frontendQ
取得amp!erateO get_rea!time_dataQ	取得amp!erateO save_high_res_bufferO
gen_rampウェーブオー gen_sinewaveO	生成_波形O get_acquisition_modeQ
gen_squarewaveQ	get_sourcesQ
gen_offQ	get_timebaseQ get_output_!oadQ
セットampレラテQ set_framerateQ	get_interpo!ationO set_output_!oadQ
	set_ヒステリシスQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_measurementQ
	概要Q

Moku MATLAB API は Moku API に基づいています。 Moku API の完全なドキュメントについては、ここにある Moku API リファレンスを参照してください。 https://apis.liq uidinstrume nts.com/re fe reそうだ/.

Moku MATLAB API の使用を開始するための追加の詳細については、次のサイトを参照してください。 https://a pis.liquid instruments.com/sta 評価-マットラボ。家

ダウングレードプロセス

バージョン 3.0 へのアップグレードによってアプリケーションにとって重要な機能が制限されるか、悪影響を受けることが判明した場合は、以前のバージョン 1.9 にダウングレードできます。これは、 web ブラウザ。

手順

Liquid Instruments に問い合わせて、 file ファームウェアバージョン9の場合。

Moku:Lab の IP アドレスを web ブラウザ（スクリーンショットを参照）。
[ファームウェアの更新] で、ファームウェアを参照して選択します。 file Liquid Instruments によって提供されます。
「アップロードと更新」を選択します。更新プロセスが完了するまでに 10 分以上かかる場合があります

laudinstruments.com

ドキュメント / リソース

液体計器 MATLAB API 統合ヒューズ [pdf] ユーザーガイド
MATLAB API、MATLAB API 統合ヒューズ、統合ヒューズ、ヒューズ

参考文献

ユーザーマニュアル