Skip to content
In application debugger for ARM Cortex microcontrollers.
Branch: master
Clone or download
Pull request Compare This branch is 1 commit ahead, 819 commits behind blacksphere:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
libopencm3 @ 20bfcae


The Black Magic Debug Project -- README

The Black Magic Debug Probe is gadget providing an in-application
debug capability for ARM Cortex-M3 and Cortex-M0 microcontrollers.  It
interfaces with the GDB, the GNU source level debugger over the USB
bus, and communicates with the target microcontroller over either a
JTAG or Serial Wire debug port.

Currently supported microcontrollers:

 - ST STM32 Family
 - TI/LMI Stellaris Family
 - NXP LPC11xx Family

Getting started
The Black Magic Probe is available as a built-up product form Black
Sphere Technologies.  Contact <> should
you wish to order one.  If you would like to work on the project see
the file HACKING for developer's info.

When connected via USB, the Black Magic probe will enumerate as a CDC-ACM
device which the OS should present as a tty device or serial port.  The
GDB remote debugging protocol is implemented over this virtual character
stream.  To connect your ARM GDB to the target device use the following

(gdb) target extended-remote /dev/ttyACM0
(gdb) mon jtag_scan
(gdb) attach 1

The command 'mon swdp_scan' may be used to use the Serial-Wire Debug Protocol
instead of JTAG to connect to the target.

Once attached, all the standard GDB commands may be used to start and control
the execution of the embedded application.

The peripheral registers are not included in the memory map provided to GDB.
I suggest you add the command "set mem inaccessible-by-default off' to
your '.gdbinit'.  That will allow you to access addresses outside of
the memory map.  It will treat anything outside of the memory map as

Project layout
flashstub/ - Source code for flash programming stubs in target drivers.
hardware/ - Schematic (gschem) and PCB layout for the Black Magic Probe
scripts/ - Python scripts useful for programming devices.
src/ - Firmware source code for the Black Magic debug probe.

You can’t perform that action at this time.