.TH DFU-UTIL 1 "February 29, 2008".SH NAMEdfu-util \- Device firmware update (DFU) USB programmer.SH SYNOPSIS.B dfu-util \fR[\fB\-ldpciatUDRhV\fR].SH DESCRIPTION.B dfu-utilis a program that implements the host (PC) side of the USB DFU(Universal Serial Bus Device Firmware Upgrade) protocol..spIn the OpenMoko project (for example), this program is used to communicatewith the specially enhanced u-boot boot loader, which implements the DFUdevice side..SH OPTIONS.TP.B "\-l, \-\-list"List the currently attached DFU capable USB devices..TP.BR "\-d, \-\-device" " VENDOR:PRODUCT"Specify vendor/product ID of the DFU device. Both.B VENDORand.B PRODUCTare hex-numbers which must start with.BR 0x .Example:.sp.B "  $ dfu-util --device 0x1457:0x5119".spIf 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 deviceit shall use..TP.BR "\-p, \-\-path" " BUS-PORT. ... .PORT"Specify the path to the DFU device..TP.BR "\-c, \-\-cfg" " CONFIG-NR"Specify the configuration of the DFU device..TP.BR "\-i, \-\-intf" " INTF-NR"Specify the DFU interface number..TP.BR "\-a, \-\-alt" " ALT"Specify the altsetting of the DFU interface by name or by number..TP.B "\-t, \-\-transfer-size"Specify the number of bytes per USB transfer. If you don't supply thisoption, the maximum possible size for your combination of host OS andUSB device is chosen (for optimal performance)..TP.BR "\-U, \-\-upload" " FILE"Read firmware from device into.BR FILE ..sp.B Note:Upload support is currently broken..TP.BR "\-D, \-\-download" " FILE"Write firmware from.B FILEinto device..TP.B "\-R, \-\-reset"Issue USB reset signalling once we're finished..TP.B "\-h, \-\-help"Show a help text and exit..TP.B "\-V, \-\-version"Show version information and exit..SH EXAMPLESHere are some examples for the usage of dfu-util in the OpenMoko project(working with the Neo1973 hardware):.PPFlashing the rootfs:.br.B "  $ dfu-util -a rootfs -R -D /path/to/openmoko-devel-image.jffs2".PPFlashing the kernel:.br.B "  $ dfu-util -a kernel -R -D /path/to/uImage".PPFlashing the bootloader:.br.B "  $ dfu-util -a u-boot -R -D /path/to/u-boot.bin".PPCopying a kernel into RAM:.br.B "  $ dfu-util -a 0 -R -D /path/to/uImage".spOnce this has finished, the kernel will be available at the default loadaddress of 0x32000000 in Neo1973 RAM..sp.B Note:You cannot transfer more than 2MB of data into RAM using this method..SH BUGSPlease see.B http://wiki.openmoko.org/wiki/Dfu-utilfor some limitations and bugs in the current dfu-util code..PPPlease report any further bugs at.B http://bugzilla.openmoko.orgor on the openmoko-kernel mailing list at.BR openmoko-kernel@lists.openmoko.org ..SH LICENCE.B dfu-utilis covered by the GNU General Public License (GPL), version 2 or later..SH AUTHORSWeston Schmidt <weston_schmidt@yahoo.com>.brHarald Welte <hwelte@hmw-consulting.de>.PPThis 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).