1# HdiSensor (V1_0) 2 3 4## 概述 5 6传感器设备驱动对传感器服务提供通用的接口能力。 7 8模块提供传感器服务对传感器驱动访问统一接口，服务获取驱动对象或者代理后，通过其提供的各类方法，实现获取传感器设备信息、订阅/取消订阅传感器数据、 使能/去使能传感器、设置传感器模式、设置传感器精度、量程等可选配置等。 9 10**起始版本：** 2.2 11 12 13## 汇总 14 15 16### 文件 17 18| 名称 | 描述 | 19| -------- | -------- | 20| [ISensorCallback.idl](_i_sensor_callback_8idl_v10.md) | Sensor模块为Sensor服务提供数据上报的回调函数。 | 21| [ISensorInterface.idl](_i_sensor_interface_8idl_v10.md) | Sensor模块对外通用的接口声明文件，提供获取传感器设备信息、订阅/取消订阅传感器数据、 使能/去使能传感器、设置传感器模式、设置传感器精度，量程等可选配置接口定义。 | 22| [SensorTypes.idl](_sensor_types_8idl_v10.md) | 定义传感器模块所使用的传感器类型，传感器信息，传感器数据结构等数据类型。 | 23 24 25### 类 26 27| 名称 | 描述 | 28| -------- | -------- | 29| interface [ISensorCallback](interface_i_sensor_callback_v10.md) | 定义用于上报传感器数据的回调函数。 | 30| interface [ISensorInterface](interface_i_sensor_interface_v10.md) | 提供Sensor设备基本控制操作接口。 | 31| struct [HdfSensorInformation](_hdf_sensor_information_v10.md) | 定义传感器的基本信息。 | 32| struct [HdfSensorEvents](_hdf_sensor_events_v10.md) | 定义传感器上报的数据。 | 33 34 35### 枚举 36 37| 名称 | 描述 | 38| -------- | -------- | 39| [HdfSensorTypeTag](#hdfsensortypetag) {<br/>HDF_SENSOR_TYPE_NONE = 0, HDF_SENSOR_TYPE_ACCELEROMETER = 1, HDF_SENSOR_TYPE_GYROSCOPE = 2, HDF_SENSOR_TYPE_PHOTOPLETHYSMOGRAPH = 3, HDF_SENSOR_TYPE_ELECTROCARDIOGRAPH = 4, HDF_SENSOR_TYPE_AMBIENT_LIGHT = 5, HDF_SENSOR_TYPE_MAGNETIC_FIELD = 6, HDF_SENSOR_TYPE_CAPACITIVE = 7, HDF_SENSOR_TYPE_BAROMETER = 8, HDF_SENSOR_TYPE_TEMPERATURE = 9, HDF_SENSOR_TYPE_HALL = 10, HDF_SENSOR_TYPE_GESTURE = 11, HDF_SENSOR_TYPE_PROXIMITY = 12, HDF_SENSOR_TYPE_HUMIDITY = 13, HDF_SENSOR_TYPE_MEDICAL_BEGIN = 128, HDF_SENSOR_TYPE_MEDICAL_END = 160, HDF_SENSOR_TYPE_PHYSICAL_MAX = 255, HDF_SENSOR_TYPE_ORIENTATION = 256, HDF_SENSOR_TYPE_GRAVITY = 257, HDF_SENSOR_TYPE_LINEAR_ACCELERATION = 258, HDF_SENSOR_TYPE_ROTATION_VECTOR = 259, HDF_SENSOR_TYPE_AMBIENT_TEMPERATURE = 260, HDF_SENSOR_TYPE_MAGNETIC_FIELD_UNCALIBRATED = 261, HDF_SENSOR_TYPE_GAME_ROTATION_VECTOR = 262, HDF_SENSOR_TYPE_GYROSCOPE_UNCALIBRATED = 263, HDF_SENSOR_TYPE_SIGNIFICANT_MOTION = 264, HDF_SENSOR_TYPE_PEDOMETER_DETECTION = 265, HDF_SENSOR_TYPE_PEDOMETER = 266, HDF_SENSOR_TYPE_GEOMAGNETIC_ROTATION_VECTOR = 277, HDF_SENSOR_TYPE_HEART_RATE = 278, HDF_SENSOR_TYPE_DEVICE_ORIENTATION = 279, HDF_SENSOR_TYPE_WEAR_DETECTION = 280, HDF_SENSOR_TYPE_ACCELEROMETER_UNCALIBRATED = 281, HDF_SENSOR_TYPE_MAX<br/>} | 定义传感器类型标识。 | 40| [HdfSensorGroupType](#hdfsensorgrouptype) { HDF_TRADITIONAL_SENSOR_TYPE = 0, HDF_MEDICAL_SENSOR_TYPE = 1, HDF_SENSOR_GROUP_TYPE_MAX } | 枚举传感器的硬件服务组。 | 41| [HdfSensorModeType](#hdfsensormodetype) { SENSOR_MODE_DEFAULT = 0, SENSOR_MODE_REALTIME = 1, SENSOR_MODE_ON_CHANGE = 2, SENSOR_MODE_ONE_SHOT = 3, SENSOR_MODE_FIFO_MODE = 4, SENSOR_MODE_MAX } | 传感器的工作模式。 | 42 43 44## 枚举类型说明 45 46 47### HdfSensorGroupType 48 49``` 50enum HdfSensorGroupType 51``` 52 53**描述** 54 55 56枚举传感器的硬件服务组。 57 58**起始版本：** 2.2 59 60| 枚举值 | 描述 | 61| -------- | -------- | 62| HDF_TRADITIONAL_SENSOR_TYPE | 传统传感器类型，传感器ID枚举值范围不在128-160之间。 | 63| HDF_MEDICAL_SENSOR_TYPE | 医疗传感器类型，传感器ID枚举值范围在128-160之间。 | 64| HDF_SENSOR_GROUP_TYPE_MAX | 最大传感器类型。 | 65 66 67### HdfSensorModeType 68 69``` 70enum HdfSensorModeType 71``` 72 73**描述** 74 75 76传感器的工作模式。 77 78**起始版本：** 2.2 79 80| 枚举值 | 描述 | 81| -------- | -------- | 82| SENSOR_MODE_DEFAULT | 传感器数据默认上报模式。 | 83| SENSOR_MODE_REALTIME | 传感器数据持续上报模式。 | 84| SENSOR_MODE_ON_CHANGE | 传感器数据变更时上报模式。 | 85| SENSOR_MODE_ONE_SHOT | 传感器一次数据上报模式。 | 86| SENSOR_MODE_FIFO_MODE | 传感器数据缓存模式。 | 87| SENSOR_MODE_MAX | 传感器最大类型标识。 | 88 89 90### HdfSensorTypeTag 91 92``` 93enum HdfSensorTypeTag 94``` 95 96**描述** 97 98 99定义传感器类型标识。 100 101**起始版本：** 2.2 102 103| 枚举值 | 描述 | 104| -------- | -------- | 105| HDF_SENSOR_TYPE_NONE | 空传感器类型，用于测试。 | 106| HDF_SENSOR_TYPE_ACCELEROMETER | 加速度传感器。 | 107| HDF_SENSOR_TYPE_GYROSCOPE | 陀螺仪传感器。 | 108| HDF_SENSOR_TYPE_PHOTOPLETHYSMOGRAPH | 心率传感器。 | 109| HDF_SENSOR_TYPE_ELECTROCARDIOGRAPH | 心电传感器。 | 110| HDF_SENSOR_TYPE_AMBIENT_LIGHT | 环境光传感器。 | 111| HDF_SENSOR_TYPE_MAGNETIC_FIELD | 地磁传感器。 | 112| HDF_SENSOR_TYPE_CAPACITIVE | 电容传感器。 | 113| HDF_SENSOR_TYPE_BAROMETER | 气压计传感器。 | 114| HDF_SENSOR_TYPE_TEMPERATURE | 温度传感器。 | 115| HDF_SENSOR_TYPE_HALL | 霍尔传感器。 | 116| HDF_SENSOR_TYPE_GESTURE | 手势传感器。 | 117| HDF_SENSOR_TYPE_PROXIMITY | 接近光传感器。 | 118| HDF_SENSOR_TYPE_HUMIDITY | 湿度传感器。 | 119| HDF_SENSOR_TYPE_MEDICAL_BEGIN | 医疗传感器ID枚举值范围的开始。 | 120| HDF_SENSOR_TYPE_MEDICAL_END | 医疗传感器ID枚举值范围的结束。 | 121| HDF_SENSOR_TYPE_PHYSICAL_MAX | 物理传感器最大类型。 | 122| HDF_SENSOR_TYPE_ORIENTATION | 方向传感器。 | 123| HDF_SENSOR_TYPE_GRAVITY | 重力传感器。 | 124| HDF_SENSOR_TYPE_LINEAR_ACCELERATION | 线性加速度传感器。 | 125| HDF_SENSOR_TYPE_ROTATION_VECTOR | 旋转矢量传感器。 | 126| HDF_SENSOR_TYPE_AMBIENT_TEMPERATURE | 环境温度传感器。 | 127| HDF_SENSOR_TYPE_MAGNETIC_FIELD_UNCALIBRATED | 未校准磁场传感器。 | 128| HDF_SENSOR_TYPE_GAME_ROTATION_VECTOR | 游戏旋转矢量传感器。 | 129| HDF_SENSOR_TYPE_GYROSCOPE_UNCALIBRATED | 未校准陀螺仪传感器。 | 130| HDF_SENSOR_TYPE_SIGNIFICANT_MOTION | 大幅度动作传感器。 | 131| HDF_SENSOR_TYPE_PEDOMETER_DETECTION | 计步器检测传感器。 | 132| HDF_SENSOR_TYPE_PEDOMETER | 计步器传感器。 | 133| HDF_SENSOR_TYPE_GEOMAGNETIC_ROTATION_VECTOR | 地磁旋转矢量传感器。 | 134| HDF_SENSOR_TYPE_HEART_RATE | 心率传感器。 | 135| HDF_SENSOR_TYPE_DEVICE_ORIENTATION | 设备方向传感器。 | 136| HDF_SENSOR_TYPE_WEAR_DETECTION | 佩戴检测传感器。 | 137| HDF_SENSOR_TYPE_ACCELEROMETER_UNCALIBRATED | 未校准加速度传感器。 | 138| HDF_SENSOR_TYPE_MAX | 传感器类型最大个数标识。 | 139