Home Assistant (HA) に Xiaomi デバイスを接続する場合、現在最も主流で最も使いやすい方法は、HACS から Xiaomi Miot Auto 連携をインストールすることです。
Xiaomi Miot と Xiaomi Cloud（通常は公式連携、またはクラウド経由で情報を取得する連携を指します）は、本質的に異なります。
以下、詳しい比較とチュートリアルです。
第 1 部：両者の違い
1. Xiaomi Miot Auto（推奨）
これは中国の開発者 al-one が開発したサードパーティプラグインで、現在 Xiaomi デバイスを接続するための最も強力で最も汎用的な方法です。
- 原理：Xiaomi の最新 MIoT プロトコル（Xiaomi IoT プロトコル）に基づいています。
- メリット：
- 対応デバイスが極めて多い：Mi Home アプリに接続されているほぼすべてのデバイスに対応します（Bluetooth Mesh ゲートウェイ配下のデバイスを含む）。
- ローカル制御：同じ LAN 内にデバイスがあれば、優先的にローカル LAN 制御を試みます（反応が速く、ネット切断時も使用可能）。ローカル制御ができない場合のみクラウド経由になります。
- 機能が豊富：デバイスの各種属性（バッテリー残量、温湿度、詳細な状態など）を読み取れます。
デメリット：HACS（Home Assistant コミュニティストア）のインストールが必要です。
2. Xiaomi Miio（公式連携）/ Xiaomi Cloud
HA には公式の Xiaomi Miio 連携が搭載されており、ユーザーがこれを大まかに Xiaomi Cloud 連携と呼ぶこともあります。
- 原理：やや古い Miio プロトコルに基づいています。
- メリット：システム標準搭載で HACS のインストールが不要、安定性が高い。
- デメリット：
- 対応デバイスが少ない：主にロボット掃除機、空気清浄機、旧型ゲートウェイに対応します。新しいコンセント、スイッチ、センサーへの対応は非常に貧弱です。
- 設定が面倒：デバイスの Token を手動で抽出しないと接続できないことがよくあります。
結論：迷わず を選んでください。これが現在の最終的なソリューションです。
第 2 部：詳しいインストールチュートリアル（Xiaomi Miot Auto）前提条件
- Home Assistant がすでにインストールされ、動作していること。
- HACS が必須です。まだ HACS をインストールしていない場合は、まず「Home Assistant HACS インストール」で検索してこの手順を完了してください（HA を扱う上での必修ルートです）。
- Xiaomi アカウントが必要で、デバイスがスマートフォンの「Mi Home」アプリに追加済みであること。
手順 1：HACS で連携をダウンロード
- Home Assistant 左側のメニューバーの HACS を開きます。
- Integrations（連携）をクリックします。
- 右下の Explore & Download Repositories（リポジトリを閲覧してダウンロード）をクリックします。
- 検索ボックスに「Xiaomi Miot Auto」と入力します。
- 検索結果の Xiaomi Miot Auto をクリックします。
- 右下の Download（ダウンロード）をクリックします。
- ダウンロード完了後、必ず Home Assistant を再起動します（設定 -> システム -> 右上の電源ボタン -> Home Assistant を再起動）。
手順 2：連携を追加してログイン
- 再起動後、左側のメニューバーの 設定 (Settings) をクリックします。
- デバイスとサービス (Devices & Services) をクリックします。
- 右下の + 連携を追加 (+ ADD INTEGRATION) をクリックします。
- 検索ボックスに Xiaomi Miot と入力し、表示された Xiaomi Miot Auto のアイコンをクリックします。
- 設定方式を選択：
- いくつかの選択肢が表示されます。最初の アカウント連携 (Add devices using Mi Account) を選択してください。これが最も簡単な方法で、クラウドからデバイス一覧を自動的に取得します。
アカウント情報を入力：
- Username: Xiaomi アカウント（電話番号または ID）。
- Password: Xiaomi アカウントのパスワード。
- Server: CN（中国本土）を選択 —— Mi Home アプリの地域を他国に設定している場合を除きます。
- 送信 (Submit) をクリックします。
手順 3：デバイスの絞り込み（任意）
ログインに成功すると、連携が Mi Home アカウント配下のすべてのデバイスを一覧表示します。
- Exclude devices（除外デバイス）：HA に取り込みたくないデバイスがある場合は、ここでチェックを入れます。
- Filter devices（デバイスの絞り込み）：通常は既定のまま（Include all devices）で問題ありません。
- Connection mode（接続モード）：
- Automatic（自動）を選ぶことをおすすめします。
- 説明：デバイスが LAN 内にあるかを自動判定します。LAN 内にあればローカル制御（即時応答）、なければ（例えば Bluetooth デバイスや別の Wi-Fi 上の場合）クラウド制御になります。
送信 (Submit) をクリックします。
手順 4：完了と使用
- 完了をクリックすると、「デバイスとサービス」の一覧に Xiaomi Miot Auto が表示されます。
- それをクリックすると「XX 個のデバイス」と表示されます。クリックして進むと、照明、コンセント、センサーなどが表示されます。
- おすすめ：
- 任意のデバイスをクリックし、その エンティティ (Entities) を確認します。
- これらのエンティティを HA のダッシュボード (Lovelace) に追加して制御できます。
第 3 部：よくある質問と応用テクニック
1. ローカル制御 (Local) とクラウド制御 (Cloud) について
見分け方：HA のデバイスページで該当デバイスをクリックし、属性を確認します。sub_type または接続モードが local と表示されていればローカル制御です。
なぜ重要か：ローカル制御はインターネットに依存せず、反応が極めて速く、プライバシーも保護されます。
注意
：ローカル制御を実現するには、HA ホストと Xiaomi デバイスが同じ LAN（同じサブネット）にある必要があります。複雑な VLAN 構成の場合は、サブネットをまたぐ mDNS ブロードキャストを有効にする必要があるかもしれません。
2. Bluetooth デバイス（温湿度計、スマートロック）
Bluetooth デバイス自体は Wi-Fi に接続せず、「Bluetooth ゲートウェイ」を通じて Mi Home クラウドに接続します。
Xiaomi Miot Auto がこれらのデバイスを接続する場合は通常クラウド (Cloud) 経由になります（HA は Wi-Fi 経由で Bluetooth デバイスに直接接続できないため）。
応用テクニック
：Bluetooth デバイスをローカル接続したい場合は、ESPHome を書き込める Bluetooth レシーバーを購入するか、HA ホスト内蔵の Bluetooth 機能と Passive BLE Monitor 連携を組み合わせる必要があります（これは別の話題です）。ただし初心者であれば、Xiaomi Miot Auto でクラウド経由の温湿度取得で十分です。
3. デバイスのエンティティ名が文字化けする/長すぎる
- 接続後、エンティティ ID が非常に長くなることがあります（例：switch.xiaomi_plug_v3_xxxx）。
- 「デバイス」ページで該当のエンティティをクリックし、右上の歯車アイコンをクリックして Entity ID と名前を変更すると、後で自動化から呼び出しやすくなります。
まとめ
違いで悩まず、HACS で Xiaomi Miot Auto をインストールし、アカウントログイン方式を選んでください。これが現在 Xiaomi エコシステム全体を接続する最も確実で簡単な「まるごとお任せ」な方法です。
