avrp(1) 						      General Commands Manual							   avrp(1)

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>] [--dis-
       able <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  MER-
       CHANTABILITY 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>

Version 1.0 beta 3						 28 September 1998							   avrp(1)