probe-rs

为在独立主机上调试ARM核心而设计的调试工具集和库。

动机

该库的目标是提供一个工具集，以与各种嵌入式MCU和调试探针交互。首先，将支持ARM核心，使用CoreSight协议。如果有高需求并有更多贡献者，打算添加对其他架构的支持。

类似的项目，如OpenOCD、PyOCD、Segger Toolset、ST Tooling等。它们都实现了GDB协议及其之上的自定义协议，以使GDB能够与调试探针通信。这并非标准化，有时也有些不稳定。每个工具的命令都不同，等等。

本项目移除了GDB层，并提供了一个直接与调试探针交互的接口，从而使其他软件，例如VisualStudio能够使用其调试功能。

更重要的是，我们可以充分利用CoreSight。我们可以实时跟踪和修改内存以及寄存器。

最终目标是创建一个完整的库工具集，以使其他工具能够使用CoreSight的功能。

功能

该库可以连接到DAPLink并正确地读取和写入内存。它可以读取ROM表并提取CoreSight组件信息。写入整个十六进制文件已经完成了一半。该库还可以连接到ST-Link，附加到STM32F429（它应该能够连接到任何目标；这个只是用于测试）并读取DAP寄存器。由于某些STLink问题，读取ROM表存在错误，但可能最终会得到修复。

开发重点在于为DAPLink实现完整的（CoreSight、烧录、调试）功能，然后从这里开始。

命令行界面

为了展示功能，编写了一个小的命令行界面（CLI）。通过以下命令启动它：

cargo run -p cli -- help

帮助对话框应该会告诉你如何使用CLI。

要使用tracer fire

cargo run -p cli -- trace <n> <address> | python3 cli/update_plot.py

目前，管道接口是二进制的。

如果你正确执行所有操作并追踪一个值变化的内存位置，它会看起来像这样

路线图

• v0.1.0
  • Cortex m0, m3, m4的基本调试。
    • 单步执行
    • 停止
    • 断点
    • 运行
  • 基本的VSCode插件
    • 单步执行
    • 停止
    • 断点
    • 运行
    • 变量检查
      • 结构体
      • 枚举
      • 基本类型
    • 堆栈帧
  • 基本的CLI
    • 单步执行
    • 停止
    • 断点
    • 运行
• 闪存下载器。
• 半托管。
• 追踪。
• SWD文件支持。

常见问题解答（FAQ）

我需要帮助！

请不要犹豫，通过 提交问题，在 irc 上提问，或者通过电子邮件联系 @Yatekii。

我能提供什么帮助？

请查看问题或如果你觉得需要，请打开一个问题。

任何贡献都非常受欢迎！

还可以查看 CONTRIBUTING.md。

许可证

以下任一许可证下授权：

• Apache License, Version 2.0 (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)
• MIT许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)，任选其一。

贡献

除非你明确表示否则，根据Apache-2.0许可证定义的，你故意提交的任何贡献，都应如上所述双重许可，不附加任何额外的条款或条件。