LIQUID INSTRUMENTS MATLAB API 集成保險絲
MATLAB API 遷移指南
將 Moku: Lab 升級到軟體版本 3.0 解鎖了許多新功能。 更新時，API 用戶必須採取額外步驟將腳本遷移到新的 Moku API 套件。 本遷移指南概述了 API 變更、版本 3.0 更新中提供的新功能以及任何向後相容性限制。
超過view
Moku:Lab 軟體版本 3.0 是重大更新，為 Moku:Lab 硬體帶來了新的韌體、使用者介面和 API。 此次更新使 Moku:Lab 與 Moku:Pro 和 Moku:Go 保持一致，從而可以輕鬆地在所有 Moku 平台上共享腳本。 此次更新為許多現有儀器解鎖了許多新功能。 它還增加了兩個新功能：多儀器模式和Moku雲編譯。 還有一些細微的行為差異，請參閱「向後相容性」部分。
這是影響 API 架構的重大更新，因此新的 MATLAB API v3.0 套件將不會向後相容現有的 MATLAB 腳本。 如果 API 使用者將 Moku:Lab 升級到版本 3.0，則需要將其腳本移植到新的 Moku API 套件。 進行大量客製化軟體開發的 API 使用者應仔細考慮移植現有程式碼所需的工作量。 Moku:Lab 1.9 不建議用於新部署，並鼓勵所有客戶升級。 如果升級後出現問題，使用者可以選擇降級到軟體版本1.9。
本遷移指南概述了高級功能tagMoku:Lab 3.0 版的更新與潛在複雜性。 它還概述了升級 MATLAB API 的過程以及如何在必要時降級 Moku:Lab。
3.0版本新功能
新功能
軟件版本 3.0 首次為 Moku:Lab 帶來了多儀器模式和 Moku 雲編譯，以及整個儀器套件的許多性能和可用性升級。
多儀器模式
Moku:Lab 上的多儀器模式允許使用者同時部署兩台儀器以建立自訂測試站。 每個儀器都可以完全存取類比輸入和輸出以及儀器插槽之間的互連。 儀器之間的互連支援高達 2 Gb/s 的高速、低延遲、即時數位通信，因此儀器可以獨立運行或連接以構建先進的信號處理管道。 儀器可以動態地換入和換出，而無需中斷其他儀器。 進階用戶還可以使用 Moku Cloud Compile 在多儀器模式下部署自己的自訂演算法。
木庫雲編譯
Moku Cloud Compile 讓您在多儀器模式下將自訂 DSP 直接部署到 Moku:Lab FPGA 上。 使用a編寫程式碼 web 瀏覽器並在雲端編譯； Moku Cloud Compile 將位元流部署到一台或多台目標 Moku 裝置。
示波器
- 深層儲存模式：最多儲存4M秒amp全 s 時每頻道的位元組數amp傳輸速率（500 MSa/s）
頻譜分析儀
- 改善本底噪聲
- 對數 Vrms 和 Vpp 刻度
- 五個新窗口函數（Bartlett、Hamming、Nuttall、Gaussian、Kaiser）
相位計
- 頻率偏移、相位和 amp緯度現在可以作為類比音量輸出tag電子信號
- 用戶現在可以向輸出信號添加直流偏移
- 鎖相正弦波輸出現在可以倍頻至 2 50x 或分頻至 125x
- 改進的頻寬範圍（1 Hz 至 100 kHz）
- 先進的相位纏繞和自動重置功能
波形發生器
- 噪音輸出
- 脈寬調製 (PWM)
鎖定 Amp改良劑
- 改善低頻表現 鎖相環 鎖定
- 最小 PLL 頻率已降至 10 Hz
- 內部 PLL 訊號現在可倍頻至 250 倍或分頻至 125 倍以用於解調
- 相位值的 6 位精度
頻率響應分析儀
- 最大頻率從 120 MHz 增加到 200 MHz
- 將最大掃描點數從 512 增加到 8192
- 新動態 Amp緯度功能自動優化輸出信號以獲得最佳測量動態範圍
- 新的 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 中的系統，可用於記錄高 s 的數據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 的用戶file直接保存到 SD 卡，否則客戶端現在需要首先轉換二進製文件 file CSV，使用客戶端應用程序或安裝獨立的液體儀器 File 轉換器到他們用於數據處理的計算機上。
不向後兼容的更改
LIA 中的數據縮放
在版本 1.9 中，我們實作了資料縮放，以便將兩個 0.1 V DC 訊號相乘得到 0.02 V DC 輸出。 在3.0版本中，我們對此進行了更改，使得結果為0.01V DC，這更符合客戶的直覺期望。
必須啟用波形發生器輸出才能用作調製源/觸發
在版本 1.9 中，即使停用了該通道的輸出，也可以將不同通道的波形用作波形產生器中的調變或觸發來源。 版本中已刪除此內容
- 想要進行交叉調變而不需要拔掉設備輸出的使用者需要調整他們的
木庫 MATLAB API
Moku MATLAB API v3.0 套件旨在為 MATLAB 開發人員提供控制任何 Moku 裝置所需的資源，並最終能夠將這些控制項合併到更大的最終用戶應用程式中。 新的 Moku MATLAB API v3.0 套件提供以下功能：
- 功能齊全的前amp每個檔案的 MATLAB 腳本
- 所有 MATLAB 腳本均附帶註釋，易於理解，可作為最終用戶進行自訂和修改的起點。
- 一組提供對 Moku 完全控制的功能
目前支援的儀器
- 任意波形發生器
- 數據記錄器
- 數字濾波盒
- FIR 濾波器生成器
- 頻率響應分析儀
- 鐳射鎖盒
- 鎖定 Amp改良劑
- 示波器
- 相位計
- PID控制器
- 頻譜分析儀
- 波形發生器
- 多儀器模式
- 木庫雲編譯
安裝
要求
- 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 腳本。 以下簡化的示波器範例amp該文件顯示了舊版 API 包和新版 API 包之間的差異，並作為移植現有代碼的路線圖。
示波器前ample
步驟順序
- 導入Moku MATLAB API 3.0
- 聲明 Moku 所有權並將示波器位元流上傳到
- 設定時基並設定時間軸的左右跨距。
- 取得數據，從示波器中取得單幀數據
- 透過放棄 Moku 所有權來結束客戶端會話
上述序列是一個簡化的例子amp文件來說明舊版和新版 API 包之間的差異。 除了開始客戶端會話、將儀器位元流上傳到 Moku 以及結束客戶端會話之外，最終用戶還可以按各種順序執行任意數量的功能，以滿足其應用程式的需求。
差異
在這裡，我們查看兩個 APl 之間序列中每個步驟的差異。
聲明 Moku 所有權並將示波器位元流上傳到裝置。 與Moku MATLAB 1.9相比，新的API具有完全不同的功能：
| 木庫MATLAB 1.9 | 木庫MATLAB 3.0 | ||
| 功能 | 按名稱取得() | 部署或連線() | 示波器() |
| 允許的欄位和值 | 名稱：字串超時：浮動 | 儀器：希望部署的儀器的類別 | ip: 字串 序號: 字串 |
| 力：布林值 | set_default: booI | 強制連接：布林值 | |
| use_externa I: 布爾 | 忽略忙碌：布林值 | ||
| 持久狀態：布林值 | |||
| 連接逾時：浮動 | |||
| 讀取逾時：浮動 | |||
- 設定時基。 功能相同，但允許的參數略有不同：
木庫MATLAB 1.9 木庫MATLAB 3.0 功能 設定時基() 設定時基() 允許的欄位和值 t1：浮點 t2：浮點 t1：浮點 t2：浮點 嚴格：布爾 - 獲取數據。 函數和允許的參數相同，但傳回的資料類型和長度不同：
木庫MATLAB 1.9 木庫MATLAB 3.0 功能 get_data（） get_data（） 允許的欄位和值 逾時：浮動等待：布爾 超時：浮動 wait_reacquire：bool 返回長度 每幀16383點 每幀1024點 - 釋放 Moku 所有權：
木庫MATLAB 1.9 魔庫API v3.0 功能 關閉（） 放棄所有權()
示波器功能列表
| 木庫MATLAB 1.9 | 木庫MATLAB 3.0 |
| 設定源O | 設定源O |
| 設定_triggerO | 設定_triggerO |
| 取得數據Q | 取得數據Q |
| 設定前端Q | 設定前端Q |
| set_default!tsQ set_timebaseO
設定x模式Q |
set_defau!tsQ set_timebaseQdisable_inputO |
| 設定精準度模式Q | 設定採集模式Q |
| 同步相位Q | 同步輸出相位Q |
| 取得前端Q | 取得前端Q |
| 得到_samp！rateO
get_rea!time_dataQ |
得到_samp！rateO
save_high_res_bufferO |
| gen_ramp波O
gen_sinewaveO |
生成波形O
get_acquisition_modeQ |
| gen_squarewaveQ | 獲取資源Q |
| gen_offQ | 獲取時基Q
get_output_!loadQ |
| 套amp學習Q
設定幀率Q |
get_interpolationO set_output_!loadQ |
| set_hysteresisQ
set_interpolationO |
|
| 設定輸入衰減O | |
| 設定源O
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 等級-Matlab。家
降級流程
如果事實證明昇級到版本 3.0 會限制對您的應用程式至關重要的某些功能或產生其他不利影響，您可以降級到先前的版本 1.9。 這可以透過 web 瀏覽器。
步驟
- 聯繫 Liquid Instruments 並獲取 file 適用於固件版本 9。
- 將您的 Moku:Lab IP 地址輸入到 web 瀏覽器（請參閱螢幕截圖）。
- 在更新固件下，瀏覽並選擇固件 file 由液體儀器提供。
- 選擇上傳和更新。 更新過程可能需要 10 分鐘以上才能完成
© 2023 液體儀器。 預訂的。
文件/資源
 |
LIQUID INSTRUMENTS MATLAB API 集成保險絲 [pdf] 使用者指南 MATLAB API、MATLAB API 集成保險絲、集成保險絲、保險絲 |