homebridge hue
v0.14.7
著作権 © 2016-2024 エリック・バウ。無断転載を禁じます。
この Homebridge プラグインは、Signify によって Hue ブリッジに接続された Apple の HomeKit Hue 互換デバイス (ライト、プラグ、センサー、スイッチなど) を公開します。
Hue は元々、フィリップスが照明部門を Signify に分割する前に開発したものであることに注意してください。 Signify は現在も Philips Hue のブランド名を使用しています。
Homebridge Hue の機能とサポートされるデバイスのリストについては、次の機能の比較を含む Wiki を参照してください。
Homebridge Hue は、Hue ブリッジを自動的に検出します。 1 つのインストールから複数のブリッジをサポートします。 v2 (四角形) と v1 (円形) の Hue ブリッジの両方をサポートします。これは、v2 Hue ブリッジのネイティブ HomeKit 機能と組み合わせて動作します。
Homebridge Hue の詳細な説明については、Wiki を参照してください。
Homebridge Hue を Hue 互換のライト、スイッチ、センサーに接続するには、Philips Hue ブリッジが必要です。 API v1.61.0 (v2 ブリッジ) または v1.16.0 (v1 ブリッジ) 以降を備えた最新の Hue ブリッジ ファームウェアを使用することをお勧めします。
Homebridge を実行するにはサーバーが必要です。これには、Raspberry Pi、NAS システム、Linux、macOS、または Windows を実行している常時接続の PC など、Node.js を実行しているものであれば何でもかまいません。詳細については、ホームブリッジ Wiki を参照してください。 Homebridge を実行しているサーバー、Hue ブリッジ、およびホーム ハブとして機能する AppleTV を接続するには、有線イーサネットを使用することをお勧めします。
HomeKit を操作するには、iPhone、Apple Watch、iPad、iPod Touch、または Apple TV (第 4 世代以降) 上の Siri または HomeKit アプリが必要です。 iOS、watchOS、tvOS の最新リリース バージョンを使用することをお勧めします。
Siri や Apple の Home アプリでさえ、依然として限られた HomeKit サポートしか提供していないことに注意してください。 Homebridge Hue の全機能を使用するには、Eve アプリ (無料) や Matthias Hochgatterer の Home+ アプリ (有料) など、他の HomeKit アプリをチェックしてみるとよいでしょう。
HomeKit はマルチキャスト DNS (別名 Bonjour) を使用して Homebridge を検出するため、Homebridge を実行しているサーバーは HomeKit を実行している iDevice と同じサブネット上にある必要があります。リモート アクセスおよび HomeKit オートメーション (ワイヤレス スイッチのサポートを含む) の場合、Apple TV (第 4 世代以降) または HomePod をホーム ハブとしてセットアップする必要があります。
Homebridge Hue には、コマンドラインから Hue API と対話するためのphコマンドライン ユーティリティが含まれています。このユーティリティの概要については、Wiki のチュートリアルを参照してください。
ph -hまたはph --help発行すると、その機能とコマンドライン引数の概要が表示されます。
Homebridge Hueをインストールするには:
Homebridge Wiki の指示に従って、Node.js と Homebridge をインストールします。
Homebridge Hue プラグインを Homebridge Config UI X を通じて、または次の方法で手動でインストールします。
$ sudo npm -g i homebridge-hue
config.jsonを編集し、Homebridge Hue が提供するHueプラットフォームを追加します。 「構成」を参照してください。
Homebridge Hue を初めて実行し、ブリッジ (それぞれ) のリンク ボタンを押します。ログ出力内の各ブリッジのブリッジ ID/API キーのペアに注目してください。 config.jsonを編集してこれらを含めます。 「構成」を参照してください。
Homebridge Config UI X の Homebridge Hue設定からこれらを追加することはできませんが、 Homebridge Config Editor を使用することはできることに注意してください。
Homebridge Hue を更新するには、別のsudo npm -gi homebridge-hue@latestを発行するだけです。 Homebridge Hueをアップデートする前にリリースノートをご確認ください。通常、マイナー バージョンへの変更は、HomeKit 構成を確認またはやり直す必要があることを示していることに注意してください。 Hue ブリッジ リソースの公開方法のマッピングの変更により、HomeKit はそれらを新しいアクセサリ、サービス、および/または特性として扱い、HomeKit ルーム、シーン、アクション、トリガーへの割り当てを失う可能性があります。以前のバージョンに戻すには、Homebridge Hue のインストール時に次のようにバージョンを指定します: sudo npm -gi [email protected] 。
Homebridge のconfig.jsonで、Homebridge Hue をプラットフォーム プラグインとして指定する必要があります。さらに、HomeKit に公開するものを指定する必要があります。 Homebridge Hue で使用されるconfig.json設定の完全なリファレンスといくつかの例については、Wiki を参照してください。
Homebridge Hue が HomeKit にどのリソースを公開するか、およびブリッジ上にリソース リンクを作成する方法のより詳細な制御については、Wiki を参照してください。
FAQをご確認ください。
Homebridge の起動に関する問題が発生した場合は、インストールされている Node.js と Homebridge のバージョンを再確認してください。 Homebridge Hue は、Node.js の最新バージョンと Homebridge の最新バージョンを使用して開発およびテストされています。他のバージョンは動作する場合と動作しない場合があります。単にこれらをテストするための帯域幅がありません。
Homebridge の起動に関する問題が発生した場合は、 config.jsonで Homebridge Hue (および Homebridge Config UI X) のみを有効にして Homebridge の別のインスタンスを実行してください。こうすることで、問題が Homebridge Hue 自体に関連しているのか、セットアップ内の複数の Homebridge プラグインの相互作用に関連しているのかを判断できます。 Homebridge のこの別個のインスタンスは、別のシステム上で、別のユーザーとして、または別のユーザー ディレクトリ ( -Uフラグで指定) から起動できます。 config.jsonでは、インスタンスごとに異なる Homebridge name 、 username 、および (同じシステム上で実行している場合は) portを使用してください。
Homebridge Hue は、設定した HomeKit 特性値ごと、および受信した HomeKit 特性値変更通知ごとに情報メッセージを出力します。 Homebridge が-Dで開始されると、Homebridge Hue は、ブリッジに対して行う各リクエスト、ブリッジのポーリング中に検出した各状態変化、および gen-2 Hue ブリッジ イベント ストリームから受信した各プッシュ通知についてデバッグ メッセージを出力します。さらに、検出したブリッジ リソースごとにデバッグ メッセージを発行します。
これらのメッセージをログ ファイルにキャプチャするには、次の手順を実行します。
$ homebridge -CD 2>&1 | tee homebridge.log
$ gzip homebridge.log
トラブルシューティングを支援するために、Homebridge Hue は起動時に、 config.json設定とすべてのブリッジの完全な状態を含む環境を圧縮された json ファイルhomebridge-hue.json.gzにダンプします。 IP アドレスとブリッジ API キーはマスクされます。このファイルは、デフォルトでは Homebridge ユーザー ディレクトリ~/.homebridgeに作成されます。これは、Homebridge Config UI X ユーザー インターフェイスの Homebridge Hue SETTINGSポップアップ ウィンドウの[Plugins]タブからダウンロードできます。
ご質問がある場合は、Discord の Homebridge コミュニティの#hueチャンネルにメッセージを投稿してください。
問題が発生した場合は、GitHub で問題を開いてください。 homebridge-hue.json.gzのコピーを問題に添付してください。 「デバッグ ダンプ ファイル」を参照してください。 homebridge.log.gzのコピーを問題に添付してください。 「デバッグ ログ ファイル」を参照してください。大量のログ出力をコピー/ペーストしないでください。
Homebridge Hue での私の取り組みを人々がどのようにサポートできるかという質問を受けることがあります。私は Homebridge Hue を趣味のプロジェクトとして、自分自身で使用するために作成しました。私がこれを GitHub で共有するのは、他の人が利益を得られるようにするため、そしてオープンソース コミュニティに恩返しするためです。彼らなしでは Homebridge Hue は実現できなかったでしょう。
そうは言っても、Homebridge Hue で新しいデバイスのサポートを追加するのは、デバイスに物理的にアクセスできないと非常に困難です。これは趣味のプロジェクトなので、他人の利益のためにそれらを統合するためだけに、自分では使用しないデバイスにお金を費やす余裕はありません。統合する新しいデバイスの形で少額の寄付、またはこれらのデバイスを自分で購入するためのお金を受け取ることができてうれしく思います。送料をご負担いただければ、後日デバイスを返品させていただきます。配送の詳細については、メールまたはDiscordでご連絡ください。
Homebridge Hue は私の趣味のプロジェクトであり、現状のまま提供され、いかなる保証もありません。自宅では何年も問題なく動作していますが、走行距離は異なる場合があります。
HomeKit の用語には慣れる必要があります。アクセサリは多かれ少なかれ物理デバイスに対応しており、iOS デバイスから WiFi または Bluetooth 経由でアクセスできます。ブリッジ(Homebridge など) は、ブリッジされた他のアクセサリへのアクセスを提供するアクセサリです。アクセサリは複数のサービスを提供する場合があります。各サービスは、仮想デバイス (電球、スイッチ、モーション センサーなどだけでなく、プログラム可能なスイッチ ボタン、アクセサリ情報、バッテリ ステータスなど) に対応します。 Siri はアクセサリではなく、サービスと対話します。サービスには 1 つ以上の特性が含まれます。特性はサービス属性のようなもので、HomeKit アプリによって読み書きされる可能性があります。 Xcodeの追加ツールとして配布されている Apple の HomeKit アクセサリ シミュレータをチェックしてみてください。
HomeKit は内部的に、UUID によってアクセサリを識別します。 Zigbee デバイス (ライト、センサー、スイッチ) の場合、Homebridge Hue はこの UUID を Zigbee MAC アドレスに基づきます。 Zigbee 以外のリソース (グループ、スケジュール、CLIP センサー) の場合、UUID はブリッジ ID とリソース パス (例: /sensors/1 ) に基づきます。リソース名 (例: Daylight ) を使用しないことにより、Homebridge Hue は重複した名前を処理できます。さらに、HomeKit はブリッジ上でリソース名が変更された後もアクセサリを認識し、どの HomeKit ルーム、グループ、シーン、アクション、トリガーが属しているかを記憶します。ただし、Zigbee 以外のブリッジ リソースが削除されて再作成され、その結果リソース パスが異なる場合、HomeKit はそれを新しいアクセサリとして扱うため、HomeKit を再構成する必要があります。
