Probe Rs

zhinkgit/embeddedskills/probe-rs

by zhinkgit536c1f929e359a5c02ef8ea9f1a20691e8d764e3No licenseListed Oct 9, 2026Updated Oct 9, 2026

probe-rs 下载与调试工具,用于探针发现、固件烧录、复位、内存读写、GDB Server 调试和 RTT 日志读取。 当用户提到 probe-rs、cargo-embed、DAP、RTT、CMSIS-DAP、ST-Link、J-Link、烧录、芯片信息、 连接 under reset、probe 选择器、probe-rs gdb、probe-rs attach 时自动触发,也兼容 /probe-rs 显式调用。 即使用户只是说"用 probe-rs 烧进去"、"看看 RTT"或"拉个 backtrace",只要上下文明确提到 probe-rs 的功能、CLI 命令或相关术语(如 cargo-embed、RTT、probe-rs flash)时就应触发此 skill。

Includes scriptsSoftware Development
AI-generated overview

Wraps the probe-rs CLI for embedded probe discovery, firmware flashing, memory access, GDB debugging and RTT log reading.

What it does
Provides a structured wrapper around the probe-rs command line tool, covering probe enumeration, target info, firmware flashing (elf/hex/bin/uf2), erase, reset, memory read and write, one-shot GDB debugging and RTT log capture. It ships Python scripts for execution, GDB and RTT, plus layered configuration for tool paths, ports and project parameters such as chip, protocol, probe selector and speed. Commands return JSON output and risky operations are flagged by risk level.
When to use it
Use it when working with probe-rs, cargo-embed, DAP, RTT, CMSIS-DAP, ST-Link or J-Link, or when flashing firmware, reading chip info, connecting under reset, selecting a probe, or pulling a backtrace from an embedded target.
Requirements
Requires the probe-rs CLI on the system, Python 3 (py -3 on Windows) to run the bundled scripts, and arm-none-eabi-gdb for the gdb subcommand. A skill-level config.json and a project-level .embeddedskills/config.json supply executable paths, ports, chip, protocol, probe selector and speed; a chip value must be supplied explicitly. Physical probe hardware and USB access are needed.

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:

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)

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 日志低

典型调用

bash
# 列出探针py -3 <skill-dir>/scripts/probe_rs_exec.py list --json
# 烧录 ELFpy -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 backtracepy -3 <skill-dir>/scripts/probe_rs_gdb.py backtrace --chip STM32F407VGTx --elf build/app.elf --json
# RTTpy -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

Source and attribution

Source:zhinkgit/embeddedskillsinprobe-rsat commit536c1f9

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal