📚 课程目录第4章使用pyvisa管理资源

4. 使用pyvisa管理资源

任务说明

本案例目标为：使用pyvisa库实现VISA资源的枚举、查询与打开/关闭管理，并验证资源管理操作的正确性。你将通过一个最小可复现的Python脚本，完成对系统内可用VISA资源的发现、信息读取以及资源句柄的生命周期管理。

实现方案

pyvisa是Python访问VISA（Virtual Instrument Software Architecture）资源的标准库。本案例不依赖任何真实仪器，仅使用pyvisa自带的模拟资源（simulator）来演示资源管理流程。核心操作包括：

创建ResourceManager对象；
调用list_resources()枚举所有可用资源地址；
通过open_resource()打开指定资源，并读取其基本信息；
使用close()释放资源，并验证资源已关闭。

代码实现

import pyvisa

def main():
    # 1. 创建资源管理器
    rm = pyvisa.ResourceManager()
    print("ResourceManager 创建成功")

    # 2. 枚举所有可用VISA资源
    resources = rm.list_resources()
    print(f"检测到 {len(resources)} 个VISA资源:")
    for res in resources:
        print(f"  - {res}")

    # 3. 若存在资源，则打开第一个资源并读取信息
    if resources:
        target = resources[0]
        print(f"\n尝试打开资源: {target}")
        instr = rm.open_resource(target)

        # 读取资源描述信息（模拟资源返回固定字符串）
        desc = instr.query("*IDN?")
        print(f"资源标识: {desc.strip()}")

        # 4. 关闭资源并验证状态
        instr.close()
        print("资源已关闭")

        # 验证：尝试对已关闭资源操作应抛出异常
        try:
            instr.query("*IDN?")
            print("错误：资源关闭后仍可操作")
        except pyvisa.Error as e:
            print(f"验证通过：关闭后操作被拒绝 ({type(e).__name__})")
    else:
        print("未发现任何VISA资源，请检查VISA后端安装")

    # 5. 关闭资源管理器
    rm.close()
    print("ResourceManager 已释放")

if __name__ == "__main__":
    main()

依赖与运行

本案例需要Python 3.7+，并安装pyvisa库。模拟资源由pyvisa内置提供，无需额外安装VISA后端或连接真实仪器。

pip install pyvisa
python visa_resource_manager.py

验证方法

运行脚本后，观察输出是否符合以下判定标准：

输出包含“ResourceManager 创建成功”；
list_resources()返回至少一个资源地址（模拟资源通常为TCPIP0::127.0.0.1::inst0::INSTR或USB0::...::INSTR格式）；
成功打开资源并读取到*IDN?的响应字符串；
资源关闭后再次调用query()抛出pyvisa.Error异常，程序捕获并打印“验证通过”。

若所有步骤均按预期输出，则说明资源管理流程正确。若list_resources()返回空列表，请检查pyvisa安装完整性或尝试重启Python环境。

预期输出示例

ResourceManager 创建成功
检测到 1 个VISA资源:
  - TCPIP0::127.0.0.1::inst0::INSTR

尝试打开资源: TCPIP0::127.0.0.1::inst0::INSTR
资源标识: Mock Instrument (pyvisa-sim)
资源已关闭
验证通过：关闭后操作被拒绝 (VisaIOError)
ResourceManager 已释放