アナログ入力値

このページでは、peripherals.analogInputs 内の1つの AnalogInputState 項目について説明します。

この配列は、アナログ入力チャネルを持つデバイスのみが返します。

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"
  }
]