# 架构 Note - 要继续阅读有关 API 或部署传感器的信息，直接跳至[接口](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-7/qsh_api_reference.html)。 - 低功耗应用数字信号处理器 (aDSP) 的源代码（包括 QSH 框架）仅供具有授权访问权限的许可用户使用。要升级您的访问权限，前往 [www.qualcomm.com/support/working-with-qualcomm](https://www.qualcomm.com/support/working-with-qualcomm)。 QSH 与 Qualcomm® Snapdragon™ 传感器核心 (SSC) 同义，它为驱动程序和算法提供一个统一的事件驱动框架。QSH 支持基于硬件和基于软件的传感器的同一组 API。此外，QSH 支持异步总线传输，并且可轻松扩展，以获得新的或自定义驱动程序功能。QSH 由各种组件组成，包括 QSH 客户端 API、传感器 API、核心框架、预实现的平台传感器、供应商实现的传感器和测试模块。它为外部客户端提供服务，并提供一个简单的界面来访问传感器数据。 下表描述了 QSH 框架中使用的术语： 表：QSH 术语 | **项目** | **说明** | | --- | --- | | 传感器 | | | 传感器实例 | | | 传感器唯一标识符 (SUID) | 每个传感器唯一的 128 位 ID | | 服务 | 为通用实用工具提供同步接口的模块 | | 数据流 | 客户端与数据源间的唯一连接 | | 请求 | 客户端发送至传感器的配置消息（请参阅 `sns_request.h` 文件） | | 活动 | 传感器实例生成的异步输出数据消息（请参阅 `sns_sensor_event.h` 文件） | | Nanopb | 用 ANSI C 实现的小代码量协议缓存 | QSH 架构的组件如下图所示： Page-1 工作表.1 工作表.2 工作表.3 工作表.4 Qualcomm Sensing Hub Qualcomm 传感器中枢 工作表.5 工作表.6 工作表.7 Client Manager 客户端管理器 工作表.8 工作表.9 Client Application 客户端应用程序 工作表.10 工作表.11 QSH Client API QSH 客户端 API 工作表.12 Application processor 应用 处理器 工作表.13 Low power processor 低功耗处理器 工作表.14 工作表.15 工作表.16 工作表.17 工作表.18 工作表.19 工作表.20 工作表.21 工作表.22 Hardware Based 基于硬件的 工作表.23 Sensor Drivers 传感器驱动程序 工作表.24 工作表.25 工作表.26 工作表.27 工作表.28 工作表.29 工作表.30 Software Based 基于软件的传感器 工作表.32 工作表.33 工作表.34 Serial Buses 串行总线 工作表.35 工作表.36 工作表.37 Platform 平台传感器 工作表.39 工作表.40 工作表.41 Service 服务管理器 工作表.43 Linux OS Linux 操作系统 工作表.44 QuRT QuRT 操作系统 工作表.46 工作表.47 工作表.48 工作表.49 Utilities 工具 工作表.50 工作表.51 QSH Sensor API QSH 传感器 API 工作表.52 工作表.53 工作表.54 工作表.55 工作表.56 工作表.57 工作表.58 工作表.59 工作表.60 工作表.61 工作表.62 工作表.63 Sensor Hardware 传感器硬件 Rounded Rectangle Accelerometer 加速度传感器 Rounded Rectangle.126 工作表.66 Gyroscope 陀螺仪传感器 Rounded Rectangle.128 Magnetometer 地磁传感器 Rounded Rectangle.130 Other Sensors 其他传感器 工作表.69 工作表.70 工作表.71 工作表.72 工作表.73 工作表.74 工作表.75 工作表.76 工作表.77 I3C I3C 工作表.78 工作表.79 工作表.80 SPI SPI 工作表.81 工作表.82 工作表.83 I2C I2C 工作表.84 工作表.85 工作表.86 UART UART Rounded Rectangle.129 ALS/Prox 光敏传感器 (ALS)/接近传感器 (Prox) Round Corner Rectangle Third-party 第三方 Round Corner Rectangle.114 Upstream 上游 Round Corner Rectangle.116 Qualcomm Qualcomm Round Corner Rectangle.118 Hardware 硬件 QSH 架构组件 - **应用处理器软件模块** - **客户端应用程序**：其包含与应用处理器端的 QSH 客户端 API 交互的*应用程序 main()* 或*入口函数*。 - **QSH 客户端 API**：它提供 high-level API 来访问 QSH 提供的服务。它通过抽象系统复杂性并专注于应用程序逻辑来简化应用程序开发。更多信息，参见[接口](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-7/qsh_api_reference.html)。 - **低功耗处理器软件模块** - **客户端管理器**：客户端管理器负责低功耗处理器与应用处理器的所有通信。负责执行以下操作： 表：客户端管理器功能 | 功能 | 说明 | | --- | --- | | 转换传入请求 | 客户端管理器接受传入的请求，并将其转换为 QSH 可以理解的格式。 | | 转换传出指示 | 客户端管理器从 QSH 接收事件消息，并将这些事件消息转换为 QSH 外部可理解的格式的传出指示。 | | 保证批处理选项 | 如果客户端指定了某些批处理（本地存储/累积）选项，则客户端管理器将确保满足批处理选项。符合标准意味着客户端管理器会检查数据是否按照客户指定的方式进行分组和发送。 | - **服务管理器**：QSH 通过其服务管理器提供同步服务。传感器和传感器实例 API 使用回调连接到此服务管理器。 `adsp_proc/qsh_platform/inc/sns_service.h` 文件列出了 QSH 中可用的服务，也称为 QSH 服务。下表介绍了对设备驱动程序至关重要的关键 QSH 服务。 表：QSH 服务 | QSH 服务 | 说明 | | --- | --- | | 流服务 | | | 属性服务 | | | 诊断服务 | | | 事件服务 | | | 电源服务 | | | 同步 COM 端口 (SCP) 服务 | | | GPIO 服务 | | | Island 服务 | | | 文件系统服务 | | - **平台传感器**：QSH 提供一些内置传感器，用于平台或硬件特定的抽象，这些抽象可由其他传感器和传感器实例使用。下表介绍了平台传感器： 表：平台传感器 | 平台传感器 | 说明 | | --- | --- | | 注册表传感器 |


>
>
> Note
>
>
> [Qualcomm Linux Sensors Guide - Addendum](https://docs.qualcomm.com/bundle/resource/topics/80-70017-7A/overview.html) 适用于具有授权访问权限的许可开发人员。

| | 定时器传感器 | | | 中断传感器 | | | 异步 COM 端口 (ASCP) 传感器 |


>
>
> Note
>
>
> 物理传感器驱动程序通常使用 ASCP 传感器读取大块 FIFO。 | | SUID 查询传感器 | | | 测试传感器 | | - **QSH 实用工具**：QSH 为传感器和传感器实例提供了多个帮助程序实用工具。所有实用工具均可以在 `adsp_proc/qsh_platform/inc/utils` 目录中找到。下表介绍了关键工具： 表：QSH 实用工具 | QSH 实用工具 | 说明 | | --- | --- | | Nanopb 编码/解码 | | | 传感器实用工具 | | | 属性实用工具 | | | 内存工具 | | | 数学运算工具 | | | Printf 工具 | | ## 传感器和传感器实例 QSH 传感器实现分为两个逻辑单元：传感器和传感器实例。 - 传感器是异步数据的生成者或使用者或二者的组合。 - 每个传感器可以有一个或多个传感器实例。 - 任何传感器数据请求都将创建一个传感器实例或共享一个现有传感器实例。 - 传感器实例根据传感器确定的结果按需创建。 - 传感器完全管理其相应实例的生命周期和配置，并负责向其客户端发送配置更新和初始状态事件。 - 每个传感器实例均使用特定的客户端配置运行。 - 物理传感器的传感器实例对传感器硬件进行编程，使其以所需的配置运行。 - 供应商必须以最少数量的传感器实例处理所有客户端请求。 - 由传感器实例生成的数据流会发送至所有活动客户端。 - 多个传感器可以共享和配置一个传感器实例，此操作模式通常用于硬件传感器的组合驱动程序，例如： - 加速度计和陀螺仪 - 接近度和环境光 ## 传感器间通信 QSH 框架中的每个算法和传感器驱动程序均是指具有标准 QSH API 的传感器。在任何实际用例中，这些传感器之间的信息交换都是必要的。 所有传感器之间的通信，包括发送和接收，都是通过数据流上的请求和事件消息进行的。消息净荷使用 nanopb 生成器、编码器和解码器以协议缓存格式定义。消息净荷长度、消息 ID 和时间戳（事件）在由 QSH 框架管理的元数据内进行通信。 下图展示了数据客户端和数据源之间使用数据流的通信： VBackground-1 Solid Page-1 Rounded Rectangle.2 Rounded Rectangle.3 Simple Arrow.30 Simple Arrow.29 Rounded Rectangle.22 PB Encode/Decode PB 编码/解码 Rounded Rectangle.21 PB Encode/Decode PB 编码/解码 工作表.7 Request 请求 工作表.8 Event 事件 工作表.9 Data Client 数据客户端 工作表.10 Data Source 数据源 Dynamic connector.27 工作表.12 Data Stream 数据流 Round Corner Rectangle Third-party 第三方 客户端与源之间的传感器通信 - 发送的请求消息用于启用、禁用和重新配置传感器。请求消息始终可寻址到特定的 SUID。当目标传感器接收到请求消息后，就会将其发送至传感器实例进行适当处理。 - 传感器实例将事件消息异步发送到其注册的客户端，这些客户端可能是其他传感器或传感器实例。 ## QSH 中的 Nanopb 协议缓存 QSH 将 nanopb 协议缓存应用于： - 传感器之间交换的所有请求和事件消息。 - 传感器或传感器实例必须针对其发送至从属传感器或传感器实例的所有请求的净荷（如果存在）进行编码。 - 传感器或传感器实例必须针对其接收的所有请求的净荷（如果存在）进行解码。 - 传感器或传感器实例必须针对其发布的所有事件的净荷（如果存在）进行编码。 - 传感器或传感器实例必须针对从其从属传感器或传感器实例接收的所有事件的净荷（如果存在）进行解码。 > > > Note > > > 某些请求或事件不含消息主体。在这种情况下，不需要对净荷进行解码或编码，传感器会根据消息 ID 来处理这些消息。 - 表示属性数据 - 所有属性值均采用 nanopb 编码格式。 - 诊断日志数据包净荷 - 诊断日志数据包中的所有净荷均采用 nanopb 编码格式。 Note 有关 Google 协议缓存和 nanopb 的更多信息，参见[协议缓存](https://developers.google.com/protocol-buffers/)和 [nanopb](https://jpa.kapsi.fi/nanopb/)。 ## 传感器 API 消息 以下文件引用 API 消息（其中包含消息定义），用于传感器之间的通信： - `.proto` 文件包含协议缓存消息定义和文档，用于在传感器之间进行通信。 - 下表列出了 `/build-qcom-wayland/workspace/sources/sensinghub/sensing-hub/apis/proto/sns_std_*.proto` 文件中定义的 API 标准消息： 表：标准原型文件 | 文件 | 说明 | | --- | --- | | `sns_std.proto` | 此文件包含标准定义，例如：



>
>
> | | `sns_std_sensor.proto` | 此文件包含定义，例如：



>
>
> | | `sns_std_type.proto` | 此文件包含常见的 API 类型定义，例如：



>
>
> | | `sns_std_event_gated_sensor.proto` | 此文件包括事件门控传感器的 API，包括配置消息 ID 和 API 文档。 | - 特定于物理传感器的 API 定义和文档位于传感器特定的 `.proto` 文件中。例如，`sns_accel.proto`，`sns_proximity.proto` 和 `sns_motion_detect.proto`。 - 平台传感器 API 定义和文档位于 `adsp_proc/qsh_platform/api/` 目录中。例如，`sns_timer.proto`，`sns_interrupt.proto` 和 `sns_async_com_port.proto`。 - SUID、注册表和诊断的框架相关 API 在以下 proto 文件中定义： - `sns_suid.proto` - `sns_registry.proto` - `sns_diag.proto` Last Published: Jan 23, 2025 [Previous Topic 功能](https://docs.qualcomm.com/bundle/publicresource/80-70017-7SC/topics/supported_features.md) [Next Topic 接口](https://docs.qualcomm.com/bundle/publicresource/80-70017-7SC/topics/qsh_api_reference.md)