Skip to content

Unify fwupd guides#1227

Draft
philipanda wants to merge 3 commits intomasterfrom
fwupd-guides
Draft

Unify fwupd guides#1227
philipanda wants to merge 3 commits intomasterfrom
fwupd-guides

Conversation

@philipanda
Copy link
Contributor

@philipanda philipanda commented Feb 18, 2026

ref: dsh-1121

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
…ethod

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
@philipanda philipanda marked this pull request as draft February 18, 2026 14:35
Copy link
Member

@SergiiDmytruk SergiiDmytruk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Large number of comments, but most of them are trivial. Overall it's a good addition to the documentation that should clear things up for users.

[Dasharo Trust Root](https://docs.dasharo.com/glossary/#dasharo-trustroot)
technology, it needs to be switched to the `Disabled (HAP)` state to perform the
update. Fwupd is unable to disable Intel ME automatically. This needs to be done
manually before the intent for updating the system. Afterwards, Intel ME needs
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
manually before the intent for updating the system. Afterwards, Intel ME needs
manually before trying to update the system. Afterwards, Intel ME needs

update. Fwupd is unable to disable Intel ME automatically. This needs to be done
manually before the intent for updating the system. Afterwards, Intel ME needs
to be manually turned back on if desired.
Check [Intel Management Engine Options](../dasharo-menu-docs/dasharo-system-features/#intel-management-engine-options)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Check [Intel Management Engine Options](../dasharo-menu-docs/dasharo-system-features/#intel-management-engine-options)
Check [Intel Management Engine Options](../dasharo-menu-docs/dasharo-system-features.md#intel-management-engine-options)

to be manually turned back on if desired.
Check [Intel Management Engine Options](../dasharo-menu-docs/dasharo-system-features/#intel-management-engine-options)
documentation for details on how to set ME mode to `Disabled (HAP)`.
See [this Knowledge Base article](../dasharo-menu-docs/dasharo-system-features.md#intel-management-engine-options)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This link must be wrong.


## Intel ME

On devices with an Intel Management Engine that are not fused using the
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This needs a note that this applies to all capsule updates before 2026 but future releases may be relieved from this requirement. Such releases will indicate so in their change logs and firmware update instructions.

Also worth addressing what happens if ME is not HAP-disabled so users know its safe to try: fwupd will attempt an update, but it will be rejected by the firmware.


## Firmware Update Prerequisites

## Intel ME
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this be ### instead of ##?

This output means the firmware version has changed to the expected one.
To manually verify this has really happened, refer to
[Checking The Current Firmware Version](#checking-the-current-firmware-version)
.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Dot on its own line adds a space in front of it:
Image

`[FIRMWARE WARNING] Capsule Updates are only supported while Intel ME is in HAP mode!`

Make sure the Intel ME mode in Setup menu is `Disabled (HAP)`. Refer to the
[prerequisites section](#preparation--prerequisites) and try again.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[prerequisites section](#preparation--prerequisites) and try again.
[prerequisites section](#firmware-update-prerequisites) and try again.

If you see any errors during the update, check the [Troubleshooting](../guides/capsule-update.md#troubleshooting)
section of the Capsule Update guide.
For instructions on how to perform updates using FWUPD and how to use the tool
in general, refer to the [Dasharo fwupd documentation](../kb/fwupd.md#updating-the-firmware)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
in general, refer to the [Dasharo fwupd documentation](../kb/fwupd.md#updating-the-firmware)
in general, refer to the [Dasharo fwupd documentation](../kb/fwupd.md#updating-the-firmware).

Comment on lines -44 to -46
!!! warning
Powering off instead of rebooting as instructed by fwupd will result in
aborting the update.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think is warning is missing from docs/kb/fwupd.md and it's worth having it there.


If you see any errors during the update, check the [Troubleshooting](../../guides/capsule-update.md#troubleshooting)
section of the Capsule Update guide.
For instructions on how to use fwupd and update the firmware, follow the [Dasharo fwupd documentation](../../kb/fwupd.md#update-instructions)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
For instructions on how to use fwupd and update the firmware, follow the [Dasharo fwupd documentation](../../kb/fwupd.md#update-instructions)
For instructions on how to use fwupd and update the firmware, follow the [Dasharo fwupd documentation](../../kb/fwupd.md#update-instructions).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

Comments