Skip to content

Commit b5a98e2

Browse files
committed
kb/fwupd.md: Fix grammar, spelling, clarity
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
1 parent d039f73 commit b5a98e2

1 file changed

Lines changed: 29 additions & 29 deletions

File tree

docs/kb/fwupd.md

Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
[fwupd][fwupd website] is an open-source project, that
66
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
88
and Linux distributions.
99

1010
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.
2020

2121
### Intel ME
2222

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
2424
using the [Dasharo Trust Root](../glossary.md#dasharo-trustroot)
2525
technology, and use Dasharo versions released before 2026. Check your release
2626
notes to verify if the step is required.
@@ -41,15 +41,15 @@ for more context.
4141

4242
### Charger connected
4343

44-
On battery powered 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
4646
for the whole duration of the update, until the device boots back up normally.
4747

4848
## Usage
4949

5050
### Desktop Environments
5151

52-
The most popular Desktop Environments like Gnome and KDE automatically
52+
The most popular Desktop Environments, like Gnome and KDE, automatically
5353
look for firmware updates on LVFS and suggest performing them with a
5454
simple button press.
5555

@@ -62,7 +62,7 @@ are met.
6262

6363
### CLI
6464

65-
For more advanced users or in more lightweight
65+
For more advanced users or in a more lightweight
6666
DEs/WMs `fwupdmgr` can be used in the terminal.
6767

6868
#### Installation
@@ -72,7 +72,7 @@ it to perform firmware updates.
7272

7373
=== "Windows"
7474
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
7676
methods need to be considered.
7777

7878
=== "Ubuntu"
@@ -139,9 +139,9 @@ it to perform firmware updates.
139139

140140
=== "QubesOS"
141141

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,
145145
that sets up the network tunnels for the firmware update
146146
downloads to be possible from dom0.
147147
The qubes-fwupdmgr package should be installed out of the box.
@@ -245,7 +245,7 @@ it to perform firmware updates.
245245
Created: 1771420572
246246
UpdateState 2
247247
```
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
249249
by fwupdmgr.
250250
As a fallback on Dasharo firmware, use `dmidecode` to verify the firmware version.
251251
Run:
@@ -330,7 +330,7 @@ it to perform firmware updates.
330330
```
331331

332332
!!! 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
334334
and the updates on LVFS may not be found using this tool. Refer to
335335
[troubleshooting](#no-updates-available-qubesos).
336336

@@ -398,17 +398,17 @@ are met.
398398
```
399399

400400
!!! 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
402402
and the updates on LVFS may not be found using this tool. Refer to
403403
[troubleshooting](#no-updates-available-qubesos).
404404

405405
!!! 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.
407407
The fwupd UEFI application that performs the update will be booted
408408
automatically after a reboot, unless there's user interaction
409409
Entering the Setup Menu, Boot Manager, or interfering in any other way will
410410
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
412412
update finishes.
413413

414414
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
443443
##### No output from fwupdmgr update
444444

445445
Depending on the version of fwupdmgr, issues like the AC being disconnected on
446-
battery powered 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.
449449
<details><summary>Example, update rejected, AC was not connected.</summary>
450450
```
451451
├─System Firmware:
@@ -466,7 +466,7 @@ and look for `Problems` header and red text under device entries.
466466
│ │ • Updatable
467467
│ │ Device Requests: • Message
468468
```
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
470470
the status of the last correctly initiated Update. Without an AC connected,
471471
the update did not even start keeping the previous value of `Update State`.
472472
</details>
@@ -477,7 +477,7 @@ To verify if the problem really occurs, you can run the command in verbose mode:
477477
$ sudo fwupdmgr update -v
478478
```
479479

480-
The output might suggest what's the issue, example:
480+
The output might suggest what the issue is, for example:
481481
<!-- markdownlint-disable MD013 -->
482482
<details><summary>Example of fwupdmgr update -v</summary>
483483
```txt
@@ -520,7 +520,7 @@ The output might suggest what's the issue, example:
520520
</details>
521521
<!-- markdownlint-enable MD013 -->
522522

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
524524

525525
```txt
526526
(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.
534534

535535
##### fwupdmgr asks for AC despite it being connected
536536

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
538538
configures a [charging threshold](http://127.0.0.1:8000/unified/novacustom/features/#charge-thresholds)
539539
for the battery that disconnects the charger once the battery reaches the threshold.
540540
If the battery is considered full and not charging at the moment, the check in
541541
fwupdmgr will think the charger is disconnected.
542542

543-
There are two options to work this issue around:
543+
There are two options to work around this issue:
544544

545-
- Deplete battery charge a couple percent, so that it
545+
- Deplete battery charge a couple of percent, so that it
546546
doesn't stop charging for the duration of fwupdmgr running the checks.
547547
- Disable battery charging thresholds in the firmware.
548548

@@ -551,7 +551,7 @@ There are two options to work this issue around:
551551
As of QubesOS R4.3 on 02-2026
552552
[qubes-fwupdmgr does not work correctly][qubes-fwupdmgr-issue]
553553
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.
555555
Either use a different update method according to the `Firmware Update`
556556
page for your device in the `Supported hardware` tab, or perform
557557
a [Local Update](#local-update) using a fwupd cabinet (.cab) file downloaded
@@ -568,7 +568,7 @@ manually from fwupd.org.
568568
$ fwupdmgr get-results
569569
```
570570

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
572572
`System Firmware` or `UEFI Device Firmware`.
573573

574574
<details><summary>Example of `fwupdmgr get-results` output after a successful update</summary>
@@ -618,7 +618,7 @@ manually from fwupd.org.
618618
##### Failed to run update on reboot: expected ... and got
619619

620620
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.
622622

623623
<details><summary>Example of fwupdmgr get-results output when that happens</summary>
624624
```
@@ -651,14 +651,14 @@ Device Flags: • Internal device
651651
```
652652
</details>
653653

654-
When that happens after rebooting instead of a Dasharo themed update
654+
When that happens after rebooting, instead of a Dasharo-themed update
655655
progress bar, a message like this will appear on top of the screen:
656656

657657
```txt
658658
[FIRMWARE WARNING] Capsule Updates are only supported while Intel ME is in HAP mode!
659659
```
660660

661-
Make sure the Intel ME mode in Setup menu is `Disabled (HAP)`. Refer to the
661+
Make sure the Intel ME mode in the Setup menu is `Disabled (HAP)`. Refer to the
662662
[prerequisites section](#firmware-update-prerequisites) and try again.
663663

664664
## References

0 commit comments

Comments
 (0)