プラットフォームドキュメント

/

対応デバイス

MQTT、HTTPS、WSSでJSONを送るデバイスを接続できます。また、NEQTO.aiは、いくつかのゲートウェイとセンサーのファミリーについて、事前のペイロード整形をほとんど(あるいは一切)必要とせずにデータを解析できます。このページでは、それらのファミリーと、プラットフォームの解析機能とインテグレーションが対応しているデバイスプロファイルを一覧にしています。

「対応」には2つの意味があります。
  • ネイティブで解析。EnOceanの無線テレグラムとBLEゲートウェイのスキャンについては、NEQTO.aiが元のプロトコルをデコードします。
  • 独自のJSONを送信。以下に記載されていないデバイスからも、MQTT、HTTPS、WSSでJSONの測定値を受け付けます。
推奨のエンベロープはneqtoai-stdですが、同等のペイロード形式も受け付けます。ペイロードのガイドはエンドポイントとデバイスを参照してください。
判断のための図。左側は2つのネイティブの経路で、EnOceanゲートウェイが送る元の無線テレグラムをNEQTO.aiがEEPコードでデコードし、BLEゲートウェイが流す元のビーコンのスキャンをNEQTO.aiがフレームタイプでデコードします。右側は汎用の経路で、任意のMQTT、HTTPS、WSSのデバイスが対応しているJSONを送り、推奨のエンベロープはneqtoai-stdです。3つの経路は、同じデバイスと自動でマッピングされた属性に合流します。
NEQTO.aiは、EnOceanとBLEスキャンのネイティブデコード、および汎用JSONに対応しています。汎用の経路で推奨するエンベロープはneqtoai-stdです。

NEQTO.aiのデバイス対応の仕組み

どの経路でも、属性が自動でマッピングされたデバイスが作成されます。違いは、NEQTO.aiが受信したデータをどう解析するかです。プラットフォームは4つの受信メッセージのプロファイルを認識し、一致したものを記録します。

プロファイル 内容 送信形式
STD 推奨のneqtoai-stdエンベロープのための、明示的な標準の経路です。 payload_format: "neqtoai-std"を含む標準のJSON
EnOcean EnOceanの無線テレグラムで、EEPコードによって項目名が付与された測定値にデコードされます。 EnOceanゲートウェイの元のメッセージ、またはテレグラムを内包したneqtoai-enoceanのJSONエンベロープ(どちらの場合も、プラットフォームが16進数をデコードします)
BLE 対応しているBLEゲートウェイが中継するBluetooth Low Energyのビーコンのスキャンで、フレームタイプによってデコードされます。 ゲートウェイのスキャンのペイロード(プラットフォームがアドバタイジングフレームをデコードします)
ANY neqtoai-stdでも認識対象のゲートウェイ形式でもない、通常のJSONのためのフォールバックです。プラットフォームは、オブジェクトをフィールドごとに、可能な範囲で保存します。 対応している任意のJSONオブジェクトまたはその配列。任意のエンベロープの別名は正規化され、測定値は任意のラッパーオブジェクト内から再帰的に探索・抽出されます。ペイロードを制御できる場合はneqtoai-stdを使ってください。
どの経路でも属性は自動でマッピングされます。NEQTO.aiは、デコードした測定値から温度、湿度、在室、接点、エネルギー、CO2、照度などの測定項目を検出します。デバイスを稼働させる前に属性を設定しておく必要はありません。必要なロールの権限を持つユーザーは、あとから属性の表示名や単位を編集できます。エンドポイントとデバイスの属性のセクションを参照してください。

対応しているデバイスファミリー

以下のゲートウェイとセンサーのファミリーが、現在の解析機能とインテグレーションの対応範囲です。EnOceanのデバイスでは、米国、カナダ、EU、日本の地域コードで無線周波数の種類を区別します。

ゲートウェイ

ゲートウェイは、センサーとNEQTO.aiの間の橋渡しをします。BLEゲートウェイはビーコンのスキャンを、EnOceanゲートウェイは無線テレグラムを中継します。

プロトコル ベンダー 製品 モデル 地域
BLE Cassia Networks Enterprise Bluetooth Gateway E1000 —
BLE Minew IoT Bluetooth Gateway G1 —
BLE HPE Aruba Networking 500 Series Campus Access Point(AOS 8 & AOS 10) AP-505 —
EnOcean Pressac Industrial Smart Gateway INGW_902_E 米国、カナダ
EnOcean HPE Aruba Networking 500 Series Campus Access Point(AOS 8 & AOS 10) AP-505(EG)、USB500U使用 米国、カナダ、EU
EnOcean HPE Aruba Networking 500 Series Campus Access Point(AOS 8 & AOS 10) AP-505(JP)、USB500J使用 日本
EnOcean EnOcean USB Gateway(Aruba APのオプション) USB500U / USB500J 米国 / 日本
ゲートウェイの詳細。HPE Aruba AP-505は、BLEのスキャンを直接中継できます。EnOceanのテレグラムを受信するには、EnOceanのUSBドングル(EGモデルにはUSB500U、JPモデルにはUSB500J)が必要です。NEQTO.aiは、アクセスポイントからのAOS 8とAOS 10のprotobufメッセージ形式を受け付けます。現在の解析機能は、MinewのMG5 Outdoor Mobile LTE Gatewayには対応していません。

BLEのIoTデバイス

これらのビーコン型センサーは、上記のBLEフレームの対応範囲に含まれます。測定値は、ゲートウェイがスキャンを中継した後に届きます。

ベンダー 製品 モデル 主なデータ
Minew Temperature and Humidity Sensor S1 温度、湿度
Minew Smart Emergency Button B10 ボタンの押下、ビーコンID
Minew Card Beacon C10 ビーコンID、RSSI
Minew Rechargeable Badge MWC01 ビーコンID、RSSI
Minew Paper-battery Asset Tag MTB02 ビーコンID、RSSI
Minew Pallet Beacon MBS01 ビーコンID、RSSI
Minew Door Sensor S4 接点(開/閉)
OKABE Marking Systems Temperature and Humidity Sensor Beacon BLE-TM530 温度、湿度
OKABE Marking Systems Accelerometer Beacon BLE-TM511 加速度(X/Y/Z)

現在の解析機能は、MinewのMillimeter Wave Radar Sensorのモデル、MSR01-A(人の在室検知用)とMSR01-B(人流計測用)には対応していません。

EnOceanのIoTデバイス

現在のEEPの対応範囲には、以下のEnOceanの無線センサーが含まれます。EEPの列は、NEQTO.aiがデコードするプロファイルを示します。1つのデバイスが複数のEEPを持つことがあります。

ベンダー 製品 モデル EEP 地域
Pressac CO2, Temperature & Humidity Sensor 60_CO2_SLR_TMP_HUM_902 A5-09-04 米国、カナダ
Pressac Three-Channel CT Clamp CTV3_928_3CH_060A D2-32-00、D2-32-02 日本
Pressac Door and Window Sensor MS_DOOR_WIN_BAT_902 / _928 D5-00-01 米国、カナダ / 日本
EnOcean GmbH Multisensor Module STM550U / STM550J D2-14-41(デフォルト)、ほかにD2-14-40、A5-02-05、A5-04-01、A5-04-03、A5-06-02、A5-06-03、A5-14-05、D5-00-01 米国、カナダ / 日本
EnOcean GmbH IoT Multisensor EMSIU / EMSIJ D2-14-41(デフォルト)、ほかにD2-14-40、A5-02-05、A5-04-01、A5-04-03、A5-06-02、A5-06-03、A5-14-05、D5-00-01 米国、カナダ / 日本
EnOcean GmbH Motion Detector with Illumination Sensor EMDCU A5-07-03、A5-07-01、A5-08-01、A5-08-02、A5-08-03 米国、カナダ
OPTEX Occupancy Sensor CPD-J(WH) A5-07-01 日本

PLC

産業用のコントローラーは、EthernetでMQTTと汎用のJSONの経路を使って接続します。推奨のエンベロープはneqtoai-stdです。

ベンダー 製品 モデル 備考
Mitsubishi MELSEC iQ-F Series FX5U MQTTで通信するには、FX5U-ENET Ethernetモジュールが必要です。

EnOceanのネイティブ対応

EnOceanゲートウェイが無線テレグラムを転送すると、NEQTO.aiはそれをEnOcean Equipment Profile(EEP)によってデコードし、名前付きの測定値を作成します。16進数のデータを解析する必要はありません。プラットフォームには、多くのEEPのデコーダーが含まれています。

受信のみ。EnOceanの対応は、データの受信のみです。アクチュエーターに制御コマンドを送り返すことはありません。空調のアクチュエーターのような双方向のプロファイルでも、NEQTO.aiがデコードするのは受信したデータだけです。
EnOceanのテレグラムを届ける方法は2つあります。対応しているEnOceanゲートウェイが独自のメッセージを直接送るか、任意のクライアントが元のテレグラムをneqtoai-enoceanのJSONエンベロープで包み、MQTT、HTTPS、WSSで送ります。2つ目の方法は、JSONを送るものの、ベンダー固有のプロトコルを使わないブリッジやゲートウェイで使えます。どちらの場合も、NEQTO.aiはテレグラムをEEPでデコードします。

neqtoai-enoceanのエンベロープは、元のテレグラムを16進数文字列として保持します。

{
  "payload_format": "neqtoai-enocean",
  "timestamp": 1716806400000,
  "data": "55..."
}

dataフィールドには、元のEnOceanパケット(16進数文字列)を指定します。timestampのフィールドは任意です。省略すると、プラットフォームはメッセージの受信時刻を使います。含める場合はUTCで送ってください。エンドポイントとデバイスを参照してください。

RPSのデバイスにティーチインは不要です。EnOceanのF6ファミリーのRPSテレグラムのデバイスには、ロッカースイッチ、スイッチ、シンプルな押しボタン、接点があります。NEQTO.aiは最初のテレグラムを受信した時点でそれらを登録し、ティーチインの手順なしに測定値が届き始めます。

この表は、現在の解析機能の対応範囲から、よく使われるEEPを挙げたものです。解析機能は、ここに記載していないEEPにも対応しています。

EEP 説明 / 測定する内容
A5-02-01 温度センサー、-40°C〜0°C
A5-02-02 温度センサー、-30°C〜+10°C
A5-02-03 温度センサー、-20°C〜+20°C
A5-02-04 温度センサー、-10°C〜+30°C
A5-02-05 温度センサー、0°C〜+40°C
A5-04-01 温度0°C〜+40°C、湿度0%〜100%
A5-04-03 温度-20°C〜+60°C、湿度(10ビット)0%〜100%
A5-05-01 気圧センサー、500〜1150 hPa
A5-06-02 照度センサー、0〜1,020 lx
A5-06-03 照度センサー(10ビット)、0〜1,000 lx
A5-06-05 照度センサー、0〜10,200 lx
A5-07-01 在室、電源電圧(任意)
A5-07-03 在室、電源電圧、照度センサー
A5-08-01 照度0〜510 lx、温度0°C〜+51°C、在室ボタン
A5-08-02 照度0〜1,020 lx、温度0°C〜+51°C、在室ボタン
A5-08-03 照度0〜1,530 lx、温度-30°C〜+50°C、在室ボタン
A5-09-04 CO2センサー
A5-09-09 純CO2センサー、停電検知
A5-10-03 設定値制御付きの温度センサー
A5-12-00 自動検針:カウンター
A5-12-01 自動検針:電力
A5-14-05 振動 / 傾き、電源電圧
A5-20-01 電池式の空調アクチュエーター(双方向)
A5-20-06 局所温度オフセット付きの環境発電式アクチュエーター(双方向)
A5-30-03 4つのデジタル入力、ウェイクと温度センサー
D2-05-00 ブラインド / ロールシャッターの制御:位置と角度のフィードバック
D2-06-01 多機能の窓ハンドル:ハンドルの位置、窓の傾き/接点、温度、湿度、照度、バッテリー
D2-14-40 室内の温度、湿度、XYZ加速度、照度
D2-14-41 室内の温度、湿度、XYZ加速度、照度
D2-14-52 音、気圧、照度、在室、温度
D2-14-53 漏水検知器
D2-14-58 温度、湿度、粒子状物質、騒音レベル、照度、CO2、VOC
D2-14-59 温度、湿度、PM、CO2、HCHO、TVOC
D2-14-5C 温度、湿度、粒子状物質、CO2、VOC
D2-14-5D 温度、湿度、騒音レベル、照度
D2-15-00 人の活動カウンター
D2-32-00 交流電流クランプ、タイプ0x00
D2-32-01 交流電流クランプ、タイプ0x01
D2-32-02 交流電流クランプ、タイプ0x02
D2-34-00 暖房 / 温度コントローラー:温度、設定値、動作モード、チャンネル
D2-70-00 デバイスの状態 / 診断:稼働時間とエラーコード
D2-B1-00 レベルセンサー / ディスペンサー
D5-00-01 単一入力の接点(ドア / 窓)
F6-02-01 照明とブラインドの制御、アプリケーションスタイル1
F6-02-02 照明とブラインドの制御、アプリケーションスタイル2
F6-02-04 照明とブラインドの制御、ERP2
F6-05-01 液体漏れセンサー(機械式ハーベスター)

プロファイルの参照先:EnOcean AllianceのEEPカタログ(enocean-alliance.org/products/eeps/)。

EEP D2-14-41で報告するEnOcean STM 550マルチセンサーの、デバイス編集画面の属性タブ。10行が自動で作成され、各行に属性名、表示名、単位があります。摂氏の温度、パーセントの湿度、ルクスの照度、加速度のステータス、gで表したX軸、Y軸、Z軸の加速度、接点の状態、接点のステータス、センサーの学習フラグです。
取り込み後のEnOceanのマルチセンサー。EEPの各フィールドが自動で属性になります。

BLEゲートウェイのネイティブ対応

BLEゲートウェイは、近隣のBluetooth Low Energy(BLE)ビーコンを受信し、そのアドバタイジングパケットをNEQTO.aiに中継します。プラットフォームはアドバタイジングのフレームタイプを使って、標準のビーコンとMinewのセンサーを名前付きの測定値にデコードします。この経路では、ペイロードの整形は不要です。

各スキャンにはビーコンのアドレスが含まれ、それがdevice_idになります。信号強度(RSSI)と、デコードしたフレームの内容も含まれます。EnOceanと同様に、BLEの対応は受信のみです。

ビーコンの形式 デコードするフレームタイプ
Apple iBeacon Apple iBeacon、Fake iBeacon Data
Eddystone UID、URL、TLM
Minew HT Data(湿度/温度)、TEMP Data、ACC-Axis Data、Light lux Data、Pressure Data、PIR Data、TVOC Data、Accelerometer and Gyroscope Data、Digital Pressure Data、3-axis Magnetometer Data、Vibration Data、Photoresistance Data、Tamper Proof Data、Leakage Frame、Temperature and Humidity、DFU Advertising Payload、Device Info、Firmware information(Device information)、Personnel traffic detection、Human Coordinate data、Self-learning result feedback、Label Frame Protocol、Temperature information、Door sensor block information、Configuration Advertising
ゲートウェイが中継するMinewのBLEセンサーの、デバイス編集画面の属性タブ。ビーコンのHTフレームとその周りのスキャンから4行が自動で作成されています。dBmの信号強度、パーセントのバッテリー、摂氏の温度、パーセントの湿度です。
ゲートウェイを通じて中継されたMinewのBLEセンサー。フレームのフィールドが属性に自動でマッピングされ、RSSIはスキャンごとに取得されます。

LoRaWANの対応

LoRaWANのデバイスは、汎用のJSONの経路で接続します。現在、プラットフォームにはLoRaWANのフレームのネイティブのデコーダーがないため、LoRaWANのデバイスまたはネットワークサーバーは、デコードした測定値をJSONとしてMQTT、HTTPS、WSSで転送するか、元のフレームを非JSON形式のメッセージとして、ペイロードデコーダーを設定したエンドポイントに送ります。推奨のエンベロープはneqtoai-stdです。対応しているベンダーのトピックと、柔軟なデコード済みのJSON形式も受け付けます。受け付ける形式と制限はエンドポイントとデバイス → MQTTトピックの選択肢を参照してください。

LoRaWANのデータの流れ。LoRaWANのネットワークサーバーがデバイスのフレームをデコードし、デコードしたフィールドを転送します。NEQTO.aiは、その結果を汎用のJSONのデバイスとして扱います。

IMBuildings People Counter(モデルIMB-PC-LW-V6)は、推奨のneqtoai-stdエンベロープを使う実例です。LoRaWAN Class Aを採用した、電池駆動・双方向検知対応の赤外線人数カウンターです。

このカウンターは、現在の間隔における方向ごとの整数のカウントとしてcounter_aとcounter_b、累計の整数のカウントとしてtotal_counter_aとtotal_counter_b、ボルト単位のbattery_voltage、ステータスのビットフィールドとしてdevice_statusとsensor_statusを送ります。各フィールドはそれぞれ1つの属性になり、フィールド名をもとにした名前に接尾辞が付きます。測定値に単位がある場合は単位、ない場合は状態の接尾辞です。下の図では、battery_voltageには_voltsの接尾辞が付いて届き、カウンターと2つのステータスのフィールドは単位がないため_state_number付きで届きます。

累計値はuint16の値で、ハードウェア上で65,536に達すると0に戻ります。通算のカウントを追跡するには、絶対値を直接参照するのではなく、アップリンク間の差分を算出してください。

IMBuildings IMB-PC-LW-V6 LoRaWAN人数カウンターの、デバイス編集画面の属性タブ。転送されたフィールドごとに1行、合計7行が自動で作成されています。間隔ごとの2つの方向のカウント、2つの累計、ボルトのバッテリー電圧、デバイスとセンサーのステータスのフィールドです。
neqtoai-stdとして転送すると、LoRaWANの人数カウンターのデコード済みのフィールドが、汎用の経路で属性に自動でマッピングされます。

その他のデバイスと汎用の経路

汎用のJSONの経路を使うために、デバイスが上記の表に載っている必要はありません。

MQTT、HTTPS、WSSで対応しているJSONを送るデバイスは、汎用の経路を使えます。独自のファームウェア、マイコン、エッジのスクリプト、PLC、LoRaWANのネットワークサーバー、クラウド間のブリッジなどが含まれます。推奨される基本形式はneqtoai-stdですが、プラットフォームは対応している同等の形式も正規化します。測定値は、ネイティブのデバイスファミリーと同じように属性に自動でマッピングされます。ペイロードの詳しいガイドとトラブルシューティングはエンドポイントとデバイスを参照してください。

JSONではなくバイナリやテキストを送るデバイスも、汎用の経路を使えます。デバイスのエンドポイントにペイロードデコーダーを設定してください。デコーダーは、デバイスが送るデータのサンプルからAtollaが作成します。エンドポイントとデバイス → ペイロードデコーダーを参照してください。

推奨のneqtoai-stdペイロード:

{
  "payload_format": "neqtoai-std",
  "timestamp": 1716806400000,
  "device_id": "my-device-01",
  "data": {
    "temperature": { "value": 22.4, "unit": "c" },
    "humidity":    { "value": 62.3, "unit": "%" }
  }
}
インテグレーションは、外部のクラウドサービスからデータを取り込みます。リリース2.4で追加されたインテグレーションにより、デバイスがデータを送信しなくても、NEQTO.aiがセキュアなMQTT、HTTPS、セキュアなWebSocketでデータを取得できるようになりました。カスタムインテグレーションでは、受信するフィールドを属性にどうマッピングするかを設定時にAIが提案します。標準コネクターでは、フィールドは自動でマッピングされます。この方法で作成されたデバイスのソースは「インテグレーション」です。直接送信するデバイスのソースは「エンドポイント」です。データがすでにベンダーやパートナーのクラウドにあり、それを送信し直したくない場合はインテグレーションを使ってください。設定の詳細はインテグレーションを参照してください。

取り込み後に得られるもの

どの経路でも、デコードした測定値は、グラフ、アラート、マップで使える属性になります。対応しているファミリーでは、一般に次の測定項目が得られます。

測定項目 主な出どころ 主な単位
温度 EnOcean、BLE、汎用 °C
湿度 EnOcean、BLE、汎用 %
照度 EnOcean、BLE lx
在室 / PIR EnOcean、BLE state
接点(開/閉) EnOcean、BLE state
CO2 EnOcean ppm
気圧 EnOcean、BLE hPa
エネルギー / 電流 EnOcean(CTクランプ) A
加速度 / 振動 EnOcean、BLE g
人数 LoRaWAN(汎用)、EnOceanの活動カウンター count
バッテリー / 電源電圧 EnOcean、BLE、LoRaWAN Vまたは%
信号強度(RSSI) BLE dBm
  • 「ネイティブ」とは、プラットフォーム側でデコードを行うという意味です。EnOceanのテレグラムとBLEのスキャンは元のバイト列として届き、NEQTO.aiがそれを上記の測定値に変換します。
  • ネイティブのプロトコル対応は受信のみです。EnOceanとBLEの対応は受信したデータを表示するもので、デバイスの制御や操作には対応していません。
  • その他のデバイスはJSONまたはペイロードデコーダーを使用できます。JSONでは、デバイスがこのページの表に載っているかどうかにかかわらず、推奨のneqtoai-stdエンベロープか、対応しているほかのJSON形式を使用してください。バイナリやテキストを送るデバイスには、エンドポイントのペイロードデコーダーが必要です。
  • EnOceanでは地域が重要です。無線の地域に合ったモデルを選んでください。米国とカナダは902 MHz、EUは868 MHz、日本は928 MHzです。