センサー・ライブラリ

環境情報センサー

環境情報センサーの例として、温度、湿度、風速などのセンサーがあります。

温度センサー

温度センサーは温度を摂氏（℃）単位で報告します。

インベントリ表現

マネージドオブジェクトにおいて、温度センサーはシンプルな空のフラグメントとしてモデル化されます。

"c8y_TemperatureSensor" : {}

メジャーメント

"c8y_TemperatureMeasurement": {
    "T": { "value": 23, "unit": "C" }
}

モーションセンサー

モーションセンサーは運動を検出します。単純なモーションセンサーとして、移動したかどうかを何らかの閾値に基づいて検出するだけの場合もある一方、より複雑なモーションセンサー（警察の速度レーダーなど）として、運動の実際の速度を測定可能な場合もあります。モデルでは、センサーに接近する速度またはセンサーから遠ざかる速度のみ測定されると想定します。このセンサータイプの単位はキロメートル毎時（km/h）です。

インベントリ表現

マネージドオブジェクトにおいて、モーションセンサーはシンプルな空のフラグメントとしてモデル化されます。

"c8y_MotionSensor" : {}

メジャーメント

"c8y_MotionMeasurement": {
    "motionDetected": { "value": 1.0, "unit": "", "type": "BOOLEAN" },
    "speed": { "value": -63.2, "unit": "km/h" }
  }

加速度センサー

加速度センサーまたは加速度計は、ある軸方向の加速度を測定するデバイスです。このセンサーモデルは軸方向は定義しません。このセンサータイプの単位はメートル毎秒毎秒です（m/s2）。

インベントリ表現

マネージドオブジェクトにおいて、加速度センサーはシンプルな空のフラグメントとしてモデル化されます。

"c8y_AccelerationSensor" : {}

メジャーメント

"c8y_AccelerationMeasurement": {
    "acceleration": { "value": 8.36, "unit": "m/s2" }
}

光センサー

光センサーは光の強度を測定します。

インベントリ表現

マネージドオブジェクトにおいて、光センサーはシンプルな空のフラグメントとしてモデル化されます。

"c8y_LightSensor" : {}

メジャーメント

光は、2つの主要な単位で測定されます。放射分析は、すべての波長での光力のメジャーメントで構成される一方、測光法は、人間の輝度認知特性の標準モデルに対して重み付けされた波長で光を測定します。 測光法は、たとえば、人間が使用する照明の光量を測定する際に役立ちます。

"c8y_LightMeasurement": {
    "e": { "value": 8.36, "unit": "lux" }
}

湿度センサー

湿度センサーは、空気中の水蒸気量を測定します。

インベントリ表現

マネージドオブジェクトにおいて、湿度センサーはシンプルな空のフラグメントとしてモデル化されます。

"c8y_HumiditySensor" : {}

メジャーメント

湿度のメジャーメントは主に絶対湿度、相対湿度および比湿度の3種類があります。絶対湿度は空気中の含水量です。相対湿度はパーセント単位で表わされ、同じ温度条件での最大湿度を基準として現在の絶対湿度を測定します。比湿度は、混合物中の総空気含有量に占める質量ベースの水蒸気含有量の比率を指します。

"c8y_HumidityMeasurement" : {
    "h" : { "value" : 13.37, "unit": "%RH"}
}

水分センサー

水分センサーは、物質の含水量を測定します。

インベントリ表現

マネージドオブジェクトにおいて、水分センサーはシンプルな空のフラグメントとしてモデル化されます。

"c8y_MoistureSensor" : {}

メジャーメント

水分のメジャーメントは主に絶対水分、相対水分および比水分の3種類があります。絶対水分は物質中の絶対含水量です。相対水分はパーセント単位で表わされ、同じ温度条件での最大水分を基準として現在の絶対水分を測定します。比水分は、混合物中の総物質含有量に占める質量ベースの水蒸気含有量の比率を指します。

"c8y_MoistureMeasurement" : {
    "moisture" : { "value" : 13.37, "unit" : "%" }
}

距離センサー

距離センサーは、センサー自体から特定の方向における最も近い物体までの距離を測定します。

インベントリ表現

マネージドオブジェクトにおいて、距離センサーはシンプルな空のフラグメントとしてモデル化されます。

"c8y_DistanceSensor" : {}

メジャーメント

"c8y_DistanceMeasurement" : {
    "distance" : { "value" : 13.37, "unit" : "mm" }
}

エネルギー

電力センサー

最も基本的レベルの電力センサー（別名電力計、ワット時計）はエネルギー消費量（通常、kWh単位）を測定しますが、複雑さ次第では「需要」、または瞬間電力（通常、W単位）、無効電力、高調波歪みなど、はるかに多くを測定することも可能です。メーターは単相（概して家庭用）または三相の測定が可能です。

インベントリ表現 - 単相電力計

マネージドオブジェクトにおいて、単相電力計はシンプルな空のフラグメントとしてモデル化されます。

"c8y_SinglePhaseElectricitySensor" : {}

メジャーメント - 単相電力計

"c8y_SinglePhaseElectricityMeasurement": {
  "A+": { "value": 123, "unit": "kWh" },
  "A-": { "value": 2, "unit": "kWh" },
  "P+": { "value": 56, "unit": "W" },
  "P-": { "value": 0, "unit": "W" }
}

インベントリ表現 - 三相電力計

マネージドオブジェクトにおいて、三相電力計はシンプルな空のフラグメントとしてモデル化されます。

"c8y_ThreePhaseElectricitySensor" : {}

メジャーメント - 三相電力計

"c8y_ThreePhaseElectricityMeasurement": {
  "A+": { "value": 435, "unit": "kWh" },
  "A-": { "value": 23, "unit": "kWh" },
  "P+": { "value": 657, "unit": "W" },
  "P-": { "value": 0, "unit": "W" },
  "A+:1": { "value": 123, "unit": "kWh" },
  "A-:1": { "value": 2, "unit": "kWh" },
  "P+:1": { "value": 56, "unit": "W" },
  "P-:1": { "value": 0, "unit": "W" },
  "A+:2": { "value": 231, "unit": "kWh" },
  "A-:2": { "value": 23, "unit": "kWh" },
  "P+:2": { "value": 516, "unit": "W" },
  "P-:2": { "value": 2, "unit": "W" },  
  "A+:3": { "value": 1423, "unit": "kWh" },
  "A-:3": { "value": 422, "unit": "kWh" },
  "P+:3": { "value": 16, "unit": "W" },
  "P-:3": { "value": 9, "unit": "W" },
  "Ri+": { "value": 231, "unit": "kVArh" },
  "Ri-": { "value": 23, "unit": "kVArh" },
  "Rc+": { "value": 342, "unit": "kVArh" },
  "Rc-": { "value": 43, "unit": "kVArh" },
  "Qi+": { "value": 234, "unit": "kVAr" },
  "Qi-": { "value": 645, "unit": "kVAr" },
  "Qc+": { "value": 76, "unit": "kVAr" },
  "Qc-": { "value": 34, "unit": "kVAr" }
}

電流センサー

電流センサーは、センサーを通過する電流を測定します。

インベントリ表現

マネージドオブジェクトにおいて、電流センサーはシンプルな空のフラグメントとしてモデル化されます。

"c8y_CurrentSensor" : {}

メジャーメント

"c8y_CurrentMeasurement" : {
    "current" : { "value" : 13.37, "unit" : "A" }
}

電圧センサー

電圧センサーは、電気回路内の2点間の電圧差を測定します。

メジャーメント

"c8y_VoltageMeasurement" : {
    "voltage" : { "value" : 13.37, "unit" : "V" }
}

位置確認特性

配置

「c8y_Position」は、アセットの地理的位置を緯度、経度および高度で報告します。高度はメートル単位で示されます。アセットまたはデバイスの現在地を報告するため、「c8y_Position」が、アセットまたはデバイスを表すマネージドオブジェクトに追加されます。アセットまたはデバイスの配置を追跡するため、「c8y_Position」が、タイプ「c8y_LocationUpdate」のイベントの要素として送信されます。

"c8y_Position": {
  "alt": 67,
  "lng": 6.15173,
  "lat": 51.211977,
  "trackingProtocol" : "TELIC",
  "reportReason" : "Time Event"
}

プロパティ「trackingProtocol」および「reportReason」は追跡エージェントによって使用され、配置追跡レポートのコンテキスト、すなわちレポートが送信された理由および使用されたプロトコルを表します。

共通の特性

リレー制御

リレーは一種のバイナリ状態スイッチで、「OPEN」または「CLOSED」いずれかの状態となり得ます。リレーは例えばスマートエネルギーメーターを通じた家庭用電源装置の接続または接続解除など、多数の目的に使用できます。

インベントリ表現

マネージドオブジェクトにおいて、リレー制御モデルには制御状態が含まれます。制御状態が変化すると、インベントリモデルは新たな状態へ更新されなければなりません。

"c8y_Relay" :
{
  "relayState" : "OPEN"
}

オペレーション

オペレーション表現はインベントリ表現と同じです。

"c8y_Relay" :
{
  "relayState" : "OPEN"
}

リレーの配列に対する制御

c8y_RelayArrayオペレーションは、複数のリレーを制御する機能性を提供します。

インベントリ表現

マネージドオブジェクトにおいて、リレー配列制御モデルには各リレーの状態が含まれます。状態が変化すると、インベントリモデルは新たな状態へ代替されなければなりません。

"c8y_RelayArray" : [
    "OPEN",
    "CLOSED",
    "CLOSED",
    "OPEN"
]

オペレーション

オペレーション表現はインベントリ表現と同じです。

"c8y_RelayArray" : [
    "OPEN",
    "CLOSED",
    "CLOSED",
    "OPEN"
]

モバイル情報

c8y_Mobileはモバイル接続状態（例：セル情報）と、デバイスのSIMカードに関する情報（例：ICCID）を保持します。デバイス内のフラグメントの変化が常に更新されるべきです。デバイスを動かさない場合の想定条件は、これらの値が滅多に変化しないことです。より頻繁に変化するモバイル情報（例：信号強度）については、メジャーメントを使用することができます。

インベントリ表現

"c8y_Mobile" : {
  "imsi": "..."
  "imei": "..."
  "currentOperator": "..."
  "currentBand": "..."
  "connType": "..."
  "rssi": "..."
  "ecn0": "..."
  "rcsp": "..."
  "mnc": "..."
  "lac": "..."
  "cellId": "..."
  "msisdn": "..."
  "iccid": "..."
}

メジャーメント

"c8y_SignalStrength": {
  "rssi": {
    "unit": "dBm",
    "value": -63
  }
}