Differences

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

--- jtag [2017/03/30 12:50] – move aluminium kingkevin
+++ jtag [2017/03/31 20:31] – [Baite] kingkevin
@@ Line 74: / Line 74: @@
 For $9 you can't expect more, and if you want a cheap adapter I recommend the other ones (see below).
-==== aluminium ====
+==== ST-LINK V2 aluminium ====
-This [[http://www.aliexpress.com/item/Hot-Sale-1PCS-ST-LINK-Stlink-ST-Link-V2-Mini-STM8-STM32-Simulator-Download-Programmer-Programming/32343514985.html|one]] comes in aluminium case.
+These adapters come in a small dongle sized aluminium case.
-It supports SWD, and SWIM (for STM8), but not JTAG.
+They supports SWD, and SWIM (for STM8), but not JTAG.
-They replaced the additional JTAG pins with power pins.
-{{:jtag:dsc02407.jpg?0x100|device front}}
+At $2.5 they are the cheapest clones you can find.\\
-{{:jtag:dsc02408.jpg?0x100|device back}}
+One trick to get this ridiculously low price is to use STM32F101 micro-controllers.
-{{:jtag:dsc02415.jpg?0x100|PCB front}}
+Compared to the STM32F103 micro-controllers they offer less functionalities, like USB ... yet this is a USB dongle!
-{{:jtag:dsc02410.jpg?0x100|PCB back}}
+Well this is because these micro-controllers use the same die, but if not all STM32F103 feature tests pass after production they get packages as STM32F101, and it seems that USB still works well enough ;).\\
+Similarly the STM32F103C8 is only rated having 64 kB of flash because it didn't pass the flash test, compared to the 128 kB for the STM32F103CB, but they very often have more (you can verify by read/writing and check for errors).
-STM32F103C8 connection:
+Several board versions exist and it is hard to know what you will get.
-^ STM32F103C8 signal ^ STM32F103C8 pin ^ adapter pin ^ adapter signal ^
+Always check the pinout on the aluminium case since this also varies.
-| PB6 | 42 | 1 | RST |
-| PB14 | 27 | 2 | SWDIO |
-| USB GND |  | 3 | GND |
-| USB GND |  | 4 | GND |
-| PB8/PB11 | 45/22 | 5 | SWIM |
-| PA5/PB13 | 15/26 | 6 | SWCLK |
-| LDO VCC |  | 7 | 3.3V |
-| LDO VCC |  | 8 | 3.3V |
-| USB VCC |  | 9 | 5V |
-| USB VCC  |  | 10 | 5V |
-| PA9 | 30 | current source  | LED |
-==== BAITE ====
+=== 2014-06-22 ST-LINK V2 ===
-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:alu_dongle_front.jpg?0x100|}}
-It supports JTAG, SWD, and SWIM (for STM8).
+{{:jtag:alu_board_front.jpg?0x100|}}
+{{:jtag:alu_board_back.jpg?0x100|}}
+I've also reversed the {{:jtag:alu.pdf|schematic}} for this board.
+One other nice trick they used is to have twos LEDs on the same pin (PA9):
+  * when the pin is set to output high, only one LED lights up
+  * when the pin is set to output low, the other LED light up
+  * when set to input floating, both LEDs are off
+  * when PWM output is used, you can mix the two colors (red and blue) quite well due to the persistence of vision (also because the LEDs are next to each other and the small hole in the case is in the center).
+=== swapped ===
+{{:jtag:reverse-gnd_case-front.jpg?0x100|}}
+{{:jtag:reverse-gnd_internal-front.jpg?0x100|}}
+{{:jtag:reverse-gnd_internal-back.jpg?0x100|}}
+From the outside this looks very similar to the previous one, except that the connector pinout is very different (except for power).\\
+No markings are on the board.
+=== 2016-01-18 MX-LINK V2 ===
+{{:jtag:mx-link__case-front.jpg?0x100|}}
+{{:jtag:mx-link__internal-front.jpg?0x100|}}
+{{:jtag:mx-link__internal-back.jpg?0x100|}}
+This one has an "M" logo instead of the ST logo, probably corresponding to the "MX-LINK V2" marking on the board.
+==== Baite ====
+{{:jtag:baite_dongle_front.jpg?0x100|dongle front}}
+{{: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:
+<code bash>
+git clone https://github.com/blacksphere/blackmagic
+cd blackmagic
+git submodule init
+git submodule update
+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" 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 =====