You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/kb/fwupd.md
+29-29Lines changed: 29 additions & 29 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@
4
4
5
5
[fwupd][fwupd website] is an open-source project, that
6
6
is widely used to make firmware updates almost as seamless and simple
7
-
as updating system packages. It is supported by most hardware vendors
7
+
as updating system packages. Most hardware vendors support it
8
8
and Linux distributions.
9
9
10
10
The `fwupd` daemon relies on the Linux Vendor Firmware Service (LVFS)
@@ -20,7 +20,7 @@ for distributing and managing the firmware binaries to the users.
20
20
21
21
### Intel ME
22
22
23
-
This only applies to devices with an Intel Management Engine, that are not fused
23
+
This only applies to devices with an Intel Management Engine that are not fused
24
24
using the [Dasharo Trust Root](../glossary.md#dasharo-trustroot)
25
25
technology, and use Dasharo versions released before 2026. Check your release
26
26
notes to verify if the step is required.
@@ -41,15 +41,15 @@ for more context.
41
41
42
42
### Charger connected
43
43
44
-
On batterypowered devices (laptops) the AC charger must be connected
45
-
before running fwupdmgr in order to start the update. It must be connected
44
+
On battery-powered devices (laptops), the AC charger must be connected
45
+
before running fwupdmgr to start the update. It must be connected
46
46
for the whole duration of the update, until the device boots back up normally.
47
47
48
48
## Usage
49
49
50
50
### Desktop Environments
51
51
52
-
The most popular Desktop Environments like Gnome and KDE automatically
52
+
The most popular Desktop Environments, like Gnome and KDE, automatically
53
53
look for firmware updates on LVFS and suggest performing them with a
54
54
simple button press.
55
55
@@ -62,7 +62,7 @@ are met.
62
62
63
63
### CLI
64
64
65
-
For more advanced users or in more lightweight
65
+
For more advanced users or in a more lightweight
66
66
DEs/WMs `fwupdmgr` can be used in the terminal.
67
67
68
68
#### Installation
@@ -72,7 +72,7 @@ it to perform firmware updates.
72
72
73
73
=== "Windows"
74
74
Dasharo Capsule Updates using fwupdmgr are not currently supported on
75
-
Windows. If that is the only Operating System you with to use, other update
75
+
Windows. If that is the only Operating System you wish to use, other update
76
76
methods need to be considered.
77
77
78
78
=== "Ubuntu"
@@ -139,9 +139,9 @@ it to perform firmware updates.
139
139
140
140
=== "QubesOS"
141
141
142
-
To use fwupdmgr on QubesOS the program needs to be run on
143
-
the `dom0` qube and it requires internet connection.
144
-
For that reason a fwupdmgr wrapper for QubesOS exists,
142
+
To use fwupdmgr on QubesOS, the program needs to be run on
143
+
the `dom0` qube, and it requires an internet connection.
144
+
For that reason, a fwupdmgr wrapper for QubesOS exists,
145
145
that sets up the network tunnels for the firmware update
146
146
downloads to be possible from dom0.
147
147
The qubes-fwupdmgr package should be installed out of the box.
@@ -245,7 +245,7 @@ it to perform firmware updates.
245
245
Created: 1771420572
246
246
UpdateState 2
247
247
```
248
-
As of QubesOS R4.2.3 the firmware version is not interpreted correctly
248
+
As of QubesOS R4.2.3, the firmware version is not interpreted correctly
249
249
by fwupdmgr.
250
250
As a fallback on Dasharo firmware, use `dmidecode` to verify the firmware version.
251
251
Run:
@@ -330,7 +330,7 @@ it to perform firmware updates.
330
330
```
331
331
332
332
!!! warning
333
-
As of QubesOS R4.3 on 02-2026 qubes-fwupdmgr might not work correctly
333
+
As of QubesOS R4.3 on 02-2026, qubes-fwupdmgr might not work correctly
334
334
and the updates on LVFS may not be found using this tool. Refer to
335
335
[troubleshooting](#no-updates-available-qubesos).
336
336
@@ -398,17 +398,17 @@ are met.
398
398
```
399
399
400
400
!!! warning
401
-
As of QubesOS R4.3 on 02-2026 qubes-fwupdmgr might not work correctly
401
+
As of QubesOS R4.3 on 02-2026, qubes-fwupdmgr might not work correctly
402
402
and the updates on LVFS may not be found using this tool. Refer to
403
403
[troubleshooting](#no-updates-available-qubesos).
404
404
405
405
!!! warning
406
-
After the command finishes fwupd will instruct to reboot the device.
406
+
After the command finishes, fwupd will instruct the device to reboot.
407
407
The fwupd UEFI application that performs the update will be booted
408
408
automatically after a reboot, unless there's user interaction
409
409
Entering the Setup Menu, Boot Manager, or interfering in any other way will
410
410
abort the update.
411
-
Allow the device to reboot freely and do not press any buttons until the
411
+
Allow the device to reboot freely, and do not press any buttons until the
412
412
update finishes.
413
413
414
414
Devices that have an Embedded Controller
@@ -443,9 +443,9 @@ source. We will use `novacustom_v54x_mtl_igpu_v1.0.1_btg_prod.cab` downloaded fr
443
443
##### No output from fwupdmgr update
444
444
445
445
Depending on the version of fwupdmgr, issues like the AC being disconnected on
446
-
batterypowered devices might not be printed explicitly right away after
447
-
trying to perform an update. In such case try running the `get-devices` command
448
-
and look for `Problems` header and red text under device entries.
446
+
battery-powered devices might not be printed explicitly right away after
447
+
trying to perform an update. In such a case, try running the `get-devices` command
448
+
and look for the `Problems` header and red text under device entries.
449
449
<details><summary>Example, update rejected, AC was not connected.</summary>
450
450
```
451
451
├─System Firmware:
@@ -466,7 +466,7 @@ and look for `Problems` header and red text under device entries.
466
466
│ │ • Updatable
467
467
│ │ Device Requests: • Message
468
468
```
469
-
Note, that `Update State` is `Success` despite a failure, as it reports
469
+
Note that `Update State` is `Success` despite a failure, as it reports
470
470
the status of the last correctly initiated Update. Without an AC connected,
471
471
the update did not even start keeping the previous value of `Update State`.
472
472
</details>
@@ -477,7 +477,7 @@ To verify if the problem really occurs, you can run the command in verbose mode:
477
477
$ sudo fwupdmgr update -v
478
478
```
479
479
480
-
The output might suggest what's the issue, example:
480
+
The output might suggest what the issue is, for example:
481
481
<!-- markdownlint-disable MD013 -->
482
482
<details><summary>Example of fwupdmgr update -v</summary>
483
483
```txt
@@ -520,7 +520,7 @@ The output might suggest what's the issue, example:
520
520
</details>
521
521
<!-- markdownlint-enable MD013 -->
522
522
523
-
On the end of the verbose output we can see the line
523
+
At the end of the verbose output, we can see the line
524
524
525
525
```txt
526
526
(fwupdmgr:4376): FuMain-DEBUG: 11:44:32.043: ignoring 204ce525ed4dbc468e789eb029f3627dd13d6cf4: System Firmware is not currently updatable: Device requires AC power to be connected
@@ -534,15 +534,15 @@ section of the Capsule Update guide.
534
534
535
535
##### fwupdmgr asks for AC despite it being connected
536
536
537
-
The check for AC charger being connected in Linux fails when the firmware
537
+
The check for an AC charger being connected in Linux fails when the firmware
538
538
configures a [charging threshold](http://127.0.0.1:8000/unified/novacustom/features/#charge-thresholds)
539
539
for the battery that disconnects the charger once the battery reaches the threshold.
540
540
If the battery is considered full and not charging at the moment, the check in
541
541
fwupdmgr will think the charger is disconnected.
542
542
543
-
There are two options to work this issue around:
543
+
There are two options to work around this issue:
544
544
545
-
- Deplete battery charge a couple percent, so that it
545
+
- Deplete battery charge a couple of percent, so that it
546
546
doesn't stop charging for the duration of fwupdmgr running the checks.
547
547
- Disable battery charging thresholds in the firmware.
548
548
@@ -551,7 +551,7 @@ There are two options to work this issue around:
551
551
As of QubesOS R4.3 on 02-2026
552
552
[qubes-fwupdmgr does not work correctly][qubes-fwupdmgr-issue]
553
553
and the updates on LVFS might not be found using this tool.
554
-
In such case, there are still a few options to perform the update.
554
+
In such a case, there are still a few options to perform the update.
555
555
Either use a different update method according to the `Firmware Update`
556
556
page for your device in the `Supported hardware` tab, or perform
557
557
a [Local Update](#local-update) using a fwupd cabinet (.cab) file downloaded
@@ -568,7 +568,7 @@ manually from fwupd.org.
568
568
$ fwupdmgr get-results
569
569
```
570
570
571
-
You will be prompted to select a device, for Dasharo firmware updates, select
571
+
You will be prompted to select a device. For Dasharo firmware updates, select
572
572
`System Firmware` or `UEFI Device Firmware`.
573
573
574
574
<details><summary>Example of `fwupdmgr get-results` output after a successful update</summary>
@@ -618,7 +618,7 @@ manually from fwupd.org.
618
618
##### Failed to run update on reboot: expected ... and got
619
619
620
620
This Update Error is most often caused by failing to set the Intel ME
621
-
to `Disabled (HAP)` mode prior to running the update.
621
+
to `Disabled (HAP)` mode before running the update.
622
622
623
623
<details><summary>Example of fwupdmgr get-results output when that happens</summary>
0 commit comments