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

# 传感器文档

本文档介绍在 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 内存、低功耗运行以及直接通道 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">
    外部指南，包括 Sensors Guide Addendum、Linux Build Guide、Yocto Guide 和开发套件文档。
  </Card>

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