# Qualcomm Hexagon NPU 手册归档

本目录保存 Qualcomm Hexagon NPU 的官方架构与指令集手册，用于 HMX/HVX/Hexagon 核心的
底层计算模型、数据布局、VTCM 与访存、VLIW 调度等研究。

- `mirror/`：`docs.alexrp.com/hexagon/` 镜像的 Hexagon 手册全集（**非高通官网**，
  但为原始 PDF 的逐字节镜像）。
- `official/`：从高通官网 `docs.qualcomm.com` 直接下载的 PDF。
- `SHA256SUMS`：上面所有 PDF 的校验和，用于版本核对。
- `mirror/_source_listing.html`：镜像目录页快照，记录文件名、大小与收录时间。
- `hexagon_v79_architecture.svg`：本仓库自制的 Hexagon v79 片上内存与 PMU 观测点架构图
  （canonical 存放处），由 [`../hexagon-npu-memory/architecture.md`](../../experiment-results/hexagon-npu-memory/architecture.md)
  引用与维护。
- `hmx_dot_axwt_vs_axa.svg`：本仓库自制的可编辑流程图，对比 HMX 的
  `A · W^T → O` 与 `A1 · A2 → O` 路径，并标明 `A2` 的 HVX 预转置、HMX 第二输入自动
  转置及论文级 FP16 输入/输出 shape。

## 核心手册

| 文档 | 版本/文档号 | 文件 |
| --- | --- | --- |
| Hexagon V81 HMX Programmer's Reference Manual | 80-N2040-62 Rev. AA（2026-03-19） | `official/80-N2040-62_REV_AA_Hexagon_V81_HMX_PRM.pdf`、`mirror/hexagon_v81_hmx.pdf` |
| Hexagon V79 HVX Programmer Reference Manual | 80-N2040-61 | `mirror/hexagon_v79_hvx.pdf` |
| Hexagon V79 Programmer Reference Manual | 80-N2040-60 | `mirror/hexagon_v79.pdf` |

`official/` 与 `mirror/` 中的 V81 HMX PDF 校验和完全一致
（`14db2946…4231939`），说明该镜像收录的是与官网一致的原始文件。

## 完整版本清单

镜像同时收录历史版本，便于跨版本对照：

- 核心架构（Programmer Reference Manual）：
  `hexagon_v2`、`hexagon_v4`、`hexagon_v5x`、`hexagon_v60_v61`、`hexagon_v62`、
  `hexagon_v65`、`hexagon_v66`、`hexagon_v68`、`hexagon_v69`、`hexagon_v71`、
  `hexagon_v73`、`hexagon_v75`、`hexagon_v79`、`hexagon_vm`
- HVX 扩展：
  `hexagon_v60_hvx`、`hexagon_v62_hvx`、`hexagon_v65_hvx`、`hexagon_v66_hvx`、
  `hexagon_v68_hvx`、`hexagon_v69_hvx`、`hexagon_v73_hvx`、`hexagon_v75_hvx`、
  `hexagon_v79_hvx`
- HMX 扩展：`hexagon_v81_hmx`

各文件对应的高通文档号以 PDF 内页为准；已知 `hexagon_v73_hvx.pdf` 为
`80-N2040-54 Rev. AB`（2024-01-29）。

## 重要限制

- **V81 HMX 手册只覆盖 FP16。** 它不构成 HMX 全部 INT8/INT4 等数据类型的完整指令说明，
  也不能据此判断各芯片的精度支持；这些需以对应版本的 QNN/QAIRT 文档和设备实测为准。
- 本目录只是文档归档，不代表任何 backend、精度或性能结论。

## 未包含的资料

以下内容不是可离线归档的高通 PDF 手册，未放入本目录：

- **Hexagon NPU SDK**：`https://www.qualcomm.com/developer/software/hexagon-npu-sdk`，
  下载需登录 Qualcomm 账号。
- **官方在线文档渲染**：
  V79 HVX `https://docs.qualcomm.com/doc/80-N2040-61/topic/introduction.html`；
  V79 核心 `https://docs.qualcomm.com/doc/80-N2040-60/topic/introduction.html`。
  其内容与本目录的 `hexagon_v79_hvx.pdf`、`hexagon_v79.pdf` 同源。
- **Hexagon-MLIR**（开源编译栈）：`https://github.com/qualcomm/hexagon-mlir`。
- **T-MAN 论文**（第三方，低比特 LLM 推理）：
  `https://arxiv.org/html/2511.11248v1`；重点 `§2.3 架构背景`、`§4 优化设计`。