CISP(1)                                                                CISP(1)



NAME
       cisp - Compact In-System Programmer for Atmel AVR microcontrollers

SYNOPSIS
       cisp options

DESCRIPTION
       This manual page documents briefly the cisp command.

       cisp transfers data to and from the non-volatile program or data memory
       of an Atmel AVR microcontroller over the  Serial  Peripheral  Interface
       (SPI).


OPTIONS
       cisp  follows the usual Unix command line syntax, with options starting
       with a dash (`-').  A file name `-' means standard input or output.

       -c type device
              Specify the type of the SPI adapter and the device name  of  the
              RS-232  interface  or  the device name or address of the printer
              interface connected to the adapter, for example, -c c2n232 com1,
              -c  stk200  /dev/parports/0 or -c dt006 0x3bc.  This option must
              be specified first.

       -C command
              Send a 4-byte command to the device, specified as eight hexadec-
              imal  digits.   Be careful with this option!  For instance, pro-
              gramming the SPIEN fuse bit disables further serial programming.

       -d     Display diagnostic information on the communications.

       -e     Erase the device.

       -l file
              Upload  an Intel hex or Motorola S record file to the flash pro-
              gram memory.

       -v file
              Verify an Intel hex or Motorola S record file against  the  con-
              tents of the flash program memory.

       -s file
              Download  the contents of the flash program memory in Motorola S
              record format.

       -i file
              Download the contents of the flash program memory in  Intel  hex
              format.

       -L file
              Upload an Intel hex or Motorola S record file to the EEPROM data
              memory.

       -V file
              Verify an Intel hex or Motorola S record file against  the  con-
              tents of the EEPROM data memory.

       -S file
              Download  the  contents  of the EEPROM data memory in Motorola S
              record format.

       -I file
              Download the contents of the EEPROM data  memory  in  Intel  hex
              format.

       -h     Display brief usage information.

ADAPTERS
       The  serial  programming  interface  consists of four active wires: the
       outputs RESET, SCK and MOSI, and the input MISO.  The RESET line may be
       hardwired  to ground during programming to simplify the connection.  In
       some adapters for the parallel printer port,  further  lines  are  con-
       nected to enable or status signals.

       cisp  supports two types of SPI adapters via a configuration table that
       is located in the source file comm/commsel.c.   RS-232  based  adapters
       may  be connected to the outputs DTR, RTS and TXD and to the input CTS.
       Adapters can also be connected to an  IBM  PC  style  parallel  printer
       port.  For both adapter types, each SPI line can be inverted if needed.

       The following adapters for the RS-232 interface are supported.

       c2n232 RESET=DTR, SCK=RTS, MOSI=TXD, MISO=CTS, all lines inverted.

       dasa   RESET=RTS, SCK=DTR, MOSI=TXD, MISO=CTS, no lines inverted.

       ponyprog
              RESET=TXD, SCK=RTS, MOSI=DTR, MISO=CTS, RESET inverted.

       The following adapters for the  parallel  printer  interface  are  sup-
       ported.

       dapa   RESET=INIT, SCK=STROBE, MOSI=D0, MISO=BUSY.

       dt006  RESET=D2, SCK=D3, MOSI=D0, MISO=BUSY.

       stk200 The  programming  dongle  for  the  STK200 and STK300 evaluation
              kits.

BUGS
       When the RESET line is not controlled by cisp but hard-wired to ground,
       the  SCK line must be set to logic '0' when the microcontroller is pow-
       ered up.  Otherwise the device may not report itself  properly,  or  it
       may  identify  itself  as  locked.   As cisp leaves the SCK line to the
       logic '0' state at exit, the problem  can  be  fixed  by  powering  the
       microcontroller off and on before restarting cisp.


AUTHOR
       The   cisp  utility  was  designed  and  implemented  by  Marko  Mkel
       <msmakela@nic.funet.fi>.

SEE ALSO
       avr-gcc(1), avr-as(1), objdump(1).



                                 April 2, 2002                         CISP(1)
