- Home
- Beaver IoT
- 5.3 MQTTデバイス統合
5.3 MQTTデバイス統合
Beaver IoTは、MQTTブローカーとして動作し、Milesightデバイスやサードパーティ製デバイスと接続して、デバイス情報とデータを取得することをサポートしております。
互換性
- あらゆるMQTTデバイス：レポート内容はJSON形式であり、アップリンクトピックの設定をサポートしております。
デバイステンプレート管理
Beaver IoTは、デバイステンプレートを使用して、異なるレポート形式を持つデバイスからのデータ形式をエンティティに解析することをサポートしており、その後のデータ可視化や管理を容易にいたします。
テンプレートの追加
- Beaver IoTプラットフォームのIntegrationページに移動し、MQTTデバイス統合を選択します。次にDevice template managementタブに移動し、+Addをクリックして新しいテンプレートを追加します。
- 一意のテンプレート名と、デバイスが報告するアップリンクトピックを入力し、コピーアイコンをクリックしてこのトピックを保存します。
- デバイスエンティティ定義と備考を設定し、Confirmをクリックしてこのテンプレートを保存します。
パラメータ 説明 Device template name この名前は一意である必要があり、以下の文字のみを含めることができます：A-Z、a-z、0-9、「_」、「@」、「#」、「$」、「-」、「/」、「[」、「]」 Device topic このトピックを入力する際は、必ず「/」で開始してください。このトピックの前半部分は固定コンテンツであり、変更できません。全文をコピーして貼り付けてください。 Device entity definition 報告されたデータを個別のエンティティに解析する。 Remark 任意入力欄。 レポート例：
{ "device_id": "24E124710E338704", "device_name": "Device 1", "temperature": 26.8, "humidity": 15.2, "status": 1, "time": "2025-07-02 15:19:35" }対応デバイステンプレート：
definition: input: type: object properties: - key: device_id # json key type: string # data type required: true is_device_id: true entity_mapping: 'device_id' # entity identifier - key: device_name # json key type: string # data type is_device_name: true - key: temperature # json key type: double # data type entity_mapping: 'temperature' # entity identifier - key: humidity # json key type: double # data type entity_mapping: 'humidity' # entity identifier - key: status # json key type: long # data type entity_mapping: 'status' # entity identifier - key: time # json key type: string # data type entity_mapping: 'time' # entity identifier output: type: object properties: - key: device_id # json key type: string # data type entity_mapping: 'device_id' # entity identifier - key: temperature # json key type: double # data type entity_mapping: 'temperature' # entity identifier - key: humidity # json key type: double # data type entity_mapping: 'humidity' # entity identifier - key: status # json key type: long # data type entity_mapping: 'status' # entity identifier - key: time # json key type: string # data type entity_mapping: 'time' # entity identifier initial_entities: - identifier: 'device_id' # entity identifier name: 'device_id' # entity name value_type: string # entity value type type: property # entity type access_mod: R - identifier: 'temperature' # entity identifier name: 'temperature' # entity name value_type: double # entity value type type: property # entity type access_mod: R attributes: unit: '℃' - identifier: 'humidity' # entity identifier name: 'humidity' # entity name value_type: double # entity value type type: property # entity type access_mod: R attributes: unit: '%' - identifier: 'status' # entity identifier name: 'status' # entity name value_type: long # entity value type type: property # entity type access_mod: R attributes: enum: 0: 'Offline' 1: 'Online' - identifier: 'time' # entity identifier name: 'time' # entity name value_type: string # entity value type type: property # entity type access_mod: Rテンプレートパラメータ：
パラメータ 必須 説明 definition Yes input Yes アップリンクコンテンツのJSON形式を定義してください type Yes その値はオブジェクトとして固定されています properties Yes key Yes JSONデータ項目名 type Yes JSONデータ型、オプション：オブジェクト、long、double、boolean、文字列 required No 報告の可否は必須項目です。オプション: true, false entity_mapping No エンティティにマッピングされた識別子値 is_device_id No このキー値がデバイスIDであるかどうか、オプション：true、false is_device_name No このキー値がデバイス名であるかどうかオプション: true, false properties No キーの型がオブジェクトの場合、次のレベルのパラメータを定義する output No ダウンリンクコンテンツのJSON形式を定義する type Yes 値はオブジェクトとして固定される properties Yes key Yes JSONデータ項目名 type Yes JSONデータ型，オプション：オブジェクト、long、double、boolean、文字列 entity_mapping No エンティティにマッピングされた識別子値 value No このキーの固定値 properties No キーの型がオブジェクトの場合、次のレベルのパラメータを定義する initial_entities Yes デバイスエンティティのフォーマットを定義する identifier Yes エンティティ固有識別子 name Yes エンティティ名 value_type Yes エンティティデータ型，オプション：オブジェクト、long、double、ブール値、文字列 type Yes エンティティタイプ，オプション：プロパティ、サービス、イベント access_mod Yes アクセス種別，オプション：読み取り（R），書き込み（W），読み書き（RW） attributes No エンティティ属性 unit No ユニット fraction_digits No 小数点以下の桁数、double型のみ使用 max No 最大値、long型またはdouble型のみ使用 min No 最小値、long型またはdouble型のみ使用 max_length No 最大長、文字列型のみ使用 min_length No 最小長、文字列型のみ使用 enum No 列挙値、その値はリストであり、形式は key: valueformat No 値が HEX の場合、内容は 16 進文字です。値が IMAGE: BASE64 または IMAGE: URL の場合、内容は画像です。 default_value No デフォルト値 optional No オプション: true, false children No 児童エンティティリスト
テストテンプレート
- ご希望のテンプレートを選択し、Test Dataアイコンをクリックしてください。
- 左側にJSON形式のレポートデータ例を入力するか、Generate simulated dataをクリックしてください。
- Simulation reportをクリックすると、テスト結果が右側に表示されます。
テンプレートの編集
ご希望のテンプレートを選択し、Editアイコンをクリックして編集を行います。
注意
テンプレート追加後のエンティティ定義内容の変更は推奨されません。Beaver IoTが正しく解析できなくなり、既存エンティティに異常が生じる可能性があります。
テンプレートの削除
注意
テンプレート削除時には、関連するデバイス及びその全データが同時に削除されます。
テンプレートの削除：対象テンプレートのDeleteアイコンをクリックして削除します。
テンプレートの一括削除：削除対象のテンプレートのチェックボックスを選択し、上部にあるDeleteボタンをクリックして削除します。
統合手順
- Beaver IoTプラットフォームのIntegrationページに移動し、MQTT Device Integrated統合を選択してMQTTブローカー情報を取得します。
- MQTTデバイスの設定ページに移動し、MQTTブローカー情報を設定します。デバイステンプレートから取得したデバイスアップリンクトピックを貼り付けます（Add Templateの手順2を参照）。
注記
設定前に、MQTTデバイスがBeaver IoTプラットフォームのMQTTブローカーアドレスにアクセスできることを必ずご確認ください。 - 設定を保存し、デバイスがBeaver IoTに接続されていることをご確認ください。接続後、Beaver IoTが自動的にデバイスと関連エンティティを作成します。これらは各関連ページで確認できます。
