.TH avrp 1 "28 September 1998" "Version 1.0 beta 3"
.SH NAME
avrp \- Atmel AVR programming software to use with Atmel's serial\-port programmers
.SH SYNOPSIS
.B avrp
[\-s <serial port>] [\-a <chip type>] [\-prv] [\-f <filename>]  [\-e <filename>]
[\-d <deffile>] [\-l <lockmode>] [\-\-enable <fuse>] [\-\-disable <fuse>]
[\-\-version] [\-\-help] [\-qIh]
.SH DESCRIPTION
.B avrp
works on serial\-port programmers which use Atmel's communication protocol
for serial\-port programmers.  These programmers can program AVR (and other)
chips both in serial and parallel mode.
.PP
These programmers are known:
    AVR ICP \- Atmel In-circuit programmer
    AVR PPR \- Atmel parallel programmer
    AVR DEV \- Atmel development board
    AVR A.G \- Parallel mode programmer by Adrian Godwin
.PP
Adrian Godwin's programmer can be found on http://www.fangorn.demon.co.uk
.PP
Instruction on how to build Atmel's in\-circuit programmer can be found on
Atmel's homepage (http://www.atmel.com). Look for application note avr910
.PP
avrp is currently supporting these systems:
    Linux
    FreeBSD
    AmigaOS
    win32 (windows 95++ and NT)
.PP
The source\-code part of Atmel's application note AVR910 was used to determine
how to communicate with these programmers.
.PP
.SH OPTIONS
Several option can be given after one '\-', but if an option requires an
argument; the argument must be given after that option.
.IP "\-s <serial port>"
Specifies which serial port to talk through.  This option can be avoided if you
set the environment variable AVRP_SERIALPORT
.IP "\-a <chip type>"
Specifies what kind of chip to talk to.  Use '\-a list' for chip type to get a list
of supported devices.  You can use the shortest possible abbreviation to
identify a chip.  This option can be avoided if you set the environment variable
AVRP_AVRTYPE
.IP \-p
Program a chip \-f <filename> and/or \-e <filename> must be specified to determine
which files to read from.  (\-f specifes flash, and \-e eeprom)
.IP \-r
Read a chip \-f <filename> and/or \-e <filename> must be specified to determine
which files to write to.  (\-f specifes flash, and \-e eeprom)
.IP \-v
Verify.  Performs a standalone verify.  (The program function will always do a
inline verify) \-f <filename> and/or \-e <filename> must be specified to determine
which files to read from.  (\-f specifes flash, and \-e eeprom)
.IP "\-f <filename>"
Specifies which flash\-file to read/write.  Supportet formats are Intel HEX and
Atmel's generic fileformat.
.IP "\-e <filename>"
Specifies which eeprom\-file to read/write.  Supportet formats are Intel HEX and
Atmel's generic fileformat.
.IP "\-l <lockmode>"
Specifies lockmode to progam into the chip. Use '\-l list' to get a list of
possible lockmodes.
.IP \-q
Quiet.  Don't write any progress information.  Will speed up programming.
.IP "\-d <deffile>"
Specifies the path and filename of avrp.def if default location is not possible.
Can also be set with the environment variable AVRP_DEFFILE
.IP \-I
Ignores the signature in the chip. This is very useful if the signature in the
chip have been destroyed in some way.
.IP "\-\-enable <fuses>"
Enables specified fuses.
.IP "\-\-disable <fuses>"
Disables specified fuses.
.IP "\-\-autoinc"
You can use this to speed up programming on newer programmer firmware.
.IP \-\-version
Print out version information.
.IP "\-\-help \-h"
Print out a short help text.
.SH FILES
.I /etc/avrp.def
.RS
Definition file
.RE
.SH ENVIRONMENT
.IP AVRP_SERIALPORT
Specifies which serial port to use.
.IP AVRP_AVRTYPE
Specifies chip to talk to.
.IP AVRP_DEFFILE
Specifies the location of avrp.def
.SH EXAMPLES
Print out information on the programmer:
   avrp \-s /dev/ttyS1

Same as above, but also give information on the inserted chip:
   avrp \-s /dev/ttyS1 \-a AT90S1200\-D/E/F

Program a chip (flash only, and using a short chip\-descriptor):
   avrp \-s /dev/ttyS1 \-a 1200-d \-p \-f avr910.rom

Read a chip (flash and eeprom, AVRP_SERIALPORT is set):
   avrp \-a 8515 \-rf test.hex \-e test.eep.hex
.SH COPYRIGHT
Copyright (C) 1997\-1998 Jon Anders Haugum

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; see the file COPYING.  If not, write to
the Free Software Foundation, Inc., 59 Temple Place \- Suite 330,
Boston, MA 02111\-1307, USA.
.SH AUTHOR
Jon Anders Haugum <jonah@colargol.tihlde.hist.no>