diff --git a/src/platforms/f072/Readme b/src/platforms/f072/Readme
deleted file mode 100644
index 3ec34df..0000000
--- a/src/platforms/f072/Readme
+++ /dev/null
@@ -1,21 +0,0 @@
-# STM32F072
-
-## System vs BMP Bootloader
-
-For the BMP bootloader, flashing was not reliable. So we use the system
-bootloder unconditional.
-
-## Connections
-
-* PA0: User button to force system bootloader entry with reset
-* PA2/PA3 eventual connected to the STLINK/ STM32F103C8
-* PA0: TDI
-* PA1: TMS/SWDIO
-* PA7: TCK/SWCLK
-* PA6: TDO/TRACESWO
-* PA5: TRST
-* PB5: LED green
-* PB6: LED yellow
-* PB7: LED red
-* PB0: VTARGET
-* PB1: VUSB
diff --git a/src/platforms/f072/Readme.md b/src/platforms/f072/Readme.md
new file mode 100644
index 0000000..cd4367f
--- /dev/null
+++ b/src/platforms/f072/Readme.md
@@ -0,0 +1,49 @@
+# BMP firmware for STM32F072
+
+## System vs BMP Bootloader
+
+For the BMP bootloader, flashing was not reliable. As an easy workaround the
+system bootloader is used. This gives additional 4 kB for the BMP firmware.
+
+## Connections
+
+* PA2: UART RX
+* PS3: UART TX
+* PA0: TDI
+* PA1: TMS/SWDIO
+* PA7: TCK/SWCLK
+* PA6: TDO/TRACESWO
+* PA5: TRST
+* PB5: LED green
+* PB6: LED yellow
+* PB7: LED red
+* PB0: VTARGET
+* PB1: VUSB
+
+## Loading/updating BMP firmware
+
+Get into ST bootloader mode with reset or repower and BOOT pulled high. If BMP firmware is already loaded and running, dfu-util can also invoke the bootloader.
+
+```
+dfu-util -d 1d50:6018 -e
+```
+
+List the available devices
+
+```
+dfu-util -l
+```
+
+dfu-util should now list "[0483:df11]" and "@Internal Flash  /0x08000000/064*0002Kg".Compilethe firmware with:
+
+```
+ make PROBE_HOST=f072 clean && make PROBE_HOST=f072
+ ```
+
+Load firmware:
+
+ ```
+ dfu-util -d 0483:df11 -a 0 -s 0x08000000:leave -D blackmagic.bin
+ ```
+
+Multiple BMP devices or STM devices on the USB bus may require additional dfu-util arguments for device selection.
diff --git a/src/platforms/f3/Readme b/src/platforms/f3/Readme
deleted file mode 100644
index 14b9c60..0000000
--- a/src/platforms/f3/Readme
+++ /dev/null
@@ -1,20 +0,0 @@
-Connections:
-====================
-
-BOOT0: Pull low to force system bootloader entry with reset
-PA2/PA3 eventual connected to the STLINK/ STM32F103C8
-
-PA0: TDI
-PA1: TMS/SWDIO
-PA5: NRST
-PA6: TDO/TRACESWO
-PA7: TCK/SWCLK
-
-PA9: USB_DETACH_N
-
-PA2: UART_RX
-PA3: UART_TX
-
-Reflash:
-====================
-dfu-util -a0 -s 0x08000000 -D blackmagic.bin
\ No newline at end of file
diff --git a/src/platforms/f3/Readme.md b/src/platforms/f3/Readme.md
new file mode 100644
index 0000000..2827213
--- /dev/null
+++ b/src/platforms/f3/Readme.md
@@ -0,0 +1,50 @@
+# BMP firmware for STM32F303
+
+## System vs BMP Bootloader
+
+For simpicity, the ST system bootloader is used. Thi saves additional 4 kB for the BMPfirmware.
+
+## Connections
+
+* PA2: UART RX
+* PS3: UART TX
+* PA0: TDI
+* PA1: TMS/SWDIO
+* PA7: TCK/SWCLK
+* PA6: TDO/TRACESWO
+* PA5: TRST
+* PB5: LED green
+* PB6: LED yellow
+* PB7: LED red
+* PB0: VTARGET
+* PB1: VUSB
+
+## Loading/updating BMP firmware
+
+Get into ST bootloader mode with reset or repower and BOOT pulled high. If BMP firmware is already loaded and running, dfu-util can also invoke the bootloader.
+
+```
+dfu-util -d 1d50:6018 -e
+```
+
+List the available devices
+
+```
+dfu-util -l
+```
+
+dfu-util should now list "[0483:df11]" "@Internal Flash  /0x08000000/064*0002Kg"
+. Compile the firmware with
+
+```
+ make PROBE_HOST=f3 clean && make PROBE_HOST=f3
+ ```
+
+Load firmware
+
+```
+ dfu-util -d 0483:df11 -a 0 -s 0x08000000:leave -D blackmagic.bin
+
+```
+
+Multiple BMP devices or STM devices on the USB bus may require additional dfu-util arguments for device selection.