传感器测试工具 - Qualcomm Dragonwing Documentation

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

传感器功能测试工具

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

传感器信息测试提供有关传感器的详细信息。
驱动接受测试确保传感器驱动正常工作并与 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`。	N.A.	查询指定传感器类型的属性信息。
Log	`int`	0 \| 1	N.A.	启用或禁用诊断 (API) 日志。
help(h)	`int`	N.A.	N.A.	显示命令用法帮助。
Duration	`int`	正值	秒	指定传感器属性更新的等待时间。
Delay	`int`	正值	秒	指定发送传感器请求前的时间延迟。
default_only	`int`	0 \| 1	N.A.	如果 `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`	N.A.	强制参数：限于可用的传感器类型。
`duration`	`float`	仅正值	秒	强制参数：传感器测试持续时间（秒）。
`sample_rate`	`float`	`正浮点数值` `-1`：最大采样率 `-2`：最小采样率	Hz	对于流式传感器强制，对于按变化的传感器可选。
`batch_period`	`float`	正浮点数	秒	此周期与报告周期相同，表示在低功耗处理器之外缓冲和报告样本的时长。
`iterations`	`int`	仅正值	N.A.	提供测试必须重复的次数。
`num_samples`	`int`	仅正值	N.A.	表示要收集的最少样本数。如果指定了 `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)`	N.A.	选择您要运行的工厂测试类型（从值列中）。

驱动接受测试示例

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

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，仅表示测试执行状态。 使用传感器 workhorse 测试对传感器进行压力测试 see_workhorse 传感器 workhorse 工具执行以下操作：

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

see_workhorse -sensor=<sensor_type> -sample_rate=<min | max | float> -duration=<float> [-batch_period=<float>] [-calibrated=<0 | 1>] [-wakeup=<0 | 1>] [-display_events=<0 | 1>]

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

标志	类型	值范围	单位	备注
`sensor`	`string`	`accel` `gyro` `sensor_temperature` `pressure` `mag` `humidity` `ambient_temperature` `ultra_violet` `proximity` `ambient_light` `rgb` `hall`	N.A.	强制参数：限于可用的传感器类型。
`on_change`	`int`	0 \| 1	N.A.	0 选择使用 `SNS_STD_SENSOR_STREAM_TYPE_STREAMING`。 1 选择使用 `SNS_STD_SENSOR_STREAM_TYPE_ON_CHANGE`。
`sample_rate`	`float`	`正浮点数值` `min`：最小采样率 `max`：最大采样率	Hz	对于流式传感器强制，对于按变化的传感器可选。
`duration`	`float`	正浮点数	秒	强制参数：传感器测试持续时间。
`batch_period`	`float`	正浮点数	秒	与批处理周期或报告周期相同。
`calibrated`	`int`	0 \| 1	N.A.	0：无操作（默认）。 1：如果 `sensor_type` 为 gyro 或 mag，则也会分别激活 `gyro_cal` 或 `mag_cal`。
`wakeup`	`int`	0 \| 1	N.A.	0：将 `suspend_config` 唤醒设置为 `SEE_CLIENT_DELIVERY_NO_WAKEUP`。 1：将 `suspend_config` 唤醒设置为 `SEE_CLIENT_DELIVERY_WAKEUP`（默认）。
`display_events`	`int`	0 \| 1	N.A.	使用事件回调以 JSON 格式显示传感器事件。

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

see_workhorse -sensor=accel -sample_rate=max -duration=30 -display_events=1

root@qcm6490:~# see_workhorse -sensor=accel -sample_rate=max -duration=30 -display_events=1
see_workhorse version 2.04
20:22:15.406 see_workhorse -sensor=accel -sample_rate=max -duration=30 -display_events=1
begin usta_get_sensor_list

20:22:15.731 stream_sensor( accel)
20:22:15.731 + sample_rate: 500.000000 hz
20:22:15.838 config_stream_sensor() complete rc 0
20:22:15.838 sleep(30) seconds


"sns_client_event_msg" : {
 "suid" : {
  "suid_low" : "0x58442ede47acd316",
  "suid_high" : "0x61ab5376b4a5c9aa"
 },
 "events" : [
  {
   "msg_id" : 768,
   "timestamp" : 78497742089,
   "payload" : {
    "sample_rate" : 500.000000,
    "water_mark" : 1,

传感中心仿真器 (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)

其他工具