Skip to content

Commit 74bd467

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 fe3136d commit 74bd467

File tree

1 file changed

+23
-0
lines changed

1 file changed

+23
-0
lines changed

README.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,29 @@ 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. 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 emdebbed devices, the fwupdmgr command line tool can be used to monitor LVFS for firmware updates as follows:
12+
13+
```bash
14+
# Download latest metadata from LVFS
15+
fwupdmgr refresh
16+
17+
# Fetch device specific firmware updates from LVFS
18+
fwupdmgr get-updates
19+
20+
# Install firmware updates
21+
fwupdmgr update
22+
```
23+
24+
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:
25+
26+
```bash
27+
# Transfer U-Boot firmware cabinet archive build from scripts/build-u-boot-rb1.sh to RB1
28+
sudo fwupdtool install u-boot.cab
29+
# It will ask for a reboot for the UEFI firmware capsule update to happen
30+
```
31+
932
## Branches
1033

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

0 commit comments

Comments
 (0)