ScopeProbe MCP

让 AI 经 MCP 读 DreamSourceLab DSCope(如 DSCope U3P100)的电压/波形——用于数字电源等硬件的在线自测与采样校准。

配合配套的 MultiProbeFlash MCP(烧录/SWD/RTT/串口)成套:一个管烧录+调试,一个管示波器测量,AI 可闭环「改码→编译→烧录→RTT/串口验证→示波器量电压」。

为什么单独做

• mainline sigrok-cli 不支持 DSCope(需 DreamSourceLab 分叉的 libsigrok4DSL)。
• 现成 scope MCP 都不覆盖 DSCope:
  • KenosInc/sigrok-mcp-server(Go,包 sigrok-cli,偏逻辑分析/协议解码)
  • MagnusJohansson/siglent-sds-mcp、lxkang00/oscilloscope-mcp(Python,SCPI 网口控 Siglent)
  • Rigol DHO / Digilent WaveForms 等
• 本 server 直接包 WaveGate 的原生采集器 wavegate-capture(sigrok4dsl 后端,已驱动 DSCope),把测量暴露成 MCP。

工具

工具	说明
scope_scan	扫描 DSCope 设备(model/serial/通道)
scope_measure_dc(channel, vdiv_mv, samples, samplerate)	采通道 → 算 DC 电压(中位码值→电压);vdiv_mv=0 自动切档(1V/2V/5V per div),带 tried/clipping/hint
scope_capture_stats(channel, ...)	采波形返回码值统计(min/max/mean/median/峰峰),快速看信号在不在/抖不抖

DC 电压换算

DSCope 8-bit 码值随电压反向(code 越小电压越高):

V = (hw_offset - code) * (vdiv_mv * vfactor * 10) / (ref_max - ref_min) / 1000

标定常数(vdiv_mv/hw_offset/ref_min/ref_max)从 wavegate-capture acquire 输出读,vdiv 跟随 DSCope 当前档位。1V/div 时量程约 ±5V。

自动切档量程

scope_measure_dc(channel, vdiv_mv=0, ...):

• vdiv_mv=0（默认）→ 自动切档:依次试 1V/2V/5V per div，取不贴量程边界（ref_min/ref_max ±2）的那档。量 ~12V 输入会自动切到 2V/div。
• vdiv_mv>0 → 固定该档（mV/div）。
• 返回带 tried（各档尝试）、clipping、hint。

依赖 wavegate-capture 支持 --vdiv（本仓库配套的 WaveGate 已加该参数）。若用的是旧版 wavegate-capture（不认 --vdiv），它会忽略该参数、维持设备当前档位，自动切档退化为"检测+提示"，此时 >±5V 需在 DSView 手动调大 vdiv。

依赖 & 配置

• pip install mcp
• wavegate-capture.exe(sigrok4dsl 后端);路径经环境变量 WAVEGATE_CAPTURE 指定。
• DSCope USB 接入;同一时刻别和 DSView / WaveGate GUI 抢设备。

Claude Code .mcp.json:

{ "mcpServers": { "scopeprobe": {
  "command": "uv",
  "args": ["run","--with","mcp","python","scopeprobe_mcp.py"],
  "env": { "WAVEGATE_CAPTURE": "C:/.../wavegate-capture.exe" }
} } }

实测

• DSCope CH0 接数字电源输出(5V):scope_measure_dc(0) → 5.02V;固件读 4.99V,吻合 ~0.6%。
• 12V 输入侧:1V/div 超量程(clipping=True)→ 提示调 2V/div。

开发约定

沿用配套 MultiProbeFlash 的「功能必进 MCP」：新增采集/测量能力都在此暴露对应 MCP 工具。

License

MIT —— 见 LICENSE。