Page-1

# 架构 Source: [https://docs.qualcomm.com/doc/80-70014-7Y/topic/architecture.html](https://docs.qualcomm.com/doc/80-70014-7Y/topic/architecture.html) Note: 低功耗处理器 (aDSP) 的源代码（包括 QSH 框架）仅供授权用户使用。要升级您的访问权限，可访问：[www.qualcomm.com/support/working-with-qualcomm](https://www.qualcomm.com/support/working-with-qualcomm). Note: 要继续阅读有关 API 和/或部署传感器的信息，直接跳至[接口](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-7/qsh_api_reference.html)。 QSH 是 Qualcomm® Snapdragon™ 传感器内核 (SSC) 的代名词，它为驱动程序和算法提供了一个统一的事件驱动框架。QSH 支持基于硬件和基于软件的传感器的同一组 API。此外，QSH 支持异步总线传输，并且可轻松扩展新的或自定义驱动程序功能。QSH 由各种组件组成，包括 QSH 客户端 API、传感器 API、核心框架、预实现的平台传感器、供应商实现的传感器和测试模块。它为外部客户端提供服务，并提供一个简单的界面来访问传感器数据。 Figure : QSH 架构下表列出了用于了解 QSH 框架及其用法的 QSH 术语。 Table : QSH 术语 | **项目** | **说明** | | --- | --- | | 传感器 |

生成单一类型数据，例如，加速度计、陀螺仪、定时器、中断、旋转矢量等

处理异步数据

发布必需属性和自定义属性，并管理其实例

| | 传感器实例 |

在特定配置下运行，发布输出数据事件，并且可以按客户端请求创建或在多个请求之间共享

物理传感器通常共享单一实例

| | 传感器唯一标识符 (SUID) | 每个传感器唯一的 128 位 ID | | 服务 | 为通用实用工具提供同步接口的模块 | | 数据流 | 客户端与数据源间的唯一连接 | | 请求 | 由客户端发送至传感器的配置消息（参见 `sns_request.h` 文件） | | 事件 | 传感器实例生成的异步输出数据消息（参见 `sns_sensor_event.h` 文件） | | Nanopb | Nanopb 是一个用 ANSI C 实现的小代码量协议缓冲区 | 以下资源提供了有关 QSH 架构的深入信息： - **应用处理器软件模块** - **应用处理器**：该模块包含与应用处理器端的 QSH 客户端 API 交互的*应用程序 main() 或入口函数*。 - **QSH 客户端 API**：该区块提供 high-level API 来访问 QSH 提供的服务。它通过抽象系统复杂性来简化应用程序开发，并使其能够专注于应用程序逻辑。更多信息，参见[接口](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-7/qsh_api_reference.html)。 - **低功耗处理器软件模块** - **客户端管理器**：该模块负责低功耗处理器与应用处理器的所有通信。客户端管理器负责以下功能： - 转换传入请求：客户端管理器接受传入的请求，并将其转换为 QSH 可以理解的格式。 - 转换传出指示：当客户端管理器从 QSH 接收事件消息时，客户端管理器会将这些事件消息转换为可在 QSH 外部理解的格式的传出指示。 - 保证批处理选项：如果客户端指定了某些批处理（本地存储/累积）选项，则客户端管理器将确保满足批处理选项。这意味着它会检查数据是否以客户端指定的方式进行分组和发送。 - **服务管理器**：QSH 通过其服务管理器提供同步服务。传感器和传感器实例 API 使用回调连接到此服务管理器。 QSH 中可用的服务（也称为 QSH 服务）列在 `adsp_proc/qsh_platform/inc/sns_service.h` 文件中。下表介绍了对设备驱动程序至关重要的关键 QSH 服务。 Table : QSH 服务 | QSH 服务 | 说明 | | --- | --- | | 流服务 |

流服务支持创建和删除传感器数据流。

有关通过数据流发送请求和接收事件的流 API，参见 adsp_proc/qsh_platform/inc/sns_data_stream.h 文件。

| | 属性服务 |

属性服务允许传感器发布其属性或功能。

所有标准属性 ID 和预期值类型均在 sns_std_sensor.proto 文件中定义。

所有属性值必须采用 nanopb 编码格式。

有关 API 的详细信息，参见 adsp_proc/qsh_platform/inc/services/sns_attribute_service.h 文件。

| | 诊断服务 |

诊断服务提供调试消息和数据日志数据包服务，并定义标准日志数据包 ID。

有关 API 的详细信息，参见 adsp_proc/qsh_platform/inc/services/sns_diag_service.h 文件。

| | 事件服务 |

凭借事件服务可发布来自源传感器实例的输出事件。

有关 API 的详细信息，参见 adsp_proc/qsh_platform/inc/services/sns_event_service.h 文件。

| | 电源服务 |

电源服务可供物理传感器注册和投票（开/关）。

有关 API 的详细信息，参见 adsp_proc/qsh_platform/inc/services/sns_pwr_rail_service.h 文件。

| | 同步 COM 端口 (SCP) 服务 |

SCP 服务可用于物理传感器注册/注销 COM 端口以及通过 COM 端口执行同步传输。

有关 API 的详细信息，参见 adsp_proc/qsh_platform/inc/services/sns_sync_com_port_service.h 文件。

| | GPIO 服务 |

GPIO 服务可供物理传感器读取/写入 GPIO 值。

该服务有效地抽象了一个 low-level CoreBSP 层来控制 GPIO。

有关 API 的详细信息，参见 adsp_proc/qsh_platform/inc/services/sns_gpio_service.h 文件。

| | Island 服务 |

物理传感器可以使用 Island 服务来请求 Island 出口。

当应用程序必须访问 DDR 或非 Island 资源时，应用程序代码可以使用 Island 服务。

有关 API 的详细信息，参见 adsp_proc/qsh_platform/inc/services/sns_island_service.h 文件。

| | 文件系统服务 |

文件系统服务可供物理传感器使用，用于文件服务管理。

抽象文件系统是应用处理器堆栈的一部分，可用于从低功耗处理器进行本地访问。

有关 API 的详细信息，参见 adsp_proc/qsh_platform/inc/services/sns_file_service.h 文件。

| - **平台传感器**：QSH 提供一些内置传感器，用于平台或硬件特定的抽象，这些抽象可以被其他传感器和传感器实例使用。下表介绍了平台传感器。 Table : 平台传感器 | 平台传感器 | 说明 | | --- | --- | | 注册表传感器 |

QSH 中的注册表传感器为传感器提供了一个接口，用于从持久内存访问注册表数据。它允许传感器创建数据流、发送请求、接收数据事件、订阅更新以及删除不必要的流。

有关注册表传感器的详细信息，参见 Qualcomm Linux Sensors Guide - Addendum 中的配置。
Note: Qualcomm Linux Sensors Guide - Addendum 仅供授权用户访问。

注册表传感器 API 记录在 adsp_proc/qsh_api/pb/sns_registry.proto 文件中。

| | 定时器传感器 |

QSH 中的定时器传感器提供了一个接口用于启动周期性或一次性定时器。需要计时器的传感器必须创建数据流、发送请求并读取传递的数据事件。

计时器传感器 API 记录在 adsp_proc/qsh_platform/api/public_sns/sns_timer.proto 文件中。

| | 中断传感器 |

QSH 中的中断传感器提供用于记录中断的接口。需要中断的传感器必须创建一个数据流、发送请求并读取传递的数据事件。

中断传感器 API 记录在 adsp_proc/qsh_platform/api/public_sns/sns_interrupt.proto 文件中。

| | 异步 COM 端口 (ASCP) 传感器 |

QSH 中的 ASCP 传感器为通过通信端口进行异步读/写操作提供了一个接口。

需要此功能的传感器必须创建数据流、发送请求并读取传递的数据事件。

ASCP 传感器 API 记录在 adsp_proc/qsh_platform/api/public_sns/sns_async_com_port.proto 文件中。

Note: 物理传感器驱动程序通常使用 ASCP 传感器读取大块 FIFO。 | | SUID 查询传感器 |

QSH 中的 SUID 查找传感器提供了一个 API，用于获取相关传感器的 SUID。它自己的 SUID 可通过 sns_sensor_util.h 文件中的 sns_get_suid_lookup() 函数使用。

SUID 查找传感器 API 记录在 adsp_proc/qsh_api/pb/sns_suid.proto 文件中。

| | 测试传感器 | 在 `adsp_proc/qsh_platform/sensors/test` 目录下有一个测试传感器，可用于定制和运行特定传感器的用例。 | - **QSH 实用工具**：QSH 为传感器和传感器实例提供了多个帮助程序实用工具。有关所有可用的实用工具，参见 `adsp_proc/qsh_platform/inc/utils` 目录。下表介绍了核心实用工具。 Table : QSH 实用工具 | QSH 实用工具 | 说明 | | --- | --- | | Nanopb 编码/解码 |

为所有传感器提供通用的编码/解码辅助函数。例如，对 sns_request 消息进行编码/解码，对数据事件进行编码和发布/解码。

异步 COM 端口 nanopb 实用工具可用于物理传感器驱动程序。

| | 传感器实用工具 |

提供常见功能，例如查找传感器实例和获取 SUID 查找传感器的 SUID。

| | 属性实用工具 |

提供可编码并发布传感器属性的辅助函数。

| | 内存、数学运算、printf 实用工具。 | | ## 传感器间的通信 Source: [https://docs.qualcomm.com/doc/80-70014-7Y/topic/architecture.html](https://docs.qualcomm.com/doc/80-70014-7Y/topic/architecture.html) QSH 框架中的每个算法和传感器驱动程序都称为具有标准 QSH API 的传感器。在任何实际用例中，这些传感器之间的信息交换都是必要的。以下资源介绍了这些传感器之间的通信。所有传感器之间的通信，包括发送和接收，都是通过数据流上的请求和事件消息进行的。消息净荷使用 nanopb 生成器、编码器和解码器以协议缓冲区格式定义。消息净荷长度、消息 ID 和时间戳（位于事件中）在由 QSH 框架管理的元数据内进行通信。 Figure : 传感器通信发送的请求消息用于启用、禁用和/或重新配置传感器。请求消息始终可寻址到特定的 SUID。当目标传感器接收到请求消息后，就会将其发送至传感器实例进行适当处理。传感器实例将事件消息异步发送到其注册的客户端，这些客户端可能是其他传感器或传感器实例。 ### 传感器和传感器实例 - 传感器是异步数据的生产者和/或消费者 - 每个传感器可具有一个或多个传感器实例。 - 每个实例运行于特定的配置环境 - 对传感器数据的任何请求，都将创建一个传感器实例或共享一个现有实例 - 传感器实例根据传感器确定的结果按需创建 - 传感器完全管理其相应实例的生命周期和配置，并负责向其客户端发送配置更新和初始状态事件 - 供应商应使用尽可能少的传感器实例为所有客户端请求提供服务 - 由传感器实例生成的数据流会发送至所有活动客户端 - 多个传感器可以共享和配置单个传感器实例，此操作模式通常适用于硬件传感器的组合驱动程序。在这里，传感器表示支持的数据类型，传感器实例是通信和配置硬件的唯一模块。 ## QSH 中的 Nanopb 协议缓冲区 Source: [https://docs.qualcomm.com/doc/80-70014-7Y/topic/architecture.html](https://docs.qualcomm.com/doc/80-70014-7Y/topic/architecture.html) QSH 将 nanopb 协议缓冲区应用于： - 传感器之间交换的所有请求和事件消息 - 传感器/传感器实例必须针对其发送至从属传感器/实例的所有请求的净荷（如果存在）进行编码。 - 传感器/传感器实例必须针对其接收的所有请求的净荷（如果存在）进行解码。 - 传感器/传感器实例必须针对其发布的所有事件的净荷（如果存在）进行编码。 - 传感器/传感器实例必须针对其从属传感器/实例发送的所有事件的净荷（如果存在）进行解码。 - 部分请求/事件不含消息主体。在这种情况下，预期不针对净荷进行解码/编码。此类消息通过其消息 ID 进行处理。 - 表示属性数据 - 所有属性值均采用 nanopb 编码格式 - 日志数据包净荷 - 日志数据包中的所有净荷均采用 nanopb 编码格式有关 Google 协议缓冲区和 nanopb 的更多信息，参见[协议缓冲区](https://developers.google.com/protocol-buffers/)和 [nanopb](https://jpa.kapsi.fi/nanopb/)。 ## 传感器 API 消息 Source: [https://docs.qualcomm.com/doc/80-70014-7Y/topic/architecture.html](https://docs.qualcomm.com/doc/80-70014-7Y/topic/architecture.html) 以下 API 消息用于传感器之间的通信： - `.proto`文件包含以下用于传感器之间通信的元素： - 协议缓冲区消息定义 - 文档 - 下表列出了 `/build-qcom-wayland/workspace/sources/sensinghub/sensing-hub/apis/proto/sns_std_*.proto` 文件中的标准消息定义： Table : 标准 proto 文件 | 文件 | 说明 | | --- | --- | | `sns_std.proto` | 此文件包括标准定义，例如消息 ID、请求消息、批处理规范、属性请求和事件以及错误事件。 | | `sns_std_sensor.proto` | 此文件包含多项定义，例如标准传感器的请求和事件 API 的消息 ID、数据流和事件消息、传感器示例状态类型、标准属性 ID、常用属性类型以及物理传感器配置事件消息。 | | `sns_std_type.proto` | 此文件包含通用 API 类型定义，如 SUID 消息、属性事件和值消息以及通用错误类型。 | | `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: Aug 20, 2024 [Previous Topic 功能](https://docs.qualcomm.com/bundle/publicresource/80-70014-7Y/topics/supported_features.md) [Next Topic 接口](https://docs.qualcomm.com/bundle/publicresource/80-70014-7Y/topics/qsh_api_reference.md)