- Work on fixing erase check. Many implementations are plain broken.

Wrote a default flash erase check fn which uses CFI's target algorithm
w/fallback to memory reads. 
- "flash info" no longer prints erase status as it is stale. 
- "flash erase_check" now prints erase status. erase check can take a 
*long* time. Work in progress
- arm7/9 with seperate srst & trst now supports reset init/halt
after a power outage. arm7/9 no longer makes any assumptions
about state of target when reset is asserted.
- fixes for srst & trst capable arm7/9 with reset init/halt
- prepare_reset_halt retired. This code needs to be inside
assert_reset anyway
- haven't been able to get stm32 write algorithm to work. Fallback
flash write does work. Haven't found a version of openocd trunk
where this works.
- added target_free_all_working_areas_restore() which can
let be of restoring backups. This is needed when asserting
reset as the target must be assumed to be an unknown state.
Added some comments to working areas API
- str9 reset script fixes
- some guidelines
- fixed dangling callbacks upon reset timeout 


git-svn-id: svn://svn.berlios.de/openocd/trunk@536 b42882b7-edfa-0310-969c-e2dbd0fdcd60

1 files changed, 18 insertions, 0 deletions

diff --git a/src/target/target/readme.txt b/src/target/target/readme.txt
new file mode 100644
index 00000000..b8bf5dcf
--- /dev/null
+++ b/src/target/target/readme.txt
@@ -0,0 +1,18 @@
+Prerequisites:

+The users of OpenOCD as well as computer programs interacting with OpenOCD are expecting that certain commands 

+do the same thing across all the targets.

+

+Rules to follow when writing scripts:

+

+1. The configuration script should be defined such as , for example, the following sequences are working:

+	reset

+	flash info <bank>

+and

+	reset 

+	flash erase_address <start> <len>

+	

+In most cases this can be accomplished by specifying the default startup mode as reset_init (target command 

+in the configuration file).

+ 

+2. If the target is correctly configured, flash must be writable without any other helper commands. It is 

+assumed that all write-protect mechanisms should be disabled.