跳到正文
FunCoding

visa-debug

当需要调试 GPIB/USB/TCP/Serial VISA 仪器通信时使用，支持 SCPI 命令收发、波形捕获、截图和持续监控。

Star
1,000
分类
编码与调试
最近提交
2026年8月20日

skills/visa-debug/SKILL.md

在 GitHub 上查看

VISA 仪器调试

适用场景

  • 需要识别和探测连接的 VISA 仪器（示波器、万用表、信号源等）。
  • 需要发送 SCPI 命令查询或控制仪器。
  • 需要从示波器捕获波形数据并保存为 CSV。
  • 需要捕获仪器屏幕截图。
  • 需要持续监控某个测量值的变化。

必要输入

  • VISA 资源字符串（如 TCPIP::192.168.1.100::INSTR、USB0::0x1AB1::0x04CE::DS1ZA1234::INSTR）。
  • SCPI 命令（查询/写入/监控模式需要）。

依赖

  • pyvisa（pip install pyvisa）
  • pyvisa-py（纯 Python 后端，pip install pyvisa-py）或 NI-VISA 驱动

执行步骤

  1. 先阅读 references/usage.md，确认操作参数。
  2. 探测环境： 
    python scripts/visa_tool.py --detect
  3. 根据需求执行操作： 
    # 查询仪器标识
python scripts/visa_tool.py --resource "TCPIP::192.168.1.100::INSTR" --idn

# 发送 SCPI 查询
python scripts/visa_tool.py --resource "TCPIP::192.168.1.100::INSTR" --query ":MEAS:VOLT?"

# 捕获波形
python scripts/visa_tool.py --resource "TCPIP::192.168.1.100::INSTR" --waveform --output wave.csv

失败分流

  • connection-failure：VISA 资源未找到或无法打开连接。
  • timeout：仪器未响应。
  • command-error：SCPI 命令被仪器拒绝。
  • data-error：波形或截图数据传输失败。

输出约定

示例输出格式：

结果: ✅ Rigol Technologies,DS1054Z,DS1ZA1234,00.04.04.SP4
  资源: TCPIP::192.168.1.100::INSTR

交接关系

  • 从 build-keil / build-platformio 烧录固件后，用此 skill 验证硬件输出信号。
  • 与 serial-monitor 互补：serial-monitor 查看串口调试输出，visa-debug 进行仪器级测量验证。
  • 与 modbus-debug / can-debug 互补：协议调试配合仪器测量。

相似的 Skill

receiving-code-review

OBobra/superpowers298k近 7 天新增 2,631 个 star

requesting-code-review

OBobra/superpowers298k近 7 天新增 2,631 个 star

systematic-debugging

OBobra/superpowers298k近 7 天新增 2,631 个 star

code-review

MAmattpocock/skills288k近 7 天新增 10,178 个 star

codebase-design

MAmattpocock/skills288k近 7 天新增 10,178 个 star

scaffold-exercises

MAmattpocock/skills288k近 7 天新增 10,178 个 star