Your company here — click to reach over 10,000 unique daily visitors

qmi-firmware-update - Man Page

Update firmware in QMI devices



qmi-firmware-update [OPTIONâ.¦] FILE1 FILE2... - Update firmware in QMI devices

Generic device selection options

-s,  --busnum-devnum=[BUS:]DEV

Select device by bus and device number (in decimal).

-d,  --vid-pid=VID[:PID]

Select device by device vendor and product id (in hexadecimal).

-w,  --cdc-wdm=[PATH]

Select device by QMI/MBIM cdc-wdm device path (e.g. /dev/cdc-wdm0).

-t,  --tty=[PATH]

Select device by serial device path (e.g. /dev/ttyUSB2).

Update options (normal mode)

-u,  --update

Launch firmware update process.

-f,  --firmware-version=[VERSION]

Firmware version (e.g. '').

-c,  --config-version=[VERSION]

Config version (e.g. '005.025_002').

-C,  --carrier=[CARRIER]

Carrier name (e.g. 'Generic').


Run update operation even with version string errors.


Download images even if module says it already has them.


Index storage for the modem image.


Don't wait to validate the running firmware after update.

Reset options (normal mode)

-b,  --reset

Reset device into download mode.

Update options (download mode)

-U,  --update-download

Launch firmware update process while in download (boot & hold) mode.

Verify options

-z,  --verify

Analyze and verify firmware images.

Application Options

-p, --device-open-proxy

Request to use the 'qmi-proxy' proxy.


Open a cdc-wdm device explicitly in QMI mode


Open a cdc-wdm device explicitly in MBIM mode


Open a cdc-wdm device in either QMI or MBIM mode (default)


Ignore ModemManager runtime check

-v, --verbose

Run action with verbose messages in standard output, including the debug ones.

-S, --silent

Run action with no messages in standard output; not even the error ones.

-L, --verbose-log=[PATH]

Write verbose messages to an output file.

-V, --version

Print version.

-h, --help

Show help.

-H, --help-examples

Show help examples.




Use this program with caution. The authors take *no* responsibility if any device gets broken as a result of using this program.

Please report issues to the libqmi mailing list at:


qmi-firmware-update 1.34.0

Copyright (C) 2016-2022 Aleksander Morgado Copyright (C) 2022 VMware, Inc. Copyright (C) 2016-2019 Bjørn Mork Copyright (C) 2016-2018 Zodiac Inflight Innovations

License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl-2.0.html> This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

See Also

The full documentation for qmi-firmware-update is maintained as a Texinfo manual.  If the info and qmi-firmware-update programs are properly installed at your site, the command

info qmi-firmware-update

should give you access to the complete manual.


January 2024