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

SYNOPSIS
       avrp [-s <serial port>] [-a <chip type>] [-prv] [-f <file-
       name>]   [-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.fan-
       gorn.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  pro-
       grammers.

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  pro-
              gram  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.   Sup-
              portet  formats  are  Intel HEX and Atmel's generic
              fileformat.

       -e <filename>
              Specifies which eeprom-file  to  read/write.   Sup-
              portet  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
       /usr/local/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 Tem-
       ple Place - Suite 330, Boston, MA 02111-1307, USA.
AUTHOR
       Jon Anders Haugum <jonah@colargol.tihlde.hist.no>
