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 | 施加电流、测量电压（Force I, Measure V） | SOUR1:FIMV ENA | FIMV 模式 |
SOURx:FVMI ENA | 施加电压、测量电流（Force V, Measure 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? | 测量电压和电流 | 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 软件提供了图形界面，会在后台发送这些命令。软件界面包括：
- 用于设置电压和电流值的输入框
- 用于启用/禁用输出的按钮
- 测量读数显示
- 保护设置的配置面板
- 数据流测量的数据可视化
在以下情况下，了解命令结构尤其有用：
- 创建自动化测试序列
- 开发自定义软件界面
- 排查设备行为问题
- 执行基本软件界面未涵盖的高级操作