外设状态说明
在 查询设备详情、查询设备列表 以及 WebSocket 设备状态消息中,peripherals 用于返回设备当前外设状态。
peripherals 是一个外设状态容器。它把继电器输出、数字输入、传感器读数、模拟量读数等设备外设数据放在同一个对象下,便于客户端按能力渲染设备状态。
peripherals 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
relays | array<RelayState> | 否 | 继电器输出列表。参见 继电器输出 |
digitalInputs | array<DigitalInputState> | 否 | 数字输入列表。参见 数字输入 |
sensors | array<SensorState> | 否 | 传感器读数列表。参见 传感器读数 |
analogInputs | array<AnalogInputState> | 否 | 模拟量读数列表。参见 模拟量读数 |
读取规则
- 当设备不支持某项能力时,对应字段可能省略。
- 除非端点另有说明,否则
peripherals应按设备外设状态数据整体处理。 - 同一个传感器接口可能在相同
index下返回多个读数。 - 客户端应使用
index + type识别一条传感器读数。 - 继电器、数字输入、模拟量输入统一使用
index作为主键。
