1. 功能库不是把命令抄一遍:可编程电源串口控制的复用边界
把可编程电源接进自动化测试,很多人第一步是打开串口敲一条 SCPI 命令看回读,这一步不难。难的是第二天换一条测试线、换一个工位,发现昨天那串命令散落在脚本各处,通道选错一次,整批数据就串了。我后来越来越倾向于先把串口控制收成一个功能库:连接、选通道、设值、回读、退出远程都封在函数里,测试脚本只负责循环和记录。这篇就围绕 IT6332A 的可编程电源串口控制,讲清楚一个能直接复用的 SCPI 功能库怎么从零搭起来,命令怎么排、参数怎么传、哪些坑必须提前堵。适合刚把电源接上串口、准备写老化或巡检脚本的人,也适合手里已经有一堆一次性脚本、想收口成可复用模块的熟手。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 命令底座:IT6332A 的通道选择、设值与回读指令
我见过不少脚本把设值和回读写成一条直线,跑单通道没问题,切到双通道就开始出现“通道 2 读到通道 1 电压”的怪事。根子不在电源,而在命令顺序:这台电源的设值和回读都作用在“当前选中通道”上,你不告诉它选哪个通道,它就沿用上一次的上下文。所以功能库的第一层不是封装函数,而是把命令顺序固定下来。下面这些命令和调用方式,是后面所有封装的地基。
2.1 先选通道再设值:INST:NSEL 1/2
INST:NSEL 是通道选择命令,后面跟通道号。它的作用是切换后续设值、回读命令的作用对象,本身不产生电压电流。材料里的用法很直接:要操作通道 1 就先发 INST:NSEL 1,要操作通道 2 就先发 INST:NSEL 2。这条命令不带问号,属于设置类命令,发完不需要等返回;如果你只发命令不读返回,串口缓冲区里也不会堆东西,但最好养成“发一条、确认一条”的习惯,尤其是在调试阶段。
python复制# 每次操作前先选通道,不要让电源沿用上一次的上下文
scpi_cmd('INST:NSEL 1')
# 后续设值或回读作用于通道 1
scpi_cmd('INST:NSEL 2')
# 后续设值或回读作用于通道 2
这段代码假设已经有一个最小的命令收发函数 scpi_cmd,它的实现放到下一章拆。这里先看命令顺序:选通道是“设值”和“回读”的前置动作,不是可选项。参数只有一个,就是通道号,材料里出现的是 1 和 2;具体设备支持几路,以面板和手册为准,功能库不要把通道号写死成只有两路。失败现象也很典型:不重选通道直接回读,读到的可能是上一次选中的通道,脚本不报错,数据却已经串了。
2.2 设值与回读:MEAS:VOLT? 与 MEAS:CURR?
回读用的是带问号的查询命令:MEAS:VOLT? 读当前通道电压,MEAS:CURR? 读当前通道电流。问号很关键,它表示“我要一个返回值”,不带问号就是设置类命令,两者不能混。材料里的轮询代码就是每次先选通道,再依次发这两条查询,把返回值分别存进 v1、i1、v2、i2。设值侧材料给的是 set_channel(1, voltage=5.0, current=2.0) 这样的调用,具体设值命令被收在函数内部,不让调用方直接拼命令,这正是功能库要解决的问题。
python复制scpi_cmd('INST:NSEL 1')
v1 = scpi_cmd('MEAS:VOLT?')
i1 = scpi_cmd('MEAS:CURR?')
scpi_cmd('INST:NSEL 2')
v2 = scpi_cmd('MEAS:VOLT?')
i2 = scpi_cmd('MEAS:CURR?')
这段代码的顺序说明一件事:回读前必须重选通道,选完立刻读,中间不要插别的通道操作。参数方面,MEAS:VOLT? 和 MEAS:CURR? 都不带参数,返回的是一段文本;常见做法是收到后去掉首尾空白,再转成浮点数,方便后面做阈值判断和写 CSV。材料里没有展开转换细节,但“回读值做阈值判断”这个用法决定了你不能把返回值当字符串直接比较大小。还有一点,回读命令本身不会改变输出状态,它只读当前值;如果你发现回读一直是 0,先查输出有没有开、通道有没有选对,再查负载。
| 命令 | 类型 | 作用对象 | 返回 | 使用注意 |
|---|---|---|---|---|
INST:NSEL 1 |
设置 | 通道选择 | 无 | 后续命令作用于通道 1 |
INST:NSEL 2 |
设置 | 通道选择 | 无 | 后续命令作用于通道 2 |
MEAS:VOLT? |
查询 | 当前通道 | 电压文本 | 读前先选通道 |
MEAS:CURR? |
查询 | 当前通道 | 电流文本 | 读前先选通道 |
2.3 用 *IDN? 做链路握手
*IDN? 是设备标识查询,材料里反复强调“脚本里永远保留 *IDN? 验证这一步,每次上电先确认链路状态,再执行后续动作”。这条命令不参与业务,但它决定了你后面所有命令有没有意义。串口线松了、端口配错、转换器没供电,现象都是命令发出去没返回,脚本超时;如果上来就设值,你会以为是电源坏了,实际只是链路没通。所以功能库的第一个对外方法应该是握手,而不是设值。
python复制ident = scpi_cmd('*IDN?')
if not ident:
raise RuntimeError('链路未就绪:先检查串口线、端口配置和转换器供电')
这段代码的逻辑是:发 *IDN?,拿到返回文本后判断是否为空。为空或抛异常时,先查物理链路,不要先怀疑电源。参数上没有额外输入,*IDN? 不带参数;返回值是一段设备标识文本,功能库可以只判断“有没有返回”,不必解析里面的字段。这里有个边界:有些转换器在刚上电时会吞掉第一条命令,所以握手失败可以重试一两次,但不要在读取循环里死等,超时后把异常抛给上层,让测试脚本决定是重试还是停线。
3. 把 SCPI 命令收进功能库:scpi_cmd 与 set_channel 的封装
命令顺序固定之后,下一步是把“发一条、收一条”的动作收进函数。很多人把串口读写直接写在测试循环里,一条命令后面跟三行解析,循环一长,代码就没法读。我的做法是功能库只暴露少数几个入口:连接、scpi_cmd、set_channel、回读、退出远程;循环次数、采样间隔、文件路径、阈值判断全部留在测试脚本。这样换一个测试用例,功能库不用动;换一台电源,只改功能库内部。
3.1 scpi_cmd:一问一答的串口读写骨架
串口是半双工的,发一条命令之后要等返回,不能一边发一边读。材料里没有给出 Python 侧的完整实现,但接口已经很清楚:scpi_cmd 收一条命令字符串,返回一段文本。常见做法是用 pyserial 打开串口,写入时补一个换行符,读取时按行读,再把结果去空白。下面是一个最小骨架,参数只保留命令和超时,串口对象由连接函数持有。
python复制import serial
ser = None
def open_port(port, baudrate):
global ser
ser = serial.Serial(port=port, baudrate=baudrate, timeout=None)
def scpi_cmd(cmd, timeout=None):
"""发送一条 SCPI 命令,返回去掉首尾空白后的文本"""
if ser is None or not ser.is_open:
raise RuntimeError('串口未打开')
ser.timeout = timeout
ser.write((cmd + '\n').encode('ascii'))
raw = ser.readline()
return raw.decode('ascii', errors='ignore').strip()
这段代码的逻辑说明:open_port 只负责打开串口,端口号和波特率由调用方传入,功能库不写死具体值,因为不同工位接线不同;scpi_cmd 先检查串口状态,再写命令、读一行、解码去空白。参数说明:cmd 是完整命令字符串,调用时不要把问号和参数漏掉;timeout 控制单条命令等待多久,传 None 表示用串口打开时的默认值,实际调试时按链路稳定度给一个有限值,避免异常时界面或脚本无限等待。readline 依赖设备以换行结束返回,如果某台设备返回不带换行,就要改成按固定字节读或按返回长度读,这一点在接新设备时要先验证。
3.2 set_channel:把“选通道 + 设值”收进一个入口
set_channel 的价值不是少写一行命令,而是让调用方没有机会漏掉通道选择。材料里的调用形式是 set_channel(1, voltage=5.0, current=2.0) 和 set_channel(2, voltage=12.0, current=1.0),电压单位是 V,电流单位是 A。函数内部先发 INST:NSEL,再下发电压电流设定;具体设定命令按设备手册来,功能库只保留参数入口,不让命令散落到测试脚本里。
python复制def set_channel(ch, voltage, current):
"""选择通道并下发电压/电流设定,设定命令按设备手册收在库内"""
scpi_cmd(f'INST:NSEL {ch}')
# 电压、电流设定命令按设备手册下发,这里只保留统一入口
# 换设备时只改这个函数,测试脚本不动
这段代码的逻辑说明:先选通道,保证后面的设定作用于正确对象;电压电流作为参数传入,调用方只关心“给哪个通道、设多少”。参数说明:ch 是通道号,材料里是 1 和 2;voltage 和 current 是数值,单位分别是 V 和 A,调用时不要传字符串,避免拼接出多余空格。这里没有把设定命令写死,是因为材料只给了调用形式,没有给具体设定指令;功能库的正确做法是把设备差异收在这一处,而不是在测试脚本里到处拼命令。失败现象:如果 set_channel 内部漏了 INST:NSEL,双通道场景下第二个通道的设定会落到第一个通道上,回读看起来“设了但不对”,排查时先看这一步。
3.3 功能库的边界:连接、命令、业务分层
功能库该收什么、不该收什么,决定了它后面好不好维护。我的划分是:连接管理、scpi_cmd、set_channel、回读函数、退出远程,放在功能库里;循环次数、采样间隔、CSV 文件路径、阈值判断、报警动作,留在测试脚本里。这样功能库不依赖具体测试业务,测试脚本也不碰串口细节。一个常见的文件划分是这样:
text复制power_lib.py # open_port、scpi_cmd、set_channel、measure、close
burn_in_test.py # 循环、记录、阈值判断、文件写入
这个划分的好处是:换测试工位只改 burn_in_test.py 里的端口和路径;换电源型号只改 power_lib.py 里的命令拼装。不要把 CSV 表头、采样间隔塞进功能库,否则下一个测试用例还得改库。还有一个边界要注意:scpi_cmd 不要做成全局裸函数到处调用,连接对象和命令收发最好收在一个类或一个模块里,至少保证“打开”和“关闭”成对出现。材料里提到的“把串口控制封装成一个类,接进已有的测试框架”,说的就是这层边界。
4. 第一个可跑脚本:双通道轮询、CSV 落盘与安全收尾
功能库搭好之后,先别急着上8小时老化。我的习惯是先写一个最小可跑脚本:两个通道各设一组电压电流,跑一个短循环,把回读值带时间戳写进 CSV,最后按固定顺序收尾。这个脚本能同时验证三件事:通道有没有串、回读值是不是数值、收尾有没有把输出关掉。材料里的示例是跑 10 次、每次间隔 0.5 秒,实际老化按小时算次数,不是直接把 10 改成一个大数字就完事。
4.1 两通道初始化:先设值再进循环
初始化阶段只做两件事:把通道 1 设成 5V/2A,把通道 2 设成 12V/1A。材料里的调用顺序是先通道 1 再通道 2,这个顺序本身不强制,因为 set_channel 内部会重选通道;但设完之后建议各回读一次,确认设定值落在预期通道上,再进循环。很多人省略这一步,直接跑循环,结果数据串了还以为是电源采样慢。
python复制set_channel(1, voltage=5.0, current=2.0)
set_channel(2, voltage=12.0, current=1.0)
这段代码的参数说明:通道 1 的电压 5.0V、电流 2.0A;通道 2 的电压 12.0V、电流 1.0A。数值来自材料里的老化场景,不是随便写的示例。调用时注意单位,voltage 传伏、current 传安,不要混成毫伏或毫安。设值完成后,如果功能库提供了回读函数,先各读一次电压电流,确认通道 1 读到 5V 附近、通道 2 读到 12V 附近,再开始记录;这一步花不了几秒,但能提前发现通道串接。
4.2 轮询:每次回读前重选通道
轮询阶段是整段脚本最容易翻车的地方。材料里的写法是每次循环先 time.sleep(0.5),然后依次选通道 1、读电压电流,再选通道 2、读电压电流,最后把时间戳和四个值追加到 records。这里的关键不是 sleep 多长,而是“每次回读前重选通道”这个动作不能省。省一次,通道 2 就可能读到通道 1 的值,而且脚本不会报错。
python复制for i in range(10): # 示例跑 10 次,实际按小时算次数
time.sleep(0.5)
scpi_cmd('INST:NSEL 1')
v1 = scpi_cmd('MEAS:VOLT?')
i1 = scpi_cmd('MEAS:CURR?')
scpi_cmd('INST:NSEL 2')
v2 = scpi_cmd('MEAS:VOLT?')
i2 = scpi_cmd('MEAS:CURR?')
records.append([time.time(), v1, i1, v2, i2])
这段代码的逻辑说明:循环体先延时,再按“选通道 1 → 读两值 → 选通道 2 → 读两值”的顺序走,最后把一条记录追加到列表。参数说明:range(10) 只是示例次数,材料明确说“实际按小时算次数”,做 8 小时老化时应该按总时长和采样间隔算出循环次数,不要直接把 10 改成 8000 就上线;time.sleep(0.5) 是示例间隔,实际间隔按测试要求定,间隔太短会把串口和记录文件压得很紧。v1、i1、v2、i2 是四条回读的原始返回值,进 CSV 前建议转成浮点或至少去空白,避免后面画曲线时还要清洗。
4.3 落盘与收尾:CSV、OUTP OFF、SYST:LOC
记录写文件看起来简单,但表头和收尾顺序最容易漏。材料里的写法是用 csv.writer 先写表头,再把 records 一次性写入 burn_in.csv,打开文件时带 newline=''。写完文件后先发 OUTP OFF 关输出,再发 SYST:LOC 让电源退出远程模式,交还面板控制权。这两条收尾命令的顺序不能反,先退远程再关输出,中间可能有人按面板,输出状态就不可控了。
python复制with open('burn_in.csv', 'w', newline='') as f:
writer = csv.writer(f)
writer.writerow(['time', 'v1', 'i1', 'v2', 'i2'])
writer.writerows(records)
scpi_cmd('OUTP OFF')
scpi_cmd('SYST:LOC') # 让电源退出远程模式,交还面板控制权
这段代码的逻辑说明:open 带 newline='' 是为了避免 CSV 在部分平台上出现多余空行;表头字段和时间戳顺序一致,后面看趋势不用再猜列含义;writerows 一次性写入,适合短循环,长时间老化可以改成分批写或每条追加,但表头只写一次。参数说明:文件名 burn_in.csv 是材料里的示例名,实际按工位和日期改;OUTP OFF 不带参数,关闭当前输出;SYST:LOC 不带参数,退出远程模式。材料里特别提到,不发 SYST:LOC,下一个人来交接时面板按键可能失灵,他第一反应是断电重启,反而容易损伤正在连接的负载。所以收尾不是“可选项”,是功能库必须提供的 close 动作。
5. 避坑与排查:通道串扰、远程锁死和链路误判
这类脚本的坑有一个共同点:大部分时候不报错,数据却不对。等你发现数据不对,往往已经跑完一批。下面四条是我在双通道电源控制里反复遇到的,每条都按“现象 → 原因 → 解决”走一遍,排查时按顺序看,别一上来就怀疑电源硬件。
5.1 四条踩坑记录
通道 2 读到通道 1 的值。 现象是双通道脚本跑完,通道 2 的电压电流和通道 1 几乎一样,或者两路数值交替跳。原因是回读前没有重新发 INST:NSEL,电源还停留在上一次选中的通道;设值和回读共用“当前通道”这个上下文,中间插了别的操作就会串。解决办法是把“选通道 + 回读”绑成一个 measure(ch) 函数,或者在每次回读前显式发 INST:NSEL,不依赖上一条命令的上下文。材料里的轮询代码每次循环都重选通道,就是对这个坑的正面处理。
脚本结束后面板按键失灵。 现象是自动化跑完,人去按电源面板没反应,以为设备死机。原因是电源还在远程模式,脚本没有发 SYST:LOC。远程模式下面板按键被接管,这是正常行为,不是故障。解决办法是把收尾顺序固定成“先 OUTP OFF,再 SYST:LOC”,并且放在 finally 块或脚本末尾,异常退出也要执行。材料里说得很直白:不发这条命令,交接的人第一反应是断电重启,反而容易损伤正在连接的负载。
线松了却以为电源坏了。 现象是命令发出去没有返回,脚本超时,第一反应是电源故障。原因是没做链路握手,串口线、端口配置、转换器供电的问题被当成设备问题。解决办法是每次上电先发 *IDN?,返回为空或异常时先查线、查端口、查转换器供电,再怀疑电源。材料里“每次上电先确认链路状态,再执行后续动作”说的就是这个顺序。功能库可以把 *IDN? 做成 connect 之后的第一个必调方法,不通过就不让进设值。
测试完负载一直带电。 现象是脚本跑完,负载还带电,电源输出没关。原因是只停了循环,没有发 OUTP OFF;或者异常退出时跳过了收尾。解决办法是收尾先 OUTP OFF,确认输出关闭后再 SYST:LOC,并且用 try/finally 兜住异常路径。材料里的收尾代码就是先关输出再退远程,这个顺序不要调换。还有一点,OUTP OFF 之后不要立刻拔线,等面板显示输出关闭再动负载。
5.2 排查顺序:先链路、再通道、后数值
遇到“数据不对”时,我一般按三步走,不跳步。第一步查链路:发 *IDN?,有返回才继续;没返回就查线、端口、转换器,别碰业务代码。第二步查通道:发 INST:NSEL 1,回读电压电流;再发 INST:NSEL 2,回读电压电流,看两路是否独立。第三步查数值:两路都独立后,再看回读值是否在设定值附近,偏差大就查输出有没有开、负载是否接对、量程是否合适。这个顺序的好处是把“链路问题”和“电源问题”分开,避免在串口线松了的时候去调电源参数。
| 排查步骤 | 检查动作 | 判据 | 不通过时先查 |
|---|---|---|---|
| 1 | 发 *IDN? |
有返回文本 | 串口线、端口、转换器供电 |
| 2 | 发 INST:NSEL 1 后回读 |
通道 1 数值独立 | 通道选择命令是否执行 |
| 3 | 发 INST:NSEL 2 后回读 |
通道 2 数值独立 | 是否每次回读前重选通道 |
| 4 | 收尾 OUTP OFF、SYST:LOC |
输出关闭、面板可控 | 收尾顺序和异常路径 |
这张表不是让你每次跑脚本都填一遍,而是出问题时按顺序定位。链路不通,后面三步全是无效动作;通道不独立,数值再准也是串的;数值偏差大,先查输出和负载,不要先改功能库。材料里提到的“先关输出再退远程”也适用于排查:手动调试完,记得把输出关掉、远程退掉,再离开工位。
6. 功能库上线前的验证清单与交接习惯
功能库写完不等于能上线,我一般会跑一个短循环做验证,再走一遍交接检查。短循环不用跑 8 小时,跑三五次就够,重点看三件事:两路数值是否独立、CSV 是否有时间戳、收尾后面板能不能接管。下面这段验证代码可以直接接在前面的功能库后面用。
python复制ident = scpi_cmd('*IDN?')
if not ident:
raise RuntimeError('链路未就绪')
set_channel(1, voltage=5.0, current=2.0)
set_channel(2, voltage=12.0, current=1.0)
# 跑 3 次短循环,检查 burn_in.csv 里 v1/v2 是否独立、time 是否有值
# 跑完执行 OUTP OFF 和 SYST:LOC,再按面板确认输出关闭
这段验证代码的重点是顺序:先握手,再设值,再短循环,最后收尾。参数沿用材料里的 5V/2A 和 12V/1A,不要为了“更真实”临时改一套没验证过的值。短循环跑完打开 burn_in.csv,看 v1 和 v2 是不是明显不同的两组数,看 time 列是不是递增的;如果两列数值一样,回到第 5 章查通道选择。最后按面板按键,确认 SYST:LOC 生效、输出已经关闭。
| 检查项 | 动作 | 通过标准 |
|---|---|---|
| 链路 | 发 *IDN? |
有返回文本 |
| 通道独立 | 双通道各回读一次 | 两路数值不串 |
| 记录完整 | 打开 burn_in.csv |
表头齐全、时间戳递增 |
| 安全收尾 | 发 OUTP OFF、SYST:LOC |
输出关闭、面板可控 |
从那以后我每次把脚本交给下一班,都强制先跑一遍 *IDN?,再走一次 OUTP OFF 和 SYST:LOC,确认面板能接管才离开。这个习惯帮我避开了好几次“线松了以为电源坏了”和“跑完负载还带电”的误判。希望帮到你。
