instrumentControl

集合仪表设备控制项目：统一封装 VISA/SCPI 控制层，按设备分目录管理专用驱动与实测脚本。

目录结构

instrumentControl/
├── common/                 # 通用层：VISA 客户端 VisaClient + 统一发现 find_device
├── mcp_instruments/        # MCP 服务器：19 工具（17 专用 + 2 通用护栏）统一暴露（server.py + SKILL.md）
├── dh1766_control/         # DH1766 电源库（独立可安装：pip install -e ./dh1766_control）
│   ├── src/dh1766_control/ # 驱动 + SCPI 命令常量 + VISA 客户端（自包含）
│   └── docs/               # 手册提取 / 命令速查 / 经验总结
├── dho_control/            # RIGOL DHO800/900 示波器库
├── sds_control/            # Siglent SDS800X HD 示波器库
├── sdg_control/            # Siglent SDG2000X 信号源库
├── keysight_3446x/         # Keysight Truevolt 34465A 万用表库
├── emoe_control/           # Emoe 校准器库（骨架版：仅发现 + *IDN?，编程手册未提供）
├── dg832-control/          # DG832 独立嵌套 git 仓库（历史库，结构不同，勿混入主仓提交）
├── devices/                # 设备专用文档（驱动已迁入 dh1766_control）
├── archive/                # 历史版本归档（旧版驱动等，可回溯）
├── TEST_SCRIPTS/           # 实测脚本（按设备分目录，输出带时间戳留痕）
├── TEST_DATA/              # 实测留痕数据（JSON，时间戳命名）
└── requirements.txt

Related MCP server: scpi-mcp

使用

pip install -r requirements.txt
pip install -e ./dh1766_control

# DH1766 实测：识别 + 读电压电流 + 开关通道演示
python TEST_SCRIPTS/dh1766/test_dh1766_read.py

# DH1766 全功能验证：手册 4.2 全部指令读写（备份-恢复式）
python TEST_SCRIPTS/dh1766/test_dh1766_full.py            # 空载时
python TEST_SCRIPTS/dh1766/test_dh1766_full.py --safe     # 接入负载时（输出ON通道拒绝改设定）

实测记录

• 2026-08-17：DH1766A-1 识别为 USB0::0x0957::0xA007::100260004670::INSTR， *IDN? = BJDH,DH1766A-1,0,V0.1.4.3；三路读回电压/电流正常，输出开关命令验证通过。 注：该设备 VID=0x0957（Keysight ID），为国产仪器兼容 VISA 驱动常见做法，以 *IDN? 为准。

• 2026-08-17：手册 4.2 全部指令集 40/40 读写验证通过（test_dh1766_full.py，留痕见 TEST_DATA/dh1766/dh1766_full_*.json）。全部写操作备份-恢复，设备设定与测试前一致。 实测发现的固件差异（V0.1.4.3 vs 手册基于的 V0.1.2.8）见 dh1766_control/docs/EXPERIENCE.md。

• 2026-08-17：dh1766_control 库建立（src 布局，pip 可安装），DH1766 系列完整手册 （43 页）经 read-pdf 提取归档至 dh1766_control/docs/，供后续查阅核对。

• 2026-08-23：common/ 统一发现层上线（find_device：显式 resource → hosts 自动选协议 → 已有资源列表 → CIDR 网段扫描，--allow-scan 默认关）。实测要点：纯 VISA 扫 /24 需 510s， 加 TCP 端口预筛(111/4880/5025/5555) 后 8s；DH1766A-1 经网线可达 TCPIP0::192.168.31.144::5025::SOCKET（raw socket 会话必须配 \n 终止符）； RIGOL DHO924S 示波器可达 TCPIP0::192.168.31.146::5555::SOCKET（Rigol SCPI raw 口）。 带载(CH1 ON 12V/0.31A)下显式 LAN 直连读取正常，CH1 保持 ON 未做开关动作。留痕见 TEST_DATA/common/discovery_smoke_*.json 与 TEST_SCRIPTS/common/test_discovery.py （T1T5 全 PASS，扫描同时识别电源+示波器且 IDN 过滤不误配）。

• 2026-08-23：全网段探测（TEST_SCRIPTS/common/probe_all.py）新发现三台在线仪器： Keysight 34465A 万用表(.123，VXI-11)、Siglent SDG2122X 信号源(.206，VXI-11)、 Siglent SDS824X HD 示波器(.220，VXI-11)。dho_control 库建立（DHO800/DHO900 系列 通用，波形 BYTE/WORD TMC 解析 + 电压换算 (raw-YORigin-YREFerence)*YINCrement）， 手册提取至 dho_control/docs/DHO800编程手册_output/（418 页），hosts 直连验证通过。

• 2026-08-23：三台新设备库完成（均含手册提取 + 只读冒烟实测）： sds_control（SDS800X HD 系列，495 页手册，波形 PREamble 二进制协议+分片读取+电压换算 raw/codevdiv-offset）、sdg_control（SDG2000X 系列，175 页 PG，BSWV 整查/键值写）、 keysight_3446x（Truevolt 583 页手册已下载提取，CONF/MEAS/NPLC/DATA:LAST）。 实测要点：SDS 全拼命令 ":ACQuire:MDEPth?" 不响应必须短形式 "ACQ:MDEP?"；SDS 响应带单位 后缀需剥离；SDS 查询回显头按前缀智能剥离；34465A DATA:LAST? 带 "VDC" 后缀。 留痕：TEST_DATA/common/three_libs_smoke_.json。DHO924S 待设备空闲后做全功能验证。

• 2026-08-25：mcp_instruments/ MCP 服务器上线：五台仪器 17 工具统一暴露（无状态 连接→操作→关闭 + 全局锁串行化；复位类零暴露，关机/开输出 confirm=True 安全门； 错误统一 {ok, error_type, error} 四分类）。已注册 zcode 用户级 config （~/.zcode/cli/config.json 的 instruments，新会话生效；使用指引 skill：instrument-mcp）。

• 2026-08-26：instr_discover v3（串口探测：占用提示/空闲 IDN 后断开/驱动挂起 6s 硬超时； VISA 先于 LAN 隔离代理干扰；fake-IP 网段污染降级 warning），实测发现串口新设备 EmoeCalibrator（ASRL31），建 emoe_control 骨架库（仅发现 + *IDN?，编程手册未提供）。

• 2026-08-26/09-01：三轮审查修复（整体代码审查 17 项、MCP 专项、DH1766 远控文档建议： find_dh1766 上次成功地址缓存 .last_good_resource.json、power_cycle 高层 API—— 后者未暴露 MCP）。

• 2026-09-03：MCP 增至 19 工具：新增 instr_query/instr_write 通用护栏（新设备零代码 接入——复位类黑名单 forbidden、通用写 confirm=True、写前 drain/写后 SYST:ERR?/自动 回读、审计落盘 TEST_DATA/common/mcp_scpi_audit_*.jsonl、离线资源硬超时看门狗）。 实测修复三缺陷：(a) mcp.run() 事件循环与后台线程 import pyvisa 死锁（冷进程首个 设备调用永久冻结）→ 重依赖 import 移主线程（<1s）；(b) instr_discover LAN 分支 probe_alive/identify_lan 未导入 NameError（存量 bug）→ 补导入+LAN 异常降级； (c) 串口探测每线程各建 RM 原生崩溃（8 串口实测）→ 共享单例 RM。真机验证：SDG 整查/ 等值写三步闭环（状态零变更）、串口新设备发现并零接入识别 EmoeR&D ADS127L11-DAQ-EV （ASRL5；校准器 ASRL31 已离线/换号，串口号会漂移，接入先 instr_discover 重定位）。

安全模式（接入负载后使用）

DH1766(client, safe_mode=True)：目标通道输出 ON 时拒绝修改电压/电流/OVP/OCP 及 输出模式（TRAC/SERI/PARA，继电器联动）；输出开关本身不拦截。