简介罗德施瓦茨FSW系列频谱仪远控SCPI指令文档基于官方用户手册整理面向实验室研究人员、电子工程师及自动测试系统设计者。内容围绕标准SCPI命令详细说明FSW8、FSW13、FSW26、FSW43、FSW50、FSW67、FSW85等型号在固件5.20及以后版本中的远程控制方法并涵盖B4 OCXO、B10外部发生器控制、B13高通滤波器、B21外部混频器、B24前置放大器、K19噪声功率比、K54 EMI测量、K544频率响应校正、K980 HUMS等常用附加选件。手册从安全与法规信息切入依次介绍常规控制指令、远程控制方法及特殊测量功能指令能帮助使用者快速掌握远程配置、自动测试流程搭建与数据采集的要点。压缩包内共1个PDF文件大小约39.69MB内容结构清晰便于按型号和功能查阅。目前已有599人学习/下载适合需要借助SCPI对FSW系列频谱仪进行自动化测量与控制的工程师参考。1. 频谱仪远控 SCPI 指令为什么说这份手册是产测程序的官方字典做射频自动测试的人迟早要面对同一个问题面板按钮能完成的操作怎么让程序也做一遍。我写产测程序时就在频谱仪上栽过跟头——按键测杂散没问题换成程序却连中心频率都设不进去。后来翻 FSW 系列手册的远控章节才明白面板每一步背后都对应一条 SCPI 指令也就是频谱仪控制指令。这份资源覆盖 FSW8 到 FSW85 七个型号、固件 5.20 及以上含 B24 前置放大器、K19 噪声功率比、K54 EMI、K553 外部前端控制等选件指令是把面板翻译成代码的官方字典。下面按拆手册顺序讲先建立连接再跑通常用测量指令最后捡坑。2. 上手先搞清两件事SCPI 命令结构与仪器连接第一次翻这份手册的人容易直接跳到命令表抄代码结果往往是连最简单的指令都调不通。我建议先花半小时做两件事确认你手上的机器在手册覆盖范围内再把电脑和仪器之间的控制通道建起来。这两件事不解决后面所有指令都处在发了等于白发的状态。2.1 手册覆盖面七个型号、固件 5.20 与选件边界手册开头就写明了适用范围FSW8、FSW13、FSW26、FSW43、FSW50、FSW67、FSW85 七个型号固件版本 5.20 及以上。型号名里的数字基本对应频率档位FSW8 到 FSW85 覆盖了从常规射频到毫米波的测试场景但远控指令集本身是一致的差异主要在硬件前端和选件支持上。型号定位远控注意事项FSW8 / FSW13 / FSW26常规射频与微波测试最常用案例最多FSW43 / FSW50 / FSW67毫米波与高动态范围测试注意前端校准状态FSW85最高档频率覆盖高频段对混频器配置敏感固件 5.20 是一个硬边界。低于这个版本手册里描述的某些指令、参数范围和选件行为可能与实机不一致。所以拿到一台设备我一般先发两条最基础的指令确认身份*IDN? SYST:OPT?*IDN?返回厂商、型号、序列号、固件版本四段信息用来核对型号和固件是否落在手册覆盖范围内SYST:OPT?返回当前已激活的选件列表。这两条执行完就知道这台机器能做什么、不能做什么。如果SYST:OPT?的结果里没有 K54后面发 EMI 测量指令就注定要进错误队列没必要浪费时间排查。手册第 5 章还单独讲了 MultiView、测量通道和运行模式其中 sequencer 的概念对自动测试特别有用它可以把多个测量应用串成一个序列依次执行。远控时通过INSTrument:CREate创建多个测量通道再用 sequencer 按序跑一套代码就能把频谱、通道功率、OBW 串起来不必每个应用手动切换。这个能力在抄手册时容易漏掉但它恰恰是产测程序最想要的结构。提示产线里有多台同型号仪器时把*IDN?和SYST:OPT?的输出存成一份基线文本。固件升级后再执行一次diff 一下指令集变化立刻可见。2.2 建立控制会话VISA 地址与 *IDN? 握手FSW 系列支持 LAN、GPIB、USB 多种控制途径我习惯用 LAN。操作上就三步在仪器触屏的 Setup 菜单里找到 Network 配置记下 IP 地址在电脑上装好 VISA 运行时然后用下面的脚本验证通道。import pyvisa rm pyvisa.ResourceManager() inst rm.open_resource(TCPIP0::192.168.1.100::INSTR) inst.timeout 10000 inst.read_termination \n print(inst.query(*IDN?))这里TCPIP0::IP::INSTR是 VXI-11 通道的标准地址形式timeout单位是毫秒我习惯给到 10 秒以上因为频谱扫描本身就可能超过 5 秒read_termination指定读到换行符结束避免返回值尾部带残留字符导致解析错位。如果你的环境里 VISA 扫描不到仪器常见原因是电脑和仪器不在同一网段先 ping 一下 IP。不同控制途径的地址写法如下表GPIB 在老产线上仍然大量存在途径地址示例适用场景LAN VXI-11TCPIP0::192.168.1.100::INSTR首选速度与稳定性均衡LAN SocketTCPIP0::192.168.1.100::5025::SOCKET自定义协议栈时GPIBGPIB0::20::INSTR老旧产线地址由仪器拨码决定USBUSB0::厂商ID::产品ID::INSTR单机调试无需网络手册第 4 章 Getting Started 里有完整的 LAN 配置、外设连接步骤。我的经验是固件版本越低的老机器越容易出现 LAN 配置未生效或 VXI-11 服务没启动的情况碰上连接失败先回面板把网络服务重启一次。另外一台仪器同一时间只接受一个远控会话调试时开着 RS 官方工具又跑自己的脚本会把连接挤掉这是新手最容易忽略的连接不稳定根源。2.3 看懂命令结构冒号分层、问号与后缀SCPI 的完整名称是 Standard Commands for Programmable Instruments可编程仪器标准命令。命令看起来一大串实际规则很规整按冒号分层左侧是路径右侧是参数。比如SENSE:FREQuency:CENTer 2.45GHz意思是在测量配置 → 频率 → 中心频率这个路径上写入 2.45GHz。要素示例说明根节点SENSE测量相关配置子节点FREQuency频率组参数2.45GHz带单位数值单位省略时按当前单位解释查询标记?把写入变成读取如 CENTer?通道后缀[1]多个 marker、trace、窗口的编号手册的 command reference 每条命令都会给出全称和缩写比如 FREQuency 与 FREQ 等价。发送时要么用全称要么用标准短形不要自己发明中间形态。另外一条经验写命令不要带问号查询命令大多数不带参数混用会得到-103 Invalid suffix之类的错误。除了测量指令还有一组以*开头的通用指令*RST恢复出厂预设、*CLS清空状态和错误队列、*OPC操作完成标志、*WAI等待操作完成。这组指令不区分仪器厂商是 SCPI 标准的一部分也是后面做同步的基础。我每次写远控程序开头固定是*RST加*CLS先把仪器拉回已知状态再开始配置。3. 跑通第一组频谱测量配置、触发与读数的三段式套路频谱仪的远控流程不管换成哪个测量应用骨架都是三段写入配置、触发扫描、读取结果。把这三段练熟剩下的都是在往配置段里加参数。这一章用最常用的 Spectrum 应用讲清楚每个阶段的关键指令和背后的同步逻辑。3.1 频率、span 与 RBW三个每天都在写的配置指令测量一个 2.45GHz 附近的信号最基本的配置就是中心频率、扫宽和分辨率带宽。三条指令如下FREQ:CENT 2.45GHz FREQ:SPAN 100MHz BAND 1MHzFREQ:CENT设置中心频率FREQ:SPAN设置扫宽BAND设置分辨率带宽 RBW。参数带单位 GHz、MHz 是明确写法不带单位时仪器按当前频率单位解释默认是 Hz。一个经典翻车现场就是把FREQ:CENT 2.45发进去仪器老老实实把中心频率设在 2.45Hz扫描结果当然是一片噪声。写代码时我习惯把所有频率参数都显式带单位杜绝这类歧义。RBW 的选择直接影响测量速度和噪底。RBW 越大扫描越快但噪底抬高、频率分辨率变差RBW 越小噪底越低能分辨密集谱线但扫描时间成倍拉长。产测里如果不是专门测噪底我一般先用 1MHz 跑全扫定位到峰值之后再用小 RBW 精测。3.2 触发单次扫描并同步INIT 与 *OPC 的配合仪器默认处于连续扫描状态面板上看到的波形一直在刷新。远控如果直接发TRAC:DATA?读迹线可能读到的是上一次扫描的残留数据也可能读到扫描到一半的中间状态。正确姿势是把仪器切到单次扫描再显式触发INIT:CONT OFF *CLS INIT *OPCINIT:CONT OFF关闭连续扫描*CLS清空状态寄存器INIT触发一次扫描*OPC会在这次扫描完全结束后置位。程序里用*OPC?查询返回 1 就代表数据已经就绪这时再读迹线就是本次扫描的完整结果。这是整个远控里最重要的一组同步组合后面所有测量应用都依赖它。另一种做法是轮询状态字节的 Operation Complete 位bit 4效果相同但代码量更大。*OPC?的好处是 VISA 层的 query 天然阻塞程序写起来最直白。注意*OPC?的超时时间要大于单次扫描耗时扫描时间可以从SWE:TIME?查出来给到它的两到三倍比较稳。3.3 读迹线与读 marker两种取数方式的取舍配置和触发都对了接下来就是取数。常用的是迹线查询和 marker 查询两条路TRAC:DATA? TRACE1 CALC:MARK1:MAX CALC:MARK1:X? CALC:MARK1:Y?TRAC:DATA? TRACE1返回当前窗口里 trace 1 的全部数据点是一长串逗号分隔的浮点数数量等于SWE:POIN设定的扫描点数。CALC:MARK1:MAX把 marker 1 跳到当前迹线最大值位置X?和Y?分别问出这个最大值的频率和电平。取数方式返回内容数据量典型场景TRAC:DATA?整条迹线数百到数万点谱形分析、存储回放CALC:MARK:X?/Y?单个坐标点几个浮点数峰值查找、杂散定位两条路的取舍很直接只需要峰值频率和电平用 marker需要完整频谱形状、后端要画曲线或做积分用 trace。要注意TRAC:DATA?返回点数会受SWE:POIN影响解析时先取SWE:POIN?校验长度避免读到一半发现数组越界。3.4 一键测量应用通道功率与 OBW 的远控流程手册第 6 章把通道功率、载噪比、OBW、NPR、SEM 等测量各开一节每一节都遵循概念 → 配置 → 执行步骤 → 远控指令的结构。通道功率手册 6.2在产测里出现频率极高远控套路是在窗口层切换应用然后直接发起结果查询INST:SEL CHP READ:CHP:CHP?INST:SEL把当前窗口切到 Channel Power 应用READ:CHP:CHP?触发一次测量并返回通道功率结果。这里有一个必须强调的坑不同固件版本里READ、MEASure、CALCulate 三组查询指令的返回字段格式会有差异发之前务必翻手册对应测量的 command reference 核对关键字。OBW 的流程写法一模一样把应用名和查询节点换成READ:OBW:OBW?即可。我一般会在脚本里把这类查询封装成带应用切换的函数切换前用INST:LIST?确认应用名拼写避免Instrument not found这类错误。4. 选件与专项测量K19、K54、B90G 这些指令能干什么基础频谱测量的指令只是手册的一小部分。后半本用大量篇幅描述了选件的功能与对应指令这些章节决定了你花预算买的选件最终能不能在自动测试代码里跑起来。这一章把选件清单拆一遍再挑两个代表性专项测量说明远控套路。4.1 从选件清单看远控边界手册明确列出了十余个选件每个选件在远控层面都有独立的指令域和前置条件选件功能远控前置条件B4 OCXO高稳参考时钟频率校准相关指令可用B10外部发生器控制连接信号源并配置联动B13高通滤波器信号路径切换指令B21外部混频器硬件连接需配本振与损耗表B24前置放大器电平读数路径变化B25电子衰减器衰减配置指令域B90G90GHz 频率扩展高频前端与校准数据K19噪声功率比 NPRLicense 激活K54EMI 测量License 激活检波器指令K544频率响应校正修正因子文件加载K553外部前端控制前端硬件连接K980HUMS健康监测状态查询读这张表时要注意一个容易忽略的点License 只是前提之一硬件和固件同样卡人。K19、K54 这类纯软件选件License 激活后指令立即可用B21、B90G、K553 这类涉及硬件的选件指令能否执行还取决于混频器、外部前端是否连接并被仪器识别。远控代码里我习惯在每次测量前先查SYST:OPT?拿不到预期选件就快速失败而不是等测量结果出来才发现路径不对。4.2 NPR 与 EMI专项测量的远控套路NPR手册 6.5用来评估非线性和噪声性能配置属性比基础频谱测量多一环要设置噪声发生器输出、陷波频率和测量带宽手册里单独有 Generator setup 和频率耦合章节。指令骨架是窗口切换加配置加查询INST:SEL NPR SOUR:... # 发生器配置手册 6.5.5 有完整节点表 CALC:NPR:...? # 结果查询以 command reference 为准有一个容易漏掉的细节NPR 的测量结果依赖发生器和分析仪的频率耦合远控时如果只配了分析仪侧忘了发生器侧的联动设置测出来的噪声功率比会直接失真。抄手册时要把 Generator setup 和 Generator frequency coupling 两节一起看缺一节都不完整。EMIK54的远控重点是检波器。EMI 测量通常同时跑峰值、准峰值、平均值三种检波器限值线定义可以在面板编辑也可以加载文件。远控代码里先选检波器再逐频段扫描INST:SEL EMI DET:QUAS ONSEM手册 6.6则把重心放在掩膜定义上远控时通常把限值掩膜做成文件指令里传路径即可。这类专项测量普遍扫描时间长EMI 的准峰值检波在低频段尤其慢。*OPC?超时设 30 秒都不夸张我见过同事把超时留在默认的 2 秒脚本跑一次失败一次最后还以为是指令写错了实际是没给够时间。4.3 外部前端与频率扩展B90G / K553 的远控要点B90G 把频率上限推到 90GHz远控层面比基础测量多出两块内容外部混频器的本振设置和转换损耗表管理。混频器在不同频段的损耗不一样仪器需要加载对应的转换损耗数据远控程序里这部分通常退化成加载预定义文件 查询校准状态两步。K553 外部前端控制则是一套独立的前端状态机适合把前端布在离仪器很远的位置做分布式测试。我踩过最深的坑是这类指令对执行顺序敏感。外部混频器要先配置本振、加载损耗表、确认前端就绪才能执行扫描顺序反了错误队列里会出现一串配置不完整相关的错误。所以涉及 B90G、K553 的代码我会把初始化序列写成一个独立函数每次测量前完整跑一遍保证前端状态可预期。手册对应章节里对状态查询指令有明确描述初始化函数最后一步就是查询前端状态寄存器的 Ready 位确认就绪再往下走。这类带硬件的选件代码里宁可多一次状态确认也不要赌指令顺序恰好正确。5. SCPI 远控常见问题五个高频踩坑点与排查顺序这一章的内容来自几条产测线的血泪记录按出现频率排序每一条都按现象 → 原因 → 解决展开程序报错时可以直接对照。5.1 *OPC? 查询超时仪器到底忙不忙现象*OPC?发出去后脚本一直卡住直到 VISA 报 timeout 异常程序崩溃。原因两种。一是仪器还处于连续扫描模式INIT:CONT是 ON*OPC永远等不到某一次扫描完成的时刻二是单次扫描时间本身超过了 VISA 的超时设置比如小 RBW 扫宽扫得很慢。解决先发INIT:CONT OFF切单次扫描再触发INIT同时把timeout设到扫描耗时的两到三倍。扫描耗时可以用SWE:TIME?查到动态设置超时比固定值靠谱。5.2 远端读数与面板差几个 dB现象脚本读到的 marker 电平与面板上肉眼看到的数值差 1 到 3 dB长期稳定性测试里尤其明显。原因单位不一致、参考电平偏移、前置放大器和电子衰减器的状态没对上。仪器的电平单位可以是 dBm、dBmV、dBuV 等代码里默认单位与面板当前显示单位不一致时读数自然差一段B24 前置放大器是否开启、B25 电子衰减器路径不同也会改变读数。解决配置阶段显式写入UNIT:POWer DBM统一单位查询REF:LEV?、PAMP?确认参考电平和前置放大器状态与你的测量意图一致。换了一台仪器就跑偏时优先检查这两项。5.3 指令发下去没反应先查错误队列现象指令不报错、不生效脚本继续往后跑最后结果全错错误还不容易定位到具体指令。原因命令拼写错误、参数超范围、当前应用不支持该指令这些错误不会打断程序而是被送进错误队列。程序没有读队列的习惯错误就一直积压着。解决每次写入后循环读SYST:ERR?直到返回0, No error把非零错误打印出来。这样哪条指令出错当场就知道。注意发*CLS或*RST会清空队列排查时不要顺手把它们加在错误查询之前。5.4 选件功能调不出来license 与固件的坑现象发 K54、K19 相关指令仪器回复选件未安装或无此命令但面板菜单里明明能看到对应功能。原因固件版本低于手册要求5.20 及以上或 License 未激活、试用过期或硬件选件没连接。面板能看到菜单不代表指令域已加载指令层面对选件状态的判断比 UI 严格得多。解决*IDN?看固件版本SYST:OPT?看 License 列表两对数据都满足再看硬件连接状态。手册适用范围一开头就写明固件 5.20 及以后老固件先升级再谈指令。5.5 trace 数据解析出错点数与格式对不上现象TRAC:DATA? TRACE1返回的字符串拆完长度不对或者数字里混着逗号导致解析崩。原因SWE:POIN被改动导致点数变化程序按固定长度解析trace 名写错读到空数据小数分隔符受仪器区域设置影响变成逗号。解决查询前先发SWE:POIN?拿实际点数做长度校验trace 名严格按照 TRACE1、TRACE2 的格式用FORMat:DEXPort:SEPArator POINt把小数点固定为句点解析逻辑就稳了。6. 固化一个远控骨架PyVISA 模板与开机自检序列每次接新项目我都是同一套起点一个带错误自检的最小模板加上一段开机自检序列。模板负责不让错误静默通过自检序列负责在开测前把所有前置条件验证一遍。import pyvisa class FswCtrl: def __init__(self, addrTCPIP0::192.168.1.100::INSTR, timeout10000): self.inst pyvisa.ResourceManager().open_resource(addr) self.inst.timeout timeout self.inst.read_termination \n def check_errors(self): while True: code, msg self.inst.query(SYST:ERR?).split(,, 1) if code.strip() 0: break print(fERR {code.strip()}: {msg.strip()}) def write(self, cmd): self.inst.write(cmd) self.check_errors()check_errors每次写入后把错误队列清空并打印保证指令没反应这类问题在第一步就暴露。timeout默认 10 秒针对长扫描的应用再单独调大。开机自检序列我固定在测试会话最前面fsw FswCtrl() print(fsw.inst.query(*IDN?)) fsw.write(*RST) fsw.write(INIT:CONT OFF) print(fsw.inst.query(SYST:OPT?))顺序是有讲究的*IDN?先确认型号固件*RST把仪器拉回已知状态INIT:CONT OFF防止后面*OPC?卡住SYST:OPT?验证选件齐不齐。四行跑完这台仪器能不能支撑今天的测试就清楚了。有校准源的话再叠一步用已知电平信号测一次 marker 峰值偏差超过 0.5dB 就停下来查路径配置。这套骨架最早来自一次反复翻车的产测调试——那台仪器的错误队列里积了二十多条历史错误我排查了整整一个下午才明白是队列污染。从那以后我每次换仪器、换产线第一件事就是强制走一遍这套自检序列把*IDN?和SYST:OPT?的输出存进日志。早年间要是有人给我这份手册加这段模板至少能省下两个大夜。希望帮到你。本文还有配套的精品资源点击获取