ABLE Application README - ATMProg
=================================

Copyright 2006 Simtec Electronics


Summary
-------

  The atmprog utility is used for writing the firmware to the ATMega devices
  used on some Simtec boards, as well as all other aspects of the device
  setup.

  Due to the way the ATMega programming interface works, even a simple
  ID will cause the device to be reset. This means that any programming
  operation will take effect when the utility exits, as part of the
  exit sequence is to de-assert the reset line.


Usage
-----

  > atmprog --vr2k|--bbb2016a [--verbose] [--write-flash|--wf <file>]
            [--write-eeprom|--wee <file>] [--erase] [--fuse-show|--fuse]
	    [--bodlevel|--bl <value>]
            [--save-eeprom]

Examples
--------

  Identify the device on the system

  > atmprog --vr2k

  Write both the flash and the EEPROM memory

  > atmprog --vr2k --wf atmflash.hex --we atmeeprom.hex


Options
-------

  The current version of atmprog does not have any board auto-detection
  mechanisms. This means that the board type needs to be passed to the
  utility when it is run.

  --vr2k

	Select the VR2000 as the current board.


  --bbd2016a

	Select the BBD2016A as the current board.


   The following are the general options that can be passed after the
   board type has been selected. Most of them have a short and long
   version:

  --erase

	Erase the flash. This may, depending on the current fuse-map
	erase the EEPROM as well.


  --fuse-show
  --fuse
	Show the current fuse-map of the ATMega.

  --bodlevel <value>
  --bl <value>

        Write the brown-out detect level of the ATMega.

	Recommended value is 4, which means ca. 5v on an AtMega48.

  --save-eeprom
  --see

	Ensure the EEPROM contents is saved when programming the flash.

	This is necessary as some modes of ATMega operation implicitly
	link the flash erase with an EEPROM erase.


  --write-eeprom [file]
  --we [file]

	Write the specified file to the EEPROM on the ATMega.


  --write-flash [file]
  --wf [file]
	
	This writes the specified file to the ATMega flash,
	erasing the flash first (see --erase for side effects).


  --verbose

	Increase the verbosity of the tool.