Skip to content
SPECIFICTION
Get listed

Black Magic Debug

black-magic.org

Free plan WindowsmacOSLinux
Visit black-magic.org
Spec score 8.7 #1 of 27 in Debuggers

What it is

Black Magic Debug is a free JTAG/SWD debugger for embedded microcontrollers, aimed at professional developers who want control over build systems and testing environments. Its firmware includes a GDB server that detects targets automatically, without target-specific configuration scripts. Debugging tools include watchpoints, flash memory breakpoints, memory and register examination, and flash programming. The project describes support for ARM Cortex-M and Cortex-A microcontrollers; its listed target platforms also include RISC-V, and remote debugging is supported. The probe connects as a standard USB CDC ACM virtual serial device, with no special driver needed for this interface on Linux or macOS. The debugger works with Linux, macOS, and Windows. The GDB server also supports semihosting and host I/O, Serial Wire Output, and USB DFU firmware upgrades. Documentation includes guides for PlatformIO and STM32CubeIDE. It can also be compiled as a desktop application and used with BMP, ST-Link, FTDI-MPSSE, SEGGER J-Link, or CMSIS-DAP adapters. Desktop-app programming is a little slower, though BMP development may be faster because firmware upload is unnecessary. Getting started requires a Black Magic Probe and a suitable target toolchain.

Spec sheet

Purpose
Black Magic Debug is a mostly plug-and-play JTAG/SWD debugger for embedded microcontrollers.Read 8 Oct 2026 · black-magic.org
Intended users
The project focuses on professional embedded software developers who want control over their build systems and testing environments.Read 8 Oct 2026 · black-magic.org
Integrations
The documentation includes usage guides for PlatformIO and STM32CubeIDE.Read 8 Oct 2026 · black-magic.org
Support
The project documentation points users to a Discord channel and mailing list, and the home page invites users to contact the project with questions or suggestions.Read 8 Oct 2026 · black-magic.org
Additional capabilities
The GDB server supports semihosting/host I/O, Serial Wire Output, and USB DFU firmware upgrades.Read 8 Oct 2026 · black-magic.org
Additional features
The project lists Semihosting/Host IO, Serial Wire Output support, and USB DFU firmware upgrades.Read 8 Oct 2026 · black-magic.org
Compatibility limit
The documentation says programming speed is a little slower when using the desktop app, though BMP development may be faster because no firmware upload is needed.Read 8 Oct 2026 · black-magic.org
Debug features
It supports watchpoints, flash memory breakpoints, memory and register examination, and flash programming.Read 8 Oct 2026 · black-magic.org
Debugging features
It supports watchpoints, flash memory breakpoints, memory and register examination, and flash programming.Read 8 Oct 2026 · black-magic.org
GDB server
Black Magic Debug firmware implements a GDB server that supports automatic target detection and does not require target-specific configuration scripts.Read 8 Oct 2026 · black-magic.org
Hardware requirement
Getting started says users need a Black Magic Probe and a suitable toolchain for the target processor.Read 8 Oct 2026 · black-magic.org
Hardware status
The supported-hardware page marks Black Magic Probe V2.3 active and several older probe models as legacy and not in production.Read 8 Oct 2026 · black-magic.org
Host support
The debugger works with Windows, Linux, and Mac environments.Read 8 Oct 2026 · black-magic.org
Security and trust
The project describes Black Magic Probe as open source, saying users can inspect it, and its FAQ says automatically built firmware images are available for official hardware.Read 8 Oct 2026 · black-magic.org
Standalone app
The project can be compiled as a desktop application and can use BMP, ST-Link, FTDI-MPSSE, SEGGER J-Link, and CMSIS-DAP adapters.Read 8 Oct 2026 · black-magic.org
Standalone app limitation
The site says programming is a little slower in the standalone app mode, though BMP development may be faster because firmware upload is not needed.Read 8 Oct 2026 · black-magic.org
Supported environments
The project states that it works with Windows, Linux, and Mac environments.Read 8 Oct 2026 · black-magic.org
Supported processors
The project describes support for ARM Cortex-M and Cortex-A based microcontrollers.Read 8 Oct 2026 · black-magic.org
Target detection
The GDB server provides automatic target detection and does not require target-specific configuration scripts.Read 8 Oct 2026 · black-magic.org
Targets
The site says the debugger targets ARM Cortex-M and Cortex-A microcontrollers.Read 8 Oct 2026 · black-magic.org
USB interface
The probe connects to the host as a standard USB CDC ACM virtual serial device, which the site says needs no special drivers on Linux or macOS.Read 8 Oct 2026 · black-magic.org

Plans and prices

Black Magic Debug software Free JTAG/SWD debugger for embedded microcontrollers · requires compatible probe hardware and a suitable toolchain Read 8 Oct 2026 · black-magic.org

Every Black Magic Debug plan and price →

Strong points and limits

Strong points

  • Automatic target detection without configuration scripts
  • Includes watchpoints and flash programming
  • Supports remote debugging
  • Works on Linux, macOS, and Windows

Limits

  • Requires a Black Magic Probe and suitable toolchain
  • Desktop-app programming is a little slower

Who it suits

It suits embedded developers working with supported microcontrollers who want GDB-based debugging and control of their development setup. Users need a Black Magic Probe and a suitable toolchain; the desktop application also supports several other adapters.

Black Magic Debug in depth

Read the full write-up

Black Magic Debug is a free JTAG/SWD debugger for embedded microcontrollers. It suits professional developers who want to control their own build and test environments, provided they have a compatible probe and a suitable toolchain. Its integrated GDB server and broad debugging functions are compelling; the hardware requirement is the main barrier to getting started.

Overview

The firmware provides a GDB server with automatic target detection, so supported targets do not need target-specific configuration scripts. That can simplify setup without taking control of the build system away from developers. Remote debugging is supported, and the target list includes ARM Cortex-M, ARM Cortex-A, and RISC-V.

The probe connects to a host as a standard USB CDC ACM virtual serial device, with no special driver required on Linux or macOS. Windows, Linux, and macOS are supported host environments. Black Magic Probe V2.3 is active, while several older models are legacy and no longer in production; hardware availability and status matter when choosing a probe.

Key features

Watchpoints, flash memory breakpoints, and memory and register examination cover the core tasks of inspecting state and tracing faults. Flash programming adds a firmware workflow to the same setup. Semihosting/host I/O and Serial Wire Output support target output, while USB DFU firmware upgrades provide a way to update probe firmware.

Documentation includes usage guides for PlatformIO and STM32CubeIDE, useful starting points for developers working in either environment. The project also offers a desktop-app build that can use BMP, ST-Link, FTDI-MPSSE, SEGGER J-Link, and CMSIS-DAP adapters. That flexibility may suit BMP development, since firmware upload is not needed, but programming is a little slower in this mode.

Pricing

Black Magic Debug software is free: free. There are no paid tiers to weigh, but the software requires compatible probe hardware and a suitable target toolchain, so free software does not mean a hardware-free setup.

Platforms

The host software works on Windows, Linux, and macOS. Linux and macOS users can connect the standard probe without special drivers. The supported target families are ARM Cortex-M, ARM Cortex-A, and RISC-V; these are processor targets, not additional host platforms.

Who it's for

This is a strong fit for professional embedded developers who want direct control of their build systems and testing environments, and who work with supported microcontrollers. Automatic target detection and the range of inspection and programming functions make it practical as an embedded debugging setup. It is less suitable for someone seeking a software-only debugger or a turnkey setup without first sourcing compatible hardware and a toolchain.

The project describes Black Magic Probe as open source, so users can inspect it, and its FAQ says automatically built firmware images are available for official hardware. Documentation aims to cover getting started with microcontroller development and debugging; users with questions or suggestions are invited to join the project chat.

Pros and cons

Pro: Automatic target detection avoids target-specific configuration scripts, reducing setup work for supported targets.

Pro: Watchpoints, flash breakpoints, memory and register inspection, and flash programming cover both diagnosis and firmware workflows.

Pro: Linux and macOS need no special drivers for the standard USB CDC ACM connection.

Con: A compatible probe and suitable target toolchain are required, adding prerequisites beyond installing the software.

Con: Programming is a little slower in desktop-app mode, which matters for users choosing that mode for adapter flexibility.

Con: Several older probe models are legacy and no longer in production, narrowing the appeal of building around older hardware.

Alternatives

For other options, browse Debuggers. Choose GDB if you want a free, source-available debugger under the GNU General Public License; choose LLDB for a free debugger with listed support across Android, iOS, Linux, macOS, and Windows. pyOCD is another free open-source project under Apache 2.0.

PonyDebugger is a free Apache License 2.0 option with an iOS client and gateway server. Perl Debugger is included with Perl, but requires the program to compile correctly before debugging. FlowStorm is free and open source, with no money involved.

IDA Pro offers a free tier for x86-32 and x86-64 disassembly with two cloud-based decompilers and a named license; its paid Essential plan is 1099.00 USD. Erlang Debugger is a free option for Linux, macOS, and Windows.

Verdict

Choose Black Magic Debug if you are an embedded developer working with its target families and want automatic target detection alongside a substantial set of debugging and programming functions. Its free software and driver-light Linux/macOS connection are strong advantages, but you still need compatible probe hardware and a target toolchain; look elsewhere if those prerequisites or the desktop app's slower programming are a poor fit.

Verdict

Black Magic Debug combines automatic target detection with a wide set of debugging functions and support for several host environments. Check the hardware and toolchain requirements first, and account for slower programming in desktop-app mode.

Where Specifiction places it

Alternatives to Black Magic DebugAll alternatives →