.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH QMI-FIRMWARE-UPDATE "1" "April 2023" "qmi-firmware-update " "User Commands"
.SH NAME
qmi-firmware-update \- Update firmware in QMI devices
.SH DESCRIPTION
.SS "Usage:"
.IP
qmi\-firmware\-update [OPTION?] FILE1 FILE2... \- Update firmware in QMI devices
.SS "Generic device selection options:"
.TP
\fB\-s\fR, \fB\-\-busnum\-devnum\fR=\fI\,[BUS\/\fR:]DEV
Select device by bus and device number (in decimal).
.TP
\fB\-d\fR, \fB\-\-vid\-pid\fR=\fI\,VID[\/\fR:PID]
Select device by device vendor and product id (in hexadecimal).
.TP
\fB\-w\fR, \fB\-\-cdc\-wdm\fR=\fI\,[PATH]\/\fR
Select device by QMI/MBIM cdc\-wdm device path (e.g. \fI\,/dev/cdc\-wdm0\/\fP).
.TP
\fB\-t\fR, \fB\-\-tty\fR=\fI\,[PATH]\/\fR
Select device by serial device path (e.g. \fI\,/dev/ttyUSB2\/\fP).
.SS "Update options (normal mode):"
.TP
\fB\-u\fR, \fB\-\-update\fR
Launch firmware update process.
.TP
\fB\-f\fR, \fB\-\-firmware\-version\fR=\fI\,[VERSION]\/\fR
Firmware version (e.g. '05.05.58.00').
.TP
\fB\-c\fR, \fB\-\-config\-version\fR=\fI\,[VERSION]\/\fR
Config version (e.g. '005.025_002').
.TP
\fB\-C\fR, \fB\-\-carrier\fR=\fI\,[CARRIER]\/\fR
Carrier name (e.g. 'Generic').
.TP
\fB\-\-ignore\-version\-errors\fR
Run update operation even with version string errors.
.TP
\fB\-\-override\-download\fR
Download images even if module says it already has them.
.TP
\fB\-\-modem\-storage\-index\fR=\fI\,[INDEX]\/\fR
Index storage for the modem image.
.TP
\fB\-\-skip\-validation\fR
Don't wait to validate the running firmware after update.
.SS "Reset options (normal mode):"
.TP
\fB\-b\fR, \fB\-\-reset\fR
Reset device into download mode.
.SS "Update options (download mode):"
.TP
\fB\-U\fR, \fB\-\-update\-download\fR
Launch firmware update process while in download (boot & hold) mode.
.SS "Verify options:"
.TP
\fB\-z\fR, \fB\-\-verify\fR
Analyze and verify firmware images.
.SS "Application Options:"
.TP
\fB\-p\fR, \fB\-\-device\-open\-proxy\fR
Request to use the 'qmi\-proxy' proxy.
.TP
\fB\-\-device\-open\-qmi\fR
Open a cdc\-wdm device explicitly in QMI mode
.TP
\fB\-\-device\-open\-mbim\fR
Open a cdc\-wdm device explicitly in MBIM mode
.TP
\fB\-\-device\-open\-auto\fR
Open a cdc\-wdm device in either QMI or MBIM mode (default)
.TP
\fB\-\-ignore\-mm\-runtime\-check\fR
Ignore ModemManager runtime check
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Run action with verbose messages in standard output, including the debug ones.
.TP
\fB\-S\fR, \fB\-\-silent\fR
Run action with no messages in standard output; not even the error ones.
.TP
\fB\-L\fR, \fB\-\-verbose\-log\fR=\fI\,[PATH]\/\fR
Write verbose messages to an output file.
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version.
.TP
\fB\-h\fR, \fB\-\-help\fR
Show help.
.TP
\fB\-H\fR, \fB\-\-help\-examples\fR
Show help examples.
.TP
***************************************************************************
Warning!
.IP
***************************************************************************
.IP
Use this program with caution. The authors take *no* responsibility if any
device gets broken as a result of using this program.
.IP
Please report issues to the libqmi mailing list at:
.IP
libqmi\-devel@lists.freedesktop.org
.PP
qmi\-firmware\-update 1.32.4
.IP
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
.PP
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.
.SH "SEE ALSO"
The full documentation for
.B qmi-firmware-update
is maintained as a Texinfo manual.  If the
.B info
and
.B qmi-firmware-update
programs are properly installed at your site, the command
.IP
.B info qmi-firmware-update
.PP
should give you access to the complete manual.