Go to file
Uwe Bonnes 04624af4e5 f4discovery: Adapt from the "native" file and add or change code where needed
- stm32_mem.py has problems with erasing the big pages, but dfu-util works
- serial GDB remote server doesn't work. It neither works for the STM32F107,
  so maybe there is a problem with the usbd_f107_driver.
2013-01-21 11:02:44 +01:00
driver Update Windows drivers to use new USB IDs. 2012-05-26 15:33:16 +12:00
flashstub Added support for STM32F0. 2012-10-24 18:08:01 +02:00
hardware Added a Makefile for generation of some hardware outputs. 2012-04-12 18:47:30 +12:00
libopencm3@20bfcaeb1c Update to current libopencm3 usb api. 2013-01-10 22:01:21 -08:00
scripts stm32_mem.py: Add exception handler for better diagnosis, as erase on STM32F407 times out 2013-01-21 11:02:44 +01:00
src f4discovery: Adapt from the "native" file and add or change code where needed 2013-01-21 11:02:44 +01:00
upgrade Corrected upgrade tool to use our new usb ids. 2012-07-27 21:59:03 +12:00
.gitignore More Files to ignore 2013-01-21 11:02:43 +01:00
.gitmodules Changed libopencm3 url to https. 2012-10-24 07:34:30 +13:00
COPYING Added README and COPYING 2011-02-07 11:01:10 +13:00
HACKING Add explanation how toi fill the libopencm3 directory 2013-01-21 11:02:43 +01:00
Makefile Add toplevel Makefile to build blackmagic with libopencm3. 2012-10-22 18:50:06 +13:00
README Add note that schematic is created in gschem. 2012-01-27 19:17:15 -05:00

README

=======================================
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 <sales@blacksphere.co.nz> 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
commands:

(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.


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.