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

# 传感器文档

本文档介绍 Qualcomm 平台上传感器的架构、集成、开发和验证。它涵盖 Qualcomm® 感知中枢（QSH）框架、传感器启用、定制以及端到端传感器开发工作流。它还介绍如何使用 Qualcomm 提供的工具和参考资料来测试、排查和支持传感器解决方案。

### 开始使用

<CardGroup cols={2}>
  <Card title="概述" href="./overview">
    介绍 Qualcomm® SoC 架构、应用处理器和应用数字信号处理器（aDSP）的作用，以及 Qualcomm® 感知中枢（QSH）在 Linux 传感器软件栈中的位置。
  </Card>

  <Card title="架构" href="./architecture">
    介绍统一的事件驱动 QSH 框架、其组件、服务、平台传感器、实用工具、操作系统抽象（OSA）和平台抽象层（PAL）。
  </Card>

  <Card title="消息" href="./sensor_api_messages">
    客户端应用程序和传感器驱动共同使用的通信契约。涵盖传感器唯一标识符（SUID）、nanopb、消息类型、请求选项、事件字段以及 proto 文件模式。
  </Card>

  <Card title="功能" href="./supported_features">
    QSH 的功能，包括操作系统和硬件独立性、孤岛内存（island memory）、低功耗运行以及直接通道 API。
  </Card>
</CardGroup>

### 开发

<CardGroup cols={2}>
  <Card title="应用处理器和低功耗处理器的软件" href="./software">
    应用处理器和 aDSP 源码树的目录布局。
  </Card>

  <Card title="QSH 客户端 API 工作流" href="./qsh_client_apis">
    帮助应用开发者了解 QSH 客户端 API 会话工作流和 `SessionClient` 示例应用程序。
  </Card>

  <Card title="开发传感器" href="./develop_sensors">
    帮助驱动和算法开发者了解传感器与传感器实例的生命周期、QSH 服务以及压力测试。
  </Card>
</CardGroup>

### API

<CardGroup cols={2}>
  <Card title="Qualcomm® 感知中枢 API" href="./qsh_api_reference">
    `getSession`、`open`、`close`、`setCallback`、`sendRequest`、功能 API 以及直接通道 API 的完整语法参考。
  </Card>
</CardGroup>

### 测试与验证

<CardGroup cols={2}>
  <Card title="校准传感器" href="./calibrate">
    加速度计、陀螺仪、磁力计、接近传感器和环境光传感器的出厂校准和运行时校准流程。
  </Card>

  <Card title="验证传感器" href="./verify">
    使用 `ssc_sensor_info` 列出所有 QSH 支持的传感器并检查其属性。
  </Card>

  <Card title="排查传感器问题" href="./test_troubleshoot">
    诊断和解决注册表错误、SUID 查找失败以及数据流问题。
  </Card>

  <Card title="传感器测试工具" href="./test_tools">
    介绍测试工具 – `ssc_sensor_info`、`ssc_drva_test`、`see_workhorse`、Qualcomm® Hexagon™ 工具链和 QXDM Professional™ 工具。
  </Card>
</CardGroup>

### 支持的平台

<CardGroup cols={2}>
  <Card title="Qualcomm Dragonwing™ 平台" href="./platform">
    Qualcomm Dragonwing™ RB3 Gen 2 开发套件的硬件规格和传感器启用。包括端到端启用流程。
  </Card>

  <Card title="平台上的传感器" href="./platform_sensor_specs">
    Core Kit 和 Vision Kit 的传感器布局和部件编号表。
  </Card>

  <Card title="仿真平台" href="./simulation">
    使用感知中枢仿真器（SHS）在没有物理硬件的情况下开发和测试传感器算法。
  </Card>

  <Card title="相关文档" href="./related_documents">
    外部指南，包括传感器指南补充文档、Linux 构建指南、Yocto 指南和开发套件文档。
  </Card>

  <Card title="缩略语和术语" href="./acronyms_and_terms">
    本指南中使用的传感器专用缩略语和定义。
  </Card>
</CardGroup>