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>