传感器测试工具

使用以下工具执行功能测试、设置构建环境和进行功能诊断。

传感器功能测试工具

这些测试工具可确保应用程序中基于硬件和基于软件的传感器的准确性、可靠性和最佳性能。以下工具有助于对传感器功能进行全面测试。

传感器信息测试提供有关传感器的详细信息。
驱动程序验收测试确保传感器驱动程序运行正常并与 Qualcomm 传感中枢（QSH）兼容。
传感器 workhorse 是在各种条件下对传感器进行压力测试的工具。

传感器信息测试 ssc_sensor_info 是 QSH 测试套件中的一个应用程序。它列出 QSH 支持的传感器及其属性。您可以在高级操作系统（HLOS）上运行以下查询，以获取指定数据类型的属性。

ssc_sensor_info [-sensor=<sensor_type>] [-delay=<time_in_seconds>][-duration=<time_in_seconds>][-default_only=<1|0>][-log=<1|0>][-help]

下表描述了 ssc_sensor_info 测试应用程序使用的参数。 表：ssc_sensor_info 的参数

标志	类型	值	单位	说明
Sensor	`string`	任何有效的传感器类型，例如 `accel` 和 `gyro`。	不适用	查询指定传感器类型的属性信息。
Log	`int`	0 \| 1	不适用	启用或禁用诊断（API）日志。
help(h)	`int`	不适用	不适用	显示命令用法帮助。
Duration	`int`	正值	秒	指定等待传感器属性更新的时间。
Delay	`int`	正值	秒	指定发送传感器请求之前的时间延迟。
default_only	`int`	0 \| 1	不适用	如果 `default_only` 标志设置为 `False`，则发送支持指定数据类型的所有可用传感器的 UID。如果 `default_only` 标志设置为 `True`，则仅发送默认可用传感器的 UID。

传感器信息测试示例

查询传感器属性并生成诊断日志。

ssc_sensor_info

root@qcm6490:~# ssc_sensor_info
ssc_sensor_info v1.86

SUID           = 0xebd5604d09d379bca54dcf30ec041e0f
NAME           = ak0991x
VENDOR         = akm
TYPE           = mag
AVAILABLE      = true
VERSION        = 2.62.47
API            = sns_mag.proto
RATES          = [1.000000, 10.000000, 20.000000, 50.000000, 100.000000]
RESOLUTIONS    = 0.150000
RANGES         = [-4912.000000,4912.000000]
DRI            = false
FIFO_SIZE      = 0
STREAM_TYPE    = streaming
STREAM_SYNC    = false
DYNAMIC        = false
EVENT_SIZE     = 16
OP_MODES       = [LOW_POWER, LOW_NOISE]
ACTIVE_CURRENT = 900
SLEEP_CURRENT  = 3
HW_ID          = 0
RIGID_BODY     = display
PHYSICAL_SENSOR       = true
PHYSICAL_SENSOR_TESTS = [3, 1]
SELECTED_RESOLUTION   = 0.150000
SELECTED_RANGE        = [-4912.000000,4912.000000]

SUID           = 0x61ab5376b4a5c9aa58442ede47acd316
NAME           = icm4x6xx
VENDOR         = TDK-InvenSense
TYPE           = accel
AVAILABLE      = true
VERSION        = 1.65.2
API            = sns_accel.proto
RATES          = [12.500000, 25.000000, 50.000000, 100.000000, 200.000000, 500.000000]
RESOLUTIONS    = [0.000019, 0.000037, 0.000075, 0.000150, 0.000299]
RANGES         = [[-9.806650,9.806650], [-19.613300,19.613300], [-39.226601,39.226601], [-78.453201,78.453201], [-156.906403,156.906403]]
DRI            = true
FIFO_SIZE      = 200
STREAM_TYPE    = streaming
STREAM_SYNC    = false
DYNAMIC        = false
EVENT_SIZE     = 16
OP_MODES       = [LPM, NORMAL, HIGH_PERF]
ACTIVE_CURRENT = [50, 240, 240]
SLEEP_CURRENT  = 6
HW_ID          = 0
RIGID_BODY     = display
PHYSICAL_SENSOR       = true
PHYSICAL_SENSOR_TESTS = [3, 2, 1]
SELECTED_RESOLUTION   = 0.000299
SELECTED_RANGE        = [-156.906403,156.906403]
LOW_LATENCY_RATES     = 1000.000000
PASSIVE_REQUEST       = true

查询所有 accel 传感器属性。

ssc_sensor_info -sensor=accel

root@qcm6490:~# ssc_sensor_info -sensor=accel
ssc_sensor_info v1.86

SUID           = 0x61ab5376b4a5c9aa58442ede47acd316
NAME           = icm4x6xx
VENDOR         = TDK-InvenSense
TYPE           = accel
AVAILABLE      = true
VERSION        = 1.65.2
API            = sns_accel.proto
RATES          = [12.500000, 25.000000, 50.000000, 100.000000, 200.000000, 500.000000]
RESOLUTIONS    = [0.000019, 0.000037, 0.000075, 0.000150, 0.000299]
RANGES         = [[-9.806650,9.806650], [-19.613300,19.613300], [-39.226601,39.226601], [-78.453201,78.453201], [-156.906403,156.906403]]
DRI            = true
FIFO_SIZE      = 80
STREAM_TYPE    = streaming
STREAM_SYNC    = false
DYNAMIC        = false
EVENT_SIZE     = 16
OP_MODES       = [LPM, NORMAL, HIGH_PERF]
ACTIVE_CURRENT = [50, 240, 240]
SLEEP_CURRENT  = 6
HW_ID          = 0
RIGID_BODY     = display
PHYSICAL_SENSOR       = true
PHYSICAL_SENSOR_TESTS = [3, 2, 1]
SELECTED_RESOLUTION   = 0.000299
SELECTED_RANGE        = [-156.906403,156.906403]
LOW_LATENCY_RATES     = [1000.000000, 2000.000000]
PASSIVE_REQUEST       = true

输出测试应用程序生成以下输出：

控制台上的标准输出
结果文件

ssc_drva_test 驱动程序验收测试工具执行以下操作：

执行传感器驱动程序验证，并在 QSH 传感器 API 层运行。
执行一系列传感器用例，例如流式传输传感器数据以及以选定的采样频率对传感器进行批处理。
直接从命令行接受参数，无需编译时选项。

这种方式使其成为在 HLOS 上执行基本驱动级测试或验证的便捷高效工具。

ssc_drva_test [-sensor=<sensor_type>] [-duration=<time_in_seconds>] [-sample_rate=<value_in_Hz>] [-batch_period=<value_in_seconds>] [-iterations=<value>] [-num_samples=<value>] [-factory_test=<value>]

下表描述了 ssc_drva_test 测试应用程序使用的参数。 表：ssc_drva_test 的参数

标志	类型	值	单位	说明
`sensor`	`string`	`accel` `gyro` `sensor_temperature` `pressure` `mag` `humidity` `ambient_temperature` `ultra_violet` `proximity` `ambient_light` `rgb` `hall` 任何添加的自定义传感器	不适用	必选参数：仅限可用的传感器类型。
`duration`	`float`	仅限正值	秒	必选参数：传感器测试持续时间，以秒为单位。
`sample_rate`	`float`	正浮点数值 -1：最大采样率 -2：最小采样率	Hz	对于流式传感器为必选，对于变化触发型传感器为可选。
`batch_period`	`float`	正浮点数	秒	此周期与报告周期相同，表示缓冲样本并向低功耗处理器外部报告的时长。
`iterations`	`int`	仅限正值	不适用	指定测试必须重复的次数。
`num_samples`	`int`	仅限正值	不适用	表示预期采集的最少样本数。如果指定了 `num_samples` 参数且测试期间未采集到足够的样本，测试传感器会生成 FAIL。
`factory_test`	`int`	`0 (SNS_PHYSICAL_SENSOR_TEST_TYPE_SW)` `1 (SNS_PHYSICAL_SENSOR_TEST_TYPE_HW)` `2 (SNS_PHYSICAL_SENSOR_TEST_TYPE_FACTORY)` `3 (SNS_PHYSICAL_SENSOR_TEST_TYPE_COM)`	不适用	选择要运行的出厂测试类型（来自值列）。

驱动程序验收测试示例

以选定的采样频率对单个传感器进行指定时长的流式传输：

ssc_drva_test -sensor=accel -duration=5 -sample_rate=500

root@qcm6490:~# ssc_drva_test -sensor=accel -duration=5 -sample_rate=500
ssc_drva_test version 1.27k
ssc_drva_test -sensor=accel -duration=5 -sample_rate=500
received event: PASS
PASS

以选定的采样频率和报告周期对单个传感器进行指定时长的批处理：

ssc_drva_test -sensor=accel -duration=30.0 -sample_rate=100 -batch_period=2.0

root@qcm6490:~# ssc_drva_test -sensor=accel -duration=30.0 -sample_rate=100 -batch_period=2.0
ssc_drva_test version 1.27k
received event: PASS
PASS

加速度计自检（硬件自检），通过运行内置诊断例程检查加速度计传感器的健康状况和基本功能：

ssc_drva_test -sensor=accel -factory_test=1 -duration=10

root@qcm6490:~# ssc_drva_test -sensor=accel -factory_test=1 -duration=10
ssc_drva_test version 1.27k
received event: PASS
PASS

输出在控制台命令行上，此测试输出 PASS 或 FAIL，仅表示测试执行状态。 see_workhorse 传感器 workhorse 工具执行以下操作：

根据命令行参数操作特定传感器。
简化各种配置下的传感器测试和数据采集。

see_workhorse [-sensor=<sensor_type>][-sample_rate=<max | min | positive integer value>] [-batch_period=<seconds>] [-calibrated=<0 | 1>] [-wakeup=<0 | 1>]

下表描述了 see_workhorse 工具使用的参数。 表：see_workhorse 的参数

标志	类型	取值范围	单位	说明
`sensor`	`string`	`accel` `gyro` `sensor_temperature` `pressure` `mag` `humidity` `ambient_temperature` `ultra_violet` `proximity` `ambient_light` `rgb` `hall` 任何添加的自定义传感器	不适用	必选参数：仅限可用的传感器类型。
`on_change`	`int`	0 \| 1	不适用	0 表示使用 `SNS_STD_SENSOR_STREAM_TYPE_STREAMING`。 1 表示使用 `SNS_STD_SENSOR_STREAM_TYPE_ON_CHANGE`。
`sample_rate`	`float`	正浮点数值 -1：最大采样率 -2：最小采样率	Hz	对于流式传感器为必选，对于变化触发型传感器为可选。
`batch_period`	`float`	正浮点数	秒	与批处理周期或报告周期相同。
`calibrated`	`int`	0 \| 1	不适用	0：无操作（默认）。 1：如果 `sensor_type` 为 gyro 或 mag，则同时分别激活 `gyro_cal` 或 `mag_cal`。
`wakeup`	`int`	0 \| 1	不适用	0：将 `suspend_config` 唤醒设置为 `SEE_CLIENT_DELIVERY_NO_WAKEUP`。 1：将 `suspend_config` 唤醒设置为 `SEE_CLIENT_DELIVERY_WAKEUP`（默认）。
`display_events`	`int`	0 \| 1	不适用	使用事件回调，以 JSON 格式显示传感器事件。

传感器 workhorse 示例 例如，使用以下命令以最大速率流式传输加速度计数据 10 秒：

see_workhorse -sensor=accel -sample_rate=-1 -duration=10 -display_events=1

root@rb3gen2-core-kit:~# see_workhorse -sensor=accel -sample_rate=-1 -duration=10 -display_events=1
see_workhorse version 2.21
47:56.554 see_workhorse -sensor=accel -sample_rate=-1 -duration=10 -display_events=1
47:57.923 suid = [high 61ab5376b4a5c9aa, low 58442ede47acd316]
47:57.924 stream_sensor( accel)
47:58.001 sleep(10) seconds
48:08.001 awoke
48:08.001 disable_sensor( accel)
48:08.024 disable_sensor() complete rc 0
48:08.024 end iteration: 1
48:08.024 msg_id: 130, num_events: 2, first_ts: 28628090051, last_ts: 28628114513, avg_delta: 24462.000
48:09.025 PASS see_workhorse -sensor=accel -sample_rate=-1 -duration=10 -display_events=1
PASS see_workhorse -sensor=accel -sample_rate=-1 -duration=10 -display_events=1
48:09.025 begin delete psalt
48:09.038 end delete psalt

传感中枢模拟器（SHS）

SHS 使您能够在 x86 Linux 平台上为 QSH 构建算法。有关更多信息，请参阅传感中枢模拟器。

其他工具

使用以下工具进行构建环境搭建和功能诊断：

Qualcomm® Hexagon™ DSP 工具链： 用于构建环境的 Hexagon 8.4.07 工具链。
QXDM Professional™ 工具： 用于功能诊断和 aDSP 侧调试的诊断客户端。
- QSH 框架可以直接调用宏和 API 来发送调试信息，以打印字符串和日志数据包。
- QXDM 日志主要用于 aDSP 侧调试。有关更多信息，请参阅传感器故障排除。
- QXDM Professional 需要 USB 连接。应用处理器可直接连接到 USB 端口，而 aDSP 没有此类连接。有关更多信息，请参阅 Qualcomm® Package Manager 3 文档。

简介

架构

关键文档

技术

系统

发行说明

传感器功能测试工具

传感中枢模拟器（SHS）

其他工具

​传感器功能测试工具

​传感中枢模拟器（SHS）

​其他工具

传感器功能测试工具

传感中枢模拟器（SHS）

其他工具