1 个不稳定版本

0.1.3 2024年1月13日
0.1.2 2023年12月1日
0.1.1 2023年9月25日
0.1.0 2023年9月18日

#183 in 硬件支持

每月 49 次下载

MIT/Apache

115KB
2K SLoC

Discord

用于运行Black Magic Debug固件的调试器的管理工具。

该项目目前仍处于早期阶段,正在积极开发中。

此工具目前可用于更新您的Black Magic Probe上的Black Magic Debug固件。

安装

Linux、Mac (arm64/AArch64) 和 Windows (arm64/AArch64) 的二进制发布版现在与每个发布一起提供。这些应该可以即插即用,不需要手动安装Windows Driver Kit 8.0或Rust。

或者,您可以直接使用 cargo 从 crates.io 安装。

首先在您的计算机上安装 Rust。请遵循Rust 语言网站上的说明。

然后,使用以下命令安装 bmputil:cargo install bmputil

Windows上的 bmputil 将在首次运行时尝试自动设置驱动程序安装。这是额外的实验性功能,首次运行需要管理员权限。

从源代码构建

或者,您可以从源代码构建和安装此工具。这假设您已经安装了 Rust(以及 git 等)。

git clone https://github.com/blackmagic-debug/bmputil.git
cd bmputil
cargo install --path .

如果您正在为工具开发补丁或贡献,您显然可以使用 cargo buildcargo run [params] 如所需。

Windows

为了在Windows平台上本地构建bmputil(无论是在Windows上还是交叉编译),您需要安装Windows Driver Kit 8.0 redistributable components(链接来自此页面)。如果您正在交叉编译到Windows,您需要将环境变量WDK_DIR设置为解压缩的WDK redistributable components的路径。

功能

此工具的第一个目标是作为更符合人体工程学的、针对BMP DFU程序员的专用工具。此实用程序旨在取代dfu-util和stm32_mem.py脚本的必要性。我们可以利用我们只需要支持特定的目标和DFU实现这一事实,以提供更好的用户体验。此外,我们可以最终提供自动固件更新/升级命令,因为我们知道在哪里查找BMP固件的位置。甚至更进一步,最终提供BMP特定的配置功能。

已实现

  • 查找并检测连接到系统的Black Magic Probe (BMP)调试器。
  • 检查连接的BMP的固件类型和版本。
  • 使用DFU协议在连接到系统的BMP上刷写固件。

计划

  • 搜索新的固件版本。
  • 提供自动升级到最新命令。
  • 配置BMP固件默认设置。(将需要固件对永久设置的支撑)
  • 还有很多... :)

获取帮助

1BitSquared discord服务器的#blackmagic频道中讨论此项目。

依赖关系

~11–23MB
~338K SLoC