NAME

       avrp - Atmel AVR programming software to use with Atmel's serial-port programmers

SYNOPSIS

       avrp  [-s  <serial  port>]  [-a  <chip  type>] [-prv] [-f <filename>]  [-e <filename>] [-d
       <deffile>] [-l <lockmode>]  [--enable  <fuse>]  [--disable  <fuse>]  [--version]  [--help]
       [-qIh]

DESCRIPTION

       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.

       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

       Adrian Godwin's programmer can be found on http://www.fangorn.demon.co.uk

       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

       avrp is currently supporting these systems:
           Linux
           FreeBSD
           AmigaOS
           win32 (windows 95++ and NT)

       The source-code part of Atmel's application note AVR910  was  used  to  determine  how  to
       communicate with these programmers.

OPTIONS

       Several  option  can  be  given  after one '-', but if an option requires an argument; the
       argument must be given after that option.

       -s <serial port>
              Specifies which serial port to talk through.  This option can be avoided if you set
              the environment variable AVRP_SERIALPORT

       -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

       -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)

       -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)

       -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)

       -f <filename>
              Specifies  which  flash-file  to  read/write.   Supportet formats are Intel HEX and
              Atmel's generic fileformat.

       -e <filename>
              Specifies which eeprom-file to read/write.  Supportet formats  are  Intel  HEX  and
              Atmel's generic fileformat.

       -l <lockmode>
              Specifies lockmode to progam into the chip. Use '-l list' to get a list of possible
              lockmodes.

       -q     Quiet.  Don't write any progress information.  Will speed up programming.

       -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

       -I     Ignores the signature in the chip. This is very useful if the signature in the chip
              have been destroyed in some way.

       --enable <fuses>
              Enables specified fuses.

       --disable <fuses>
              Disables specified fuses.

       --autoinc
              You can use this to speed up programming on newer programmer firmware.

       --version
              Print out version information.

       --help -h
              Print out a short help text.

FILES

       /etc/avrp.def
              Definition file

ENVIRONMENT

       AVRP_SERIALPORT
              Specifies which serial port to use.

       AVRP_AVRTYPE
              Specifies chip to talk to.

       AVRP_DEFFILE
              Specifies the location of avrp.def

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

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.

AUTHOR

       Jon Anders Haugum <jonah@colargol.tihlde.hist.no>