isp-at89.1

at51系列单片机编程源码

.\"                              hey, Emacs:   -*- nroff -*-
.\" pbbuttons 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, 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.TH ISP-AT89 1 "11. January 2004"
.\" Please update the above date whenever this man page is modified.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins (default)
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
isp-at89 \- An In-System-Programming tool for the AT89S8252 from ATMEL
.SH SYNOPSIS
.B isp-at89
.RI [ options ]
.RI command
.RI [<datafile>]
.SH DESCRIPTION
\fBisp-at89\fP is an In-System-Programmer for ATMEL's AT89S8252 microcontroller.
This microcontroller is equipped with 8k flash memory, 2k EEPROM and 256 bytes
RAM. Additional external memory could be connected. All this memory types (internal
Flash, EEPROM and external SRAM/Flash ROM) could be read and written with this tool.
.PP
External memory could not be accessed yet. This option is planned for later versions.
.PP
The interal memory of the microcontroller is programmed through the SPI
interface which is emulated through the parallel port on the Linux side. You
need a special cable which could easily built up by yourself. Please see
README for details.
.PP
The input file format can be binary or intel hex format. The type of input file
will automatically detected. Everything not intel hex is assumed as binary.
.PP
.SH COMMANDS
The command tells the program what to do. Four commands are currently supported:
.TP
\fBtest\fR
This command activates the hardware test mode. This mode is mainly for
testing the parallel port cabling to the microcontroller. Through a
simple user interface each used line at the parport could be toggled to
verify the according connection.
.TP
\fBread\fR
Read data from memory. Specify the memory type to read from with the '--memory'
option below. If a datafile was given the read memory data would be written to
this file. If the datafile was missing, the action defaults to dump action.
Please see below for further information.
.TP
\fBwrite\fR
Write data into memory. Specify the memory type to write to with the '--memory'
option below. This action require a datafile. If it was missing, an error message
would be printed and the program terminates.
.TP
\fBdump\fR
Dump the datafile in human readable form. The data will be printed as hex codes and
if possible as ASCII. Alternatively to the hex output the code from the
microcontroller could be disassembled. Look at option '--disassemble' below for
further information.
.SH OPTIONS
\fBisp-at89\fP accepts the following options:
.TP
\fB-p\fR, \fB\-\-ppdev\fR=\fIparport device\fR
Which parport is the microcontroller attached to? The default is /dev/parport0.
.TP
\fB-m\fR, \fB\-\-memory\fR=\fImemory type\fR
With this option the memory type to act on could be specified. Currently three
types are supported:
.PP
.ad l
.in 21
.ti -7
\fBintern\fR
Read from or write to the 8K internal program memory. If no --memory option
is specified this will be the default memory to act on.
.PP
.ad l
.in 21
.ti -7
\fBeeprom\fR
Read from or write to the 2K internal EEPROM.
.PP
.ad l
.in 21
.ti -7
\fBextern\fR
Read from or write to external flash memory. This needs a special boot loader in
the ATMEL microprocessor which will do the programming. This is a future option
and not yet implemented.
.TP
\fB-c\fR, \fB\-\-check (verify)\fR
Verify the data written to the microcontroller. This option will only
be accepted in combination with write operations. Default is 'no verify'.
.TP
\fB-e\fR, \fB\-\-erase\fR
Erase the memory prior to writing operations. This option will only be accepted
in combination with write operations. Default is 'no erase'.
.TP
\fB-d\fR, \fB\-\-disassemble\fR
This option enables the integrated AT89S8252 disassembler. This option can be
used in combination with read and dump commands. The output will be printed to
stdout. If you want to save the output redirect stdout to whatever.
.TP
.B \-h, \-\-help
Show summary of options.
.TP
.B \-v, \-\-version
Show version of \fBisp-at89\fP.

.SH AUTHOR
Matthias Grimm, Andreas Ochmann and Sascha Flohr.