Skip to content

外设状态说明

查询设备详情查询设备列表 以及 WebSocket 设备状态消息中,peripherals 用于返回设备当前外设状态。

peripherals 是一个外设状态容器。它把继电器输出、数字输入、传感器读数、模拟量读数等设备外设数据放在同一个对象下,便于客户端按能力渲染设备状态。

peripherals 字段

字段类型必填说明
relaysarray<RelayState>继电器输出列表。参见 继电器输出
digitalInputsarray<DigitalInputState>数字输入列表。参见 数字输入
sensorsarray<SensorState>传感器读数列表。参见 传感器读数
analogInputsarray<AnalogInputState>模拟量读数列表。参见 模拟量读数

读取规则

  • 当设备不支持某项能力时,对应字段可能省略。
  • 除非端点另有说明,否则 peripherals 应按设备外设状态数据整体处理。
  • 同一个传感器接口可能在相同 index 下返回多个读数。
  • 客户端应使用 index + type 识别一条传感器读数。
  • 继电器、数字输入、模拟量输入统一使用 index 作为主键。
Docs buildVersion v1.2.19-20260602-174859-60
Copyright © 2026 WLTE