* doc/avrdude.texi: Add comment before each node to make them stand out better.
Use @option{} command for options instead of @code{}.
Merge FreeBSD and Linux platform dependent information.
git-svn-id: svn://svn.savannah.nongnu.org/avrdude/trunk/avrdude@274 81a1dc3b-b13d-400b-aceb-764788c761c2
This commit is contained in:
Theodore A. Roth
parent
52f274c2e3
commit
32595b3b80
285
doc/avrdude.texi
285
doc/avrdude.texi
|
|
@ -103,6 +103,9 @@ For avrdude version @value{VERSION}, @value{UPDATED}.
|
|||
* Platform Dependent Information::
|
||||
@end menu
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Introduction, Command Line Options, Top, Top
|
||||
@comment node-name, next, previous, up
|
||||
@chapter Introduction
|
||||
|
|
@ -140,6 +143,9 @@ programming function.
|
|||
* History::
|
||||
@end menu
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node History, , Introduction, Introduction
|
||||
@section History
|
||||
|
||||
|
|
@ -165,6 +171,9 @@ formatting was modeled after that of the Simulavr documentation by Ted
|
|||
Roth.
|
||||
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Command Line Options, Terminal Mode Operation, Introduction, Top
|
||||
@chapter Command Line Options
|
||||
@cindex options
|
||||
|
|
@ -174,6 +183,9 @@ Roth.
|
|||
* Example Command Line Invocations::
|
||||
@end menu
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Option Descriptions, Example Command Line Invocations, Command Line Options, Command Line Options
|
||||
@section Option Descriptions
|
||||
|
||||
|
|
@ -357,7 +369,7 @@ specified as `-' to use stdin as the input.
|
|||
Specifies which program area of the MCU to read or write; allowable
|
||||
values depend on the MCU being programmed, but most support at least
|
||||
@code{eeprom} for the EEPROM, and @code{flash} for the flash ROM. Use
|
||||
the @code{-v} option on the command line or the @code{part} command from
|
||||
the @option{-v} option on the command line or the @code{part} command from
|
||||
terminal mode to display all the memory types supported by a particular
|
||||
device. The default is @code{flash}.
|
||||
|
||||
|
|
@ -391,7 +403,7 @@ Disable automatic verify check when uploading data.
|
|||
@item -y
|
||||
Tells AVRDUDE to use the last four bytes of the connected parts' EEPROM
|
||||
memory to track the number of times the device has been erased. When
|
||||
this option is used and the @code{-e} flag is specified to generate a
|
||||
this option is used and the @option{-e} flag is specified to generate a
|
||||
chip erase, the previous counter will be saved before the chip erase, it
|
||||
is then incremented, and written back after the erase cycle com- pletes.
|
||||
Presumably, the device would only be erased just before being
|
||||
|
|
@ -411,6 +423,9 @@ should not be used.
|
|||
|
||||
@end table
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Example Command Line Invocations, , Option Descriptions, Command Line Options
|
||||
@section Example Command Line Invocations
|
||||
|
||||
|
|
@ -467,11 +482,14 @@ avrdude done. Thank you.
|
|||
@end example
|
||||
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Terminal Mode Operation, Configuration File, Command Line Options, Top
|
||||
@chapter Terminal Mode Operation
|
||||
|
||||
AVRDUDE has an interactive mode called @var{terminal mode} that is
|
||||
enabled by the @code{-t} option. This mode allows one to enter
|
||||
enabled by the @option{-t} option. This mode allows one to enter
|
||||
interactive commands to display and modify the various device memories,
|
||||
perform a chip erase, display the device signature bytes and part
|
||||
parameters, and to send raw programming commands. Commands and
|
||||
|
|
@ -530,6 +548,9 @@ Leave terminal mode and thus AVRDUDE.
|
|||
|
||||
@end table
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Terminal Mode Examples, , Terminal Mode Commands, Terminal Mode Operation
|
||||
@section Terminal Mode Examples
|
||||
|
||||
|
|
@ -629,6 +650,9 @@ avrdude>
|
|||
@end example
|
||||
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Configuration File, Platform Dependent Information, Terminal Mode Operation, Top
|
||||
@chapter Configuration File
|
||||
|
||||
|
|
@ -646,7 +670,7 @@ AVRDUDE first looks for a system wide configuration file in a platform
|
|||
dependent location. On Unix, this is usually
|
||||
@code{/usr/local/etc/avrdude.conf}, while on Windows it is usally in the
|
||||
same location as the executable file. The name of this file can be
|
||||
changed using the @code{-C} command line option. After the system wide
|
||||
changed using the @option{-C} command line option. After the system wide
|
||||
configuration file is parsed, AVRDUDE looks for a per-user configuration
|
||||
file to augment or override the system wide defaults. On Unix, the
|
||||
per-user file is @code{.avrduderc} within the user's home directory. On
|
||||
|
|
@ -660,6 +684,9 @@ directory as the executable.
|
|||
* Other Notes::
|
||||
@end menu
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node AVRDUDE Defaults, Programmer Definitions, Configuration File, Configuration File
|
||||
@section AVRDUDE Defaults
|
||||
|
||||
|
|
@ -667,19 +694,22 @@ directory as the executable.
|
|||
|
||||
@item default_parallel = "@var{default-parallel-device}";
|
||||
Assign the default parallel port device. Can be overidden using the
|
||||
@code{-P} option.
|
||||
@option{-P} option.
|
||||
|
||||
@item default_serial = "@var{default-serial-device}";
|
||||
Assign the default serial port device. Can be overidden using the
|
||||
@code{-P} option.
|
||||
@option{-P} option.
|
||||
|
||||
@item default_programmer = "@var{default-programmer-id}";
|
||||
Assign the default programmer id. Can be overidden using the @code{-c}
|
||||
Assign the default programmer id. Can be overidden using the @option{-c}
|
||||
option.
|
||||
|
||||
@end table
|
||||
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Programmer Definitions, Part Definitions, AVRDUDE Defaults, Configuration File
|
||||
@section Programmer Definitions
|
||||
|
||||
|
|
@ -704,6 +734,9 @@ programmer
|
|||
@end example
|
||||
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Part Definitions, Other Notes, Programmer Definitions, Configuration File
|
||||
@section Part Definitions
|
||||
|
||||
|
|
@ -746,6 +779,9 @@ part
|
|||
* Instruction Format::
|
||||
@end menu
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Instruction Format, , Part Definitions, Part Definitions
|
||||
@subsection Instruction Format
|
||||
|
||||
|
|
@ -798,6 +834,9 @@ write = "1 1 0 0 0 0 0 0 x x x x x x x x",
|
|||
|
||||
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Other Notes, , Part Definitions, Configuration File
|
||||
@section Other Notes
|
||||
|
||||
|
|
@ -837,27 +876,72 @@ problem with the at90s4433/2333's; see the at90s4433 errata at:
|
|||
@end itemize
|
||||
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Platform Dependent Information, , Configuration File, Top
|
||||
@appendix Platform Dependent Information
|
||||
|
||||
@menu
|
||||
* FreeBSD::
|
||||
* Linux::
|
||||
* Unix::
|
||||
* Windows::
|
||||
@end menu
|
||||
|
||||
@node FreeBSD, Linux, Platform Dependent Information, Platform Dependent Information
|
||||
@section FreeBSD
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Unix, Windows, Platform Dependent Information, Platform Dependent Information
|
||||
@section Unix
|
||||
|
||||
@menu
|
||||
* Unix Installation::
|
||||
* Unix Configuration Files::
|
||||
* Unix Port Names::
|
||||
* Unix Documentation::
|
||||
@end menu
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Unix Installation, Unix Configuration Files, Unix, Unix
|
||||
@subsection Unix Installation
|
||||
|
||||
@noindent
|
||||
To build and install from the source tarball on Unix like systems:
|
||||
|
||||
@example
|
||||
$ gunzip -c avrdude-@value{VERSION}.tar.gz | tar xf -
|
||||
$ cd avrdude-@value{VERSION}
|
||||
$ ./configure
|
||||
$ make
|
||||
$ su root -c 'make install'
|
||||
@end example
|
||||
|
||||
The default location of the install is into @code{/usr/local} so you
|
||||
will need to be sure that @code{/usr/local/bin} is in your @code{PATH}
|
||||
environment variable.
|
||||
|
||||
If you do not have root access to your system, you can do the the
|
||||
following instead:
|
||||
|
||||
@example
|
||||
$ gunzip -c avrdude-@value{VERSION}.tar.gz | tar xf -
|
||||
$ cd avrdude-@value{VERSION}
|
||||
$ ./configure --prefix=$HOME/local
|
||||
$ make
|
||||
$ make install
|
||||
@end example
|
||||
|
||||
@menu
|
||||
* FreeBSD Installation::
|
||||
* FreeBsd Configuration Files::
|
||||
* FreeBSD Port Names::
|
||||
* FreeBSD Documentation::
|
||||
* Linux Installation::
|
||||
@end menu
|
||||
|
||||
@node FreeBSD Installation, FreeBsd Configuration Files, FreeBSD, FreeBSD
|
||||
@subsection Installation
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node FreeBSD Installation, Linux Installation, Unix Installation, Unix Installation
|
||||
@subsubsection FreeBSD Installation
|
||||
|
||||
@noindent
|
||||
AVRDUDE is installed via the FreeBSD Ports Tree as follows:
|
||||
|
|
@ -880,72 +964,114 @@ Of course, you must be connected to the Internet for these methods to
|
|||
work, since that is where the source as well as the pre-built package is
|
||||
obtained.
|
||||
|
||||
|
||||
@node FreeBsd Configuration Files, FreeBSD Port Names, FreeBSD Installation, FreeBSD
|
||||
@subsection Configuration Files
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Linux Installation, , FreeBSD Installation, Unix Installation
|
||||
@subsubsection Linux Installation
|
||||
|
||||
@noindent
|
||||
The default configuration file for FreeBSD is located at
|
||||
@code{/usr/local/etc/avrdude.conf}. This can be changed by using the
|
||||
@code{-C} command line option. Additionally, the user's home directory
|
||||
is search for a file named @code{.avrduderc}, and if found, is used to
|
||||
On rpm based linux systems (such as RedHat, SUSE, Mandrake, etc), you
|
||||
can build and install the rpm binaries directly from the tarball:
|
||||
|
||||
@example
|
||||
$ su - root
|
||||
# rpmbuild -tb avrdude-@value{VERSION}.tar.gz
|
||||
# rpm -Uvh /usr/src/redhat/RPMS/i386/avrdude-@value{VERSION}-1.i386.rpm
|
||||
@end example
|
||||
|
||||
Note that the path to the resulting rpm package, differs from system
|
||||
to system. The above example is specific to RedHat.
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Unix Configuration Files, Unix Port Names, Unix Installation, Unix
|
||||
@subsection Unix Configuration Files
|
||||
|
||||
@noindent
|
||||
When AVRDUDE is build using the default @option{--prefix} configure
|
||||
option, the default configuration file for a Unix system is located at
|
||||
@code{/usr/local/etc/avrdude.conf}. This can be overridden by using the
|
||||
@option{-C} command line option. Additionally, the user's home directory
|
||||
is searched for a file named @code{.avrduderc}, and if found, is used to
|
||||
augment the system default configuration file.
|
||||
|
||||
@node FreeBSD Port Names, FreeBSD Documentation, FreeBsd Configuration Files, FreeBSD
|
||||
@subsection Port Names
|
||||
|
||||
@noindent
|
||||
AVRDUDE uses the FreeBSD ppi(4) interface for accessing the parallel
|
||||
port and the sio(4) driver for serial port access. The default name
|
||||
used for the parallel port is @code{/dev/ppi0}, while the default serial
|
||||
port device is @code{/dev/cuaa0}.
|
||||
|
||||
@node FreeBSD Documentation, , FreeBSD Port Names, FreeBSD
|
||||
@subsection Documentation
|
||||
|
||||
@noindent
|
||||
AVRDUDE installs a manual page as well as HTML and PDF documentation.
|
||||
The manual page is installed in @code{/usr/local/man/man1} area, while
|
||||
the HTML and PDF documentation is installed in
|
||||
@code{/usr/local/share/doc/avrdude} directory.
|
||||
|
||||
|
||||
@node Linux, Windows, FreeBSD, Platform Dependent Information
|
||||
@section Linux
|
||||
|
||||
@menu
|
||||
* Linux Installation::
|
||||
* FreeBSD Configuration Files::
|
||||
* Linux Configuration Files::
|
||||
* Linux Port Names::
|
||||
* Linux Documentation::
|
||||
@end menu
|
||||
|
||||
@node Linux Installation, Linux Configuration Files, Linux, Linux
|
||||
@subsection Installation
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node FreeBSD Configuration Files, Linux Configuration Files, Unix Configuration Files, Unix Configuration Files
|
||||
@subsubsection FreeBSD Configuration Files
|
||||
|
||||
@noindent
|
||||
Empty.
|
||||
When AVRUDE is installed using the FreeBSD ports system, the system
|
||||
configuration file is always @code{/usr/local/etc/avrdude.conf}.
|
||||
|
||||
@node Linux Configuration Files, Linux Port Names, Linux Installation, Linux
|
||||
@subsection Configuration Files
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Linux Configuration Files, , FreeBSD Configuration Files, Unix Configuration Files
|
||||
@subsubsection Linux Configuration Files
|
||||
|
||||
@noindent
|
||||
Empty.
|
||||
When AVRDUDE is installed using from an rpm package, the system
|
||||
configuration file will be always be @code{/etc/avrdude.conf}.
|
||||
|
||||
@node Linux Port Names, Linux Documentation, Linux Configuration Files, Linux
|
||||
@subsection Port Names
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Unix Port Names, Unix Documentation, Unix Configuration Files, Unix
|
||||
@subsection Unix Port Names
|
||||
|
||||
@noindent
|
||||
Empty.
|
||||
The parallel and serial port device file names are system specific.
|
||||
The following table lists the default names for a given system.
|
||||
|
||||
@node Linux Documentation, , Linux Port Names, Linux
|
||||
@subsection Documentation
|
||||
@multitable @columnfractions .30 .30 .30
|
||||
@item @strong{System}
|
||||
@tab @strong{Default Parallel Port}
|
||||
@tab @strong{Default Serial Port}
|
||||
@item FreeBSD
|
||||
@tab @code{/dev/ppi0}
|
||||
@tab @code{/dev/cuaa0}
|
||||
@item Linux
|
||||
@tab @code{/dev/parport0}
|
||||
@tab @code{/dev/ttyS0}
|
||||
@end multitable
|
||||
|
||||
On FreeBSD systems, AVRDUDE uses the ppi(4) interface for
|
||||
accessing the parallel port and the sio(4) driver for serial port
|
||||
access.
|
||||
|
||||
On Linux systems, AVRDUDE uses the ppdev interface for
|
||||
accessing the parallel port and the tty driver for serial port
|
||||
access.
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Unix Documentation, , Unix Port Names, Unix
|
||||
@subsection Unix Documentation
|
||||
|
||||
@noindent
|
||||
Empty.
|
||||
AVRDUDE installs a manual page as well as info, HTML and PDF
|
||||
documentation. The manual page is installed in
|
||||
@code{/usr/local/man/man1} area, while the HTML and PDF documentation
|
||||
is installed in @code{/usr/local/share/doc/avrdude} directory. The
|
||||
info manual is installed in @code{/usr/local/info/avrdude.info}.
|
||||
|
||||
Note that these locations can be altered by various configure options
|
||||
such as @option{--prefix}.
|
||||
|
||||
@node Windows, , Linux, Platform Dependent Information
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Windows, , Unix, Platform Dependent Information
|
||||
@section Windows
|
||||
|
||||
@menu
|
||||
|
|
@ -957,12 +1083,18 @@ Empty.
|
|||
* Credits.::
|
||||
@end menu
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Windows Installation, Windows Configuration Files, Windows, Windows
|
||||
@subsection Installation
|
||||
|
||||
@noindent
|
||||
Empty.
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Windows Configuration Files, Windows Port Names, Windows Installation, Windows
|
||||
@subsection Configuration Files
|
||||
|
||||
|
|
@ -971,6 +1103,9 @@ Empty.
|
|||
* How AVRDUDE finds the configuration files.::
|
||||
@end menu
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Configuration file names, How AVRDUDE finds the configuration files., Windows Configuration Files, Windows Configuration Files
|
||||
@subsubsection Configuration file names
|
||||
|
||||
|
|
@ -979,6 +1114,9 @@ AVRDUDE on Windows looks for a system configuration file name of
|
|||
@code{avrdude.conf} and looks for a user override configuration file of
|
||||
@code{avrdude.rc}.
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node How AVRDUDE finds the configuration files., , Configuration file names, Windows Configuration Files
|
||||
@subsubsection How AVRDUDE finds the configuration files.
|
||||
|
||||
|
|
@ -1012,6 +1150,9 @@ The directories that are listed in the PATH environment variable.
|
|||
@end enumerate
|
||||
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Windows Port Names, Using the parallel port, Windows Configuration Files, Windows
|
||||
@subsection Port Names
|
||||
|
||||
|
|
@ -1020,6 +1161,9 @@ The directories that are listed in the PATH environment variable.
|
|||
* Parallel Ports::
|
||||
@end menu
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Serial Ports, Parallel Ports, Windows Port Names, Windows Port Names
|
||||
@subsubsection Serial Ports
|
||||
|
||||
|
|
@ -1027,6 +1171,9 @@ The directories that are listed in the PATH environment variable.
|
|||
When you select a serial port (i.e. when using an STK500) use the
|
||||
Windows serial port device names such as: com1, com2, etc.
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Parallel Ports, , Serial Ports, Windows Port Names
|
||||
@subsubsection Parallel Ports
|
||||
|
||||
|
|
@ -1053,7 +1200,9 @@ name of the port the corresponds to the base address of the parallel
|
|||
port that you want.
|
||||
|
||||
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Using the parallel port, Documentation, Windows Port Names, Windows
|
||||
@subsection Using the parallel port
|
||||
|
||||
|
|
@ -1062,6 +1211,9 @@ port that you want.
|
|||
* Windows 95/98::
|
||||
@end menu
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Windows NT/2K/XP, Windows 95/98, Using the parallel port, Using the parallel port
|
||||
@subsubsection Windows NT/2K/XP
|
||||
|
||||
|
|
@ -1099,6 +1251,9 @@ means that after the first time install_giveio is executed, you should
|
|||
be able to subsequently execute the batch file from any directory and have
|
||||
it successfully start the driver.
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Windows 95/98, , Windows NT/2K/XP, Using the parallel port
|
||||
@subsubsection Windows 95/98
|
||||
|
||||
|
|
@ -1106,12 +1261,18 @@ it successfully start the driver.
|
|||
On Windows 95 and 98 the giveio.sys driver is not needed.
|
||||
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Documentation, Credits., Using the parallel port, Windows
|
||||
@subsection Documentation
|
||||
|
||||
@noindent
|
||||
Empty.
|
||||
|
||||
@c
|
||||
@c Node
|
||||
@c
|
||||
@node Credits., , Documentation, Windows
|
||||
@subsection Credits.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue