From 61d1d13a0248fc6f0b131210d816b823816f14d6 Mon Sep 17 00:00:00 2001 From: Michal Lenc Date: Mon, 25 Aug 2025 15:39:15 +0200 Subject: [PATCH] doc/openocd.texi: add entry describing atsamv user signature area Adds documentation entry for newly added possibility to program ATSAMV family embedded flash signature area page. Change-Id: I3bbaba304868dca49d6dd7006276d2d3a95facad Signed-off-by: Michal Lenc Reviewed-on: https://review.openocd.org/c/openocd/+/9096 Reviewed-by: Tomas Vanek Tested-by: jenkins --- doc/openocd.texi | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/openocd.texi b/doc/openocd.texi index 22c7fcedd..4d8f79558 100644 --- a/doc/openocd.texi +++ b/doc/openocd.texi @@ -6965,6 +6965,18 @@ This driver uses the same command names/syntax as @xref{at91sam3}. flash bank $_FLASHNAME atsamv 0x00400000 0 0 0 $_TARGETNAME @end example +These families also have a user signature area located at the beginning +of an embedded flash. This is a 512 bytes large page whose data are not +erased by assering ERASE pin or by software ERASE command. It can be +used to store configuration, keys, trimming values and so on. The area +overlaps with the beginning of standard flash and uses special commands +to perform write/read operations. OpenOCD locates the signature area +at fake address above 32 bit address space, specifically at 0x100000000. + +@example +flash bank $_SIGNATURENAME atsamv 0x100000000 0 0 0 $_TARGETNAME +@end example + @deffn {Command} {atsamv gpnvm} [@option{show} [@option{all}|number]] @deffnx {Command} {atsamv gpnvm} (@option{clr}|@option{set}) number With no parameters, @option{show} or @option{show all},