Repolode
XiaoMi

XiaoMi/ha_xiaomi_home

Xiaomi Cloudまたはローカルの中央ハブゲートウェイ経由で、Xiaomi IoTスマートデバイスをHome Assistantに取り込む公式連携。

代替できる製品:Mi Home

スター
22,240
フォーク
1,193
未解決の Issue
157
最終コミット
26 日前

これは何?

Xiaomi Home Integrationは、XiaomiがメンテナンスするHome Assistant用のカスタムコンポーネントで、Xiaomi IoTデバイスをHome Assistantに取り込みます。ユーザーはOAuth 2.0を使ってXiaomiアカウントにサインインし、ホームを選択すると、そのホームにあるデバイスがHome Assistantのエンティティとして作成されます。

デバイスはMIoT-Spec-V2仕様に基づいてマッピングされます。書き込み可能なプロパティはSwitch、Number、Select、Textエンティティに、読み取り専用プロパティはSensorエンティティに、イベントはEventエンティティに、アクションはButtonまたはNotifyエンティティに変換されます。ローカルのspecフィルターや多言語ファイルを使って、エンティティの変換ルールをカスタマイズできます。1つのHome Assistantインスタンスに複数のXiaomiアカウントを追加できます。

通常、制御にはXiaomi Cloudを経由します。Xiaomi中央ハブゲートウェイ、またはハブを内蔵したデバイスがある場合は、MQTT経由でコマンドや状態更新をローカルに処理できます。一部のIP接続デバイス向けにLAN制御オプションもありますが、プロジェクトでは使用を推奨していません。

主な機能

  • 01Xiaomiアカウントでログインすると、Xiaomi IoTデバイスをHome Assistantに取り込める
  • 02MIoT-Spec-V2のプロパティ、イベント、アクションをHome Assistantのエンティティにマッピング
  • 03Xiaomi中央ハブゲートウェイ、またはハブを内蔵したデバイス経由のローカル制御に対応
  • 041つのインスタンスで複数のXiaomiアカウントと地域を利用可能
  • 0513のインターフェース言語に対応し、エンティティの変換ルールをカスタマイズ可能

ユースケース

  • Home AssistantのダッシュボードからXiaomiの照明、プラグ、センサーを操作する
  • Xiaomiデバイスと他社のスマートホーム製品を組み合わせたオートメーションを構築する
  • 中国本土でXiaomi中央ハブゲートウェイを使い、ローカル優先の制御を実現する

トピック

よくある質問

ha_xiaomi_home とは?
Xiaomi Cloudまたはローカルの中央ハブゲートウェイ経由で、Xiaomi IoTスマートデバイスをHome Assistantに取り込む公式連携。 Xiaomi Home Integrationは、XiaomiがメンテナンスするHome Assistant用のカスタムコンポーネントで、Xiaomi IoTデバイスをHome Assistantに取り込みます。ユーザーはOAuth 2.0を使ってXiaomiアカウントにサインインし、ホームを選択すると、そのホームにあるデバイスがHome Assistantのエンティティとして作成されます。
ha_xiaomi_home は無料で使えますか?ライセンスは?
ha_xiaomi_home は Other ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
ha_xiaomi_home は今もメンテナンスされていますか?
活発にメンテナンス中。ha_xiaomi_home の最終コミットは 2026年9月28日 です。
ha_xiaomi_home は何に使えますか?
Home AssistantのダッシュボードからXiaomiの照明、プラグ、センサーを操作する Xiaomiデバイスと他社のスマートホーム製品を組み合わせたオートメーションを構築する 中国本土でXiaomi中央ハブゲートウェイを使い、ローカル優先の制御を実現する
ha_xiaomi_home はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/XiaoMi/ha_xiaomi_home

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト