Zigbee2MQTT ? ?

ベンダーのブリッジやゲートウェイなしでZigbee デバイスを使用できるようにします。

イベントをブリッジし、MQTT 経由で Zigbee デバイスを制御できるようにします。このようにして、Zigbee デバイスを使用しているスマートホームインフラストラクチャと統合できます。

はじめる

ドキュメントには、起動して実行するために必要なすべての情報が記載されています。初めてアクセスする場合は、重要な詳細が記載されている可能性があるため、セクションをスキップしないようにしてください。

Zigbee の用語に詳しくない場合は、必ずこれを読んでください。

統合

Zigbee2MQTT は MQTT を使用するため、(ほぼ) すべてのホームオートメーションソリューションとうまく統合できます。ただし、次の統合については言及する価値があります。

ホームアシスタント

ホームアシスタントOS：公式アドオンを使用する
その他のインストール: ここの手順を使用してください

アットホームな

Homeyアプリに統合を実装
Homey フォーラムのドキュメントとサポート

ドモティチ

Domoticz に統合が実装されました (ドキュメント)。

グラディスアシスタント

統合は Gladys Assistant にネイティブに実装されています (ドキュメント)。

IoBroker

IoBroker に統合が実装されました (ドキュメント)。

建築

内部アーキテクチャ

Zigbee2MQTT は 3 つのモジュールで構成されており、それぞれが独自の Github プロジェクトで開発されました。ハードウェア (アダプター) から始まり、上に進みます。 zigbee-herdsman は Zigbee アダプターに接続し、スタックの上位レベルで API を使用できるようにします。たとえば、Texas Instruments ハードウェアの場合、zigbee-herdsman は TI zStack モニタリングおよびテスト API を使用してアダプターと通信します。 Zigbee-herdsman は、コアとなる Zigbee 通信を処理します。モジュール zigbee-herdsman-converters は、個々のデバイスモデルからサポートされる Zigbee クラスターへのマッピングを処理します。 Zigbee クラスターは、基本プロトコルの上にある Zigbee プロトコルのレイヤーであり、ライト、センサー、スイッチが Zigbee ネットワーク上で相互に通信する方法などを定義します。最後に、Zigbee2MQTT モジュールは zigbee-herdsman を駆動し、zigbee メッセージを MQTT メッセージにマップします。 Zigbee2MQTT はシステムの状態も追跡します。この状態は、 database.dbファイルを使用して保存されます。接続されたデバイスとその機能の JSON データベースを含むテキストファイル。 Zigbee2MQTT は、監視と構成を可能にする Web ベースのインターフェイスを提供します。

現像

Zigbee2MQTT は TypeScript を使用します (現時点では部分的に)。したがって、 lib/ディレクトリ内のファイルに変更を加えた後、Zigbee2MQTT を再コンパイルする必要があります。これは、 npm run build実行することで実行できます。開発を高速化するには、 npm run build実行する代わりに、別のターミナルセッションでnpm run build-watch実行できます。これにより、ファイルを変更すると再コンパイルされます。ビルドする前に初めて、 npm install --include=dev実行する必要があります。変更を送信する前に、 npm run test-with-coverage 、 npm run pretty:check 、およびnpm run eslint実行します。