dfu-programmer: A C repository from Urus Team

dfu-programmer is an implementation of the Device Firmware Upgrade class
USB driver that enables firmware upgrades for various USB enabled (with the
correct bootloader) Atmel chips.  This program was created because the
Atmel "FLIP" program for flashing devices does not support flashing via USB
on Linux, and because standard DFU loaders do not work for Atmel's chips.

Check out the Atmel website for more information.  They are kind enough to
provide generally correct specifications this implementation is based on.

The project website is http://dfu-programmer.github.io and you can
use that to check for updates.

Currently Supported Chips
=========================
8051 based controllers:
    at89c51snd1c       at89c51snd2c       at89c5130          at89c5131
    at89c5132
AVR based controllers:
    at90usb1287        at90usb1286        at90usb1287-4k     at90usb1286-4k
    at90usb647         at90usb646         at90usb162         at90usb82
    atmega32u6         atmega32u4         atmega32u2         atmega16u4
    atmega16u2         atmega8u2
AVR32 based controllers:
    at32uc3a0128       at32uc3a1128       at32uc3a0256       at32uc3a1256
    at32uc3a0512       at32uc3a1512       at32uc3a0512es     at32uc3a1512es
    at32uc3a364        at32uc3a364s       at32uc3a3128       at32uc3a3128s
    at32uc3a3256       at32uc3a3256s      at32uc3a4256s      at32uc3b064
    at32uc3b164        at32uc3b0128       at32uc3b1128       at32uc3b0256
    at32uc3b1256       at32uc3b0256es     at32uc3b1256es     at32uc3b0512
    at32uc3b1512       at32uc3c064        at32uc3c0128       at32uc3c0256
    at32uc3c0512       at32uc3c164        at32uc3c1128       at32uc3c1256
    at32uc3c1512       at32uc3c264        at32uc3c2128       at32uc3c2256
    at32uc3c2512
XMEGA based controllers:
    atxmega64a1u       atxmega128a1u      atxmega64a3u       atxmega128a3u
    atxmega192a3u      atxmega256a3u      atxmega16a4u       atxmega32a4u
    atxmega64a4u       atxmega128a4u      atxmega256a3bu     atxmega64b1
    atxmega128b1       atxmega64b3        atxmega128b3       atxmega64c3
    atxmega128c3       atxmega256c3       atxmega384c3       atxmega16c4
    atxmega32c4

Experimental support for ST cortex M4:
    stm32f4_B          stm32f4_C          stm32f4_E          stm32f4_G


Simple install procedure for Unix/Linux/MAC
===========================================

  % tar -xzf dfu-programmer-<version>.tar.gz    # unpack the sources
            -- or --
  % git clone https://github.com/dfu-programmer/dfu-programmer.git

  % cd dfu-programmer       # change to the top-level directory

  [ If the source was checked-out from GitHub, run the following command.
    You may also need to do this if your libusb is in a non-standard location,
    or if the build fails to find it for some reason.  This command requires
    that autoconf is installed (sudo apt-get install autoconf) ]

  % ./bootstrap.sh          # regenerate base config files


  [ Optionally you can add autocompletion using the dfu_completion file,
    and possibly instructions provided after running the ./bootstrap command ]

  % ./configure             # regenerate configure and run it

  [ Optionally you can specify where dfu-programmer gets installed
    using the --prefix= option to the ./configure command.  See
    % ./configure --help for more details. ]

  [ By default the build process will use libusb-1.0 if available.
    It tries to auto-discover the library, falling back to the older
    libusb if libusb-1.0 is not available. This process is not entirely
    reliable and may decide that libusb-1.0 is available when in fact
    it is not. You can select libusb using --disable-libusb_1_0. If
    usb library is not available try getting libusb-1.0-0-dev ]

  % make                    # build dfu-programmer

  [ Become root if necessary ]
  % make install            # install dfu-programmer

Build procedure for Windows
===========================

  Building Windows apps from source is never quite as simple ...
  Firstly you need to have MinGW and MSys with developer tools.
  Get them from http://sourceforge.net/projects/mingw/files/

  The windows build uses the libusb-win32 library, which is a
  port of libusb 0.1. For convenience these files are included
  with this distribution, located in the windows sub-directory.
  You need to copy these files to your MinGW install directory
  if they are not already there:

    windows/usb.h -> {path-to-mingw}/include/usb.h
    windows/libusb.a -> {path-to-mingw}/lib/libusb.a

  Open the MinGW shell window and change to the dfu-programmer folder.
  Note that C:\dir is accessed in MinGW using the path /c/dir

  [ If the source was checked-out from GitHub, run the following command ]
  $ ./bootstrap.sh

  $ ./configure --disable-libusb_1_0

  $ make

  The executable will be built in the dfu-programmer/src folder.


Windows Driver Files
====================
Atmel's FLIP programmer also uses libusb-win32, so we use the same
library here and take advantage of Atmel's official certified driver
set. The windows driver files can be downloaded as a separate zip file
dfu-prog-usb-x.x.x.zip
UrusTeam/dfu-programmer
