Home Assistant 2025.12.2 版における 格力（Gree）エアコンデバイスの接続詳細チュートリアル。
本チュートリアルでは Home Assistant 公式内蔵の統合（Integration）を優先して使用します。これがもっとも安定しており初心者にも最適な方法で、サードパーティ製プラグインのインストールは不要です。
✅ 中心となる前提（必読）
開始前に、以下の準備を必ず完了してください。そうでなければ接続できません：
- デバイスがネットワーク設定済み：お使いの格力エアコンが “Gree+”（格力+）スマホアプリで自宅の WiFi に接続済みで、スマホから正常に操作できること。
- ネットワーク環境が同一：Home Assistant のホスト（Raspberry Pi やソフトルーターなど）と格力エアコンが 同じローカルネットワーク（同じルーター） に接続されていること。
- 注意：公式統合は自動検出機能に依存しているため、デバイスが別セグメント（VLAN）にある場合は検出できないことがあります。
WiFi 帯域：エアコンは通常 2.4GHz WiFi のみ対応です。
🚀 ステップ1：Home Assistant で統合を追加する
- Home Assistant を開く ブラウザまたはアプリで Home Assistant のバックエンドにログインします。
- 「デバイスとサービス」に入る
- 左側のメニューバーの 設定（Settings）をクリックします。
- デバイスとサービス（Devices & Services）を選択します。
統合を追加
- 右下の + 統合を追加（+ ADD INTEGRATION）ボタンをクリックします。
- 検索ボックスに Gree と入力します。
- 検索結果の Gree Climate アイコンをクリックします。
デバイスの自動検索
- クリックすると、システムがローカルネットワーク内の格力デバイスを自動スキャンします。
- ケース A：自動検出に成功（推奨）
- 画面に検出されたデバイスが表示されます（通常は MAC アドレスまたは既定の名前で表示されます）。
- 送信（Submit）をクリックします。
- デバイスに エリア（Area）を選択でき（例：リビング、主寝室）、その後 完了（Finish）をクリックします。
ケース B：デバイスが見つからない
- 長い間ローディングが続き「デバイスが見つかりません」と表示された場合は、エアコンの電源、WiFi の状態、HA ホストと同じネットワークに接続されているかを確認してください。
- 初心者向けヒント：ルーターの管理画面でエアコンに固定 IP を割り当て、その後エアコンと Home Assistant を再起動してもう一度試してみてください。
🎮 ステップ2：操作と使用
追加に成功すると、エアコンは Home Assistant に接続されています。
- エンティティを探す
- 設定 -> デバイスとサービス に戻ります。
- Gree Climate カードの 1 個のデバイス（または複数）をクリックします。
- クリックしてデバイス詳細ページに入ります。
コントロールパネル標準的なサーモスタットカードが表示され、機能は次のとおりです：
- モード切替：冷房（Cool）、暖房（Heat）、自動（Auto）、送風（Fan only）、除湿（Dry）、電源オフ（Off）。
- 温度調整：円環をドラッグするか矢印をクリックして目標温度を調整します。
- 補助スイッチ：システムは通常、追加のスイッチエンティティ（Entities）を自動生成します。例：
- Panel Light：エアコン本体の LED ディスプレイのオン／オフを制御します。
- Quiet：静音モード。
- XFan：ドライ／補助暖房機能。
ダッシュボードに追加
- デバイス詳細ページで「ダッシュボードに追加」ボタンをクリックすると、エアコンカードをホーム画面に配置でき、日常の操作が便利になります。
❓ よくある質問とトラブルシューティング（FAQ）
Q1：なぜデバイスが検索できないのですか？
- 原因 1：ネットワーク分離。ルーターで「AP 分離」が有効になっている場合や、HA とエアコンが別セグメントにある場合、ブロードキャストパケットが届かず、公式統合は自動検出できません。
- 解決：両者が同じ WiFi 信号（2.4G）に接続されていることを確認してください。
原因 2：デバイスの機種が古すぎる、または新しすぎる。
- 解決：Gree+ アプリに対応するデバイスのほとんどがサポートされます。どうしてもだめな場合は、エアコンを一度再起動する（電源を切り再接続）必要があるかもしれません。
Q2：追加後に「不可用（Unavailable）」と表示される？
- これは通常、エアコンがオフラインになったためです。格力エアコンの WiFi モジュールは長時間待機後にときどきスリープします。リモコンで電源を入れるか、ルーターで固定 IP アドレスを割り当てて安定性を高めてみてください。
Q3：公式統合が使いにくい場合は？
- 上級ユーザーで、公式統合では要件を満たせない場合（例えば別セグメントからの制御が必要な場合）、HACS 経由でサードパーティ製の Gree Climate Component をインストールできます。手動での IP アドレス入力による接続に対応していますが、初心者には上記の公式統合の使用を強くおすすめします。
💡 検証環境について
- 検証バージョン：Home Assistant Core 2025.12.2
- 検証デバイス：Gree+ プロトコルに対応する汎用 WiFi エアコン
- 統合タイプ：Official Core Integration（HACS 不要）
投稿者紹介 — 莱特智能（Laite）は2010年設立、スマートホームのトータルソリューションを専門としています。Now ALL IN HA。
