Skip to content

传感器读数 ​

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

SensorState 结构 ​

字段类型必填说明
indexinteger是传感器接口或通道序号,从 1 开始
typestring是类型代码。当前枚举值:TEMP、HUMI
valuenumber否当前数值
unitstring是测量单位,例如 °C、°F、%
statusstring是传感器状态,枚举: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"
  }
]
Docs buildVersion v1.6.3-20261020-171545-90
Copyright © 2026 WLTE