mirror of
https://git.proxmox.com/git/fwupd
synced 2025-06-12 18:03:18 +00:00
e6121ae3c7
Some devices such as the Quectel EG25-G modem need some breathing room between fastboot commands. This quirk allows to specify for such devices a delay which is used after each read or write command. Without this, the Quectel EG25-G modem's fastboot bootloader cannot handle this and crashes.
63 lines
1.6 KiB
Markdown
63 lines
1.6 KiB
Markdown
# Fastboot
|
|
|
|
## Introduction
|
|
|
|
This plugin is used to update hardware that uses the fastboot protocol.
|
|
|
|
## Firmware Format
|
|
|
|
The daemon will decompress the cabinet archive and extract a firmware blob in
|
|
ZIP file format. Inside the zip file must be all the firmware images for each
|
|
partition and a manifest file. The partition images can be in any format, but
|
|
the manifest must be either an Android `flashfile.xml` format file, or a QFIL
|
|
`partition_nand.xml` format file.
|
|
|
|
For both types, all partitions with a defined image found in the zip file will
|
|
be updated.
|
|
|
|
This plugin supports the following protocol ID:
|
|
|
|
* com.google.fastboot
|
|
|
|
## GUID Generation
|
|
|
|
These devices use the standard USB DeviceInstanceId values, e.g.
|
|
|
|
* `USB\VID_18D1&PID_4EE0&REV_0001`
|
|
* `USB\VID_18D1&PID_4EE0`
|
|
* `USB\VID_18D1`
|
|
|
|
## Update Behavior
|
|
|
|
A fastboot device usually presents in runtime mode (or with no interface),
|
|
but if the user puts the device into fastboot mode using a physical button
|
|
it then enumerates with a USB descriptor. On attach the device reboots to
|
|
runtime mode which *may* mean the device "goes away".
|
|
|
|
For this reason the `REPLUG_MATCH_GUID` internal device flag is used so that
|
|
the bootloader and runtime modes are treated as the same device.
|
|
|
|
## Quirk Use
|
|
|
|
This plugin uses the following plugin-specific quirk:
|
|
|
|
### FastbootBlockSize
|
|
|
|
Block size to use for transfers.
|
|
|
|
Since: 1.2.2
|
|
|
|
### FastbootOperationDelay
|
|
|
|
Time in ms to delay after a read or write operation.
|
|
|
|
Since: 1.7.4
|
|
|
|
## Vendor ID Security
|
|
|
|
The vendor ID is set from the USB vendor, for example `USB:0x18D1`
|
|
|
|
## External Interface Access
|
|
|
|
This plugin requires read/write access to `/dev/bus/usb`.
|