一、前言射频研发、滤波器调试、接收机本振测试、教学实验经常需要一台宽频便携信号源。商用台式信号源动辄几千上万体积大不便外场携带而HT008BHTOOL便携式射频信号源采用 GD32F303 主控覆盖 50MHz~6400MHz 微波正弦信号内置 CH340G USB 转串口支持标准 SCPI 指令程控可 USB / 锂电池双供电兼顾低成本、便携、可二次开发非常适合小型实验室与自动化 ATE 测试场景。本文完整拆解硬件参数、本地按键操作、串口通信协议、全套 SCPI 指令说明并附上可直接运行的 Python 串口控制代码解决新手驱动安装、指令报错、扫频参数配置踩坑问题。二、HT008B 硬件核心规格与特性2.1 硬件架构主控GD32F303 单片机显示屏0.96 寸 OLED90*160 分辨率通信内置 CH340G USB 转串口电脑识别为虚拟 COM 口需安装 CH340 驱动供电USB 5V 供电 / 5V 1A 锂电池便携供电2.2 射频关键指标输出频率范围50MHz ~ 6400MHz 连续正弦波频率分辨率700MHz 以下 1KHz 步进相位噪声超低相噪典型值 -106dBc3GHz偏移 100KHz双通道输出通道一主输出可调幅度11 档功率调节75MHz~6000MHz 区间输出-25dBm ~ -15dBm误差说明50~75MHz、6000~6400MHz 满功率 - 15dBm 时存在 1~3dBm 幅值偏差高精度测试建议避开该频段端点工作模式点频固定输出 单 / 循环扫频双模式拓展能力完整 SCPI 程控协议支持上位机自动化控制、二次开发集成测试系统三、本地按键操作说明无电脑离线使用3.1 点频模式操作按下 OK 键进入点频界面左右方向键移动光标切换可调参数上下键增减当前光标对应频率OK 键退出点频界面。3.2 扫频模式操作踩坑重点扫频必须完整配置 4 项参数否则无法启动起始频率、终止频率、扫频步长、单步间隔时间 操作逻辑左右键切换光标上下键修改起始 / 终止频率、扫频开关、步长、时间强制约束起始频率必须 终止频率步长与间隔时间不能为空参数全部设置完成后打开扫频使能开关才会执行扫描若起始大于终止、步长 / 时间缺失设备直接忽略扫频指令无输出。四、USB 串口通信基础配置4.1 串口硬件参数固定不可修改波特率115200数据位8停止位1校验位None无校验传输格式纯 ASCII 字符串每条指令结尾必须携带\r\n换行符4.2 CH340 驱动安装步骤Windows下载 CH340 驱动包设备管理器中更新未知 USB 设备驱动Linux内核自带 ch34x 驱动插入 USB 自动生成/dev/ttyUSBxMac安装 CH340 官方驱动重启后识别串口校验插入设备后串口助手能识别 COM 端口发送*IDN?\r\n有返回即通信正常。4.3 SCPI 模式激活硬性规则高频报错根源上位机第一条发送指令必须是*IDN?\r\n设备收到后才正式进入 SCPI 程控模式限制条件设备本次开机 USB 连接后不能先用自定义私有协议连接并异常断开否则 SCPI 指令失效需重新插拔 USB 重启设备查询指令统一以?结尾设备应答同样带\r\n。五、SCPI 指令语法标准通用规范HT008B 遵循 SCPI std V1999.0 标准语法规则统一层级分隔冒号:划分指令层级例GEN:STAT缩写规则仅大写字母有效小写可省略FREQuencyFREQ可选层级[]包裹内容可省略AMPL[:VALU]AMPL:VALUAMPL多选参数{A|B}代表仅能选择其中一个参数分隔符指令与参数空格隔开多参数逗号,分隔结束符所有下发指令、设备回复末尾强制\r\n六、全套 SCPI 功能指令详解6.1 强制初始化指令必发第一条scpi*IDN?\r\n功能激活 SCPI 通信模式设备返回设备型号标识字符串无返回即通信异常。6.2 输出开关控制scpi# 设置信号输出开启/关闭 GEN:STAT {ON|OFF}\r\n # 查询当前输出状态 GEN:STAT?\r\n # 返回 ON / OFF6.3 输出幅度设置scpi# 设置输出幅值ampl单位dBm范围-25~-15 GEN:AMPL ampl\r\n # 查询当前通道输出幅度 GEN:AMPL?\r\n6.4 点频模式固定单频输出scpi# 设置点频输出频率单位MHz GEN:POIN freq\r\n # 查询当前点频频率 GEN:POIN?\r\n6.5 扫频基础参数配置scpi# 设置扫频总跨度MHz FREQ:SPAN freq\r\n FREQ:SPAN?\r\n # 扫频起始频率MHz FREQ:STAR freq\r\n FREQ:STAR?\r\n # 扫频截止频率MHz FREQ:STOP freq\r\n FREQ:STOP?\r\n # 单步停留时间整数ms FREQ:TIME time\r\n FREQ:TIME?\r\n6.6 单次扫频 / 循环扫频一键指令单次扫频执行一轮自动停止scpiGEN:SING start,stop,step,time\r\n # 参数顺序起始频率(MHz),终止频率(MHz),步长(MHz),单步时间(ms) GEN:SING?\r\n # 查询当前单次扫频参数循环扫频持续往复扫描scpiGEN:CYCL start,stop,step,time\r\n GEN:CYCL?\r\n # 查询循环扫频配置七、Python 完整程控实操代码pySerial7.1 环境依赖安装bashpip install pyserial7.2 通用控制类封装所有 SCPI 指令python运行import serial import time class HT008BSource: def __init__(self, port, baud115200, timeout1): self.ser serial.Serial( portport, baudratebaud, bytesize8, stopbits1, parityserial.PARITY_NONE, timeouttimeout ) # 第一步必须发送*IDN?激活SCPI self.send_cmd(*IDN?) print(设备识别返回, self.read_resp()) def send_cmd(self, cmd): 发送指令自动补全\r\n full_cmd cmd.strip() \r\n self.ser.write(full_cmd.encode(ascii)) time.sleep(0.05) def read_resp(self): 读取设备应答 resp self.ser.readline().decode(ascii).strip() return resp # 输出开关 def set_output(self, en: bool): state ON if en else OFF self.send_cmd(fGEN:STAT {state}) return self.read_resp() def get_output_state(self): self.send_cmd(GEN:STAT?) return self.read_resp() # 幅度控制 def set_ampl(self, ampl: float): self.send_cmd(fGEN:AMPL {ampl}) def get_ampl(self): self.send_cmd(GEN:AMPL?) return self.read_resp() # 点频设置 def set_point_freq(self, freq_mhz: float): self.send_cmd(fGEN:POIN {freq_mhz}) def get_point_freq(self): self.send_cmd(GEN:POIN?) return self.read_resp() # 单次扫频 def single_sweep(self, start, stop, step, t_ms): self.send_cmd(fGEN:SING {start},{stop},{step},{t_ms}) # 循环扫频 def cycle_sweep(self, start, stop, step, t_ms): self.send_cmd(fGEN:CYCL {start},{stop},{step},{t_ms}) def close(self): self.set_output(False) self.ser.close() if __name__ __main__: # 修改为你的实际COM口Windows COM3 / Linux /dev/ttyUSB0 src HT008BSource(portCOM3) # 示例1输出1000MHz点频幅度-20dBm打开输出 src.set_point_freq(1000.0) src.set_ampl(-20) src.set_output(True) print(当前点频, src.get_point_freq()) print(当前幅度, src.get_ampl()) time.sleep(3) # 示例2单次扫频 100MHz~1000MHz步长10MHz每步停留200ms src.single_sweep(100, 1000, 10, 200) time.sleep(10) # 关闭输出并释放串口 src.close()八、常见问题与排错指南问题 1发送所有指令无返回检查 CH340 驱动是否安装设备管理器是否识别 COM 口串口参数严格 115200 8N1不能修改第一条指令必须*IDN?\r\n未发送则 SCPI 不生效重新插拔 USB 重启信号源清除异常连接状态。问题 2扫频执行无信号输出起始频率 ≥ 终止频率参数颠倒未设置步长或单步时间未打开输出GEN:STAT ON频段落在 50~75MHz / 6000~6400MHz功率误差过大误以为无输出。问题 3幅度设置不生效通道一只支持 75MHz~6000MHz 完整功率调节两端频段幅值存在固定偏差属于硬件固有特性。问题 4Python 读取返回为空指令末尾缺少\r\n串口 timeout 超时太短发送指令后未加短暂延时。九、应用场景总结射频教学实验低成本 6.4G 信号源替代高价台式设备滤波器 / 天线调试点频定点测试、扫频快速测带宽接收机本振模拟低相噪信号做射频本振源自动化 ATE 测试Python/LabVIEW 集成 SCPI批量多频段自动测试外场便携测试锂电池供电无市电场景使用。#射频信号源 #SCPI 指令 #CH340 串口 #GD32 #自动化测试 #微波源 #Python 程控