3. SCPI语言入门

SCPI（Standard Commands for Programmable Instruments，可编程仪器标准命令）是搭建射频仪器通信框架的核心语言基础。无论是使用VISA库直接编写控制程序，还是通过Keysight VEE、LabVIEW等图形化环境间接调用，最终下发给信号源、频谱仪、网络分析仪等射频仪器的底层指令都是SCPI命令。理解SCPI的树状结构、语法规则和响应格式，是确保通信稳定、代码可移植、排障高效的关键前提。本章将从命令结构、语法规则、常用命令实例和响应解析四个维度展开，帮助您建立扎实的SCPI编程功底。

上图展示了SCPI命令的核心逻辑：以仪器根节点为起点，通过冒号分隔的层级关键字定位到具体功能子系统，最终执行设置或查询操作。公共命令（以星号开头）则直接挂在根节点下，用于实现仪器识别、复位、自检等通用功能。下面我们深入解析每一部分的细节。

3.1 SCPI命令结构：树状层级与关键字缩写规则

核心原理：SCPI命令采用树状层级结构，类似于文件系统的目录路径。命令由根节点、子系统节点和叶节点组成，节点之间使用冒号（:）分隔。这种设计使得命令具有极强的可读性和扩展性。例如，设置信号源频率的命令路径为 :FREQuency:CW 1.5 GHz，其中 FREQuency 是频率子系统，CW 是连续波频率设置节点。

关键字缩写规则：SCPI命令支持长格式和短格式两种写法。短格式规则为：如果关键字长度大于4个字母，则取前4个字母（若第4个字母为辅音，则取前3个字母加第4个字母）；如果关键字长度小于等于4个字母，则全部保留。例如：

• FREQuency → 短格式 FREQ
• POWer → 短格式 POW
• LEVel → 短格式 LEV
• OUTPut → 短格式 OUTP

实际编程中，推荐使用短格式以减少传输字节数，但必须保证缩写唯一性。例如 :FREQ:CW 2.4GHz 与 :FREQuency:CW 2.4GHz 完全等价。

3.2 语法规则：参数类型、单位与终止符

参数类型：SCPI命令参数分为数值型、布尔型、字符串型和离散型四种。射频仪器中最常用的是数值型参数，其单位可以显式给出，也可以省略（使用仪器默认单位）。例如：

:FREQ:CW 2.4 GHz    // 显式单位
:FREQ:CW 2400000000  // 无单位，默认Hz
:POW:LEV -20 dBm     // 功率单位dBm
:POW:LEV 0.01        // 无单位，默认W（需根据仪器手册确认）

单位换算规则：SCPI支持标准科学计数法后缀，包括 GHz、MHz、kHz、Hz、dBm、dB、V、A、W 等。仪器内部会自动换算为基本单位。例如发送 :FREQ:CW 1.5GHz，仪器内部存储为 1500000000 Hz。

命令终止符：SCPI命令必须以换行符（\n，ASCII 0x0A）或回车换行符（\r\n）结束。在VISA编程中，viWrite 函数发送的字符串末尾需要显式添加终止符，或者通过设置VISA属性 VI_ATTR_TERMCHAR_EN 自动追加。查询命令（以问号结尾）发送后，必须使用 viRead 读取响应，响应同样以换行符结束。

3.3 常用命令实战：*IDN?、频率与功率设置

3.3.1 *IDN? 仪器识别命令

这是所有SCPI仪器必须支持的公共命令，用于查询仪器身份信息。其响应格式固定为四个字段，以逗号分隔：

厂商, 型号, 序列号, 固件版本
示例：Keysight Technologies,E8257D,US00012345,2.4.5

在通信框架搭建初期，发送 *IDN? 并验证返回信息是确认VISA连接是否成功、仪器地址是否正确的最快捷方法。如果返回空字符串或错误信息，说明通信链路存在问题。

3.3.2 频率设置与查询

对于信号源，设置输出频率是最核心的操作。常用命令如下：

:FREQ:CW 1.5 GHz    // 设置连续波频率为1.5GHz
:FREQ:CW?            // 查询当前频率，返回如 "1500000000"

对于频谱仪，频率设置通常涉及中心频率和扫宽：

:FREQ:CENT 2.4 GHz  // 设置中心频率
:FREQ:SPAN 100 MHz   // 设置扫宽
:FREQ:CENT?          // 查询中心频率

3.3.3 功率设置与查询

信号源的输出功率设置命令为：

:POW:LEV -20 dBm    // 设置输出功率为-20dBm
:POW:LEV?            // 查询当前功率，返回如 "-20.000000"

注意：功率查询返回的是ASCII字符串，需要转换为浮点数才能进行数值比较。在C语言中使用 atof()，在Python中使用 float()，在LabVIEW中使用 Fract/Exp String To Number 节点。

3.4 查询响应格式与常见误区

响应格式规范：SCPI查询命令的响应总是以ASCII字符串形式返回，并以换行符（\n）结束。数值型响应可能包含科学计数法（如 1.500000E+09），也可能为普通十进制（如 1500000000），具体取决于仪器型号和当前精度设置。字符串型响应（如 *IDN?）直接返回原始字符串。

常见误区一：忽略响应缓冲区的清空。在连续发送多条查询命令时，如果未及时读取上一次的响应，可能导致缓冲区溢出或数据错位。正确做法是每次查询后立即读取，或使用 viClear 清空缓冲区。

常见误区二：单位混淆。例如发送 :POW:LEV -20 时，仪器默认单位可能是dBm，也可能是W，取决于仪器出厂设置。建议始终显式携带单位，避免歧义。

常见误区三：命令大小写混用。SCPI命令不区分大小写，但为了代码可读性，建议统一使用大写或小写。混用不会导致错误，但会降低代码美观度。