1DFU-UTIL(1) General Commands Manual DFU-UTIL(1)
2
3
4
6 dfu-util - Device firmware update (DFU) USB programmer
7
9 dfu-util [-ldpciatUDRhvV]
10
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
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
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
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
103 dfu-util is covered by the GNU General Public License (GPL), version 2
104 or later.
105
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)