Home Assistant (HA) に Aqara（Lumi）デバイスを追加する方法は、お持ちのハードウェアによって大きく 2 つの主流なやり方があります。
ご自身の状況に応じて、以下のいずれかを選んでください：
方法 A：Aqara 公式ゲートウェイを持っている
（M1S、M2、E1、エアコンコンパニオン P3 など）。
- 基本方針：HomeKit 経由で逆方向に HA へ接続します。
方法 B：汎用 Zigbee アダプターを持っている
（Sonoff ZBDongle、SkyConnect などの USB スティック）。
- 基本方針：ZHA または Zigbee2MQTT で直接デバイスを制御します（推奨。完全ローカルで、ゲートウェイの制約から解放されます）。
方法 A：Aqara 公式ゲートウェイを使う（HomeKit Controller 経由）
これが最も簡単な方法で、ハードウェアをいじりたくない、すでに Aqara ゲートウェイを購入済みのユーザーに適しています。現在の Aqara ゲートウェイのほとんどは HomeKit に対応しており、HA は LAN 上で iOS デバイスを「模擬」してゲートウェイとその子デバイスを引き継ぐことができます。
手順：
Aqara App でネットワーク設定を行います：
スマートフォンに「Aqara Home」App をダウンロードします（できるだけ Mi Home App は使わないでください。Aqara Home のほうが HomeKit 対応が良好です）。
ゲートウェイと子デバイス（センサー、スイッチなど）を Aqara Home App に追加し、ファームウェアが最新に更新されていることを確認します。
注意：
iPhone を使っている場合、iOS の「ホーム」App にこのゲートウェイを追加しないでください。すでに追加している場合は、iOS のホーム App からこのゲートウェイを削除（バインド解除）してください。HomeKit デバイスは通常、1 台のコントローラー（スマートフォンまたは HA）によってのみ排他的に制御できるためです。
Home Assistant でデバイスを検出します：
- Home Assistant の Web 画面を開きます。
- 設定 (Settings) -> デバイスとサービス (Devices & Services) に進みます。
- 通常 HA は LAN 内の HomeKit デバイスを自動検出し、「HomeKit Device」の下に検出の通知が表示されます。
- 自動検出されない場合は、右下の 連携を追加 をクリックし、HomeKit Device を検索します（HomeKit Bridge ではないので注意）。
ペアリング：
- 設定をクリックすると、ペアリングコード (Pairing Code) の入力が求められます。
- ペアリングコードは通常、ゲートウェイの底面やパッケージ箱に印刷されています（形式は XXX-XX-XXX）。
- 入力して数秒待つと、ゲートウェイとそれに接続されたすべての子デバイスが自動的に HA に表示されます。
メリット： 簡単で、公式 App でファームウェアをアップグレードできます。
デメリット： ゲートウェイに依存し、一部の特殊な属性（照度センサーの具体的な数値の更新頻度など）は HomeKit プロトコルによって制限されることがあります。
方法 B：Zigbee USB アダプターを使う（推奨：Zigbee2MQTT）
これは上級者や安定性を重視する人にとっての第一選択です。Zigbee USB ドングル（Sonoff ZBDongle-P または -E 版を推奨）を購入する必要があります。この方式では Aqara ゲートウェイは不要で、すべてのデバイスが HA に直接接続され、応答速度が最も速くなります。
ここでは最も強力な Zigbee2MQTT (Z2M) の方法を紹介します。ZHA より少し複雑ですが、Aqara デバイスの独自プロトコルへの対応が最も優れています。
- 準備：
Zigbee USB スティックを HA を動かしている機器（Raspberry Pi/NAS/ミニ PC）に挿します。USB 3.0 の干渉を避けるため、USB 延長ケーブルの使用が望ましいです。
- ステップ 1：MQTT Broker (Mosquitto) をインストール
- HA で 設定 -> アドオン (Add-ons) -> アドオンストア に進みます。
- Mosquitto broker を検索してインストールします。
- 起動し、「起動時に開始」と「ウォッチドッグ」を有効にしてください。
設定 -> デバイスとサービス に戻ると、HA が MQTT を自動検出するはずなので、設定をクリックして送信します。
- ステップ 2：Zigbee2MQTT をインストール
- 設定 -> アドオン -> アドオンストア に進みます。
- 右上のメニュー（三点） -> リポジトリ をクリックし、Z2M のリポジトリ URL を追加します：https://github.com/zigbee2mqtt/hassio-zigbee2mqtt（公式のものが見つからない場合は、まずこれを追加してください）。
更新後、Zigbee2MQTT をインストールします。
- ステップ 3：Zigbee2MQTT を設定
- Z2M アドオンのページで、構成 (Configuration) タブをクリックします。
- MQTT 設定：
- server: mqtt://core-mosquitto:1883
- user: （通常は空欄、または HA のユーザー名を入力）
password: （同上）
Serial 設定（重要）：
USB スティックのポートパス（例：/dev/ttyUSB0）を知る必要があります。設定 -> システム -> ハードウェア -> すべてのハードウェア で確認できます。
serial:
port: /dev/ttyUSB0
# 根据实际情况修改</li></ul>設定に以下を追加します：
Zigbee2MQTT アドオンを起動し、ログ を確認して正常に起動したこと（赤いエラーがないこと）を確かめます。
「WEB UI を開く」をクリックします。
- ステップ 4：Aqara デバイスを追加
- Zigbee2MQTT の Web 画面上部で、参加を許可 (Permit join) をクリックします（カウントダウンが始まります）。
- Aqara デバイスをリセットします：
- ほとんどの Aqara センサー（人感、ドア/窓、温湿度）：デバイス上のリセットボタンを 5〜10 秒間長押しし、青色のインジケーターが点滅するまで待ちます。
そこで手を離すと、デバイスが対応していればもう一度点滅し、接続中であることを示します。
Z2M の画面を観察すると、デバイスがインタビューを経て、「Lumi」で始まる型番として表示されます。
デバイス名の横の青い鉛筆アイコンをクリックして分かりやすい名前に変更し（例：「リビング人感センサー」）、「Home Assistant のエンティティ ID を更新」にチェックを入れることができます。
- メリット：
- ローカル化：クラウドから完全に切り離されます。
- 互換性：Aqara だけでなく、IKEA や Tuya など他ブランドの Zigbee デバイスも混在して接続できます。
機能が豊富：Aqara の多くのデバイスには隠しパラメータ（人感センサーの感度、停電時の状態記憶など）があり、Z2M ではこれらを直接変更できますが、ゲートウェイモードでは多くの場合できません。
方法 C：ZHA（Zigbee Home Automation）を使う – 簡易版 USB スティック方式
- 方法 B は複雑すぎると感じる場合は、HA ネイティブの ZHA 連携が使えます。これも USB スティックが必要です。
- USB スティックを挿します。
- 設定 -> デバイスとサービス に進みます。
- 通常 HA が USB スティックを自動検出し、Zigbee Home Automation をセットアップするか尋ねてきます。
- 設定をクリックし、正しいシリアルポートを選んでネットワークを作成します。
- 設定が完了したら、ZHA 連携カードの 設定 -> デバイスを追加 をクリックします。
Aqara デバイスのリセットボタンを長押ししてペアリングします。
注：ZHA の Aqara デバイスへの対応も良好ですが、一部の新しい型番や特殊なパラメータの調整に関しては Zigbee2MQTT ほど柔軟ではありません。
まとめと提案
初心者／ハードウェアをいじりたくない方：
方法 A（Aqara ゲートウェイ + HomeKit）
を使いましょう。最も確実で、App でデバイスのファームウェアも更新できます。
上級者／応答速度を重視／デバイスが多い方
：
方法 B（Zigbee2MQTT）
- を使いましょう。これは現在 HA コミュニティで最も推奨されている方式で、Aqara デバイスのポテンシャルを最大限に引き出します。よくある問題 Troubleshooting
- デバイスが頻繁にオフラインになる？
- Aqara の旧型 Zigbee デバイス（T1 シリーズ以外）は標準の Zigbee 3.0 プロトコルにあまり準拠しておらず、オフラインになりやすいです。
解決策： Zigbee ルーター機器（つまり常時給電のデバイス。Aqara の零火対応壁スイッチ、スマートプラグなど）を増やし、センサーを USB スティックから遠く離して直接接続させないようにします。
- ペアリングできない？
- できるだけ USB スティックやゲートウェイに近づけてペアリングしてください。
Aqara デバイスの場合、リセットボタンを長押ししてランプが点滅した後、1 秒ごとにボタンを短く押してデバイスを起こした状態に保ち、ペアリングが成功するまで続けることをおすすめします。
- Mi Home App に接続できるゲートウェイはどう接続する？
旧型の Xiaomi マルチモードゲートウェイであれば、Xiaomi Gateway 3 連携（HACS でインストール）が使えます。ただし現在の新しいデバイスは HomeKit 経路を推奨します。Mi Home プロトコルは頻繁に変更され、ローカルインターフェースも塞がれるためです。
