From: Øyvind Harboe <oyvind.harboe@zylin.com>
Date: Tue, 20 Apr 2010 07:05:07 +0000 (+0200)
Subject: doc: gdb-attach can fix gdb connect issues
X-Git-Tag: v0.5.0-rc1~742
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=e4056cca2d10da3a746ebfa01799165140640071;p=openocd

doc: gdb-attach can fix gdb connect issues

Flash probing must succeed for e.g. gdb load and automatic
hardware/software breakpoints to work.

Signed-off-by: Øyvind Harboe <oyvind.harboe@zylin.com>
---

diff --git a/doc/openocd.texi b/doc/openocd.texi
index bb8f3abb..5273d5de 100644
--- a/doc/openocd.texi
+++ b/doc/openocd.texi
@@ -3784,7 +3784,8 @@ proc my_attach_proc @{ @} @{
 mychip.cpu configure -event gdb-attach my_attach_proc
 mychip.cpu configure -event gdb-attach @{
     echo "Reset..."
-    reset halt
+    # To make flash probe and gdb load to flash work we need a reset init.
+    reset init
 @}
 @end example
 
@@ -3804,7 +3805,11 @@ The following target events are defined:
 @* Currently not used (goal: when JTAG examine starts)
 @end ignore
 @item @b{gdb-attach}
-@* When GDB connects
+@* When GDB connects. This is before any communication with the target, so this 
+can be used to set up the target so it is possible to probe flash. Probing flash
+is necessary during gdb connect if gdb load is to write the image to flash. Another
+use of the flash memory map is for GDB to automatically hardware/software breakpoints
+depending on whether the breakpoint is in RAM or read only memory.
 @item @b{gdb-detach}
 @* When GDB disconnects
 @item @b{gdb-end}