1. 引言agilent-visa-control 是一个基于 PyVISA 封装的 Python 库专门用于通过 VISAVirtual Instrument Software Architecture接口控制安捷伦Agilent现 Keysight系列仪器包括示波器、信号发生器、电源、万用表、频谱分析仪等。该库将底层 VISA 通信细节封装为简洁的 Python API帮助测试工程师快速实现仪器自动化控制、数据采集与远程配置。本文将从功能特性、安装方法、核心语法与参数、9 个实际应用案例以及常见错误与注意事项五个方面系统介绍 agilent-visa-control 包的使用方法。2. 功能概述agilent-visa-control 包的核心功能可以概括为以下几个方面仪器连接管理支持通过 USB、GPIB、LANVXI-11 或 SOCKET等接口自动发现并连接安捷伦仪器统一管理连接会话。SCPI 命令封装将常用的 SCPIStandard Commands for Programmable Instruments命令封装为 Python 方法例如查询仪器 ID、设置电压电流、读取测量值等。数据读取与波形采集针对示波器提供波形数据读取接口支持将二进制波形数据解析为 NumPy 数组便于后续分析。批量配置与状态查询支持对仪器进行批量参数配置并查询仪器状态、错误队列等信息。多仪器协同控制允许在同一脚本中同时管理多台仪器适用于搭建自动化测试系统。3. 安装方法agilent-visa-control 依赖 PyVISA 和 PyVISA-Py纯 Python 后端或 PyVISA-Py 对应的 NI-VISA 后端。推荐使用 pip 进行安装pip install agilent-visa-control如果需要使用 NI-VISA 后端还需要安装 NI-VISA 运行时并安装对应的 PyVISA 后端pip install pyvisa pyvisa-py安装完成后可以通过以下命令验证是否安装成功import agilent_visa_control print(agilent_visa_control.__version__)4. 核心语法与参数agilent-visa-control 包的核心类是Instrument它封装了与单台仪器通信的所有操作。下面介绍最常用的语法和参数。4.1 创建仪器连接创建仪器连接时需要指定仪器的 VISA 地址。VISA 地址的格式取决于接口类型USB 接口USB::0x0957::0x17XX::MYXXXXXXXX::INSTRGPIB 接口GPIB0::7::INSTRLAN 接口TCPIP0::192.168.1.100::INSTR或TCPIP0::192.168.1.100::5025::SOCKETfrom agilent_visa_control import Instrument 通过 USB 连接 inst Instrument(USB::0x0957::0x17XX::MYXXXXXXXX::INSTR) 通过 LAN 连接 inst Instrument(TCPIP0::192.168.1.100::INSTR)4.2 常用方法与参数Instrument 类提供以下常用方法query_idn()查询仪器 IDN 字符串返回仪器厂商、型号、序列号等信息。write(command)向仪器发送 SCPI 命令无返回值。query(command)向仪器发送 SCPI 命令并读取返回值。read()读取仪器返回的数据。close()关闭与仪器的连接。此外包还提供了一些高层封装方法例如set_voltage(channel, voltage)设置电源指定通道的输出电压。set_current(channel, current)设置电源指定通道的输出电流。measure_voltage(channel)读取电源指定通道的当前电压。get_waveform()从示波器读取波形数据并返回 NumPy 数组。4.3 参数说明在创建 Instrument 对象时可以传入以下可选参数timeout通信超时时间单位为毫秒默认值为 5000。read_termination读取终止符默认值为\n。write_termination写入终止符默认值为\n。backend指定 PyVISA 后端可选py纯 Python 后端或niNI-VISA 后端。inst Instrument( TCPIP0::192.168.1.100::INSTR, timeout10000, read_termination\n, write_termination\n, backendpy )5. 实际应用案例下面通过 9 个实际案例展示 agilent-visa-control 包在不同场景下的具体用法。案例 1查询仪器基本信息连接仪器后首先查询仪器 IDN 字符串确认通信正常。from agilent_visa_control import Instrument inst Instrument(USB::0x0957::0x17XX::MYXXXXXXXX::INSTR) idn inst.query_idn() print(仪器信息:, idn) inst.close()案例 2设置直流电源输出电压通过 SCPI 命令设置电源通道 1 的输出电压为 5V并启用输出。from agilent_visa_control import Instrument inst Instrument(GPIB0::5::INSTR) inst.write(:OUTP CH1,ON) inst.write(:VOLT CH1,5.0) print(电压设置完成) inst.close()案例 3读取万用表测量值配置万用表为直流电压测量模式并读取当前测量值。from agilent_visa_control import Instrument inst Instrument(TCPIP0::192.168.1.50::INSTR) inst.write(:CONF:VOLT:DC) value inst.query(:READ?) print(测量电压:, value, V) inst.close()案例 4示波器波形数据采集从示波器读取通道 1 的波形数据并转换为 NumPy 数组进行绘图分析。import matplotlib.pyplot as plt from agilent_visa_control import Instrument inst Instrument(TCPIP0::192.168.1.100::INSTR) inst.write(:WAV:SOUR CHAN1) inst.write(:WAV:FORM BYTE) waveform inst.get_waveform() plt.plot(waveform) plt.title(Channel 1 Waveform) plt.show() inst.close()案例 5信号发生器输出正弦波配置信号发生器输出 1kHz、幅度 2V 的正弦波。from agilent_visa_control import Instrument inst Instrument(USB::0x0957::0x17XX::MYXXXXXXXX::INSTR) inst.write(:FREQ 1000) inst.write(:VOLT 2.0) inst.write(:FUNC SIN) inst.write(:OUTP ON) print(信号输出已启动) inst.close()案例 6批量设置多通道电源对电源的 3 个通道进行批量配置分别设置不同的电压和电流限制。from agilent_visa_control import Instrument inst Instrument(GPIB0::5::INSTR) channels {CH1: (5.0, 1.0), CH2: (3.3, 0.5), CH3: (12.0, 2.0)} for ch, (volt, curr) in channels.items(): inst.write(f:VOLT {ch},{volt}) inst.write(f:CURR {ch},{curr}) inst.write(f:OUTP {ch},ON) print(多通道配置完成) inst.close()案例 7自动记录电压变化曲线定时读取电源输出电压记录 10 个数据点并绘制变化曲线。import time import matplotlib.pyplot as plt from agilent_visa_control import Instrument inst Instrument(TCPIP0::192.168.1.50::INSTR) voltages [] for i in range(10): v float(inst.query(:MEAS:VOLT?)) voltages.append(v) time.sleep(1) plt.plot(voltages) plt.xlabel(Time (s)) plt.ylabel(Voltage (V)) plt.show() inst.close()案例 8多仪器协同测试同时控制电源和万用表搭建一个简单的自动化测试流程设置电压、读取测量值并判断是否在允许范围内。from agilent_visa_control import Instrument psu Instrument(GPIB0::5::INSTR) dmm Instrument(TCPIP0::192.168.1.50::INSTR) psu.write(:VOLT CH1,5.0) psu.write(:OUTP CH1,ON) measured float(dmm.query(:READ?)) if 4.9 measured 5.1: print(测试通过电压:, measured) else: print(测试失败电压:, measured) psu.close() dmm.close()案例 9错误队列查询与处理在发送命令后查询仪器错误队列确保命令执行成功。from agilent_visa_control import Instrument inst Instrument(USB::0x0957::0x17XX::MYXXXXXXXX::INSTR) inst.write(:VOLT CH1,5.0) error inst.query(:SYST:ERR?) if No error in error: print(命令执行成功) else: print(仪器错误:, error) inst.close()6. 常见错误与使用注意事项在使用 agilent-visa-control 包时可能会遇到以下几类常见问题需要特别注意。6.1 常见错误VISA 地址错误地址格式不正确或仪器未开机会导致连接失败抛出pyvisa.errors.VisaIOError。超时错误仪器响应时间超过设定的 timeout 值会抛出超时异常。此时应适当增大 timeout 参数。SCPI 命令语法错误命令拼写错误或参数格式不正确仪器会返回错误信息可通过查询错误队列定位。后端未安装未安装 PyVISA-Py 或 NI-VISA 后端时会抛出ValueError提示找不到可用的 VISA 实现。波形数据解析失败示波器波形格式设置不正确可能导致返回的二进制数据无法解析为有效数组。6.2 使用注意事项正确设置终止符不同仪器的读写终止符可能不同需根据仪器手册配置read_termination和write_termination。及时关闭连接每次使用完毕后应调用close()释放资源避免占用仪器通信端口。注意仪器通道编号不同型号仪器的通道编号规则可能不同使用前应查阅对应型号的编程手册。波形数据格式读取示波器波形前应先设置:WAV:FORM为BYTE或WORD并确认返回数据的字节序。异常处理建议在代码中使用 try-except 捕获 VISA 异常避免程序因通信错误而崩溃。版本兼容性注意 agilent-visa-control 与 PyVISA 主版本之间的兼容性升级 PyVISA 后应重新验证包的可用性。7. 总结agilent-visa-control 包为安捷伦仪器的自动化控制提供了简洁高效的 Python 接口。通过本文介绍的功能、安装方法、核心语法以及 9 个实际案例读者可以快速上手将其应用到电源、万用表、示波器、信号发生器等常见仪器的自动化测试场景中。在实际使用过程中注意合理配置连接参数、正确处理异常并参考仪器手册确认命令细节即可稳定可靠地完成各类自动化测量与控制任务。《动手学PyTorch建模与应用:从深度学习到大模型》是一本从零基础上手深度学习和大模型的PyTorch实战指南。全书共11章前6章涵盖深度学习基础包括张量运算、神经网络原理、数据预处理及卷积神经网络等后5章进阶探讨图像、文本、音频建模技术并结合Transformer架构解析大语言模型的开发实践。书中通过房价预测、图像分类等案例讲解模型构建方法每章附有动手练习题帮助读者巩固实战能力。内容兼顾数学原理与工程实现适配PyTorch框架最新技术发展趋势。