mcpField
V
visa-debug

visa-debug

github.com/leokemp223Testing & quality1.0k554 installsUpdated 10w ago
Repository

About visa-debug

A skill for debugging measurement instruments over VISA, intended for developers checking hardware outputs or collecting instrument data. Its command-line script detects devices, sends SCPI commands, and supports waveform and screenshot capture.

Key features

  1. 01Detect available VISA instruments
  2. 02Query device identity and send SCPI commands
  3. 03Capture oscilloscope waveforms as CSV
  4. 04Capture instrument screenshots
  5. 05Monitor measurement values continuously

Use cases

  1. 01Verify hardware output after flashing firmware
  2. 02Query readings and control measurement instruments
  3. 03Save oscilloscope waveforms for later analysis
  4. 04Track changes in a measurement value

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/leokemp223/embed-ai-tool --skill visa-debug

After installing, type/visa-debugin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
usage.md
scripts/
visa_tool.py

Details

From the project README

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 互补：协议调试配合仪器测量。

Comments

Markdown supported