Docs reorganization (#1236)

* Docs reorganization

Removed broken link

* README.md relative link consistency

1 files changed, 48 insertions, 0 deletions

diff --git a/doc/gdb.md b/doc/gdb.md
new file mode 100644
index 00000000..eb9b73f1
--- /dev/null
+++ b/doc/gdb.md
@@ -0,0 +1,48 @@
+# Flashing the firmware with GDB and Black Magic Probe (BMP)
+
+Enter the following command into GDB:
+
+```
+target extended-remote /dev/ttyACM0
+monitor swdp_scan
+attach 1
+file ./pinetime-app-full.hex
+load
+run
+```
+
+Example :
+```
+$ /home/jf/nrf52/gcc-arm-none-eabi-8-2019-q3-update/bin/arm-none-eabi-gdb
+
+(gdb) target extended-remote /dev/ttyACM0
+Remote debugging using /dev/ttyACM0
+(gdb) monitor swdp_scan
+Target voltage: ABSENT!
+Available Targets:
+No. Att Driver
+ 1      Nordic nRF52 M3/M4
+ 2      Nordic nRF52 Access Port
+
+(gdb) attach 1
+Attaching to Remote target
+warning: No executable has been specified and target does not support
+determining executable automatically.  Try using the "file" command.
+0xfffffffe in ?? ()
+(gdb) file ./pinetime-app-full.hex
+A program is being debugged already.
+Are you sure you want to change the file? (y or n) y
+Reading symbols from ./pinetime-app-full.hex...
+(No debugging symbols found in ./pinetime-app-full.hex)
+(gdb) load
+Loading section .sec1, size 0xb00 lma 0x0
+Loading section .sec2, size 0xf000 lma 0x1000
+Loading section .sec3, size 0x10000 lma 0x10000
+Loading section .sec4, size 0x5150 lma 0x20000
+Loading section .sec5, size 0xa000 lma 0x26000
+Loading section .sec6, size 0x10000 lma 0x30000
+Loading section .sec7, size 0xdf08 lma 0x40000
+Start address 0x0, load size 314200
+Transfer rate: 45 KB/sec, 969 bytes/write.
+```
+