センサー・ライブラリ

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

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

環境情報センサー

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

温度センサー

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

インベントリ表現

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

"c8y_TemperatureSensor" : {}

メジャーメント

メジャーメント 単位 説明
T C 温度メジャーメント
"c8y_TemperatureMeasurement": {
    "T": { "value": 23, "unit": "C" }
}

モーションセンサー

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

インベントリ表現

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

"c8y_MotionSensor" : {}

Measurement

メジャーメント 単位 説明
motionDetected none 運動が検出された(非ゼロ値)か否か(ゼロ値)を示すboolean値。
speed km/h センサーに接近する速度(+ve)またはセンサーから遠ざかる速度(-ve)の測定値。
"c8y_MotionMeasurement": {
    "motionDetected": { "value": 1.0, "unit": "", "type": "BOOLEAN" },
    "speed": { "value": -63.2, "unit": "km/h" }
  }

加速度センサー

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

インベントリ表現

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

"c8y_AccelerationSensor" : {}

メジャーメント

メジャーメント 単位 説明
acceleration m/s2 センサー軸に沿って測定された加速度(このメジャーメントではセンサー軸の方向を定義しません)。
"c8y_AccelerationMeasurement": {
    "acceleration": { "value": 8.36, "unit": "m/s2" }
}

光センサー

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

インベントリ表現

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

"c8y_LightSensor" : {}

メジャーメント

光は主に2つ選択的な一連の単位で測定され、放射分析はすべての波長での光のメジャーメントで構成される一方、分光法では、人間の輝度認知特性を示す標準モデルを元とした重みによって波長を計測します。分光法は、例えば人間が感じる光量を測定する際に役立ちます。

メジャーメント 単位 説明
e lux 測光メジャーメント
"c8y_LightMeasurement": {
    "e": { "value": 8.36, "unit": "lux" }
}

湿度センサー

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

インベントリ表現

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

"c8y_HumiditySensor" : {}

メジャーメント

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

メジャーメント 単位 説明
h %RH 相対湿度メジャーメント
"c8y_HumidityMeasurement" : {
    "h" : { "value" : 13.37, "unit": "%RH"}
}

水分センサー

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

インベントリ表現

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

"c8y_MoistureSensor" : {}

メジャーメント

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

メジャーメント 単位 説明
水分量 % 相対水分量メジャーメント
"c8y_MoistureMeasurement" : {
    "moisture" : { "value" : 13.37, "unit" : "%" }
}

距離センサー

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

インベントリ表現

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

"c8y_DistanceSensor" : {}

Measurement

メジャーメント 単位 説明
distance mm 距離メジャーメント
"c8y_DistanceMeasurement" : {
    "distance" : { "value" : 13.37, "unit" : "mm" }
}

エネルギー

電力センサー

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

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

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

"c8y_SinglePhaseElectricitySensor" : {}

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

メジャーメント 単位 説明
A+ kWh 総有効エネルギー(in)
A- kWh 総有効エネルギー(out)
P+ W 総有効電力(in)
P- W 総有効電力(out)
"c8y_SinglePhaseElectricityMeasurement": {
  "A+": { "value": 123, "unit": "kWh" },
  "A-": { "value": 2, "unit": "kWh" },
  "P+": { "value": 56, "unit": "W" },
  "P-": { "value": 0, "unit": "W" }
}

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

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

"c8y_ThreePhaseElectricitySensor" : {}

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

メジャーメント 単位 説明
A+ kWh 総有効エネルギー(相全体の合計)
A+:1(2, 3) kWh 有効エネルギー(相1、2または3)
A- kWh 総有効エネルギー(out)(総全体の合計)
A-:1(2, 3) kWh 有効エネルギー(out)(相1、2または3)
P+ W 総有効電力(in)(総全体の合計)
P+:1(2, 3) W 有効電力(in)(相1、2または3)
P-:1(2, 3) W 有効電力(out)(相1、2または3)
Ri+ kVArh 総無効誘導性エネルギー(in)
Ri- kVArh 総無効誘導性エネルギー(out)
Rc+ kVArh 総無効容量性エネルギー(in)
Rc- kVArh 総無効容量性エネルギー(out)
Qi+ kVAr 総無効誘導性電力(in)
Qi- kVAr 総無効誘導性電力(out)
Qc+ kVAr 総無効容量性電力(in)
Qc- kVAr 総無効容量性電力(out)
"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" : {}

メジャーメント

メジャーメント 単位 説明
電流 A 電流メジャーメント
"c8y_CurrentMeasurement" : {
    "current" : { "value" : 13.37, "unit" : "A" }
}

電圧センサー

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

メジャーメント

メジャーメント 単位 説明
電圧 V 電圧メジャーメント
"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"
}

オペレーション

オペレーション 状態 説明
state OPEN, CLOSED OPENはリレーを開位置にするよう命令し、CLOSEDはリレーを閉位置にするよう命令します。

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

"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": "..."
}

メジャーメント

メジャーメント 単位 説明
rssi dBm RSSIメジャーメント
"c8y_SignalStrength": {
  "rssi": {
    "unit": "dBm",
    "value": -63
  }
}