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）

为了展示功能，编写了一个小的CLI。用

cargo run -p cli -- help

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

要使用跟踪器，请

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

当前的管道接口是二进制的。

以下是如果一切正确且跟踪一个具有变化值的内存位置时的样子

路线图

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

常见问题解答

我需要帮助！

请不要犹豫，通过 提交问题，在 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许可证的定义，将双重许可如上所述，没有任何附加条款或条件。