# 设置 capsule 设备上的固件通过 UEFI 使用 capsule 进行更新。此过程涉及将固件更新有效负载采集在 capsule [.cap file] 中，然后由系统固件处理以更新设备的固件。 Note 所述 capsule 更新仅适用于 Qualcomm Linux 高级版和基础版。 ## 设备固件 要更新设备固件，请安装控制硬件的底层软件。此过程可以提高设备的性能、修复错误、添加新功能或增强安全性。如需配置设备固件，请参阅：[如何使用 capsule 更新设备固件](https://docs.qualcomm.com/doc/80-70022-4SC/topic/How-tos.html#how-tos)。 ## **用于 capsule 更新的 UEFI 变量** 操作系统和 UEFI 之间的通信是通过与平台固件交互的协议和服务来实现的。UEFI 提供标准引导环境、包含平台信息的数据表以及操作系统加载程序和操作系统的引导/ runtime 服务调用。 capsule 更新使用的 UEFI 变量 | 变量名称 | 说明 | | --- | --- | | OsIndications | 该变量归操作系统所有，用于指示操作系统希望固件启用或操作系统希望固件采用的功能。该变量由操作系统设置并由 UEFI 清除。 | | OsIndicationsSupported | 该变量归固件所有，指示固件支持哪些操作系统指示功能和操作。 | | OsTrialBootStatus - 是一个 32 位 UEFI 变量。 | 位图：



>
>
> | | EFI 系统资源表 (ESRT) | ESRT 表由 UEFI 在 capsule 更新后设置。 | 如需了解更多的 OsIndications 和 OsIndicationsSupported 变量的详细信息，请参阅[在操作系统和固件之间交换信息](https://uefi.org/specs/UEFI/2.10/08_Services_Runtime_Services.html?highlight=osindications#exchanging-information-between-the-os-and-firmware)。 Note - 如果 ESP 分区（在 EFI/UpdateCapsule 中）中有多个 capsule，则考虑更新所有 capsule，并按字母顺序更新。 - 将所有 UEFI 非易失性变量均存储在必须处于已配置状态的回滚保护内存块 (RPMB) 分区中。 > > > - 在启用了 Qualcomm 安全启动的设备上自动配置 RPMB。 > - 在 Qualcomm 非安全设备上，请勿自动配置 RPMB，请使用测试密钥进行配置。 > - 如果在非安全设备上使用测试密钥配置 RPMB，则在设备上启用 Qualcomm 安全启动时无法使用设备密钥重新配置。 > - 使用 `rpmbClient` 应用从 Linux 配置 RPMB。如需了解更多详细信息，请参阅 [Qualcomm 安全 Linux 指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-11/bring-up.html#verify-trustzone/device-configuration/hypervisor-image-loading)。 ## 用于 capsule 更新状态的 EFI 系统资源表 (ESRT) > > > ESRT 是一种可选机制，可识别用于提供固件更新的设备和系统固件资源。每个 ESRT 条目都描述一个可以更新的固件资源，并报告上次尝试更新的状态。ESRT 中用于报告上次尝试更新状态的条目如下： 表：ESRT 条目 | **ESRT 字段** | **说明** | | --- | --- | | FwClass | 固件类字段包含一个 GUID，用于标识可通过 *UpdateCapsule()* 更新的固件组件。 | | FwType | 标识固件资源的类型。 | | FwVersion | 固件版本字段表示固件资源的当前版本。该值必须始终增加，因为较大的数字代表较新的版本。 | | LowestSupportedFwVersion | 指定系统/设备的固件资源可以回滚到的最低固件资源版本。 | | CapsuleFlags | capsule 标志字段包含在 capsule 标头中设置的 *EFI\_CAPSULE\_HEADER* 中定义的 *CapsuleGuid* 标志（ 0-15 位）。 | | LastAttemptVersion | 该字段用于描述尝试更新的最后一个固件版本（使用与固件版本相同的格式）。 | | LastAttemptStatus | 该字段用于描述固件资源条目的最后一次固件更新尝试的结果。 | ESRT 内容由操作系统从 sysfs 路径公开。 /sys/firmware/efi/esrt/entries/entry0/ sh-5.1# cd /sys/firmware/efi/esrt/entries/entry0/ sh-5.1# ls capsule_flags fw_type last_attempt_status lowest_supported_fw_version w_class fw_version last_attempt_version Copy to clipboard ESRT 表在 capsule 更新后由 UEFI 设置。X 代 capsule 更新之前的固件版本。Y 代表固件的版本，可在 capsule [.cap] 文件中找到。 Note 仅当配置了 RPMB 时，上次尝试的固件版本才可用。 | **上次尝试的固件版本** | **当前固件版本** | **last\_attempt 状态** | **Capsule 更新场景** | | --- | --- | --- | --- | | Y | Y | 0 | 更新成功 | | Y | X | 1 | Capsule 更新失败 | | 0 | X | 0 | Capsule 元数据故障 | | Y | X | 0 | 固件回滚完成 | 如需了解更多 ESRT 的信息，请参见[固件更新和报告 - UEFI Specification 2.10 documentation](https://uefi.org/specs/UEFI/2.10/23_Firmware_Update_and_Reporting.html#efi-system-resource-table) 该流程图解释了如何使用 UEFI capsule 解决方案/方法（使用不同的 UEFI 变量以及回滚支持）更新设备固件。 Layer_1 Sheet.1 Sheet.2 Sheet.3 Sheet.4 启动并发起 OTA 更新 启动并发起 OTA 更新 Sheet.5 设置 TrialBootMaxCount 之后设置 TrialBootEnabled 设置 TrialBootMaxCount之后设置 TrialBootEnabled Sheet.6 重启 重启 Sheet.7 执行 capsule 更新 执行 capsule 更新 Sheet.8 更新 ESRT 以清除 OsIndications 更新 ESRT 以清除OsIndications Sheet.9 启动至 UEFI 启动至 UEFI Sheet.10 暂存 capsule 并向 UEFI 发出信号以进行更新和重启 操作系统将设置 TrialBootMaxCount 暂存 capsule 并向 UEFI 发出信号以进行更新和重启（操作系统将设置 TrialBootMaxCount） Sheet.11 操作系统根据 ESRT 执行操作系统更新以设置 OtaStatus 并重启 操作系统根据 ESRT 执行操作系统更新以设置OtaStatus 并重启 Sheet.16 启动操作系统并检查 ESRT 启动操作系统并检查 ESRT Sheet.18 操作系统 Trialboot 已确认完成 操作系统 Trialboot 已确认完成 Sheet.19 增量 TrialBootCount 增量 TrialBootCount Sheet.20 已达到回滚限制 已达到回滚限制 Sheet.22 固件回滚完成且系统重启 固件回滚完成且系统重启 Sheet.24 UEFI 恢复为以前的固件以更新 ESRT UEFI 恢复为以前的固件以更新 ESRT Sheet.28 OS boots successfully Reset TrialBootEnabled OS boots successfullyReset TrialBootEnabled Sheet.72 否 否 Sheet.73 否 否 Sheet.74 否 否 Sheet.75 禁用 禁用 Sheet.76 启用 启用 Sheet.77 是 是 Sheet.78 是 是 Sheet.79 是 是 Sheet.83 设置 OSIndications 设置 OSIndications Sheet.85 TrialBootEnabled TrialBootEnabled Sheet.87 Sheet.88 Sheet.89 Sheet.90 Sheet.91 Sheet.92 Sheet.93 Sheet.94 Sheet.95 Sheet.96 Sheet.97 Sheet.98 Sheet.99 Sheet.100 Sheet.101 Sheet.102 Sheet.103 Sheet.104 Sheet.105 Sheet.106 Sheet.107 Sheet.108 Sheet.109 Sheet.110 Sheet.111 Sheet.112 Sheet.113 Sheet.114 Sheet.115 Sheet.116 Sheet.117 Sheet.118 Sheet.119 Sheet.120 Sheet.121 Sheet.122 Sheet.123 Sheet.124 Sheet.125 Sheet.126 Sheet.127 Sheet.128 Sheet.129 Sheet.130 Sheet.131 Sheet.132 Sheet.133 Sheet.134 Sheet.135 Sheet.136 Sheet.137 Sheet.138 Sheet.139 Sheet.140 Sheet.141 Sheet.142 Sheet.143 Sheet.144 RollbackCount 检查内部 UEFI RollbackCount检查内部 UEFI Sheet.145 TrialBootCount= TrialBootMaxCount TrialBootCount=TrialBootMaxCount Sheet.148 Sheet.149 Sheet.150 Sheet.151 Sheet.152 Sheet.153 Sheet.154 Sheet.155 Sheet.156 Sheet.157 结束 Sheet.158 Sheet.159 结束 1. **启动**: 无线 (OTA) 更新过程开始，操作系统准备更新 capsule ，向 UEFI 发出信号（通过设置 `OsIndications`）开始更新。操作系统设置 `TrialBootMaxCount` 来跟踪允许的尝试启动次数，然后重新启动设备。 2. **UEFI 更新**：重新启动时，系统会检查 `OsIndications`。如果存在，它将执行 capsule 更新，更新 EFI 系统资源表 (ESRT)，清除 `OsIndications`，如果设置了 `TrialBootMaxCount`，则允许 `TrialBootEnabled` 并再次重启系统。 3. **Trialboot 处理**： - 如果未设置 `OsIndications`，系统将检查 `TrialBootEnabled` 是否处于活动状态。 - 如果 `TrialBootEnabled` 有效并且 `TrialBootCount` 等于 `TrialBootMaxCount`，则检查回滚计数。 - 如果允许回滚，UEFI 将恢复为固件、更新 ESRT，然后重新启动。 - 如果不允许回滚，则表明已达到回滚限制。 - 如果 `TrialBootCount` 小于 `TrialBootMaxCount`，则增加 `TrialBootCount` 并继续该过程。 4. **完成**: 系统启动到操作系统，检查 ESRT，如果操作系统成功启动，则会重置 `TrialBootEnabled` 字段。 5. **结果**： - 如果 `TrialBootEnabled` 未激活，则确认 OTA 更新已完成。 - 系统清除 `OtaTrialBootStatus` 并将 `LwSupportedFwVersion` 设置为当前固件版本以禁用回滚。 6. **恢复**：如果固件封装更新在更新过程中失败，UEFI 具有恢复机制来保持稳定性和功能。 > > > 1. **回滚**：如果允许回滚，UEFI 将恢复到之前的固件版本。这涉及将固件恢复到尝试更新之前的状态。 > 2. **ESRT 更新**：更新 ESRT，以反映回滚情况。 > 3. **重启**：回滚完成后，UEFI 会触发重新启动，以确保其运行之前的稳定固件版本。 此过程可确保应用更新，并在设备试用期间遇到任何问题时允许回滚。 ## 身份验证和签名 身份验证对于固件更新而言具有至关重要的意义，以确保安全性和稳定性。它保证仅应用来自可信来源的更新，从而防止恶意或未经授权的更新。通过验证 capsule 的数字签名，它可以确保更新在传输过程中未被篡改，并且仅安装经过验证和测试的更新。这降低了由于固件故障而导致系统崩溃或故障的风险。 如需了解更多信息，请参阅：[如何验证和签署 capsule 更新](https://docs.qualcomm.com/doc/80-70022-4SC/topic/How-tos.html#how-tos)。 Last Published: Dec 07, 2025 [Previous Topic 更新设备固件](https://docs.qualcomm.com/bundle/publicresource/80-70022-4SC/topics/Update-the-device-firmware.md) [Next Topic 在基础版和高级版中更新 capsule 并试用启动回滚](https://docs.qualcomm.com/bundle/publicresource/80-70022-4SC/topics/capsule-update-for-base-and-advance-variants.md)