Skip to content

A tool for flashing Black Magic Probe firmware

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE
MIT
LICENSE-MIT
Notifications You must be signed in to change notification settings

blackmagic-debug/bmputil

Folders and files

NameName
Last commit message
Last commit date
Aug 1, 2022
Aug 25, 2023
Aug 1, 2022
May 31, 2022
Aug 25, 2023
Sep 18, 2023
Jan 17, 2023
Jan 17, 2023
Oct 24, 2022
Jan 17, 2023
May 3, 2022

Repository files navigation

Discord

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.

About

A tool for flashing Black Magic Probe firmware

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Languages