Zigbee2MQTT 🌉 🐝

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

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

はじめ

ドキュメントには、起動して実行するために必要なすべての情報が記載されています。これがあなたの最初の訪問であるならば、あなたのためにそこに重要な詳細があるかもしれないので、あなたがセクションをスキップしないようにしてください。

Zigbeeの用語に慣れていない場合は、これを読んでください。

統合

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

ホームアシスタント

• ホームアシスタント:公式アドオンの使用
• 汎用インストール:ここでの手順を使用する

ドモティス

• domoticz-zigbee2mqtt-plugin に実装された統合

建築

内部アーキテクチャ

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

database.db

現像

Zigbee2MQTTはTypeScriptを使用しています(今のところ部分的に)。したがって、ディレクトリ内のファイルに変更を加えた後、Zigbee2MQTTを再コンパイルする必要があります。これは、実行することで実行できます。実行する代わりに開発を高速化するために別のターミナルセッションで実行でき、ファイルを変更すると再コンパイルされます。

lib/

npm run build

npm run build

npm run build-watch

サポートされているデバイス

お使いのデバイスがサポートされているかどうかを確認するには、「サポートされているデバイス」を参照してください。Xiaomi、Ikea、Philips、OSRAMなどのベンダーのデバイスを含む、非常に広範なリストがあります。

[サポートされているデバイス] に記載されていない場合は、サポートを (公平に) 簡単に追加できます。

サポート&ヘルプ

サポートが必要な場合は、未解決の問題を確認できます。問題を修正したり、新しいデバイスを追加したり、ソーシャルメディアで愛を共有したりできたときは、プルリクエストを手伝ってください。