> ## 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.

# Wasp

## **什么是 Wasp？**

**Wasp** 是 Qualcomm 面向其各款 SoC 中小型子系统处理器的**基于 Zephyr** 的嵌入式软件平台。它提供完整的 RTOS，以及标准化、可复用的固件栈，包含通用驱动程序、服务和集成支持。

## **Wasp SDK 提供哪些内容？**

Wasp SDK（`wasp-sdk`）是 Wasp 的平台*清单仓库（manifest repository）*。它提供：

* **板级支持包（BSP）**：所有受支持 Qualcomm 平台的 SoC 和板卡定义。
* **Qualcomm 子系统驱动程序**：用于基础设施 IP 模块（时钟、电源稳压器、GPIO、TLMM、IPCC、SPMI 等）的驱动程序。
* **平台服务**：操作系统抽象层（OSAL）、处理器间通信（mproc）、电源管理、日志记录等。
* **构建和工作区工具**：West 扩展（`west qc-build`、`west qc-sign`），用于使用标准 Zephyr 工作区工作流构建和签名 Qualcomm 固件镜像。
* **设备树基础设施**：拆分为静态（基于 Zephyr 宏）和动态（libfdt DTB）两类设备树支持，并针对 Qualcomm SoC 资源管理进行了优化。
* **CI 和测试支持**：用于离线（off-target）测试的 QEMU 板卡变体、ZTest 集成以及 Coral CI 流水线配置。

## **与 Zephyr 的关系**

Wasp 构建在 [<u>Zephyr RTOS</u>](https://zephyrproject.org/) 之上。Zephyr 提供内核、调度器、设备驱动模型、设备树框架、构建系统（CMake + West）以及上游驱动生态系统。Wasp 使用 Qualcomm 特定的平台代码扩展 Zephyr，这些代码无法或尚未贡献到上游。

两者有意采用分层关系：

* **上游 Zephyr**：内核、通用子系统以及非 Qualcomm 特定的驱动程序。有关 Wasp 如何跟踪上游 Zephyr 版本，请参阅[<u>分支模型</u>](https://animated-fortnight-o3ll9mn.pages.github.io/integration/branching-model.html)。
* `wasp-sdk`：Qualcomm 平台代码，包括 BSP、HAL 驱动程序和平台服务。该层的代码旨在遵循 Zephyr 编码规范和驱动程序 API，以便随着时间推移贡献到上游（尽管与其他软件平台的复用在某些情况下会导致差异）。
* **产品固件镜像**：使用 SDK 为特定 SoC 目标生成已签名固件镜像的应用级代码和配置。

Qualcomm 已获准将大部分代码贡献给 Zephyr 项目（Apache 2.0 许可证），将 Qualcomm 驱动程序贡献到上游是一个积极推进的目标。

## **仓库布局**

该 SDK 采用 [<u>west</u>](https://docs.zephyrproject.org/latest/develop/west/index.html) 清单仓库的结构。工作区结构如下：

```text theme={null}
<workspace>/
├── wasp-sdk/       ← this repository (manifest)
├── zephyr/         ← upstream Zephyr RTOS
├── modules/        ← external modules (HALs, libraries)
└── applications/   ← application code
```