Skip to content
This repository was archived by the owner on Feb 21, 2026. It is now read-only.

Release Candidate v1.0.0-rc.2

Pre-release
Pre-release

Choose a tag to compare

View all tags
@dragonmux dragonmux released this 04 Jul 14:58
· 74 commits to main since this release
v1.0.0-rc.2
This tag was signed with the committer’s verified signature.
dragonmux Rachel Mant
GPG key ID: 64861EA89B35507A
Verified
Learn about vigilant mode.
66b6acc
This commit was signed with the committer’s verified signature.
dragonmux Rachel Mant
GPG key ID: 64861EA89B35507A
Verified
Learn about vigilant mode.

We are happy to announce the second v1.0.0 release candidate of the Black Magic Probe Utility.

This is the first full release of the tool, and comes with pre-built binaries available in the release assets below.

Usage

The tool is self contained in a single binary file. All you need to do is download the zip/archive file, decompress it, and run the bmputil-cli from the command line of your operating system. Running the program without any parameters will provide usage help.

Alternatively you can install bmputil from source using cargo install bmputil@v1.0.0-rc.2. An up-to-date installation of Rust via rustup is required.

bmputil-cli does not offer a graphical UI at this time, and needs to be run from the command line interface.

For more information about the usage refer to our website: https://black-magic.org/upgrade.html

CLI API improvements

In this release we introduce a big CLI API change. Most existing functions are moved into probe namespace, and we reserve additional target, server, debug namespaces for future use. We reserve those namespaces so that we don't have to fully break the CLI API right after releasing V1.0 of the tool, as adding new functionality will not break semver rules.

While we were changing the API the function of probe update and probe switch have changed slightly.

probe update is now automatically checking the active firmware version on the attached Black Magic Probe and executes an update if there is a new version available. It can still flash an arbitrary firmware binary by passing the firmware file name to the command. It also can update to a release candidate of the firmware by providing a --use-rc override, and an update can be forced with --force even if the tool considers the probe as being fully up to date.

The probe switch command now only functions as a firmware variant selector. firmware variants are being introduced in Black Magic Firmware V2.0 series allowing the partitioning of firmware functionality to work around the flash size limitation of the Black Magic Probe hardware.

Following is a screenshot of the tool called without any parameters to illustrate what namespaces mean.
Screenshot 2025-07-04 at 10 36 38 AM

In this release

  • Fixed a spurious STALL error being emitted under Linux by the utility when it should be suppressed [dragonmux]
    • The STALL condition is real, but also not erroneous so should not prevent forward progress from the tool
  • Overhauled the project's README and updated it to more accurate reflect what tool does and is [dragonmux]
  • Fixed a spurious disconnect error being emitted under Windows by the utility [dragonmux]
    • The STALL condition is real, but also not erroneous so should not prevent forward progress from the tool
  • Fixed the parsing of the firmware's identity string as it was breaking the string down slightly incorrectly [P-Storm]
  • Restructured the tool's CLI, converting the style of the parser and moving commands around for better consistency and structure [dragonmux]
  • Fixed several clippy lints and the code base formatting using rustfmt nightly [dragonmux/lethalbit]
  • Implemented handling for probe info --list-targets and introduced BMD remote serial protocol support
  • Implemented better probe update control, allowing a user to force a firmware change and ask the tool to consider using RC's as well as full releases [dragonmux]
  • Implemented better upgrade diagnostics following on from the better probe update controls [dragonmux]
  • Fixed an issue with product string parsing on bootloader strings, resulting in errors/crashes in those cases [dragonmux]
  • Moved the suppressions to a more suitable layer and applied them + fixed reboot behaviour across all places DFU_DETACH can be generated [dragonmux]

Contributors to v1.0.0-rc.2

We have had 2 individuals contribute 148 commits since the v1.0.0-rc.1 release candidate.

Contributor (Contributions)
dragonmux (142)
P-Storm (6)

Sponsors

This project is sponsored in parts by:

  • 1BitSquared - Design, Manufacture and distribution of open source embedded hardware development tools and platforms, as well as educational electronics. Thank you everyone who buys Black Magic Probes from 1BitSquared directly through our stores or indirectly through Adafruit. The hardware sales allow us to continue supporting the Black Magic Debug project.
  • All the generous Patrons and GitHub Sponsors supporting esden’s work
  • All the generous GitHub Sponsors supporting dragonmux’s work
Assets 6
Loading