Skip to content

Upgrading Firmware

Piotr Esden-Tempski edited this page Jul 4, 2022 · 23 revisions

WARNING: The content of this wiki has been moved to http://black-magic.org website. Please update your links.

We still welcome and encourage contributions to the Black Magic Probe documentation through the website repository.

Native Hardware

If you have a BMP firmware Black Magic Probes with BMP bootloader, preferred process to upgrade the firmware is by using the python3 script stm32-mem like

cd blackmagic && scripts/stm32_mem.py blackmagic.bin

For firmware BMPs with BMP bootloader or as fallback, dfu-utils can be used. Some v0.10 on windows misbehaves, use recent git, v0.9 or v0.11 when released.

Linux / MacOS

DFU-Util

Download or compile a Black Magic Probe (BMP) firmware. Regarding firmware selection:

  • As of this writing, the latest stable release is 1.7.1, check this page for updates.
  • The 1.6.1 release is quite old and does not support all targets. It also has subtle issues that can be confusing, e.g. on certain ARM chips if you modify data in memory while execution is stopped and then continue execution, the old data will be effective, since the necessary commands to flush the cache are not in the 1.6.1 stable release.
  • Use the daily build at this link, which is current at the time of writing. To check if it is still current, download the file blackmagic-native.bin and run the command strings blackmagic-native.bin |grep "Black Magic Probe" on it to see the corresponding git commit hash.
  • If you use the daily build, expect that there could be issues, and please report any issues here so that they can be fixed.

Plug in the Black Magic Probe into your computer and run the following command:

sudo dfu-util -d 1d50:6018,:6017 -s 0x08002000:leave -D blackmagic-native.bin

You will need to install dfu-util package. On MacOS you can use homebrew, macports or fink depending on your preferred package manager. You will need version 0.8.0 or greater to support the dfuse commands.

If this does not manage to switch your BMP into bootloader mode you can also plug in your BMP while holding down the button. This will force the BMP to stay in the bootloader on power up.

Windows

DFU-Util

Download or compile a Black Magic Probe (BMP) firmware.

Plug in the Black Magic Probe into your computer and run the following command:

dfu-util.exe -d 1d50:6018,:6017 -s 0x08002000:leave -D blackmagic.bin

You will need to download the Windows release of dfu-util package.

You may need use Zadig to install the WinUSB driver. Both PID 0x6017 and 0x6018 need to be known to Zadig.

Note: On first run Zadig may not see the 6017 PID. Once the dfu exe runs and detaches the device, it should appear in Zadig. Install the WinUSB driver on it and re-run the dfu exe.

Built-in Upgrade tool

Instructions for Linux in hacking section

NOTICE: The content of this wiki has been moved to http://black-magic.org website. Please update your links.

Clone this wiki locally