From 91d7c9f70238acd51f0d21dd4921e09a76f3f6ef Mon Sep 17 00:00:00 2001 From: stefanrueger Date: Sat, 27 Jan 2024 13:13:10 +1300 Subject: [PATCH] Document factory reset command --- src/avrdude.1 | 8 ++++++++ src/doc/avrdude.texi | 11 +++++++++++ 2 files changed, 19 insertions(+) diff --git a/src/avrdude.1 b/src/avrdude.1 index be7b0bbe..dceed2f5 100644 --- a/src/avrdude.1 +++ b/src/avrdude.1 @@ -1260,6 +1260,14 @@ can be uniquely resolved. It is quite possible, as is with direct writing to the underlying fuses and lock bits, to brick a part, i.e., make it unresponsive to further programming with the chosen programmer: here be dragons. +.It Ar factory reset +Resets the connected part to factory state as far as possible; +bootloaders, for example, cannot write fuses and may not have a means to +erase EEPROM. This may change the clock frequency of the part after the +next reset when the new fuse values come into effect. As such this may +require that avrdude is called with a different bit clock rate for the +programmer next time. Note that the command factory can be abbreviated +but the required argument reset needs to be spelled out. .It Ar regfile {} regfile with no further argument displays the register file of a part, i.e., all register names and their contents in diff --git a/src/doc/avrdude.texi b/src/doc/avrdude.texi index ec853862..7324c72f 100644 --- a/src/doc/avrdude.texi +++ b/src/doc/avrdude.texi @@ -2463,6 +2463,17 @@ It is quite possible, as is with direct writing to the underlying fuses and lock bits, to brick a part, i.e., make it unresponsive to further programming with the chosen programmer: here be dragons. +@item factory reset +Resets the connected part to factory state as far as possible; +bootloaders, for example, cannot write fuses and may not have a means to +erase EEPROM. This may change the clock frequency of the part after the +next reset when the new fuse values come into effect. As such this may +require that avrdude is called with a different bit clock rate for the +programmer next time. Note that the command @code{factory} can be +abbreviated but the required argument @code{reset} needs to be spelled +out. + + @item regfile [@var{opts}] @code{regfile} with no further argument displays the register file of a part, i.e., all register names and their contents in @code{io} memory, if