A management utility for debuggers running the Black Magic Debug firmware.

This project is currently still in early stages and under heavy development.

This tool can currently be used to update the Black Magic Debug firmware on your Black Magic Probe.

Installation

First install Rust on your computer. Follow the instructions on the Rust Lang website.

Now you can build and install the tool from source.

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

If you are working on patches or contributions to the tool, you can obviously use cargo build and cargo run [params] as needed.

Note: This tool is not yet listed on crates.io. So unfortunately you can't install it using cargo directly yet. Note: We don't currently have pre-built binaries/installers available. But they are planned.

Windows

Installation is done with the above instructions, with one additional prerequisite. You will need to install the Windows Driver Kit 8.0 redistributable components (link from this page). If you are cross compiling to Windows, you will need to set the WDK_DIR environment variable to the path of the extracted WDK redistributable components.

bmputil on Windows will also attempt to automatically setup driver installation on first run. This is extra experimental, and will require administrator access on the first run.

Features

The first goal of this tool is to serve as a more ergonomic, dedicated to BMP DFU programmer. This utility is meant to replace the need for dfu-util and stm32_mem.py script. We can take advantage of the fact that we only have to support a specific target and DFU implementation to make for a nicer user experience. Additionally we can eventually provide automatic firmware update/upgrade commands as we know the location where to look for BMP firmwares. And even further, eventually, provide BMP specific configuration functions.

Currently implemented:

• Find and detect Black Magic Probe (BMP) debuggers connected to the system.
• Check firmware type and version on the attached BMPs.
• Flash Firmware using the DFU protocol onto the BMPs connected to the system.

Planned:

• Search for new firmware releases.
• Provide automated upgrade to newest command.
• Configure BMP firmware defaults. (will require firmware support for permanent settings)
• And many more... :)

Getting Help

Discuss this project in the #blackmagic channel on the 1BitSquared discord server.