Skip to main content
Qualcomm® 传感中心 (QSH) 接口可用于基于硬件、基于软件、预先存在的或任何其他符合 QSH 的传感器。QSH 框架在低功耗处理器上运行,并在应用处理器上公开 API。这些 API 包括以下内容:
  • 用于应用开发的 QSH 客户端 API 和各种功能 API。
  • 用于在低功耗处理器上创建新传感器的传感器 API。

应用处理器 API

QSH 在应用处理器上提供功能 API 以解决特定的传感器用例。

QSH 客户端 API

QSH 客户端 API 提供了一个接口,使客户端代码能够访问 QSH 功能并开发端到端的传感器应用。QSH 支持以下 API:

getSession()

此 API 创建 ISession 的一个实例并返回指向它的指针。 语法
参数 — 无。 响应

open()

此 API 启动使用 getSession() API 创建的客户端会话。open() API 建立并设置客户端与 QSH 框架之间的通信。客户端必须在每个会话中只调用此函数一次。 语法
参数 — 无。 响应

setCallBacks()

对于指定的 SUID,此 API 允许用户为通过 Open() API 打开的会话上收到的响应、错误和事件设置回调。此 API 使用作为参数传递给该 API 的回调函数注册 SUID。 要取消设置已注册 SUID 的回调,您可以为所有三个回调函数:respCallBack、errorCallBack 和 eventCallBack 传递 nullptr。为所有回调函数传递 nullptr 会对未注册的 SUID 产生错误。 语法
参数 响应

sendRequest()

此 API 异步向 QSH 框架发送协议缓冲 (proto) 编码消息。proto 编码消息包含由 SUID 标识的传感器的指令或配置设置。 对于指定的 SUID,如果您使用 setCallBacks() API 设置回调指针,则会从 QSH 框架接收响应、事件或响应和事件的组合。 语法
参数 响应

close()

此 API 关闭传感器会话并终止客户端与 QSH 框架之间的通信。客户端必须在会话结束时调用此函数,以释放资源并避免内存泄漏。 语法
参数 — 无。 响应
有关更多信息和示例代码,请参阅 使用 QSH 客户端 API 开发应用。

QSH 直接通道 API

QSH 直接通道 API 为高速率应用提供低延迟传感器数据通道。直接通道 API 使用 FastRPC 接口,该接口绕过标准处理器间通信 (IPC) 机制以实现更快的通信。有关更多信息,请参阅 Qualcomm 传感中心 API。

低功耗处理器 API

低功耗处理器 API 提供对以下内容的访问:
  • QSH 框架资源,例如服务和实用程序。
  • 核心功能,例如诊断接口和计时器。
您可以使用低功耗处理器 API 创建符合 QSH 标准的算法和传感器驱动。有关更多信息,请参阅 Qualcomm 传感中心 API。 后续步骤