1DFU-TOOL(1) User Commands DFU-TOOL(1)
2
6 dfu-tool - dfu-tool
7
9 This manual page documents briefly the dfu-tool command.
10 dfu-tool allows a user to write various kinds of firmware onto devices
12 supporting the USB Device Firmware Upgrade protocol. This tool can be
13 used to switch the device from the normal runtime mode to `DFU mode'
14 which allows the user to read and write firmware. Either the whole
15 device can be written in one operation, or individual `targets' can be
16 specified with the alternative name or number.
17 dfu-tool uses the libdfu shared library to perform actions. All syn‐
19 chronous actions can be safely cancelled and on failure will return
20 errors with both a type and a full textual description. libdfu sup‐
21 ports DFU 1.0, DFU 1.1 and the ST DfuSe vendor extension, and handles
22 many device `quirks' necessary for the real-world implementations of
23 DFU.
24 Additionally dfu-tool can be used to convert firmware from various dif‐
26 ferent formats, or to modify details about the elements, images and
27 metadata contained inside the firmware file. For example, you can eas‐
28 ily convert DFU 1.1 firmware into the vendor-specific DfuSe format,
29 convert a Intel HEX file into a raw file padded to a specific size, or
30 add new copyright and licensing information to an existing file.
31 Fields such as the vendor and product IDs can be changed, and the
32 firmware elements can be encrypted and decrypted using various differ‐
33 ent methods. Merging two DfuSe files together is also possible,
34 although specifying different alt-setting numbers before merging is a
35 good idea to avoid confusion.
36 Although dfu-tool tries to provide a large number of easy-to-use com‐
38 mands, it may only be possible to do certain operations using the
39 libdfu library directly. This is easier than it sounds, as the library
40 is built with GObject Introspection support making it usable in many
41 languages such as C, Javascript and Python. Furthermore, using the
42 library is a good idea if you want to perform multiple operations on
43 large firmware files, for instance, converting from an Intel HEX file,
44 padding to a certain size, setting vendor and adding licensing informa‐
45 tion and then saving to a remote location.
46 Failed to load quirks: Error creating directory /var/cache/fwupd: Per‐
48 mission denied
49dfu-tool 1.4.1 April 2020 DFU-TOOL(1)