Differences

This shows you the differences between two versions of the page.

--- jtag [2017/03/30 13:38] – [aluminium] kingkevin
+++ jtag [2017/04/06 08:08] – [Black Magic Probe] add patch kingkevin
@@ Line 118: / Line 118: @@
 This one has an "M" logo instead of the ST logo, probably corresponding to the "MX-LINK V2" marking on the board.
-==== BAITE ====
+==== Baite ====
-The first clone is a [[http://www.aliexpress.com/item/Free-Shipping-1SET-ST-Link-st-link-V2-for-STM8S-STM8L-STM32-Cortex-M0-Cortex-M3/1758613434.html|BAITE]] ST-Link V2.
+{{:jtag:baite_dongle_front.jpg?0x100|dongle front}}
-It supports JTAG, SWD, and SWIM (for STM8).
+{{:jtag:baite_dongle_back.jpg?0x100|dongle back}}
+{{:jtag:baite_board_front.jpg?0x100|board front}}
+{{:jtag:baite_board_back.jpg?0x100|board front}}
+The [[http://betemcu.cn/|Baite]] [[https://www.aliexpress.com/store/product/Best-Quality-ST-Link-stlink-V2-for-STM8S-STM8L-STM32-Cortex-M0-Cortex-M3-SWIM-JTAG/213957_32676015777.html|ST-Link V2]] is my favorite clone since it supports JTAG, SWD, and SWIM (for STM8).
+The seem to use the same board also for several other programmers, and since the pinout is not on the case I've decided to make my own sticker.
-{{:jtag:dsc02404.jpg?0x100|device front}}
-{{:jtag:dsc02405.jpg?0x100|device back}}
-{{:jtag:dsc02403.jpg?0x100|PCB front}}
 {{:jtag:dsc02406.jpg?0x100|pinout sticker}}
 {{:jtag:st-link_v2_baite.svg?0x100|pinout}}
-STM32F103C8 connection:
+I've also reversed the board layout to get the {{:jtag:baite_schematic.pdf|schematic}}.
-^ STM32F103C8 signal ^ STM32F103C8 pin ^ adapter pin ^ adapter signal ^
+The connector pins are all protected with 220 ohms resistors.
-| PA7 | 17 | 1 | JRST |
-| AMS1117 |  | 2 | 3V3 |
+===== Black Magic Probe =====
-| USB VCC |  | 3 | 5V |
-| PA4 | 14 | 4 | JTCK/SWCLK |
+The [[https://github.com/blacksphere/blackmagic/wiki|Black Magic Probe]] (aka. BMP) is a quite nice SWJ adapter because it comes with an embedded GDB server.
-| PB11 | 22 | 5 | SWIM |
+Thus no need to have an OpenOCD server to control the SWJ adapter.
-| PA14 | 37 | 6 | JTMS/SWDIO |
+You can directly connect GDB to this adapter (over USB CDC ACM).\\
-| USB GND |  | 7 | GND |
+It also comes with a UART port (over a second USB CDC ACM).
-| PA5 | 15 | 8 | JTDO |
+This is very useful while developing (for printf debugging).
-| PB6 | 42 | 9 | SWIM_RST |
-| PA6  | 16 | 10 | JTDI |
+The hardware comes with some disadvantages though:
-| PB12,PB14 | 25,27 |  |  100 ohms |
+  * the ARM Cortex SWJ connector uses a small header (not very dupont-wire friendly)
-| PB5 | 41 |  | LED |
+  * the separate UART is not always populated (UART is also available on the SWJ connector)
+  * it is quite expensive (> $50)
+  * it is always sold out (and V2.1 on pre-order will take a bit of time until it is available)
+But because the firmware is open source it is possible to port it to other hardware, and [[https://github.com/blacksphere/blackmagic/wiki/Debugger-Hardware|people already did it]].\\
+It has been [[https://medium.com/@paramaggarwal/converting-an-stm32f103-board-to-a-black-magic-probe-c013cf2cc38c|ported]] on the [[stm32f1xx#blue_pill|blue pill]], but I don't find this board as handy as a dongle.\\
+It has also been [[http://blog.linuxbits.io/2016/02/15/cheap-chinese-st-link-v-2-programmer-converted-to-black-magic-probe-debugger/|ported]] to the [[#st-link_v2_aluminium|ST-Link V2 clone]], but then there is no additional UART anymore.\\
+So I decided to port it to the [[#baite|baite]].
+This has less power pins (who needs 2xGND, 2x5V, 3x3.3V anyway), but provides enough function pins to add UART (and SRST).
+To build the firmware ([[https://sourceforge.net/p/blackmagicdebug/mailman/message/35762464/|patch]] integration pending):
+<code bash>
+git clone https://github.com/blacksphere/blackmagic
+cd blackmagic
+git submodule init
+git submodule update
+wget -O 0001-add-new-platform-Baite-ST-Link-V2-clone.patch "https://sourceforge.net/p/blackmagicdebug/mailman/attachment/20170401092652.GA15475%40coil/1/"
+patch -p1 < 0001-add-new-platform-Baite-ST-Link-V2-clone.patch
+make
+cd src
+make clean
+make PROBE_HOST=baite
+</code>
+First we need to re-program the Baite dongle.\\
+As you can see on the {{:jtag:baite_schematic.pdf|schematic}} the JTAG and SWD pins of the micro-controller are not connected (there even are no pads on the board for the pins to be soldered on).
+But on the back of the board you can find test points so to program the device using the serial bootloader:
+^ pin ^ signal ^
+| 1 (square) | RX |
+| 2 | TX |
+| 3 | BOOT0 |
+| 4 | +5V |
+| 5 | GND |
+Use any USB to UART converter and connect the corresponding pins to this port.
+Don't power the Baite dongle over USB since it might then boot the normal application.
+Instead let the USB to UART converter power it.
+To start the serial bootloader when powering the dongle you need to set BOOT0 high by connecting it to +3.3V or DTR (or any high signal present on the USB to UART converter).
+To flash the Black Magic DFU bootloader I used [[https://sourceforge.net/p/stm32flash/wiki/Home/|stm32flash]].
+Since the flash is read/write protected you first need to clear these option bits.
+<code bash>
+# disable flash read protection
+stm32flash -k /dev/ttyUSB0
+# disable flash write protection
+stm32flash -u /dev/ttyUSB0
+# erase flash
+stm32flash -o /dev/ttyUSB0
+# flash DFU bootloader
+stm32flash -w blackmagic/src/blackmagic_dfu.bin /dev/ttyUSB0
+</code>
+Unplug and re-plug the Baite dongle and you should see the device in DFU bootlader mode.
+Flash the main application firmware using dfu-util:
+<code bash>
+dfu-util -d 1d50:6017 -s 0x08002000:leave -D blackmagic.bin
+</code>
+Unplug and re-plug the Baite dongle.
+The adapter should be running the main application and two USB CDC ACM ports will appear.
+You can re-flash the device from the main application using dfu-util:
+<code bash>
+dfu-util -d 1d50:6018 -s 0x08002000:leave -D blackmagic.bin
+</code>
+or short RX to ground (pin 5 and 7) to force the DFU bootloader start when plugin in the dongle (in case the main application is buggy).
+Here is the new "BMP Baite" {{ :jtag:bmp_baite.pdf |pinout}}:
+^ signal ^ pin ^ pin ^ signal ^
+| SRST | 1 | 2| +3.3V |
+| +5V | 3 | 4 | JTCK/SWCLK |
+| RX | 5 (key) | 6 | JTMS/SWDIO |
+| GND | 7 | 8 | JTDO/TRACESWO |
+| TX | 9 | 10 | JTDI |
-the adapter pins are protected with a 220 ohms resistor.
+**note**: the RX pin is pulled up by a 620 ohms resistor. Thus the TX connected to BMP Baite must by strong enough to drive it low (e.g. not like with the CH340 USB to UART converter).
+If you connect SRST to the target NRST, it is even possible to reset the target board without having to press on the on-board reset button (of there is any):
+<code bash>
+gdb --eval-command="target extended-remote /dev/ttyACM0" --eval-command="monitor hard_srst" --eval-command="quit"
+</code>
 ===== Altera USB-Blaster =====