avr
/
avrdude
mirror of https://github.com/mariusgreuel/avrdude.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity

Document conditional options -c ? -p part and -p ? -c programmer

This commit is contained in:
Stefan Rueger 2022-09-20 21:39:15 +01:00
parent 97c5ac312a
commit b04a83b1a2
No known key found for this signature in database
GPG Key ID: B0B4F1FD86B1EC55
2 changed files with 38 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
src/avrdude.1
View File

@ -301,10 +301,16 @@ need to be specified to
.Nm avrdude . .Nm avrdude .
.Bl -tag -offset indent -width indent .Bl -tag -offset indent -width indent
.It Fl p Ar partno .It Fl p Ar partno
This is the only option that is mandatory for every invocation of This option specifies the MCU connected to the programmer. The MCU
.Nm avrdude . descriptions are read from the config file. For currently supported MCUs use
It specifies the type of the MCU connected to the programmer. These are read from the config file. ? as partno, which will print a list of partno ids and official part names.
For currently supported MCU types use ? as partno, this will print a list of partno ids and official part names on the terminal. (Both can be used with the -p option.) Both can be used with the -p option. If -p ? is specified with a specific
programmer, see -c below, then only those parts are output that the
programmer expects to be able to handle, together with the programming
interface(s) that can be used in that combination. In reality there can be
deviations from this list, particularly if programming is directly via a
bootloader.
.Pp .Pp
Following parts need special attention: Following parts need special attention:
.Bl -tag -width "ATmega1234" .Bl -tag -width "ATmega1234"
@ -357,6 +363,11 @@ file to assign a default programmer to keep from having to specify
this option on every invocation. this option on every invocation.
A full list of all supported programmers is output to the terminal A full list of all supported programmers is output to the terminal
by using ? as programmer-id. by using ? as programmer-id.
If -c ? is specified with a specific part, see
-p above, then only those programmers are output that expect
to be able to handle this part, together with the programming interface(s) that can be
used in that combination. In reality there can be deviations from this list,
particularly if programming is directly via a bootloader.
.It Fl C Ar config-file .It Fl C Ar config-file
Use the specified config file to load configuration data. This file Use the specified config file to load configuration data. This file
contains all programmer and part definitions that contains all programmer and part definitions that

33
src/doc/avrdude.texi
View File

@ -399,14 +399,19 @@ following options are recognized:
@table @code @table @code
@item -p @var{partno} @item -p @var{partno}
This is the only mandatory option and it tells AVRDUDE what type of part This option tells AVRDUDE what part (MCU) is connected to the programmer.
(MCU) that is connected to the programmer. The @var{partno} parameter The @var{partno} parameter is the part's id listed in the configuration file.
is the part's id listed in the configuration file. Specify -p ? to list For currently supported MCU types use ? as partno, which will print a list of
all parts in the configuration file. If a part is unknown partno ids and official part names on the terminal. Both can be used with the
to AVRDUDE, it means that there is no config file entry for that part, -p option. If a part is unknown to AVRDUDE, it means that there is no config
but it can be added to the configuration file if you have the Atmel file entry for that part, but it can be added to the configuration file if
datasheet so that you can enter the programming specifications. you have the Atmel datasheet so that you can enter the programming
Currently, the following MCU types are understood: specifications. If @code{-p ?} is specified with a specific programmer, see
@code{-c} below, then only those parts are output that the programmer expects
to be able to handle, together with the programming interface(s) that can be
used in that combination. In reality there can be deviations from this list,
particularly if programming is directly via a bootloader. Currently, the
following MCU types are understood:
@cindex Device support @cindex Device support
@ -459,7 +464,12 @@ AVRDUDE, and the programmer is controlled via the PC parallel port,
there's a good chance that it can be easily added to the configuration there's a good chance that it can be easily added to the configuration
file without any code changes to AVRDUDE. Simply copy an existing entry file without any code changes to AVRDUDE. Simply copy an existing entry
and change the pin definitions to match that of the unknown programmer. and change the pin definitions to match that of the unknown programmer.
Currently, the following programmer ids are understood and supported: If @code{-c ?} is specified with a specific part, see @code{-p} above, then
only those programmers are output that expect to be able to handle this part,
together with the programming interface(s) that can be used in that
combination. In reality there can be deviations from this list, particularly
if programming is directly via a bootloader. Currently, the following
programmer ids are understood and supported:
@cindex Programmer support @cindex Programmer support
@ -1737,7 +1747,10 @@ Known programming modes are
@item @code{PM_HVSP}: High Voltage Serial Programming (some classic parts) @item @code{PM_HVSP}: High Voltage Serial Programming (some classic parts)
@item @code{PM_HVPP}: High Voltage Parallel Programming (most non-HVSP classic parts) @item @code{PM_HVPP}: High Voltage Parallel Programming (most non-HVSP classic parts)
@item @code{PM_debugWIRE}: Simpler alternative to JTAG (a subset of HVPP/HVSP parts) @item @code{PM_debugWIRE}: Simpler alternative to JTAG (a subset of HVPP/HVSP parts)
@item @code{PM_JTAG}: Joint Test Action Group standard (some classic parts, some xmega) @item @code{PM_JTAG}: Joint Test Action Group standard (some classic parts)
@item @code{PM_JTAGmkI}: Subset of @code{PM_JTAG}, older parts, Atmel ICE mkI
@item @code{PM_XMEGAJTAG}: JTAG, some XMEGA parts
@item @code{PM_AVR32JTAG}: JTAG for 32-bit AVRs
@item @code{PM_aWire}: AVR32 parts @item @code{PM_aWire}: AVR32 parts
@end itemize @end itemize