Skip to content

传感器读数

本页说明 peripherals.sensors 中每一条传感器读数的结构。

SensorState 结构

字段类型必填说明
indexinteger传感器接口或通道序号,从 1 开始
typestring类型代码。当前枚举值:TEMPHUMI
valuenumber当前数值
unitstring测量单位,例如 C%
statusstring传感器状态,枚举:ONLINEOFFLINE

传感器 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"
  }
]
Docs buildVersion v1.2.19-20260602-174859-60
Copyright © 2026 WLTE