Add install doc for STM32H103 (dirtyjtag#86)

* Add SWD pinout image * Add JTAG pinout image * Add installation documentation * Add STM32H103 install doc link
Woolfy025 · Jan 28, 2021 · d7edded · d7edded
1 parent 001480b
commit d7edded
Show file tree

Hide file tree

Showing 4 changed files with 29 additions and 1 deletion.
diff --git a/README.md b/README.md
@@ -18,7 +18,7 @@ If you prefer OpenOCD to UrJTAG, I suggest using Zoobab's fork of Versaloon firm
 | Olimex STM32-H103                              |
 |:----------------------------------------------:|
 | ![STM32-H103 icon](docs/img/stm32h103-128.jpg) |
-| No instructions yet                            |
+| [Instructions](docs/install-stm32h103.md)      |
 
 ## Software compatible with DirtyJTAG
 

diff --git a/docs/img/stm32h103-pinout.jpg b/docs/img/stm32h103-pinout.jpg
diff --git a/docs/img/stm32h103-swd-pinout.jpg b/docs/img/stm32h103-swd-pinout.jpg
diff --git a/docs/install-stm32h103.md b/docs/install-stm32h103.md
@@ -0,0 +1,28 @@
+# Installing DirtyJTAG on Olimex STM32-H103
+
+Thanks Olimex for gifting us this board! You can order it [on their website](https://www.olimex.com/Products/ARM/ST/STM32-H103/) (unsponsored link).
+
+## Prerequisites
+
+ * An ST-Link programmer
+ * [stlink](https://github.com/texane/stlink)
+
+## SWD wiring
+
+The SWD signals are available on the HE20 JTAG connector:
+
+![SWD pinout on the JTAG connector of STM32H103](img/stm32h103-swd-pinout.png)
+
+## Flashing DirtyJTAG
+
+Download a binary version of DirtyJTAG (make sure to get the `bluepill` build!) or [compile it yourself](building-dirtyjtag.md), then flash it using `st-flash`:
+
+```
+st-flash write /path/to/dirtyjtag.bluepill.bin 0x8000000
+```
+
+## Pinout
+
+The STM32H103 uses currently the same pinout as Bluepill (if flashed with the `bluepill` firmware):
+
+![JTAG pinout of STM32H103](img/stm32h103-pinout.jpg)