传感器读数
本页说明 peripherals.sensors 中每一条传感器读数的结构。
SensorState 结构
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
index | integer | 是 | 传感器接口或通道序号,从 1 开始 |
type | string | 是 | 类型代码。当前枚举值:TEMP、HUMI |
value | number | 否 | 当前数值 |
unit | string | 是 | 测量单位,例如 C、% |
status | string | 是 | 传感器状态,枚举:ONLINE、OFFLINE |
传感器 type 枚举
| 枚举值 | 说明 |
|---|---|
TEMP | 温度 |
HUMI | 湿度 |
传感器 status 枚举
| 枚举值 | 说明 |
|---|---|
ONLINE | 传感器在线 |
OFFLINE | 传感器离线 |
说明:
- 同一个传感器接口可能在相同
index下返回多个读数。 - 客户端应使用
index + type识别一条传感器读数。 - 当传感器离线时,
value可能省略。
示例
单温度传感器:
json
[
{
"index": 1,
"type": "TEMP",
"value": 30.4,
"unit": "C",
"status": "ONLINE"
}
]温湿度传感器:
json
[
{
"index": 2,
"type": "TEMP",
"value": 32.6,
"unit": "C",
"status": "ONLINE"
},
{
"index": 2,
"type": "HUMI",
"value": 54,
"unit": "%",
"status": "ONLINE"
}
]离线传感器:
json
[
{
"index": 1,
"type": "TEMP",
"unit": "C",
"status": "OFFLINE"
}
]