probe-rs

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

Audit 0.4.1 · source sha 674ae8bca880 · 27 Oct 2026Report an issue or request a re-scan

• Publisherzhinkgit GitHub userOwner of the repository this skill is read from
• Source folderzhinkgit/embeddedskills/probe-rsThe exact folder we audited
• LicenceMITAs the repository states it
• Commit pinned for this verdict674ae8bca880A new audit runs when the source changes
• Repository statusNot archivedLast push 7 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: 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 显式调用。…

---
name: probe-rs
description: >-
  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。
argument-hint: "[list|info|flash|erase|reset|read-mem|write-mem|attach|run|gdb|rtt] ..."
---

# 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

# 烧录 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

Excerpt, first 3,065 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

git clone https://github.com/zhinkgit/embeddedskills
git -C embeddedskills checkout 674ae8bca880

Works in

1. 2026-10-27
   ✓SAFE B 89 / 100

   first audit · source 674ae8bca880

Questions about probe-rs

• github.com/zhinkgit/embeddedskills/tree/main/probe-rs — the audited source at commit 674ae8bca880 and every finding aboveObserved · 27 Oct 2026

Spotted something wrong? Report a correction · Methodology