Describe -A in the man and .texi documentation
This commit is contained in:
parent
f47ec634f8
commit
580c37fbfe
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
Loading…
Reference in New Issue