模拟量读数

本页说明 peripherals.analogInputs 中每一条模拟量读数的结构。

仅支持模拟量输入通道的设备会返回该数组。

AnalogInputState 结构

字段	类型	必填	说明
index	integer	是	模拟量输入通道序号，从 1 开始
type	string	是	类型代码。当前枚举值：CURRENT
value	number	否	当前电流值
unit	string	是	当前电流单位，固定为 mA
status	string	是	通道状态，枚举：ONLINE、OFFLINE
measurement	object	否	已根据设备配置转换后的测量值。没有配置或配置不完整时不返回

说明：

• 当通道离线时，value 可能省略。
• value 始终表示模拟量输入的真实电流值，单位为 mA。
• measurement 只有在设备已经配置模拟量量程、传感器量程和显示单位，并且服务端能够完成换算时才返回。

measurement 结构

字段	类型	必填	说明
value	number	是	转换后的测量值
unit	string	是	转换后的测量单位，由设备配置决定

模拟量输入 type 枚举

枚举值	说明
CURRENT	电流

通道 status 枚举

枚举值	说明
ONLINE	模拟量输入在线
OFFLINE	模拟量输入离线

示例

[
  {
    "index": 1,
    "type": "CURRENT",
    "value": 15.468,
    "unit": "mA",
    "status": "ONLINE",
    "measurement": {
      "value": 71.7,
      "unit": "C"
    }
  },
  {
    "index": 2,
    "type": "CURRENT",
    "value": 6.928,
    "unit": "mA",
    "status": "ONLINE"
  }
]

未配置换算参数或离线通道不会返回 measurement：

[
  {
    "index": 1,
    "type": "CURRENT",
    "unit": "mA",
    "status": "OFFLINE"
  }
]