> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装或升级 SoftSKU 功能包

<Warning>
  当前版本未启用此功能。
</Warning>

您可以使用 Qualcomm<sup>®</sup> 无线边缘服务 (WES) 许可证升级 QCS5430 软库存单位 (SKU) 功能包。有关功能包的更多信息,请参阅 [QCS5430:功能包](https://docs.qualcomm.com/bundle/publicresource/topics/80-75285-1/qcs5430-collection-landing-page.html#feature-packs)。

**重要**

此功能适用于 QCS5430。

## **下载评估许可证**

下图显示了下载和升级 QCS5430 SoftSKU 功能包的过程。

**图:升级 QCS5430 SoftSKU 功能包**

<img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/System/Security/media-security/k2c-qli-security/download-feature-pack-updated.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=af099036c99ce9030895a765947cb56c" alt="升级 QCS5430 SoftSKU 功能包" width="701" height="376" data-path="System/Security/media-security/k2c-qli-security/download-feature-pack-updated.png" />

下表列出了功能包以及下载其评估许可证的相应链接。

**表:下载评估许可证**

| **功能包** |                                                     **许可证文件下载链接**                                                    |
| :-----: | :------------------------------------------------------------------------------------------------------------------: |
|   FP2   | [QCM5430 FP2.0](https://softwarecenter.qualcomm.com/api/download/software/licenses/feature_packs/QCM5430-FP-2.0.zip) |
|  FP2.5  | [QCM5430 FP2.5](https://softwarecenter.qualcomm.com/api/download/software/licenses/feature_packs/QCM5430-FP-2.5.zip) |
|   FP3   | [QCM5430 FP3.0](https://softwarecenter.qualcomm.com/api/download/software/licenses/feature_packs/QCM5430-FP-3.0.zip) |

## **准备设备**

1. 在设备上设置 Wi-Fi 并获取 `device-ip-address`。
2. 使用 SSH 连接到设备:
   `ssh root@device-ip-address`
   有关说明,请参阅 [Qualcomm Linux 构建指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-80021-254/how_to.html#use-ssh)。
3. 使用读/写权限重新挂载文件系统:
   ```text theme={null}
   mount -o rw,remount /usr
   ```
4. 将许可证推送到设备,推送许可证的参考命令如下:
   > ```text theme={null}
   > scp /path/to/<QCM5430 FP*>.pfm root@device-ip-address:/data/
   > ```

## **安装评估许可证**

1. 确保满足以下先决条件:
   > * 已配置 RPMB。
   >   > 要验证 RPMB 是否已配置,请参阅 [验证 RPMB 配置状态](/zh/System/Security/verify-the-security-configurations-of-qualcomm-linux#verify-rpmb-provisioning-status)。
   > * 设备中可用 `qwes_cli` 工具。
2. 安装 Qualcomm WES 命令行接口工具:
   * 帮助:`qwes_cli –help`。
   * 随 Qualcomm Linux 软件产品一起提供的默认工具。
3. 安装评估许可证:
   ```text theme={null}
   ssh root@device-ip-address
   qwes_cli -f /data/<QCM5430 FP*>.pfm install
   ```
4. 验证许可证安装:
   ```text theme={null}
   qwes_cli list
   ```
   | **命令** | **输出** |
   | :----: | :----: |
   | 检查序列号: |        |
   > `qwes_cli list`
   > \| `# qwes_cli list` `Running GetAllSerialNumber test with multithread Disabled` `Success. Len = 25` `Parsing 2 serial numbers` `Serial Number: 15b3` `Serial Number: 3e52b512f2f47851a40fa5b30000018c86261aa1` |
   > \| :-- |
5. 确保重启设备以使许可证生效。

## **验证功能包升级**

验证功能包的两种方式是:

* 使用以下命令验证功能包升级:
  > ```text theme={null}
  > ssh root@device-ip-address
  > cat /proc/device-tree/model
  > ```
  >
  > 输出中显示功能包 ID 型号:
  >
  > * `FP2: Qualcomm Technologies, Inc. qcs5430 fp2 addons rb3gen2 platforms`
  > * `FP2.5: Qualcomm Technologies, Inc. qcs5430 fp2p5 addons rb3gen2 platform`
  > * `FP3: Qualcomm Technologies, Inc. qcs5430 fp3 addons rb3gen2 platform`
  >
  > **注意**
  >
  > 功能包和型号 ID 映射为 `{Feature Pack2: fp2 ; Feature pack2.5: fp2.5; Feature pack 3: fp3}`。
* 通过以下 UEFI 日志验证功能包 ID:
  > | FP1   | `SoftSKU ID is disabled. The default setting is 1.` |
  > | :---- | :-------------------------------------------------- |
  > | FP2   | `SoftSKU ID is enabled. updated here: 2`            |
  > | FP2.5 | `SoftSKU ID enabled. updated here: 8`               |
  > | FP3   | `SoftSKU ID enabled. updated here: 3`               |

## **管理设备许可证**

您可以执行以下操作来管理设备许可证:

* 升级功能包或应用新许可证。
  > * 您可以根据需要升级或降级功能包许可证。
  > * 要应用新许可证(无论是升级还是降级),必须先移除现有许可证。
  > * 移除旧许可证后,应用所需功能包的许可证。
  > * 此过程可确保强制执行正确的功能包。
* 移除评估许可证。
  > * 获取许可证序列号:
  >   > ```text theme={null}
  >   > qwes_cli list
  >   > Running GetAllSerialNumber test with multithread Disabled
  >   > Success.  Len = 25
  >   > Parsing 2 serial numbers
  >   > Serial Number: 15b3
  >   > Serial Number: 3e52b512f2f47851a40fa5b30000018c86261aa1
  >   > ```
  > * 移除许可证:
  >   > ```text theme={null}
  >   > ssh root@device-ip-address
  >   > qwes_cli -s 3e52b512f2f47851a40fa5b30000018c86261aa1 remove
  >   > Serial number length 20
  >   > Remove License is successful.
  >   > ```
  > * 验证移除的许可证序列号不再出现在许可证列表中:
  >   > ```text theme={null}
  >   > qwes_cli list
  >   > Running GetAllSerialNumber test with multithread Disabled
  >   > Success.  Len = 4
  >   > Parsing 1 serial numbers
  >   > Serial Number: 15b3
  >   > ```
  > * 确保重启设备以使许可证移除生效。

## **功能包许可证 - 软件升级中的持久性**

* 许可证安装在持久性安全存储 RPMB 中。
* 当许可证成功安装时,其元数据存储在 RPMB 中,并在数据分区中保留副本。
* 即使用户数据被擦除,许可证仍保留在 RPMB 中,确保设备功能不受影响。

**注意**

此功能对具有授权访问权限的许可用户开放,以管理功能包许可证。如果您具有访问权限,请参阅 [Qualcomm Linux 无线边缘服务指南](https://docs.qualcomm.com/bundle/resource/topics/80-80021-11B/overview.html)。

## **后续步骤**

* 要了解 Qualcomm WES,请参阅 [Qualcomm WES](/zh/System/Security/security-features#qualcomm-wireless-edge-services)。
* 要开发提供基于硬件的证明、零接触设备配置和芯片组功能管理的应用程序,请参阅:[Qualcomm Linux 无线边缘服务指南](https://docs.qualcomm.com/bundle/resource/topics/80-80021-11B/overview.html)。此功能对具有授权访问权限的许可用户开放。
