mcpField
P
probe-rs

probe-rs

github.com/zhinkgitDevelopment772635 installsUpdated 1w ago
Repository

About probe-rs

A structured wrapper around the `probe-rs` CLI for embedded developers working with probes and target chips. It covers flashing, memory operations, one-shot GDB debugging, and RTT log reading, and requires an explicit chip model.

Key features

  1. 01List probes and inspect target information
  2. 02Flash firmware, erase chips, and reset targets
  3. 03Read and write memory
  4. 04Run one-shot GDB debugging
  5. 05Read RTT logs

Use cases

  1. 01Check connected probes and targets
  2. 02Flash ELF, HEX, BIN, or UF2 firmware
  3. 03Inspect or modify target memory
  4. 04Run one-shot GDB debugging and read RTT logs

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zhinkgit/embeddedskills --skill probe-rs

After installing, type/probe-rsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

config.example.json
README.md
scripts/
probe_rs_exec.py
probe_rs_gdb_common.py
probe_rs_gdb.py
probe_rs_rtt.py
probe_rs_runtime.py
tests/
test_probe_list.py

Details

From the project README

probe-rs 下载与调试

本 skill 提供 probe-rs CLI 的结构化包装，覆盖探针发现、目标信息、烧录、复位、内存读写、one-shot GDB 调试和 RTT 日志读取。

Windows 下优先使用 py -3 调用脚本；若 arm-none-eabi-gdb 已在 PATH 中，gdb 子命令可自动发现，不强依赖 skill config.json。

配置

环境级配置（skill/config.json）

首次使用前建议在 skill 目录下创建 config.json：

{
  "exe": "probe-rs",
  "gdb_exe": "C:\\Program Files\\Arm\\GNU Toolchain mingw-w64-x86_64-arm-none-eabi\\bin\\arm-none-eabi-gdb.exe",
  "gdb_port": 3333,
  "dap_port": 50000,
  "operation_mode": 1
}
  • exe：probe-rs 可执行文件路径或命令名
  • gdb_exe：arm-none-eabi-gdb 路径，gdb 子命令需要
  • gdb_port：默认 GDB 端口
  • dap_port：预留给交互式 DAP 会话
  • operation_mode：1 直接执行 / 2 输出风险摘要但不阻塞 / 3 执行前确认
工程级配置（.embeddedskills/config.json）
{
  "probe-rs": {
    "chip": "STM32F407VGTx",
    "protocol": "swd",
    "probe": "",
    "speed": 4000,
    "connect_under_reset": false
  }
}
  • chip：芯片型号，probe-rs 主后端必填
  • protocol：swd 或 jtag
  • probe：探针选择器，格式 VID:PID[:Serial]
  • speed：调试速率 kHz
  • connect_under_reset：连接时是否保持 reset

参数优先级：CLI 参数 > 工程配置（.embeddedskills/config.json）> state.json > skill 配置（config.json）> 默认值

各层职责：skill config.json 提供工具路径与端口等环境级常量；.embeddedskills/config.json 提供芯片、协议等工程级参数；CLI 参数在单次调用中覆盖一切。

子命令

子命令用途风险
list枚举可用探针低
info查看探针与目标信息低
flash烧录固件（elf/hex/bin/uf2）高
erase擦除芯片非易失存储高
reset复位目标芯片高
read-mem读取内存低
write-mem写内存高
attach / run包装 probe-rs attach/run低
gdb启动 GDB Server 并执行 one-shot 调试低
rtt读取 RTT 日志低

典型调用

# 列出探针
py -3 <skill-dir>/scripts/probe_rs_exec.py list --json

# 烧录 ELF
py -3 <skill-dir>/scripts/probe_rs_exec.py flash --chip STM32F407VGTx --file build/app.elf --json

# 烧录 BIN（必须提供地址）
py -3 <skill-dir>/scripts/probe_rs_exec.py flash --chip STM32F407VGTx --file build/app.bin --address 0x08000000 --json

# 读取内存
py -3 <skill-dir>/scripts/probe_rs_exec.py read-mem --chip STM32F407VGTx --address 0x20000000 --length 16 --width b32 --json

# one-shot backtrace
py -3 <skill-dir>/scripts/probe_rs_gdb.py backtrace --chip STM32F407VGTx --elf build/app.elf --json

# RTT
py -3 <skill-dir>/scripts/probe_rs_rtt.py --chip STM32F407VGTx --json

核心规则

  • 不自动猜测 chip，缺失时直接报错
  • 多探针场景建议显式提供 --probe；若未检测到任何探针，应提示用户检查 USB 连接并重试；若探针配置错误（如 VID:PID 不匹配），应报告具体错误信息并建议运行 list 子命令确认可用探针
  • .bin 烧录必须显式提供地址
  • workflow build-debug 只走 one-shot 诊断包装，不启动需要人工接管的长期 DAP 会话
  • Windows 下若要用 probe-rs 驱动 J-Link，通常需要切换到 WinUSB，这会影响 SEGGER 官方工具继续使用；若仍依赖 J-Link 官方工具链，优先继续用现有 jlink skill

Comments

Markdown supported