aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMoritz 'Morty' Strübe <moritz.struebe@redheads.de>2019-08-29 09:07:06 +0200
committerSpencer Oliver <spen@spen-soft.co.uk>2019-10-15 09:00:45 +0100
commit51ce53d044bc1f60519c0b24c6afe845f66f25e8 (patch)
treeb03af6888c0bde09ed17d1bdbb2d31a8a39452bf /doc
parentb4a7ff291c3636eb5f6aa224476268775aceecad (diff)
downloadriscv-openocd-51ce53d044bc1f60519c0b24c6afe845f66f25e8.zip
riscv-openocd-51ce53d044bc1f60519c0b24c6afe845f66f25e8.tar.gz
riscv-openocd-51ce53d044bc1f60519c0b24c6afe845f66f25e8.tar.bz2
src/flash/startup.tcl: Add preverify to program command
The preverify option allows to check whether flashing is necessary. If the target is flashed often/automatically this can save time and preserve the flash. This is expecially helpful in CI environments. Change-Id: Iead0a269e1a772b751d4dd9e8b53b2fecc874624 Signed-off-by: Moritz 'Morty' Strübe <moritz.struebe@redheads.de> Reviewed-on: http://openocd.zylin.com/5292 Tested-by: jenkins Reviewed-by: Paul Fertser <fercerpav@gmail.com> Reviewed-by: Spencer Oliver <spen@spen-soft.co.uk> Reviewed-by: Tarek BOCHKATI <tarek.bouchkati@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/openocd.texi3
1 files changed, 2 insertions, 1 deletions
diff --git a/doc/openocd.texi b/doc/openocd.texi
index bc77469..440f434 100644
--- a/doc/openocd.texi
+++ b/doc/openocd.texi
@@ -5138,7 +5138,7 @@ command or the flash driver then it defaults to 0xff.
@end deffn
@anchor{program}
-@deffn Command {program} filename [verify] [reset] [exit] [offset]
+@deffn Command {program} filename [preverify] [verify] [reset] [exit] [offset]
This is a helper script that simplifies using OpenOCD as a standalone
programmer. The only required parameter is @option{filename}, the others are optional.
@xref{Flash Programming}.
@@ -7528,6 +7528,7 @@ The script is executed as follows and by default the following actions will be p
@item 'init' is executed.
@item 'reset init' is called to reset and halt the target, any 'reset init' scripts are executed.
@item @code{flash write_image} is called to erase and write any flash using the filename given.
+@item If the @option{preverify} parameter is given, the target is "verified" first and only flashed if this fails.
@item @code{verify_image} is called if @option{verify} parameter is given.
@item @code{reset run} is called if @option{reset} parameter is given.
@item OpenOCD is shutdown if @option{exit} parameter is given.