4、SCPI协议入门：SCPI命令格式、查询与设置命令、仪器通信基础

在自动化测试系统中，SCPI（Standard Commands for Programmable Instruments，可编程仪器标准命令）是连接上位机与频谱仪之间的“通用语言”。无论是使用Python、LabVIEW还是C#，最终都需要将用户意图翻译为符合SCPI规范的文本字符串，通过VISA、Socket或串口发送给仪器。本章将系统讲解SCPI命令的语法结构、查询与设置命令的差异、仪器通信的底层机制，并结合频谱仪EMI扫描的实际场景，帮助您建立扎实的SCPI编程基础。

4.1 SCPI命令的核心语法结构

SCPI命令采用分层树状结构，类似于文件系统的目录层级。每个命令由子系统关键字、助记符和参数组成，子系统之间用冒号（:）分隔，命令与参数之间用空格分隔。这种设计使得命令具有极强的可读性和扩展性。

:SUBSYSTEM:KEYWORD1:KEYWORD2? [参数]

:SENSE:FREQ:CENTER 1 GHz

:SENSE:FREQ:CENTER?

SCPI命令对大小写不敏感，但习惯上使用大写以增强可读性。命令中的关键字可以简写为前四个字母（若四个字母相同则需更多），例如:FREQuency可简写为:FREQ。这种简写机制在编写长命令时能显著减少字符串长度，但建议在脚本中保持全称以提高代码可维护性。

4.1.1 命令层级与子系统

频谱仪常见的SCPI子系统包括：

• :SENSE — 测量配置（频率、带宽、检波器等）
• :INIT — 触发初始化
• :TRIG — 触发源与触发方式
• :CALC — 数据处理（标记、峰值搜索等）
• :DISPlay — 显示控制
• :OUTPut — 输出接口配置
• :SYSTem — 系统级操作（错误查询、预设等）

理解子系统层级是编写正确命令的前提。例如，要设置频谱仪的分辨率带宽（RBW），需要定位到:SENSE:BANDwidth:RESolution，而不是直接使用:BAND。这种层级关系在仪器手册中通常以命令树的形式给出，建议初学者先查阅手册中的命令树总览。

4.1.2 参数类型与单位

SCPI命令的参数支持多种数据类型，包括数值型、布尔型、字符串型和枚举型。数值型参数可以附带单位，频谱仪常用的单位有Hz、kHz、MHz、GHz、dBm、dBµV、s、ms等。单位可以省略，此时使用仪器的默认单位。例如：

:SENSE:FREQ:STOP 1GHz    // 合法
:SENSE:FREQ:STOP 1000000000  // 合法，默认单位Hz
:SENSE:FREQ:STOP 1e9      // 合法，科学计数法

布尔型参数通常使用ON/OFF或1/0。枚举型参数则使用特定的字符串值，如:SENSE:SWEep:TYPE LIST中的LIST。在编写脚本时，建议始终显式指定单位，避免因默认单位不同导致的错误。

4.2 设置命令与查询命令的差异

SCPI命令分为两大类：设置命令（写命令）和查询命令（读命令）。设置命令用于修改仪器状态，查询命令用于读取当前状态或测量数据。两者的语法差异仅在于查询命令末尾多一个问号（?），但执行逻辑和返回行为有本质区别。

在实际编程中，设置命令和查询命令往往交替使用。例如，在EMI扫描前，需要先设置频率范围、RBW、检波器等参数，然后触发扫描，最后查询扫描结果。查询命令的返回值通常是ASCII字符串，需要在上位机中进行类型转换。

4.3 仪器通信基础：从物理层到应用层

SCPI命令本身只是文本字符串，必须通过物理通信接口传输到仪器。常见的通信方式包括GPIB、USB、LAN（VXI-11或Socket）和串口（RS-232）。在现代测试系统中，LAN和USB已成为主流，其中LAN通信又分为VXI-11协议和Raw Socket两种模式。

4.3.1 通信协议栈

以LAN通信为例，SCPI命令的传输路径为：

1. 应用层：SCPI命令字符串（如:SENSE:FREQ:STOP 1GHz）
2. 表示层：VISA库将命令封装为VXI-11或HiSLIP协议
3. 传输层：TCP/IP协议栈保证数据可靠传输
4. 物理层：以太网接口传输电信号

对于Raw Socket模式，上位机直接通过TCP/IP发送SCPI字符串，无需VISA库，但需要自行处理连接管理和错误重试。VISA库则提供了统一的API，屏蔽了底层协议差异，推荐在复杂系统中使用。

4.3.2 通信超时与同步

SCPI通信中最常见的错误是超时。当上位机发送查询命令后，仪器需要时间准备数据，如果上位机在设定时间内未收到响应，就会抛出超时异常。解决超时问题的常用方法包括：

• 设置合理的超时时间（通常为5-10秒，扫描类操作可延长至30秒）
• 使用*OPC?（操作完成查询）命令同步仪器状态
• 在发送查询命令前，先发送*WAI命令等待操作完成

# Python示例：使用*OPC?同步
import pyvisa
rm = pyvisa.ResourceManager()
sa = rm.open_resource('TCPIP0::192.168.1.100::INSTR')
sa.timeout = 10000  # 10秒超时

sa.write(':SENSE:FREQ:STOP 1GHz')
sa.write(':INIT:CONT OFF')  # 关闭连续扫描
sa.write(':INIT')           # 触发单次扫描
sa.write('*OPC?')           # 等待扫描完成
opc_result = sa.read()      # 返回1表示完成
if opc_result.strip() == '1':
    peak = sa.query(':CALC:MARK1:Y?')  # 查询峰值
    print(f'峰值电平: {float(peak):.2f} dBm')

4.4 实战案例：构建EMI扫描的SCPI命令序列

下面通过一个完整的EMI预扫描场景，演示SCPI命令的实际应用。假设我们需要使用频谱仪在30MHz-1GHz频段内进行峰值检波扫描，并读取所有峰值频率和幅度。

步骤1：初始化仪器状态

:SYSTem:PRESet          // 恢复出厂设置
:SENS:SWEep:TYPE LIST   // 设置为列表扫描模式
:SENS:FREQ:STAR 30MHz   // 起始频率
:SENS:FREQ:STOP 1GHz    // 停止频率
:SENS:BAND:RES 120kHz   // RBW=120kHz（EMI标准）
:SENS:BAND:VID 300kHz   // VBW=300kHz
:SENS:DET:PEAK ON       // 峰值检波器

步骤2：触发扫描并等待完成

:INIT:CONT OFF          // 关闭连续扫描
:INIT                   // 启动单次扫描
*OPC?                   // 查询操作完成状态

步骤3：查询峰值列表

:CALC:MARK:PEAK:COUNt?  // 查询峰值数量
// 假设返回5，则循环查询每个峰值
:CALC:MARK1:X?          // 查询第1个峰值的频率
:CALC:MARK1:Y?          // 查询第1个峰值的幅度
:CALC:MARK2:X?
:CALC:MARK2:Y?
// ... 依次查询所有峰值

步骤4：错误检查与日志记录

:SYSTem:ERRor?          // 查询错误队列
// 返回0,"No error"表示无错误

在实际脚本中，建议将上述命令封装为函数，并加入异常处理逻辑。例如，当查询峰值数量为0时，应检查扫描是否成功完成，而不是直接进入循环。

4.5 常见误区与总结复盘

在SCPI编程实践中，初学者常犯以下错误：

• 命令拼写错误：SCPI命令对拼写敏感，多一个字母或少一个冒号都会导致错误。建议使用仪器手册中的命令树进行核对。
• 单位缺失或错误：如将1GHz写成1G，部分仪器可能无法识别。
• 查询命令未加问号：导致仪器一直等待参数，上位机超时。
• 忽略错误队列：仪器执行错误后不会主动通知上位机，必须通过:SYSTem:ERRor?查询。
• 同步机制缺失：发送扫描命令后立即查询数据，此时扫描尚未完成，返回的是旧数据。

为避免上述问题，建议在脚本开发初期就建立命令发送-响应验证-错误检查的标准流程。每次发送命令后，可以主动查询错误队列，确保命令被正确执行。对于耗时操作，务必使用*OPC?或*WAI进行同步。