Describe -A in the man and .texi documentation

This commit is contained in:
Stefan Rueger 2022-04-29 00:14:45 +01:00
parent f47ec634f8
commit 580c37fbfe
2 changed files with 35 additions and 5 deletions

View File

@ -18,7 +18,7 @@
.\" .\"
.\" $Id$ .\" $Id$
.\" .\"
.Dd DATE November 22, 2021 .Dd DATE April 28, 2022
.Os .Os
.Dt AVRDUDE 1 .Dt AVRDUDE 1
.Sh NAME .Sh NAME
@ -31,6 +31,7 @@
.Op Fl B Ar bitclock .Op Fl B Ar bitclock
.Op Fl c Ar programmer-id .Op Fl c Ar programmer-id
.Op Fl C Ar config-file .Op Fl C Ar config-file
.Op Fl A
.Op Fl D .Op Fl D
.Op Fl e .Op Fl e
.Oo Fl E Ar exitspec Ns .Oo Fl E Ar exitspec Ns
@ -102,7 +103,7 @@ available (like almost all embedded Linux boards) you can do without
any additional hardware - just connect them to the MOSI, MISO, RESET any additional hardware - just connect them to the MOSI, MISO, RESET
and SCK pins on the AVR and use the linuxgpio programmer type. It bitbangs and SCK pins on the AVR and use the linuxgpio programmer type. It bitbangs
the lines using the Linux sysfs GPIO interface. Of course, care should the lines using the Linux sysfs GPIO interface. Of course, care should
be taken about voltage level compatibility. Also, although not strictrly be taken about voltage level compatibility. Also, although not strictly
required, it is strongly advisable to protect the GPIO pins from required, it is strongly advisable to protect the GPIO pins from
overcurrent situations in some way. The simplest would be to just put overcurrent situations in some way. The simplest would be to just put
some resistors in series or better yet use a 3-state buffer driver like some resistors in series or better yet use a 3-state buffer driver like
@ -253,7 +254,7 @@ The Teensy bootloader is supported for all AVR boards.
As the bootloader does not support reading from flash memory, As the bootloader does not support reading from flash memory,
use the use the
.Fl V .Fl V
option to prevent AVRDUDE from verifing the flash memory. option to prevent AVRDUDE from verifying the flash memory.
See the section on See the section on
.Em extended parameters .Em extended parameters
for Teensy specific options. for Teensy specific options.
@ -376,6 +377,20 @@ files. This can be used to add entries to the configuration
without patching your system wide configuration file. It can be used without patching your system wide configuration file. It can be used
several times, the files are read in same order as given on the command several times, the files are read in same order as given on the command
line. line.
.It Fl A
Disable the automatic removal of trailing-0xFF sequences in file
input that is to be programmed to flash and in AVR reads from
flash memory. Normally, trailing 0xFFs can be discarded, as flash
programming requires the memory be erased to 0xFF beforehand.
.Fl A
should be used when the programmer hardware, or bootloader
software for that matter, does not carry out chip erase and
instead handles the memory erase on a page level. The popular
Arduino bootloader exhibits this behaviour; for this reason
.Fl A
is engaged by default when specifying
. Fl c
arduino.
.It Fl D .It Fl D
Disable auto erase for flash. When the Disable auto erase for flash. When the
.Fl U .Fl U
@ -389,6 +404,10 @@ use page erase before writing each page so no explicit chip erase
is required. is required.
Note however that any page not affected by the current operation Note however that any page not affected by the current operation
will retain its previous contents. will retain its previous contents.
Setting
.Fl D
implies
.Fl A.
.It Fl e .It Fl e
Causes a chip erase to be executed. This will reset the contents of the Causes a chip erase to be executed. This will reset the contents of the
flash ROM and EEPROM to the value flash ROM and EEPROM to the value

View File

@ -321,13 +321,13 @@ via a serial link (@url{https://github.com/ElTangas/jtag2updi}).
The Micronucleus bootloader is supported for both protocol version V1 The Micronucleus bootloader is supported for both protocol version V1
and V2. As the bootloader does not support reading from flash memory, and V2. As the bootloader does not support reading from flash memory,
use the @code{-V} option to prevent AVRDUDE from verifing the flash memory. use the @code{-V} option to prevent AVRDUDE from verifying the flash memory.
See the section on @emph{extended parameters} See the section on @emph{extended parameters}
below for Micronucleus specific options. below for Micronucleus specific options.
The Teensy bootloader is supported for all AVR boards. The Teensy bootloader is supported for all AVR boards.
As the bootloader does not support reading from flash memory, As the bootloader does not support reading from flash memory,
use the @code{-V} option to prevent AVRDUDE from verifing the flash memory. use the @code{-V} option to prevent AVRDUDE from verifying the flash memory.
See the section on @emph{extended parameters} See the section on @emph{extended parameters}
below for Teensy specific options. below for Teensy specific options.
@ -495,6 +495,16 @@ without patching your system wide configuration file. It can be used
several times, the files are read in same order as given on the command several times, the files are read in same order as given on the command
line. line.
@item -A
Disable the automatic removal of trailing-0xFF sequences in file
input that is to be programmed to flash and in AVR reads from
flash memory. Normally, trailing 0xFFs can be discarded, as flash
programming requires the memory be erased to 0xFF beforehand. -A
should be used when the programmer hardware, or bootloader
software for that matter, does not carry out chip erase and
instead handles the memory erase on a page level. The popular
Arduino bootloader exhibits this behaviour; for this reason -A is
engaged by default when specifying -c arduino.
@item -D @item -D
Disable auto erase for flash. When the -U option with flash memory is Disable auto erase for flash. When the -U option with flash memory is
@ -506,6 +516,7 @@ use page erase before writing each page so no explicit chip erase
is required. is required.
Note however that any page not affected by the current operation Note however that any page not affected by the current operation
will retain its previous contents. will retain its previous contents.
Setting -D implies -A.
@item -e @item -e
Causes a chip erase to be executed. This will reset the contents of the Causes a chip erase to be executed. This will reset the contents of the