OS Manuals

/usr/bin/dfu-util

USB Device Firmware Upgrade utility

From dfu-util 0.11-r5 (enterprise-packages), captured 2026-11-08 by running dfu-util --help (exit 0). permalink

Usage: dfu-util [options] ...
  -h --help			Print this help message
  -V --version			Print the version number
  -v --verbose			Print verbose debug statements
  -l --list			List currently attached DFU capable devices
  -e --detach			Detach currently attached DFU capable devices
  -E --detach-delay seconds	Time to wait before reopening a device after detach
  -d --device <vendor>:<product>[,<vendor_dfu>:<product_dfu>]
				Specify Vendor/Product ID(s) of DFU device
  -n --devnum <dnum>		Match given device number (devnum from --list)
  -p --path <bus-port. ... .port>	Specify path to DFU device
  -c --cfg <config_nr>		Specify the Configuration of DFU device
  -i --intf <intf_nr>		Specify the DFU Interface number
  -S --serial <serial_string>[,<serial_string_dfu>]
				Specify Serial String of DFU device
  -a --alt <alt>		Specify the Altsetting of the DFU Interface
				by name or by number
  -t --transfer-size <size>	Specify the number of bytes per USB Transfer
  -U --upload <file>		Read firmware from device into <file>
  -Z --upload-size <bytes>	Specify the expected upload size in bytes
  -D --download <file>		Write firmware from <file> into device
  -R --reset			Issue USB Reset signalling once we're finished
  -w --wait			Wait for device to appear
  -s --dfuse-address address<:...>	ST DfuSe mode string, specifying target
				address for raw file download or upload (not
				applicable for DfuSe file (.dfu) downloads).
				Add more DfuSe options separated with ':'
		leave		Leave DFU mode (jump to application)
		mass-erase	Erase the whole device (requires "force")
		unprotect	Erase read protected device (requires "force")
		will-reset	Expect device to reset (e.g. option bytes write)
		force		You really know what you are doing!
		<length>	Length of firmware to upload from device
Options (19)
OptionDescriptionSource
-h, --help --helpShow a help text and exit.help + man
-V, --version --versionShow version information and exit.help + man
-v, --verbose --verbosePrint more information about dfu-util's operation.help + man
-l, --list --listList the currently attached DFU capable USB devices.help + man
-e, --detach --detachRequest that the device re-enumerate out of run-time mode and into DFU mode as when uploading or downloading, but exit immediately after sending the request.help + man
-E, --detach-delay --detach-delayWhen uploading or downloading, wait SECONDS seconds for the device to re-enumerate after sending the detach request before giving up.help + man
-n --devnumMatch given device number (devnum from --list)help
-p, --path --pathSpecify the path to the DFU device.help + man
-c, --cfg --cfgSpecify the configuration of the DFU device.help + man
-i, --intf --intfSpecify the DFU interface number.help + man
-a, --alt --altSpecify the altsetting of the DFU interface by name or by number.help + man
-t, --transfer-size --transfer-sizeSpecify the number of bytes per USB transfer.help + man
-U, --upload --uploadRead firmware from device into <file>help + man
-Z, --upload-size --upload-sizeSpecify the expected upload size, in bytes.help + man
-D, --download --downloadWrite firmware from <file> into devicehelp + man
-R, --reset --resetIssue USB reset signalling after upload or download has finished.help + man
-w, --wait --waitWait until matching device appears on the USB bus.help + man
-s --dfuse-addressST DfuSe mode string, specifying target address for raw file download or upload (not applicable for DfuSe file (.dfu) downloads).help
--device 1457:51abWork with a device in run-time mode with vendor ID 0x1457 and product ID 0x51ab, or in DFU mode with vendor ID 0x0951 and product ID 0x0026 (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.