miIO/MIoTプロトコルでXiaomiのスマートホーム機器を操作するPythonライブラリとmiiocliコマンドラインツール。
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 の数値は毎日更新されます。
関連プロジェクト
mijiaAPIをベースに、GUI、トレイ、デスクトップウィジェットを備えた、Xiaomi Mijiaスマートホーム機器を操作するWindowsデスクトップクライアントです。
自宅をライブ3Dモデルで表示し、Smart Life、Home Assistant、Hue、Apple Home経由で照明やエアコンを操作できるメニューバー/iPhoneアプリ。
ローカルで動作し、操作性とプライバシーを重視するオープンソースのホームオートメーションプラットフォーム。Raspberry Piやローカルサーバーで動かせます。
Zigbeeスマートホーム機器をMQTTに接続し、メーカー純正のハブやゲートウェイなしで使えるブリッジ。
WiFi経由でアドレス指定可能なRGB LEDテープ、2Dマトリクス、HUB75パネルを制御するオープンソースのESP32ファームウェア。