visa-debug

Original：🇨🇳 Chinese

Translated

1 scriptsChecked / no sensitive code detected

Used for debugging GPIB/USB/TCP/Serial VISA instrument communication, supporting SCPI command sending and receiving, waveform capture, screenshot, and continuous monitoring.

3installs

Sourceleokemp223/embed-ai-tool

Added on2026-05-16

NPX Install

npx skill4agent add leokemp223/embed-ai-tool visa-debug

SKILL.md Content (Chinese)

View Translation Comparison →

VISA Instrument Debugging

Application Scenarios

Need to identify and detect connected VISA instruments (oscilloscopes, multimeters, signal sources, etc.).
Need to send SCPI commands to query or control instruments.
Need to capture waveform data from oscilloscopes and save it as CSV.
Need to capture instrument screen screenshots.
Need to continuously monitor changes in a certain measurement value.

Required Inputs

VISA resource string (e.g.,

TCPIP::192.168.1.100::INSTR

,

USB0::0x1AB1::0x04CE::DS1ZA1234::INSTR

).

SCPI commands (required for query/write/monitor modes).

Dependencies

```
pyvisa
```
(pip install pyvisa)
```
pyvisa-py
```
(pure Python backend, pip install pyvisa-py) or NI-VISA driver

Execution Steps

First read references/usage.md to confirm operation parameters.
Detect the environment:
bash
```
python scripts/visa_tool.py --detect
```

Perform operations according to requirements:

bash

# Query instrument identification
python scripts/visa_tool.py --resource "TCPIP::192.168.1.100::INSTR" --idn

# Send SCPI query
python scripts/visa_tool.py --resource "TCPIP::192.168.1.100::INSTR" --query ":MEAS:VOLT?"

# Capture waveform
python scripts/visa_tool.py --resource "TCPIP::192.168.1.100::INSTR" --waveform --output wave.csv

Failure Diversion

```
connection-failure
```
: VISA resource not found or connection cannot be opened.
```
timeout
```
: Instrument does not respond.
```
command-error
```
: SCPI command rejected by the instrument.
```
data-error
```
: Waveform or screenshot data transmission failed.

Output Convention

Example output format:

Result: ✅ Rigol Technologies,DS1054Z,DS1ZA1234,00.04.04.SP4
  Resource: TCPIP::192.168.1.100::INSTR

Handover Relationship

After firmware is burned via
```
build-keil
```
/
```
build-platformio
```
, use this skill to verify hardware output signals.
Complementary to
```
serial-monitor
```
: serial-monitor views serial port debugging output, visa-debug performs instrument-level measurement verification.
Complementary to
```
modbus-debug
```
/
```
can-debug
```
: protocol debugging combined with instrument measurement.