# 开发传感器 本节介绍了客户端应用程序如何与 QSH 框架交互。然后，进一步解释了 QSH 框架内传感器驱动程序和传感器算法的开发和集成过程。此外，还介绍了传感器校准的程序。 ## Qualcomm 传感中枢客户端 API 工作流 Qualcomm 传感中枢 (QSH) 公开的 API 称为应用程序的 QSH 客户端 API。客户端应用与低功耗处理器上的 QSH 框架进行交互。下图显示了 QSH 客户端 API 的详细细分和使用情况。 Page-1 shape30-1 shape2-3 Application 应用程序 shape4-6 libSensingHubSession libSensingHubSession shape5-9 Sheet.5 Sheet.6 shape6-12 Sheet.8 Sheet.9 shape7-15 getSession getSession shape8-23 ISession* ISession* shape9-31 Open Open shape10-38 success/fail 成功/失败 shape11-45 shape12-47 setCallBacks setCallBacks shape13-54 success/fail 成功/失败 shape14-61 sendRequest sendRequest shape15-68 success/fail 成功/失败 shape16-75 shape17-77 sensorEvent sensorEvent shape18-84 close() close() shape19-91 shape21-101 Application 应用程序 shape22-104 libSensingHubSession libSensingHubSession shape23-107 delete ISession* 删除 ISession* shape26-110 opt opt shape27-113 loop loop shape28-116 [perSUID] [perSUID] shape29-119 [sensorEvent] [sensorEvent] shape20-68 **图：QSH 客户端 API 工作流程** 以下列表描述了 QSH 客户端 API： - `getSession()`：要与 QSH 交互，传感器应用客户端必须通过调用 `getSession()` API 创建接口会话。如果成功创建接口会话，则会向客户端返回 `ISession*` 对象。 - `open()`、`close()`、`setCallback()` 和 `sendRequest()`：使用 `getSession()` API 创建的接口以 *once\_per\_session* 为基础运行。此接口允许客户端应用程序使用 QSH 客户端 API，例如 `open()`、`close()`、`setCallback()` 和 `sendRequest()`，直到使用 `close()` 和 `delete()` API 显式删除会话。 建立接口会话后，客户端应用程序或客户端代码可通过调用 `open()` API 来打开传感器会话。与 `getSession()` 类似，`open()` API 也是在 *once\_per\_session* 基础上调用。对于指定的 SUID，会调用一次 `setCallback()` 和 `sendRequest()` API。 ### 消息 传感器客户端应用发送和接收以下请求与响应消息： 1. 通过 `sendRequest()` API 发送 `sns_client_request_msg` 请求消息。 - 此消息的唯一字段是净荷，它是一个不透明的字节数组。该字段由协议缓存编码的 `sns_client_request_msg` 消息填充。 2. 收到 `sns_client_resp_msg` 响应消息。 - 客户端管理器确定 `sns_client_request_msg` 消息是否已相应编码以及目标 SUID 是否可用。对请求执行最少量的处理。 - 客户端管理器在收到请求后立即发送此响应消息。 3. 接收 `sns_client_event_msg` 消息类型的一个或多个事件。 - 事件回调函数按照 `setCallback` API 中的规定接收事件消息。 - 每个事件消息都有一个 SUID。 - 事件消息可能包含一个或多个逻辑传感器示例，这些示例都编码在单个 `sns_client_event_msg` 消息中。 ### 协议缓存 QSH 客户端请求和事件消息是包含协议缓存编码消息的不透明内存缓冲区。客户端可以用多种编程语言生成这些消息，然后将编码的字节数据流复制到 `sns_client_request_msg` 消息中。同样，客户端可以从 `sns_client_report_ind_msg` 消息中复制编码的消息并单独对其进行解码。 有关协议缓存的更多信息，请参阅[协议缓存](https://developers.google.com/protocol-buffers/)和 [nanopb](https://github.com/nanopb/nanopb)。 ### 客户端管理器 传感器客户端管理器位于 QSH 内，负责监督所有通信过程并履行以下责任： #### 转换传入请求 > > > 客户端管理器接收传入请求并将其转换为 QSH 可以理解的格式。转换涉及将请求转换为特定的请求消息。 #### 转换传出指示 > > > 客户端管理器在收到来自 QSH 的事件消息时，将其转换为传出指示。通过转换可确保消息的格式在 QSH 外部可理解。 #### 保证批处理选项 > > > 如果客户端指定了某些批量处理选项，则客户端管理器会确保这些选项得以满足。它检查数据是否以客户端指定的方式分组和发送。 > > > 关于客户端管理器的更多信息，请参阅 `/build-qcom-wayland/workspace/sources/sensinghub/sensing-hub/apis/proto/sns_client.proto` 文件。 #### SUID > > > SUID 是一个整数，用于唯一标识 QSH 提供的单个传感器。客户端将此 ID 视为启动期间随机生成的值。客户端不会假定 ID 重复或从数字本身派生任何信息。客户端管理器从请求中读取 SUID，并将请求路由到由 SUID 标识的传感器。 > > > 例如，如果 QSH 有两种引力算法可用，则每种算法都有自己唯一的 SUID。这种唯一的 ID 分配方式同样适用于物理传感器。如果物理传感器模型的硬件在设备上多次存在，则每个硬件都有自己的 SUID。 > > > 有关系统上可用传感器的完整列表，客户端可以向 SUID 传感器发送请求。关于更多详细信息，请参阅[表：平台传感器](https://docs.qualcomm.com/doc/80-70022-7SC/topic/architecture.html#table-platform-sensors)。 #### 客户端请求 > > > 客户端管理器的所有传入请求均使用 `sns_client_request_msg` 作为最外面的协议缓存消息。此消息包含以下字段： > > - SUID：用作请求消息的目标地址。所有请求消息均发送到有效的 SUID 进行处理；否则，客户端管理器将拒绝这些消息。 > - msg\_id：`sns_std_request::payload` 消息中所包含的已编码请求的数字标识符。 > > > 例如，传感器可以支持请求消息，以启用流传输并启动数据刷新请求。这两条消息的格式不同，此字段指示目标传感器如何解释请求。消息 ID 在传感器支持的所有消息中始终是唯一的。但是，两个不同的传感器可能会对不同的消息类型使用特定的 ID。例如，以下是两种类型的消息： > > - `SNS_STD_SENSOR_MSGID_SNS_STD_SENSOR_CONFIG`：表示从客户端到传感器的标准流传输请求。 > - `SNS_STD_SENSOR_MSGID_SNS_STD_SENSOR_EVENT`：表示来自数据源传感器的标准传感器事件。 > - 请求：是客户端发送到传感器的信息包。其中包含传感器所需的所有详细信息。`sns_std_request::payload` 字段对应于消息 ID 并且具有特定于传感器的配置。如需了解更多信息，请参阅特定于传感器的 proto 文件。 > - 重采样器配置：在客户端想要更改传感器对数据进行采样的速率时使用。使用以下选项进行重采样器配置： > > - `SNS_RESAMPLER_RATE_FIXED`：客户端需要以特定速率提供数据。例如，如果客户端希望以 200 Hz 的频率获取数据，而物理传感器支持以 240 Hz 的频率进行数据流传输，则以 200 Hz 的频率发送示例。 > - `SNS_RESAMPLER_RATE_MINIMUM`：客户端希望以一定的最低速率提供数据。例如，如果客户端希望以 200 Hz 的频率获取数据，而物理传感器支持以 240 Hz 的频率进行数据流传输，则以 240 Hz 的频率发送示例。 > - 阈值配置：当客户端仅在满足特定条件的情况下才需要数据时使用。共有四个种类型的条件： > > - `SNS_THRESHOLD_TYPE_RELATIVE_VALUE` 提供的阈值，是当前值与上次报告的超出配置阈值的值这二者之间的差值。 > - `SNS_THRESHOLD_TYPE_RELATIVE_PERCENT` 基于当前值与上一次报告值之间的差值提供阈值。它是上一次报告值的百分比，该百分比代表配置的阈值。 > - `SNS_THRESHOLD_TYPE_ABSOLUTE` 提供的阈值是固定配置的值。 > - `SNS_THRESHOLD_TYPE_ANGLE` 提供的阈值是四元数传感器的电流与上次报告的四元数之间夹角（以弧度为单位）。 > - 挂起配置：指定处理器挂起时系统的行为方式。 > > - `client_proc_type` 是客户端所在的处理器。如果此处理器上的任何客户端请求刷新（完全发送数据），则该处理器上的所有客户端都将获得刷新数据。 > - `delivery_type` 是关于处理器挂起时是否发送事件的配置项。 > > - `SNS_STD_DELIVERY_WAKEUP`：每当事件可用时（以采样率或批处理周期）发送事件。如果请求的 `batch_period` 大于系统容量，则在容量耗尽时发送所有数据。启用此选项后，由于未发送的批量数据无法在缓存累积，因此 `flush_period` 将被有效忽略。 > - `SNS_STD_DELIVERY_NO_WAKEUP`：仅当客户端处理器未挂起时才发送事件；否则，将数据批处理到刷新期为止。目标处理器退出挂起状态后，将发送所有挂起的事件。 > - `nowakeup_msg_ids` 是不会唤醒客户端处理器的消息 ID 列表。所述消息 ID 不具备唤醒能力。仅当存在其他具备唤醒能力的事件时，才会发送这些消息 ID。 > > > > 有关详细信息，请参阅 `/build-qcom-wayland/workspace/sources/sensinghub/sensing-hub/apis/proto/sns_client.proto` 文件。此处，`` 指定了您的工作目录。 #### 批处理 > > > 在 `sns_client_request_msg::sns_std_request` 消息中，客户端可以指定接收请求数据的方式和时间。`sns_std_request` 消息包含以下字段： > > - `batching::batch_period`：一个无符号整数值，表示批处理时间（以微秒为单位）。客户端可以假定已为给定的 `batch_period` 注册了一个定时器。自上次定时器过期到下一次定时器触发之前所生成的所有事件都将保存。此周期将被解释为客户端指定的最大周期。在某些并发场景下，事件会以更快的速率（更短的批处理周期）传递给客户端。客户端可以随时发送刷新请求，以指示客户端管理器发送所有批处理数据。默认情况下，批处理处于禁用状态。 > - `batching::flush_period`：无符号整数值，以微秒为单位。如果数据未发送到客户端，此字段会向客户端管理器或物理传感器提供有关必须批处理的历史数据量的提示。换言之，客户端管理器可能会以微秒为单位删除早于 `flush_period` 的数据。由于系统内存限制，有效刷新周期可能较小，在并发情况下可能较长。此字段是可选的，如果未设置，则默认为 `batch_period`，即仅保留一批数据。如果设置了该字段，则 `flush_period` 必须大于或等于 `batch_period`。 > - `batching::flush_only`：如果设置为 `True`，则客户端管理器仅在客户端发起刷新时发送事件。否则，它会继续批处理，直至达到 `flush_period` 为止（此时批处理将继续，但最旧的数据将被丢弃）。 > - `batching::max_batch`：如果设置为 `True`，它将引导传感器以最大批处理容量运行。如果请求同时具有 `flush_only = true` 和 `max_batch = true`，则 `flush_only` 优先。 #### 客户端事件 > > > 来自客户端管理器的所有传出指示均使用 `sns_client_event_msg` 作为位于 `sns_client_report_ind_msg` 的净荷字段内的最外层协议缓存编码消息。`sns_client_event_msg` 消息包含多个字段： > > - SUID：与数据源事件关联。如果客户端向单个连接上的多个 SUID 发送请求，则此消息仅包含一个 SUID 的事件。来自其他 SUID 的事件在单独的指示消息中传递。 > - `events::msg_id`：唯一标识关联的事件消息。 > - `events::timestamp`：与该事件相关联的基于 QTimer 时钟计时单位的时间戳。对于大多数事件，传感器会设置时间戳，该时间戳是指在传感器硬件中创建物理示例的时间。对于框架生成的事件（如配置更新或错误事件），此时间戳是指创建事件的时间。 > - `events::payload`：动态长度净荷，包含来自传感器的实际数据/事件。使用特定于传感器的 proto 缓存单独解码此净荷。 #### 消息净荷 > > > 传感器特定的请求或事件在 `sns_client_request_msg::sns_std_request::payload` 和 `sns_client_event_msg::sns_client_event::payload` 消息中提及。这些消息字段可能包含协议缓存编码的消息，其字段特定于该消息 ID，或者可能为空，并且没有字段。 > > > 客户端使用与其通信的传感器关联的 `proto` 文件。每种传感器类型均有相应的 `proto` 文件。例如，`sns_accel.proto` 描述了如何启用加速计流。每个传感器都会发布其 `proto` 文件列表作为其属性的一部分。如需了解更多信息，请参阅[传感器属性](https://docs.qualcomm.com/doc/80-70022-7SC/topic/develop_sensors.html##table-sensor-attribute)。 > > - 数据类型：每个传感器均会通告一个数据类型属性。每种数据类型都与一组唯一的 `proto` 文件相关联，这些文件构成了该传感器专有 API。所有相同类型的传感器必须支持一组最少的请求和事件消息。它们可以定义和使用更多的该传感器专有的可选消息。每个传感器都会发布其 `proto` 文件的完整列表作为其属性的一部分。 > - 标准化消息：任何客户端均可向任意传感器发送一组 Qualcomm 定义的标准化消息。这些消息在 `sns_std.proto` 文件中定义。 > > - `SNS_STD_MSGID_SNS_STD_ATTR_REQ`：查询传感器的属性列表。它会返回一个具有 `SNS_STD_MSGID_SNS_STD_ATTR_EVENT` ID 的事件，该事件包含所有已发布属性的列表，请参阅[传感器属性](https://docs.qualcomm.com/doc/80-70022-7SC/topic/develop_sensors.html##table-sensor-attribute)。客户端还可以在发布新属性或更新属性时注册通知。 > > - `sns_std_attr_req` 包含 `register_updates` 字段。如果设置为 `True`，则每当传感器属性发生更改时，客户端都会通过 `sns_std_attr_event` 收到通知。 > - `sns_std_attr_event` 包含 `attributes` 字段，该字段列出了传感器为响应 `sns_std_attr_req` 而发送的传感器发布的所有属性，或在对已注册传感器的属性更改时发布的所有属性。 > - `SNS_STD_MSGID_SNS_STD_FLUSH_REQ`：强制立即将来自此传感器的所有批处理数据发送到客户端。此请求消息强制系统上适用的硬件和软件缓存刷新所有存在的数据。 > > > 例如，向加速度计传感器发送此请求会触发物理先进先出 (FIFO) 刷新，以及客户端管理器当前持有的任何样本。如果刷新请求是针对内部使用加速度计和陀螺仪数据的算法（例如游戏旋转矢量 (GRV)），则加速度计和陀螺仪硬件 FIFO 都会刷新。 > - `SNS_CLIENT_MSGID_SNS_CLIENT_DISABLE_REQ`：禁用此传感器的活动请求。例如，客户端向加速度计传感器发送 `SNS_STD_SENSOR_MSGID_SNS_STD_SENSOR_CONFIG` 消息以启用数据流动。稍后，发送 `DISABLE_REQ` 将取消数据流请求，并且此客户端的加速计数据流将停止。 > - `SNS_STD_MSGID_SNS_STD_FLUSH–EVENT`：对刷新请求的响应。它表示没有与刷新请求对应的其他事件。 > - `SNS_STD_MSGID_SNS_STD_ERROR–EVENT`：由传感器、传感器实例或框架生成的错误事件。 > > > 有关详细信息，请参阅 `/build-qcom-wayland/workspace/sources/sensinghub/sensing-hub/apis/proto/sns_client.proto` 文件。 > - 标准化传感器消息：客户端请求中描述的消息适用于所有传感器。除了客户端请求中所描述的消息之外，还可以使用 Qualcomm 推荐的标准化消息。这些建议是可选的，您可以选择定义自己的请求和事件消息。 > > - `SNS_STD_SENSOR_MSGID_SNS_STD_SENSOR_CONFIG`：允许以下情况进行流传输的请求消息： > > - 任何物理传感器，例如加速度计、陀螺仪和地磁传感器。 > - 部分算法，例如旋转矢量、重力和线性加速度。 > - `SNS_STD_SENSOR_MSGID_SNS_STD_ON_CHANGE_CONFIG`：请求允许对更改类型传感器进行流传输的消息。例如，接近度、环境光和步进检测传感器。 > - `SNS_STD_SENSOR_MSGID_SNS_STD_SENSOR_PHYSICAL_CONFIG_EVENT`：处理客户端请求后所有物理传感器发送的事件。它指示数据流客户端的期望，例如传感器生成示例的速率。 > - `SNS_STD_SENSOR_MSGID_SNS_STD_SENSOR_EVENT`：根据客户请求，传感器产生的数据样本。 > > > > 有关详细信息，请参阅 `sns_std_sensor.proto` 文件。 > - SUID 查找传感器：客户端可以在 SUID 查找传感器中查询与特定数据类型关联的 SUID 列表。`sns_suid_req` 消息指定数据类型，客户端接收所有匹配的 SUID。空数据类型字符串会导致接收系统上所有 SUID。 > > > 例如，如果客户端将 *accel* 指定为数据类型，则客户端会收到其传感器提供 *accel* 类型数据的所有 SUID 的列表。此外，如果客户端希望接收新匹配项的通知，则可以通过 `register_updates` 字段来表明这一需求。客户端可以在 `sns_suid_req` 消息之后发送一个属性请求 (`sns_std_attr_req`)，以决定哪些可用的*加速度*传感器适合该客户端。 > > > SUID 查找传感器具有自己的 SUID，该 SUID 是常量并发布在 `sns_suid.proto` 文件中（在所有其他传感器中保持唯一）。 > > > `sns_suid_req` 消息包含以下字段。有关更多信息，请参阅 `sns_suid.proto` 文件和示例代码。 > > > > 表：SUID 请求 > > > | 字段 | 强制或可选 | 数据类型 | 说明 | > | --- | --- | --- | --- | > | `data_type` | 必选 | 字符串 | 要查询 SUID 的传感器的数据类型。 | > | `register_updates` | 可选 | Boolean | 注册以获取更新，了解公布 `data_type` 字段的 SUID 列表。 | > | `default_only` | 可选 | Boolean | 可以通过注册表为每种数据类型配置一个默认传感器。



>
>
>

    >

  • 如果 default_only 字段设置为 True，且：


      >

    • 显式配置了数据类型的默认值，则仅通过 SUID 事件发送默认的传感器 SUID（如有）。


      • >

    • 未显式配置数据类型的默认值，则通过 SUID 事件发送数据类型相匹配的第一个传感器的 SUID。


      • >

    >

    • >

  • 如果 default_only 字段设置为 False，则数据类型匹配的所有传感器都将在可用时发送。


    • >
| #### 传感器属性 > > > 每个传感器都会发布一个属性列表，每个属性由一个数字标识符表示。这些属性提供有关传感器功能及其接受作为输入的值范围的信息。下表列出了几个重要属性： > > > > > > > > 表：传感器属性 > > > > > > | 属性 ID | 属性名称 | 必需？ | 数据类型 | 说明 | > > | --- | --- | --- | --- | --- | > > | 0 | `SNS_STD_SENSOR_ATTRID_NAME` | 是 | 字符串 | 易读的传感器名称。 | > > | 1 | `SNS_STD_SENSOR_ATTRID_VENDOR` | 是 | 字符串 | 易读的供应商名称。 | > > | 2 | `SNS_STD_SENSOR_ATTRID_TYPE` | 是 | 字符串 | 传感器 proto 文件中所定义的供此传感器使用的数据类型。 | > > | 3 | `SNS_STD_SENSOR_ATTRID_AVAILABLE` | 是 | Boolean | 指示此传感器是否可用于客户端。 | > > | 4 | `SNS_STD_SENSOR_ATTRID_VERSION` | 是 | 整型 |

  • 64 位整数值以 major[31:16].minor[15:8].revision[7:0] 呈现，用于表示传感器的版本。


  • 十六进制示例：major：0x0002 minor：0x00 revision：0x36。


  • DRIVER_VERSION 0x00020036。


| > > | 5 | `SNS_STD_SENSOR_ATTRID_API` | 是 | 字符串 | 列出该传感器使用的各个 `proto` 文件名；更多 `proto` 依赖项可以在同一个 proto 文件中指定为导入项，以用于自动化测试的目的。 | > > | 6 | `SNS_STD_SENSOR_ATTRID_RATES` | 否 | 浮点 | 传感器支持的采样率。 | > > | 7 | `SNS_STD_SENSOR_ATTRID_RESOLUTIONS` | 否 | 浮点 | 传感器支持的样品分辨率。 | > > | 8 | `SNS_STD_SENSOR_ATTRID_FIFO_SIZE` | 否 | 整型 | 支持的 FIFO 深度（示例数）。 | > > | 9 | `SNS_STD_SENSOR_ATTRID_ACTIVE_CURRENT` | 否 | 整型 | 有源电流阵列（以 μA 为单位）。 | > > | 10 | `SNS_STD_SENSOR_ATTRID_SLEEP_CURRENT` | 否 | 整型 | 非活动电流（以 μA 为单位）。 | > > | 11 | `SNS_STD_SENSOR_ATTRID_RANGES` | 否 | 浮点 | 传感器支持的工作范围。 | > > | 12 | `SNS_STD_SENSOR_ATTRID_OP_MODES` | 否 | 字符串 | 定义传感器支持的操作模式。例如，[LPM, HIGH\_PERF, NORMAL, OFF]. | > > | 13 | `SNS_STD_SENSOR_ATTRID_DRI` | 否 | Boolean | 表示传感器是支持数据就绪中断 (DRI) 还是带内中断 (IBI)：



>
>
>

    >

  • True = DRI


    • >

  • False = IBI


    • >
| > > | 14 | `SNS_STD_SENSOR_ATTRID_STREAM_SYNC` | 否 | Boolean | 表示传感器是否支持同步数据流。 | > > | 15 | `SNS_STD_SENSOR_ATTRID_EVENT_SIZE` | 否 | 整型 |

  • 此传感器生成的数据事件（协议缓冲区编码）的大小（以字节为单位）。


  • 对于物理和虚拟传感器，此值是指其传感器示例的大小


  • 供硬件抽象层 (HAL) 用于确定最大批处理容量。


| > > | 16 | `SNS_STD_SENSOR_ATTRID_STREAM_TYPE` | 是 | 整型 | 表示传感器支持的流传输类型：



>
>
>

    >

  • 0 = 连续定期采样


    • >

  • 1 = 更改时


    • >

  • 2 = 单路输出（单次）


    • >
| > > | 17 | `SNS_STD_SENSOR_ATTRID_DYNAMIC` | 否 | Boolean | 指定此传感器是否为动态（在运行时连接或断开）。 | > > | 18 | `SNS_STD_SENSOR_ATTRID_HW_ID` | 否 | 整型 | 区分同一硬件的多个传感器。 | > > | 19 | `SNS_STD_SENSOR_ATTRID_RIGID_BODY` | 否 | 整型 | 放置传感器的刚体。



>
>
>

    >

  • 0 = 传感器硬件位于显示屏侧


    • >

  • 1 = 传感器硬件位于键盘侧


    • >

  • 2 = 传感器硬件安装在外部设备上


    • >
| > > | 21 | `SNS_STD_SENSOR_ATTRID_PHYSICAL_SENSOR` | 否 | Boolean |

  • 如果是物理传感器，则为 True。


  • 如果是虚拟传感器，则为 False。


| > > | 22 | `SNS_STD_SENSOR_ATTRID_PHYSICAL_SENSOR_TESTS` | 否 | 整型 | 使用 `sns_physical_sensor_test_type` 中的枚举值表示支持的物理传感器测试。 | > > | 23 | `SNS_STD_SENSOR_ATTRID_SELECTED_RESOLUTION` | 否 | 浮点 | 每个动态范围值的测量分辨率。 | > > | 24 | `SNS_STD_SENSOR_ATTRID_SELECTED_RANGE` | 否 | Float[2] | 传感器支持的动态范围选项。对于默认选项，请参阅供应商的传感器硬件要求规范。 | > > | 25 | `SNS_STD_SENSOR_ATTRID_ADDITIONAL_LOW_LATENCY_RATES` | 否 | 浮点 | 低延迟操作的其他采样率，以 Hz 为单位。这些采样率适用于专用的低延迟客户端，扩展了 `SNS_STD_SENSOR_ATTRID_RATES` 属性中发布的速率。


专用内部客户端必须使用这些更高的数据传输速率，因为它们可能会影响系统性能。 | > > | 26 | `SNS_STD_SENSOR_ATTRID_PASSIVE_REQUEST` | 否 | Boolean | 如果传感器支持被动请求，则为 `True`；否则为 `False`。如果传感器不支持被动请求，则必须将所有请求视为主动请求。 | > > | 29 | `SNS_STD_SENSOR_ATTRID_TRANSPORT_MTU_SIZE` | 否 | 整型 | 传输传感器的最大传输单元 (MTU) 大小（以字节为单位）。 | > > | 30 | `SNS_STD_SENSOR_ATTRID_HLOS_INCOMPATIBLE` | 否 | Boolean | 如果传感器与支持的数据类型的高级操作系统 (HLOS) 规范不兼容，则为 `True`。 | > > | 31 | `SNS_STD_SENSOR_ATTRID_SERIAL_NUM` | 否 | 字符串 | 传感器序列号。 | > > | 32 | `SNS_STD_SENSOR_ATTRID_TECH_USED` | 否 | 整数数组 | 使用的技术列表。如需了解更多信息，请参阅 `sns_std_type.proto` 文件中的 `sns_tech`。 | > > > > 有关更多信息，请参阅 `sns_std_sensor.proto` 文件和示例代码。Proto 文件位于设备上的 `/etc/sensors/proto/` 目录中。 - [使用 QSH 客户端 API 开发应用程序](https://docs.qualcomm.com/doc/80-70022-7SC/topic/sample1.html) - [配置传感器](https://docs.qualcomm.com/doc/80-70022-7SC/topic/sample1.html#id1) - [开发并集成传感器驱动程序](https://docs.qualcomm.com/doc/80-70022-7SC/topic/sample1.html#id2) - [开发并集成自定义传感器算法](https://docs.qualcomm.com/doc/80-70022-7SC/topic/sample1.html#id3) - [校准传感器](https://docs.qualcomm.com/doc/80-70022-7SC/topic/calibrate.html) Last Published: Nov 03, 2025 [Previous Topic 调通传感器](https://docs.qualcomm.com/bundle/publicresource/80-70022-7SC/topics/bringup_sensors.md) [Next Topic 使用 QSH 客户端 API 开发应用程序](https://docs.qualcomm.com/bundle/publicresource/80-70022-7SC/topics/sample1.md)