miniSMU MS01 以指令介面進行操作，並遵循 SCPI（Standard Commands for Programmable Instruments，可程式化儀器標準指令）慣例。本節說明指令結構，並概述可用的指令。
指令語法概覽
指令透過軟體介面傳送到裝置。指令的一般結構如下：COMMAND[:SUBCOMMAND] [PARAMETER]
若是向裝置要求資訊的查詢指令，請在指令後方加上問號：COMMAND[:SUBCOMMAND]?
指令結構元素
常用指令參考
下表列出最常用的指令，供您參考：
| 指令 | 功能 | 範例 | 回應 |
|---|---|---|---|
*IDN? | 回傳裝置識別資訊 | *IDN? | Undalogic Ltd, miniSMU MS01, SN12345, v1.0, FW2.3 |
*RST | 重新啟動裝置 | *RST | 裝置重新啟動 |
系統指令
系統指令用於控制整台裝置的設定與狀態：
| 指令 | 功能 | 範例 | 備註 |
|---|---|---|---|
SYST:TIME <time> | 設定系統時間 | SYST:TIME 1751312870064 | UNIX 時間，單位為毫秒 |
SYST:WIFI DIS | 停用 Wi-Fi | SYST:WIFI DIS | Wi-Fi 關閉 |
SYST:WIFI ENA | 啟用 Wi-Fi | SYST:WIFI ENA | Wi-Fi 開啟 |
SYST:WIFI:AUTO? | 查詢自動連線設定 | SYST:WIFI:AUTO? | 0 或 1 |
SYST:WIFI:AUTO DIS | 停用自動連線 | SYST:WIFI:AUTO DIS | 不自動連線 |
SYST:WIFI:AUTO ENA | 啟用自動連線 | SYST:WIFI:AUTO ENA | 已啟用自動連線 |
SYST:WIFI:SCAN? | 掃描網路 | SYST:WIFI:SCAN? | JSON 格式的網路清單 |
SYST:WIFI? | 查詢 Wi-Fi 狀態 | SYST:WIFI? | JSON 格式的連線狀態 |
SYST:WIFI:SSID "<name>" | 設定 Wi-Fi SSID | SYST:WIFI:SSID "Home_Network" | 已設定 SSID |
SYST:WIFI:PASS "<password>" | 設定 Wi-Fi 密碼 | SYST:WIFI:PASS "SecurePass123" | 已設定密碼 |
SYST:WIFI:SSID? | 查詢 Wi-Fi SSID | SYST:WIFI:SSID? | 目前的 SSID |
SYST:TEMP? | 查詢溫度 | SYST:TEMP? | 溫度值（ADC、通道 1、通道 2） |
輸出設定與輸出控制指令
這些指令用於控制各通道的輸出設定。請將 x 換成通道編號（1 或 2）：
| 指令 | 功能 | 範例 | 備註 |
|---|---|---|---|
SOURx:CURR:PROT <value> | 設定電流限值 | SOUR1:CURR:PROT 0.1 | CH1 限值 100 mA |
SOURx:CURR <value> | 設定電流輸出 | SOUR2:CURR 0.01 | CH2 輸出 10 mA |
SOURx:VOLT:PROT <value> | 設定電壓限值 | SOUR1:VOLT:PROT 5 | CH1 限值 5V |
SOURx:VOLT <value> | 設定電壓輸出 | SOUR2:VOLT 3.3 | CH2 輸出 3.3V |
SOURx:FIMV ENA | 施加 I、量測 V | SOUR1:FIMV ENA | FIMV 模式 |
SOURx:FVMI ENA | 施加 V、量測 I | SOUR2:FVMI ENA | FVMI 模式 |
SOURx:DATA:STREAM ON/OFF | 切換串流 | SOUR1:DATA:STREAM ON | 串流開啟 |
OUTPx ON/OFF | 切換輸出 | OUTP1 ON | 已啟用輸出 |
量測指令
這些指令用於執行量測。請將 x 換成通道編號（1 或 2）：
| 指令 | 功能 | 範例 | 備註 |
|---|---|---|---|
MEASx:VOLT:CURR? | 量測 V 與 I | MEAS1:VOLT:CURR? | 兩項讀值 |
MEASx:VOLT? | 量測電壓 | MEAS2:VOLT? | 電壓值 |
MEASx:CURR? | 量測電流 | MEAS1:CURR? | 電流值 |
MEASx:OSR <value> | 設定量測過取樣 | MEAS2:OSR 10 | 210 倍過取樣（有效值為 0-15） |
資料串流指令
用於連續資料擷取：
| 指令 | 功能 | 範例 | 備註 |
|---|---|---|---|
SOURx:DATA:STREAM ON | 啟用串流 | SOUR1:DATA:STREAM ON | 已開始串流 |
SOURx:DATA:STREAM OFF | 停用串流 | SOUR1:DATA:STREAM OFF | 已停止串流 |
SOURx:DATA:SRATE <rate> | 設定目標取樣率 | SOUR1:DATA:SRATE 500 | 以 500 Hz 取樣 |
資料會分批傳送，採用 CSV 格式，結構如下：
1,1751313180797,3.713e-02,-7.441e-10,0
資料格式欄位
| 欄位 | 範例 | 說明 |
|---|---|---|
| 通道編號 | 1 | miniSMU 的通道（1 或 2） |
| UNIX 時間戳記 | 1751313180797 | 量測的時間戳記，單位為毫秒 |
| 電壓 | 3.713e-02 | 電壓量測值，單位為伏特（V） |
| 電流 | -7.441e-10 | 電流量測值，單位為安培（A） |
| 檔位 | 0 | 電流檔位識別碼（僅供除錯） |
指令分隔字元與結束字元
- 指令通常以換行字元
\n結尾 - 指令的回應通常以換行字元結尾
指令執行注意事項
- 指令會依接收的順序依序執行
- 部分指令可能需要一些時間才能完成（例如 Wi-Fi 掃描）
- 設定指令通常會回應
OK表示確認 - 查詢指令一律會回傳回應
錯誤訊息
若指令發生錯誤，裝置可能會回傳錯誤訊息：
- 語法錯誤（以 SOUR:VOLT 為例）：
Invalid SOUR:VOLT command - 未知的指令：
Invalid input format
軟體介面
雖然在進階的程式設計情境中，您可以直接使用這些指令，但 miniSMU 軟體提供了圖形化介面，會在背景替您發送這些指令。軟體介面包括：
- 用於設定電壓與電流值的輸入欄位
- 用於啟用／停用輸出的按鈕
- 顯示量測讀值的畫面
- 保護設定的設定面板
- 串流量測的資料視覺化
在下列情況下，了解指令結構特別有幫助：
- 建立自動化測試程序
- 開發自訂的軟體介面
- 排解裝置行為的問題
- 執行基本軟體介面未涵蓋的進階操作