1DFU-UTIL(1)                 General Commands Manual                DFU-UTIL(1)
2
3
4

NAME

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

SYNOPSIS

9       dfu-util [-ldpciatUDRhvV]
10

DESCRIPTION

12       dfu-util is a program that implements the host (PC) side of the USB DFU
13       (Universal Serial Bus Device Firmware Upgrade) protocol.
14
15       In the OpenMoko project (for example), this program is used to communi‐
16       cate  with  the specially enhanced u-boot boot loader, which implements
17       the DFU device side.
18

OPTIONS

20       -l, --list
21              List the currently attached DFU capable USB devices.
22
23       -d, --device VENDOR:PRODUCT
24              Specify vendor/product ID of the DFU  device.  Both  VENDOR  and
25              PRODUCT are hex-numbers which must start with 0x.  Example:
26
27                $ dfu-util --device 0x1457:0x5119
28
29              If  you only have one standards-compliant DFU device attached to
30              your PC, this is optional. However, as soon as you have multiple
31              DFU  devices, dfu-util will detect this and abort, asking you to
32              specify which device it shall use.
33
34       -p, --path BUS-PORT. ... .PORT
35              Specify the path to the DFU device.
36
37       -c, --cfg CONFIG-NR
38              Specify the configuration of the DFU device.
39
40       -i, --intf INTF-NR
41              Specify the DFU interface number.
42
43       -a, --alt ALT
44              Specify the altsetting of the DFU interface by name or  by  num‐
45              ber.
46
47       -t, --transfer-size
48              Specify  the number of bytes per USB transfer. If you don't sup‐
49              ply this option, the maximum possible size for your  combination
50              of host OS and USB device is chosen (for optimal performance).
51
52       -U, --upload FILE
53              Read firmware from device into FILE.
54
55              Note: Upload support is currently broken.
56
57       -D, --download FILE
58              Write firmware from FILE into device.
59
60       -R, --reset
61              Issue USB reset signalling once we're finished.
62
63       -h, --help
64              Show a help text and exit.
65
66       -v, --verbose
67              Print  more  information about dfu-util's operation. A second -v
68              will turn on verbose logging of USB requests.
69
70       -V, --version
71              Show version information and exit.
72

EXAMPLES

74       Here are some examples for  the  usage  of  dfu-util  in  the  OpenMoko
75       project (working with the Neo1973 hardware):
76
77       Flashing the rootfs:
78         $ dfu-util -a rootfs -R -D /path/to/openmoko-devel-image.jffs2
79
80       Flashing the kernel:
81         $ dfu-util -a kernel -R -D /path/to/uImage
82
83       Flashing the bootloader:
84         $ dfu-util -a u-boot -R -D /path/to/u-boot.bin
85
86       Copying a kernel into RAM:
87         $ dfu-util -a 0 -R -D /path/to/uImage
88
89       Once  this  has  finished,  the kernel will be available at the default
90       load address of 0x32000000 in Neo1973 RAM.
91
92       Note: You cannot transfer more than 2MB of data  into  RAM  using  this
93       method.
94

BUGS

96       Please  see http://wiki.openmoko.org/wiki/Dfu-util for some limitations
97       and bugs in the current dfu-util code.
98
99       Please report any further bugs at  http://bugzilla.openmoko.org  or  on
100       the openmoko-kernel mailing list at openmoko-kernel@lists.openmoko.org.
101

LICENCE

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

AUTHORS

107       Weston Schmidt <weston_schmidt@yahoo.com>
108       Harald Welte <hwelte@hmw-consulting.de>
109
110       This manual page was written by Uwe Hermann  <uwe@hermann-uwe.de>.   It
111       is licensed under the terms of the GNU GPL (version 2 or later).
112
113
114
115                               February 29, 2008                   DFU-UTIL(1)
Impressum