Skip to content

Commit 89a10c4

Browse files
committed
README: Document firmware updates
Document firmware updates for Qualcomm Linux Debian images. The devices are expected to support UEFI firmware capsule updates. On the OS side, the standard mechanism for firmware updates known as LVFS or fwupd is leverage to update firmware on devices. Note here that currently firmware for devices supported by Qualcomm Linux isn't yet available/pushed on LVFS (WIP). Hence, the fwupdtool is used currently for testing purposes. Signed-off-by: Sumit Garg <[email protected]>
1 parent e1e982b commit 89a10c4

File tree

1 file changed

+29
-0
lines changed

1 file changed

+29
-0
lines changed

README.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,35 @@ Initially, this repository provides [debos](https://github.com/go-debos/debos) r
66

77
We are also working towards providing ready-to-use, pre-built images – stay tuned!
88

9+
## Firmware updates
10+
11+
On standard Linux distros like Debian, firmware updates are generally delivered via Linux Vendor Firmware Service ([LVFS](https://fwupd.org/)). The OEM/ODM vendors usually upload latest firmware releases on LVFS (refer [here](https://lvfs.readthedocs.io/en/latest/upload.html)) as cabinet (.cab) firmware archive files containing at least one metadata (.metainfo.xml) file describing the firmware update. On the device, fwupd is installed which provides a system-activated daemon listening on D-Bus for installing any firmware updates.
12+
13+
### Firmware delivery
14+
15+
On a Desktop system, its usually GNOME Software which monitors LVFS for any firmware updates and pushes to fwupd if any. On a headless system like most embedded devices, the fwupdmgr command line tool can be used to monitor LVFS for firmware updates as follows:
16+
17+
```bash
18+
# Download latest metadata from LVFS
19+
fwupdmgr refresh
20+
21+
# Fetch device specific firmware updates from LVFS
22+
fwupdmgr get-updates
23+
24+
# Install firmware updates
25+
fwupdmgr update
26+
```
27+
28+
### Firmware on devices supported by Qualcomm Linux
29+
30+
The firmware on Qualcomm devices is expected to support UEFI UpdateCapsule plugin for fwupd daemon. However, currently firmware for Qualcomm devices in not available in LVFS which is a work in progress as of now. In order to play with UEFI firmware capsule updates, one can use fwupdtool to locally update firmware like on RB1 as follows:
31+
32+
```bash
33+
# Transfer U-Boot firmware cabinet archive build from scripts/build-u-boot-rb1.sh to RB1
34+
sudo fwupdtool install u-boot.cab
35+
# It will ask for a reboot for the UEFI firmware capsule update to happen
36+
```
37+
938
## Branches
1039

1140
main: Primary development branch. Contributors should develop submissions based on this branch, and submit pull requests to this branch.

0 commit comments

Comments
 (0)