NAME

       dfu-util - Device firmware update (DFU) USB programmer

SYNOPSIS

       dfu-util [-ldpciatUDRhvV]

DESCRIPTION

       dfu-util  is  a  program  that  implements  the host (computer) side of the USB DFU (Universal Serial Bus
       Device Firmware Upgrade) protocol.

       In the OpenMoko project (for example), this program is used to communicate with the specially enhanced u-
       boot boot loader, which implements the DFU device side.

OPTIONS

       -l, --list
              List the currently attached DFU capable USB devices.

       -d, --device VENDOR:PRODUCT
              Specify  vendor/product  ID of the DFU device. Both VENDOR and PRODUCT are hexadecimal numbers (no
              prefix needed).  Example:

                $ dfu-util --device 1457:51ab

              If you only have one standards-compliant DFU  device  attached  to  your  PC,  this  is  optional.
              However, as soon as you have multiple DFU devices, dfu-util will detect this and abort, asking you
              to specify which device it shall use.

       -p, --path BUS-PORT. ... .PORT
              Specify the path to the DFU device.

       -c, --cfg CONFIG-NR
              Specify the configuration of the DFU device.

       -i, --intf INTF-NR
              Specify the DFU interface number.

       -a, --alt ALT
              Specify the altsetting of the DFU interface by name or by number.

       -t, --transfer-size
              Specify the number of bytes per USB transfer.  If  you  don't  supply  this  option,  the  maximum
              possible size for your combination of host OS and USB device is chosen (for optimal performance).

       -U, --upload FILE
              Read firmware from device into FILE.

              Note: Upload support is currently broken.

       -D, --download FILE
              Write firmware from FILE into device.

       -R, --reset
              Issue USB reset signalling once we are finished.

       -s, --dfuse-address
              Specify  target  address  for  raw  binary  download/upload on DfuSe devices.  Do not use this for
              downloading DfuSe files.

       -h, --help
              Show a help text and exit.

       -v, --verbose
              Print more information about dfu-util's operation. A second -v will turn on verbose logging of USB
              requests.

       -V, --version
              Show version information and exit.

EXAMPLES

       Here  are  some  examples  for  the  usage  of dfu-util in the OpenMoko project (working with the Neo1973
       hardware):

       Flashing the rootfs:
         $ dfu-util -a rootfs -R -D /path/to/openmoko-devel-image.jffs2

       Flashing the kernel:
         $ dfu-util -a kernel -R -D /path/to/uImage

       Flashing the bootloader:
         $ dfu-util -a u-boot -R -D /path/to/u-boot.bin

       Copying a kernel into RAM:
         $ dfu-util -a 0 -R -D /path/to/uImage

       Once this has finished, the kernel will be available at the default load address of 0x32000000 in Neo1973
       RAM.

       Note: You cannot transfer more than 2MB of data into RAM using this method.

BUGS

       Please  see  http://wiki.openmoko.org/wiki/Dfu-util for some limitations and bugs in the current dfu-util
       code.

       Please report any further bugs at on the openmoko mailing list at openmoko@lists.openmoko.org.

LICENCE

       dfu-util is covered by the GNU General Public License (GPL), version 2 or later.

AUTHORS

       Weston Schmidt <weston_schmidt@yahoo.com>
       Harald Welte <hwelte@hmw-consulting.de>

       This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>.  It is licensed under the terms of  the
       GNU GPL (version 2 or later).

                                                February 29, 2008                                    DFU-UTIL(1)