From ebe370ab0e35d970601496c331c85198a0587955 Mon Sep 17 00:00:00 2001
From: Stefan Rueger <stefan.rueger@urclocks.com>
Date: Thu, 20 Jun 2024 00:10:01 +0100
Subject: [PATCH] Document XMEGA calibration, sernum and tempsense memories

---
 src/avrdude.1        | 16 ++++++++++++----
 src/doc/avrdude.texi | 16 ++++++++++++----
 2 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/src/avrdude.1 b/src/avrdude.1
index 3a859781..528d40cf 100644
--- a/src/avrdude.1
+++ b/src/avrdude.1
@@ -845,6 +845,9 @@ Application flash area
 Application table flash area
 .It boot
 Boot flash area
+.It   calibration
+An area of 4 (ATxmega-A series) or 5 bytes (ATxmega-B/C/D/E) with
+oscillator calibration values; this is a sub-memory of prodsig
 .It fuse0
 A.k.a. jtaguid: JTAG user ID for some devices
 .It fuse1
@@ -857,12 +860,17 @@ Other fuse bytes of ATxmega devices, where
 is 2, 4 or 5, for system configuration
 .It prodsig
 The production signature row is a read-only memory section for factory
-programmed data such as the signature and calibration values for
-oscillators or analogue modules; it also contains a serial number that
-consists of the production lot number, wafer number and wafer coordinates
-for the part
+programmed data such as the calibration values for oscillators or analogue
+modules; it also contains a serial number that consists of the production
+lot number, wafer number and wafer coordinates for the part
+.It sernum
+Serial number with a unique ID for the part consisting of 10 bytes; these
+are part of the prodsig memory above
 .It sigrow
 Memory alias for prodsig
+.It tempsense
+A two-byte memory, which is located within prodsig; it contains a 12-bit
+temperature sensor calibration value
 .It usersig
 Additional flash memory page that can be used for firmware settings; this
 memory is not erased during a chip erase
diff --git a/src/doc/avrdude.texi b/src/doc/avrdude.texi
index b9b9dacf..dcde9e53 100644
--- a/src/doc/avrdude.texi
+++ b/src/doc/avrdude.texi
@@ -901,6 +901,9 @@ Application flash area
 Application table flash area
 @item boot
 Boot flash area
+@item calibration
+An area of 4 (ATxmega-A series) or 5 bytes (ATxmega-B/C/D/E) with
+oscillator calibration values; this is a sub-memory of @code{prodsig}
 @item fuse0
 A.k.a. jtaguid: JTAG user ID for some devices
 @item fuse1
@@ -911,12 +914,17 @@ Fault detection action configuration TC4/5 for ATxmega E series parts
 Other fuse bytes of ATxmega devices, where @emph{N} is 2, 4 or 5, for system configuration
 @item prodsig
 The production signature row is a read-only memory section for factory
-programmed data such as the signature and calibration values for
-oscillators or analogue modules; it also contains a serial number that
-consists of the production lot number, wafer number and wafer coordinates
-for the part
+programmed data such as calibration values for oscillators or analogue
+modules; it also contains a serial number that consists of the production
+lot number, wafer number and wafer coordinates for the part
+@item sernum
+Serial number with a unique ID for the part consisting of 10 bytes; these
+are part of the @code{prodsig} memory above
 @item sigrow
 Memory alias for prodsig
+@item tempsense
+A two-byte memory, which is located within @code{prodsig}; it contains a 12-bit
+temperature sensor calibration value
 @item usersig
 Additional flash memory page that can be used for firmware settings; this
 memory is not erased during a chip erase