センサー・ライブラリ

概要

センサー・ライブラリは、既定のセンサー特性／制御特性に関する標準セットを定義します。センサー特性は、デバイスにおいて測定される何らかの数値量の特性を表し、また制御特性は、デバイスにおいて修正、変更またはその他、リモート制御可能な特性を表します。

Things Cloud アプリケーションでは好きな要素を好きなドメインに自由に割り当てることができる拡張性の高いアーキテクチャを採用していますが、このライブラリでは、それぞれの特性を関連するドメイン（マネージドオブジェクト、イベントなど）の要素として所属するよう定義しています。各特性の名称は「フラグメント」の命名慣例を踏襲します。これらの特性それぞれについて、フラグメント名に相当するJava表現がJavaパッケージでも見つかります。

環境情報センサー

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

c8y_TemperatureSensor

温度センサーは温度を摂氏（℃）単位で報告します。 マネージドオブジェクトにおいて、温度センサーはシンプルな空のフラグメントとしてモデル化されます。

"c8y_TemperatureSensor" : {}

c8y_TemperatureMeasurement

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

c8y_MotionSensor

モーションセンサーは動きを検出します。単純なモーションセンサーは、事前定義されたしきい値に基づいて、モーションがあるかどうかを検出するだけです。より複雑なモーションセンサー(警察の速度レーダーなど)は、モーションの実際の速度を測定できます。モデルでは、センサーに向かう速度またはセンサーから離れる速度のみが測定されることが想定されています。このセンサータイプの単位はキロメートル/時(km/h)です。 マネージドオブジェクトにおいて、モーションセンサーはシンプルな空のフラグメントとしてモデル化されます。

"c8y_MotionSensor" : {}

c8y_SpeedMeasurement

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

c8y_AccelerationSensor

加速度センサーまたは加速度計は、ある軸方向の加速度を測定するデバイスです。このセンサーモデルは軸方向は定義しません。このセンサータイプの単位はメートル毎秒毎秒です（m/s²）。 マネージドオブジェクトにおいて、加速度センサーはシンプルな空のフラグメントとしてモデル化されます。

"c8y_AccelerationSensor" : {}

c8y_AccelerationMeasurement

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

c8y_LightSensor

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

"c8y_LightSensor" : {}

c8y_LightMeasurement

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

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

c8y_HumiditySensor

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

"c8y_HumiditySensor" : {}

c8y_HumidityMeasurement

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

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

c8y_MoistureSensor

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

"c8y_MoistureSensor" : {}

c8y_MoistureMeasurement

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

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

c8y_DistanceSensor

距離センサーは、センサー自体から特定の方向における最も近い物体までの距離を測定します。 マネージドオブジェクトにおいて、距離センサーはシンプルな空のフラグメントとしてモデル化されます。

"c8y_DistanceSensor" : {}

c8y_DistanceMeasurement

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

エネルギー

電力センサー

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

c8y_SinglePhaseElectricitySensor

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

"c8y_SinglePhaseElectricitySensor" : {}

c8y_SinglePhaseEnergyMeasurement

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

c8y_ThreePhaseElectricitySensor

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

"c8y_ThreePhaseElectricitySensor" : {}

c8y_ThreePhaseEnergyMeasurement

"c8y_ThreePhaseEnergyMeasurement": {
  "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_CurrentSensor" : {}

c8y_CurrentMeasurement

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

c8y_VoltageMeasurement

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

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

位置確認特性

c8y_Position

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 は追跡エージェントによって使用され、配置追跡レポートのコンテキスト、すなわちレポートが送信された理由および使用されたプロトコルを表します。

共通の特性

c8y_Relay

リレーは一種のバイナリ状態スイッチで、「OPEN」または「CLOSED」いずれかの状態となり得ます。リレーは例えばスマートエネルギーメーターを通じた家庭用電源装置の接続または接続解除など、さまざまな目的に使用できます。 マネージドオブジェクトにおいて、リレー制御モデルには制御状態が含まれます。制御状態が変化すると、インベントリモデルは新たな状態へ更新しなければなりません。

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

オペレーション

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

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

c8y_RelayArray

c8y_RelayArrayオペレーションは、複数のリレーを制御する機能を提供します。 マネージドオブジェクトでは、リレーの配列の制御モデルに各リレーの状態が含まれます。状態が変化したら、インベントリ モデルを新しい状態に置き換える必要があります。

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

オペレーション

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

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