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