Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Clone this wiki locally
The Black Magic Probe is a modern, in-application debugging tool for embedded microprocessors. It allows you see what is going on 'inside' an application running on an embedded microprocessor while it executes. It is able to control and examine the state of the target microprocessor using a JTAG or Serial Wire Debugging (SWD) port and on-chip debug logic provided by the microprocessor. The probe connects to a host computer using a standard USB interface. The user is able to control exactly what happens using the GNU source level debugging software, GDB.
- Targets ARM Cortex-M and Cortex-A based microcontrollers.
- Connects to the target processor using the JTAG or Serial Wire Debug (SWD) interface.
- Provides full debugging functionality, including: watchpoints, flash memory breakpoints, memory and register examination, flash memory programming, etc.
- Semihosting / Host IO support as well as Serial Wire Debug TRACESWO support.
- Interface to the host computer is a standard USB CDC ACM device (virtual serial port), which does not require special drivers on Linux or OS X.
- Implements the GDB extended remote debugging protocol for seamless integration with the GNU debugger and other GNU development tools.
- Implements USB DFU class for easy firmware upgrade as updates become available.
- Works with Windows, Linux and Mac environments.
The Black Magic Probe allows you to:
- Load your application into the target Flash memory or RAM.
- Single step through your program.
- Run your program in real-time and halt on demand.
- Examine and modify CPU registers and memory.
- Obtain a call stack backtrace.
- Set up to 6 hardware assisted breakpoints.
- Set up to 4 hardware assisted read, write or access watchpoints.
- Set unlimited software breakpoints when executing your application from RAM.
The Black Magic Probe firmware supports a large selection of host hardware. You can find an in depth description of supported Debugger-Hardware on its own wiki page. There is also "native" hardware which you can buy from a few vendors, and it was specifically designed with Black Magic Probe in mind.
The official Black Magic Probe hardware is available from these distributors in alphabetical order:
- DE: 1BitSquared Germany Black Magic Probe V2.1 (Newest)
- NZ / AU: Greenstage Black Magic Probe V1.0
- USA: 1BitSquared US Black Magic Probe V2.1 (Newest)
- USA: Hackerwarehouse Black Magic Probe V2.1 (Newest)
- USA: Tag-Connect Black Magic Probe V1.0
By buying the official hardware you are supporting the continued development of the Black Magic Probe software. Thank you! :)
- If you have questions or suggestions feel free to join us on
- There is also a mailinglist