Difference between revisions of "Debug Probes"

From PaparazziUAV
Jump to navigation Jump to search
Line 1: Line 1:
__TOC__
__TOC__


These various programming adapters and probes can be used for flashing, debugging and some also as serial adapters. <br/>
These various programming adapters can be used for flashing and debugging Paparazzi hardware, some can even as USB-UART adapters. <br/>
Most are compatible with the currently used STM32 platform, some also with the older LPC 21xx.
 
Programming adapters for Atmel/AVR and SiLabs (ESC Controller chips) are located on the [[ESC]] page since those Microcontrollers are note more used as main processors.
 
==Debug Protocols / Interfaces==
 
There are two different relevant Protocolls / Interfaces  for flashing and debugging for STM32:<br/>


==Protocol / Interface==
Note: Some STM32 MCUs can also be flashed via Serial and or USB DFU! But SWD and JTAG provide (much better) debugging capabilities.


There are two different relevant Protocolls / Interfaces for STM32:
===SWD===
===SWD===
===JTAG===


Recently some new [[JTAG]] adapters that use the FTDI2232 USB-parallel converter were introduced through OpenOCD. USB JTAG adapters include Floss-JTAG, Olimex or Amontec and also fine with Windows (Yagarto).
[http://www.arm.com/products/system-ip/debug-trace/coresight-soc-components/serial-wire-debug.php ARM Serial Wire Debug (SWD)] is a program and debug protocol for ARM processors. It's a low pin count and high-performance alternative and replacement to JTAG.


===JTAG===


JTAG is a industry standard on-chip debugging protocoll. It can be used for one or more chips (daisy chained), for interfacing with the chip as well as flashing software.


A JTAG interface is designed for on-chip debugging. It can also be used to flash your firmware if you do not have a means to upload software via USB already. For short, if you want to upload your own software or want to do serious paparazzi development work, the you need a JTAG adapter like this.
[[DevGuide/OpenOCD]] can be used for interfacing with JTAG hardware (e.g. FTDI chips).
 
See also:
* [[FirmwareFlashing#JTAG|firmware flashing via JTAG]]
* [[DevGuide/OpenOCD]] for installation and configuration instructions


==[[CricketProbe/v1.00 | CricketProbe v1.00]]==
==[[CricketProbe/v1.00 | CricketProbe v1.00]]==
Line 41: Line 45:
[https://github.com/molnarkares/blackmagic/tree/master/hardware/contrib/lyorak molnarkares/blackmagic git repo (fork from blackmagic)]
[https://github.com/molnarkares/blackmagic/tree/master/hardware/contrib/lyorak molnarkares/blackmagic git repo (fork from blackmagic)]


== Black Magic Probe==
=Black Magic Probe=


[[Image:BMPM_1_top.jpg|300px|Black Magic Probe]]
[[Image:BMPM_1_top.jpg|300px|Black Magic Probe]]
Line 53: Line 57:


[https://github.com/blacksphere/blackmagic blacksphere/blackmagic git repo]
[https://github.com/blacksphere/blackmagic blacksphere/blackmagic git repo]
[http://www.blacksphere.co.nz/main/index.php/blackmagic]
[http://1bitsquared.com/collections/supporting-hardware/products/black-magic-probe Buy at 1bitsquared for 65$]


 
=[[STLink]]=
==[[STLink]]==


[[Image:St-link.jpg|300px]]
[[Image:St-link.jpg|300px]]


Every STM discovery / eval board comes with a [http://www.st.com/web/catalog/tools/FM146/CL1984/SC724/SS1677/PF251168 ST-Link V2] on board, with one exception; the STM32VL version, that board comes with ST-Link V1.
Most STM discovery / eval boards comes with a [http://www.st.com/web/catalog/tools/FM146/CL1984/SC724/SS1677/PF251168 ST-Link V2] on board, with one exception; the STM32VL version, that board comes with ST-Link V1.


These can be used with [https://github.com/texane/stlink texane’s] utilities, or reflashed with [[STLink#Update_the_ST-Link_to_blackmagic_probe| the blackmagic firmware]].
These can be used with [https://github.com/texane/stlink texane’s] tools, or reflashed with [[STLink#Update_the_ST-Link_to_blackmagic_probe| the blackmagic firmware]].


<br style="clear:both">
<br style="clear:both">


==FLOSS JTAG==
=FLOSS JTAG=


[[Image:Jtag-up.jpg|300px|FLOSS JTAG top]]
[[Image:Jtag-up.jpg|300px|FLOSS JTAG top]]
[[Image:Jtag-down.jpg|300px|FLOSS JTAG bottom]]
[[Image:Jtag-down.jpg|300px|FLOSS JTAG bottom]]


The FLOSS JTAG is based on an FTDI 2232HL chip that allows two simultaneous USB connections, which means that FLOSS JTAG allows JTAG and UART/COM connections.<br/>
The FLOSS JTAG is based on an FTDI 2232HL chip that allows two simultaneous USB connections, which means that FLOSS JTAG allows JTAG and UART simultaneously.<br/>


The upper side contains the JTAG connector (which is connected on photo) and two sets of RX/TX LEDs for JTAG and UART/COM interface separately. The JTAG connector is 2x5 pins, 0.05-inch pitch, and is compatible with the Samtec FFSD-05-D-06.00-01-N-RW-R ribbon cable.
The upper side contains the JTAG connector and two sets of RX/TX LEDs for JTAG and UART/COM interface separately. The JTAG connector is 2x5 pins, 0.05-inch pitch, and is compatible with the Samtec FFSD-05-D-06.00-01-N-RW-R ribbon cable.


On the bottom side there is 4 pin UART/COM connector, which contains (from top to bottom on the image, or color dots): Ground (black), RX (orange), TX (yellow), and +5V (red)  
On the bottom side there is 4 pin UART connector, which contains (from top to bottom on the image, or color dots): Ground (black), RX (orange), TX (yellow), and +5V (red)  


<br style="clear:both">
<br style="clear:both">


Can be used with [[DevGuide/OpenOCD]] software.
===Documentation===
===Documentation===


[http://randomprojects.org/wiki/Floss-JTAG randomprojects.org/wiki/Floss-JTAG]
[http://randomprojects.org/wiki/Floss-JTAG randomprojects.org/wiki/Floss-JTAG]


==FT2232H Mini Module==
=FT2232H Mini Module=


[[Image:AlternativeFlossJtag.png|300px|FT2232H Mini Modules as JTAG adapter]]
[[Image:AlternativeFlossJtag.png|300px|FT2232H Mini Modules as JTAG adapter]]
Line 91: Line 97:


The FT2232H Mini modules can be used with blackmagic firmware or as FLOSS-JTAG device. <br/>
The FT2232H Mini modules can be used with blackmagic firmware or as FLOSS-JTAG device. <br/>
More Information can be found at the [[Serial_Adapter#FT2232H_Mini_Module| FT2232H Mini Module Serial Adapter page]].


'''Important'''
'''Important'''
Line 156: Line 161:
[http://at.mouser.com/ProductDetail/FTDI/FT2232H-MINI-MODULE/?qs=sGAEpiMZZMvOu2nvEqRMlAhGRrWaSCdm Mouser shop 22€]
[http://at.mouser.com/ProductDetail/FTDI/FT2232H-MINI-MODULE/?qs=sGAEpiMZZMvOu2nvEqRMlAhGRrWaSCdm Mouser shop 22€]


==Blackmagic Probe usage==
=Blackmagic Probe usage=


In the wiki (under [Developer_Guide]) is already some helpful information:
In the wiki (under [Developer_Guide]) is already some helpful information:
* Use Blackmagic Probe with Eclipse [[RT_Paparazzi#Debugging_with_an_Eclipse_IDE]].
* Use Blackmagic Probe with Eclipse [[RT_Paparazzi#Debugging_with_an_Eclipse_IDE]].
* General OpenOCD/GDB commands in reagards of the BMP, also about SWD [[DevGuide/GDB-Debug#Debugging_with_GDB_over_JTAG]] [[DevGuide/GDB-Debug#Black_Magic_Probe_2]].
* General OpenOCD/GDB commands in reagards of the BMP, also about SWD [[DevGuide/GDB-Debug#Debugging_with_GDB_over_JTAG]] [[DevGuide/GDB-Debug#Black_Magic_Probe]].


===Upgrade BMP firmware===
===Upgrade BMP firmware===
TODO: rewrite, this is just copied from the JTAG page.


Check firmware version:
Check firmware version:
  $ sudo /usr/bin/arm-none-eabi-gdb
  $ arm-none-eabi-gdb
  (gdb)  target extended-remote /dev/ttyACM0
  (gdb)  target extended-remote /dev/ttyACM0
  (gdb)  monitor version
  (gdb)  monitor version


To upgrade the brain of your Black Magic Probe, a.k.a. its firmware:
Download source from git, compile:
 
  $ git clone https://github.com/blacksphere/blackmagic
  - Download the compiled firmware from http://blacksphere.co.nz/builds/  (more info at https://github.com/blacksphere/blackmagic/wiki/Frequently-Asked-Questions)
  $ cd blackmagic
  - Download and run the stm32_mem.py script:
$ git submodule init
  $ git clone git://blackmagicdebug.git.sourceforge.net/gitroot/blackmagicdebug/blackmagicdebug
$ git submodule update
  $ cd blackmagicdebug/src/scripts
$ make
  $ ./stm32_mem.py blackmagic-XXXX.bin   (this is the .bin file you downloaded in previous step)
$ cd src
 
$ make clean
$ make PROBE_HOST=naive
$ cd ../scripts
Connect the Blackmagic Probe to USB while holding down the button for firmware update, then start "stm32_mem.py".
$ stm32_mem.py ../src/blackmagic.bin


You can build different targets (Hardware Platforms), default value is;
$ make PROBE_HOST=naive
[[Category:Hardware]]
[[Category:Hardware]]

Revision as of 14:25, 31 March 2015

These various programming adapters can be used for flashing and debugging Paparazzi hardware, some can even as USB-UART adapters.
Most are compatible with the currently used STM32 platform, some also with the older LPC 21xx.

Programming adapters for Atmel/AVR and SiLabs (ESC Controller chips) are located on the ESC page since those Microcontrollers are note more used as main processors.

Debug Protocols / Interfaces

There are two different relevant Protocolls / Interfaces for flashing and debugging for STM32:

Note: Some STM32 MCUs can also be flashed via Serial and or USB DFU! But SWD and JTAG provide (much better) debugging capabilities.

SWD

ARM Serial Wire Debug (SWD) is a program and debug protocol for ARM processors. It's a low pin count and high-performance alternative and replacement to JTAG.

JTAG

JTAG is a industry standard on-chip debugging protocoll. It can be used for one or more chips (daisy chained), for interfacing with the chip as well as flashing software.

DevGuide/OpenOCD can be used for interfacing with JTAG hardware (e.g. FTDI chips).

CricketProbe v1.00

CricketProbe v1.00 page

The CricketProbe is a programming and debugging tool for ARM Cortex MCU, based on Black Sphere Technologies Black Magic Probe.


Lyorak Probe

Lyorak probe Lyorak probe pinout

The Lyorak probe is a programming and debugging tool for ARM Cortex MCU, based on the Black Magic Probe.
Designed with 1206 SMD components for easy assmbly and a CAN interface.


Documentation

molnarkares/blackmagic git repo (fork from blackmagic)

Black Magic Probe

Black Magic Probe Black Magic Probe

This is the original Black Magic Probe from Black Sphere Technologies, a programming and debugging tool for ARM Cortex MCU.


Documentation

blacksphere/blackmagic git repo [1] Buy at 1bitsquared for 65$

STLink

St-link.jpg

Most STM discovery / eval boards comes with a ST-Link V2 on board, with one exception; the STM32VL version, that board comes with ST-Link V1.

These can be used with texane’s tools, or reflashed with the blackmagic firmware.


FLOSS JTAG

FLOSS JTAG top FLOSS JTAG bottom

The FLOSS JTAG is based on an FTDI 2232HL chip that allows two simultaneous USB connections, which means that FLOSS JTAG allows JTAG and UART simultaneously.

The upper side contains the JTAG connector and two sets of RX/TX LEDs for JTAG and UART/COM interface separately. The JTAG connector is 2x5 pins, 0.05-inch pitch, and is compatible with the Samtec FFSD-05-D-06.00-01-N-RW-R ribbon cable.

On the bottom side there is 4 pin UART connector, which contains (from top to bottom on the image, or color dots): Ground (black), RX (orange), TX (yellow), and +5V (red)


Can be used with DevGuide/OpenOCD software.

Documentation

randomprojects.org/wiki/Floss-JTAG

FT2232H Mini Module

FT2232H Mini Modules as JTAG adapter Top with all necessary connections Bottom with pin headers


The FT2232H Mini modules can be used with blackmagic firmware or as FLOSS-JTAG device.

Important

Out of the box, there is NO power supply for the FT2232H because this can either done with USB or external 5V.
The pictures above show two different PCB versions. The suggested connections only apply to the right (latest) layout.

Connect: (for power supply over USB)

  • CN3 pin 1 to CN3 pin 3
  • CN2 pin group 1,3,5 to CN2 pin group 11,21 and to CN3 pin group 12,22

Pinout

UART
Use Pin Name
UART1 RX CN2-10 ADBUS1
UART1 TX CN2-7 ADBUS0
UART2 RX CN3-25 BDBUS1
UART2 TX CN3-26 BDBUS0
JTAG
Use Pin Name
JTAG1 TCK CN2-7 ADBUS0
JTAG1 TDI CN2-10 ADBUS1
JTAG1 TDO CN2-9 ADBUS2
JTAG1 TMS CN2-12 ADBUS3
JTAG2 TCK CN3-26 BDBUS0
JTAG2 TDI CN3-25 BDBUS1
JTAG2 TDO CN3-24 BDBUS2
JTAG2 TMS CN3-23 BDBUS3

Blackmagic firmware

First, get the VID/PID for your FT2232 device using 'lsusb'. Edit the file 'src/libftdi/platform.h' and change the VID/PID to match your hardware. Compile the application with the command: 

make PROBE_HOST=libftdi

Use as FLOSS-JTAG

With the tool "FT_Prog" change the description the FT2232H to "FLOSS-JTAG".

Documentation

FT2232H Datasheet
FT2232H Mini Module Datatsheet
Mouser shop 22€

Blackmagic Probe usage

In the wiki (under [Developer_Guide]) is already some helpful information:

Upgrade BMP firmware

Check firmware version: 

$ arm-none-eabi-gdb
(gdb)  target extended-remote /dev/ttyACM0
(gdb)  monitor version

Download source from git, compile: 

$ git clone https://github.com/blacksphere/blackmagic
$ cd blackmagic
$ git submodule init
$ git submodule update
$ make
$ cd src
$ make clean
$ make PROBE_HOST=naive
$ cd ../scripts

Connect the Blackmagic Probe to USB while holding down the button for firmware update, then start "stm32_mem.py". 

$ stm32_mem.py ../src/blackmagic.bin

You can build different targets (Hardware Platforms), default value is; 

$ make PROBE_HOST=naive
Retrieved from "http://wiki.paparazziuav.org/w/index.php?title=Debug_Probes&oldid=19697"