Visa Debug

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. 探测环境： ``bash python scripts/visa_tool.py --detect ``
3. 根据需求执行操作： ```bash # 查询仪器标识 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` 互补：协议调试配合仪器测量。