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 [AT] colargol.no>