2024 年時点で、Bosch/Siemens(BSH グループ)の Home Connect 機器に、実用的な「完全ローカル(Local)」接続方法は存在しません。
メーカーのセキュリティポリシーにより、家電のローカル API ポートは暗号化されているか閉じられています。そのため、名前に “Local” が含まれる連携を見かけたり、HACS 経由でインストールしたとしても、本質的には Home Connect のクラウド API を通じて通信します。
おそらくあなたが指しているのは、HACS ストアで非常に人気のある “Home Connect Alt” 連携(公式連携の強化版代替)か、あるいはローカル化を実現したいけれど方法が見つからないという状況でしょう。
Home Connect Alt は現在、使い勝手と機能の両面で最も優れたサードパーティ連携として評価されています。以下はこの連携を使うための詳しいチュートリアルです。公式連携よりも反応が速く、センサーも多く、より高度な機能にも対応しています。
Home Connect Alt(HACS 版)詳細設定チュートリアル
このチュートリアルでは Home Connect Alt のインストール方法を解説します。クラウドに依存しますが、現時点で Home Assistant において「ローカル」に最も近い応答速度を実現できる方法です。
ステップ1:準備
- HACS がインストールされていることを確認:まだ HACS(Home Assistant Community Store)をインストールしていない場合は、先にインストールしてください。
- Home Connect アカウントを用意:家電がすでに紐付けられた通常の Home Connect App アカウントが必要です(スマートフォンから家電を操作できる状態)。
- 開発者アカウントを登録:ここが最も重要なステップで、API キー(Client ID)を申請する必要があります。
ステップ2:開発者 API を申請する(重要なステップ)
Home Connect では、制御権限を取得するために「模擬アプリ」を作成する必要があります。
- アクセスします。
- 右上の Sign up をクリックして開発者アカウントを登録します(スマートフォン App とは別のメールアドレスでも構いません。分けておくことをおすすめします)。
- ログイン後、上部の Applications をクリックし、次に Register Application をクリックします。
- 申請フォームを入力します(大部分は適当で構いませんが、以下は正確に入力する必要があります):
- Application ID: 任意の名前で構いません。例えば ha-integration。
- OAuth Flow: Authorization Code Grant Flow を選択します。
- Redirect URI(リダイレクト先): ここが最も間違いやすいポイントです!
- Home Assistant の My Home Assistant サービスを使う場合(推奨)、以下を入力します:
- https://my.home-assistant.io/redirect/oauth
よく分からない場合や上記が使えない場合も、通常はこれを入力するのが既定です。
Save をクリックして保存します。
保存すると、Client ID と Client Secret が表示されます。この 2 つの文字列をコピーして保管してください。後で使用します。
注意
:開発者アカウントは既定では「模擬家電」にしかアクセスできません。自宅の実機を制御するには、個人の Home Connect アカウント(スマートフォン App のもの)をテストユーザーに追加するか、Home Assistant での認証時に個人アカウントでログインしてください。通常、開発者アカウントがそのまま管理アカウントになります。
- ステップ3:HACS で連携をインストール
- Home Assistant を開き、左側メニューの HACS をクリックします。
- Integrations(連携)をクリックします。
- 右下の Explore & Download Repositories(リポジトリを閲覧してダウンロード)をクリックします。
- “Home Connect Alt” を検索します。
注意:公式の “Home Connect” は選ばず、”Alt” が付いたもの、または作者が以下であるものを選んでください。
クリックして開き、Download を選択します。
ダウンロードが完了したら、Home Assistant を再起動します。
- ステップ4:連携を設定する
- 再起動後、HA の 設定 (Settings) -> デバイスとサービス (Devices & Services) に進みます。
- 右下の 連携を追加 (Add Integration) をクリックします。
- Home Connect Alt を検索します。
- 認証情報の入力を求めるダイアログが表示されます:
- Client ID: ステップ2 で取得した ID を入力します。
Client Secret: ステップ2 で取得した Secret を入力します。
送信をクリックすると、Home Connect の Web ログインページに移動します。
重要:ここでログインする際は、スマートフォン App に紐付けた通常のユーザーアカウントを使用してください(開発者アカウントと通常アカウントが同一の場合はそれでログインします)。
ログインに成功すると、ページに認証を求める表示が出るので、Approve(同意)をクリックします。
すべて順調に進めば、ページに “Link Successful” と表示され、Home Assistant を開くかどうか尋ねられます。
Home Assistant に戻ると、食洗機、洗濯機、オーブンなどのデバイスが表示されているはずです。
ステップ5:よくある質問と活用のコツ
1. なぜ「利用不可」(Unavailable) と表示されるのか?
- Home Connect の機器は省電力のため、通常は電源オフ状態で Wi-Fi を切断します(一部の新しい食洗機はリモート起動に対応しています)。
- 洗濯機/乾燥機:通常、電源が入っていて「リモートコントロール」ボタンが有効な場合にのみ HA から操作できます。
食洗機:「ネットワークスタンバイ」機能を有効にしていれば、通常は常時オンラインです。
2. ここでの “Local” とは具体的に何を指すのか?
- 古いチュートリアルで “Local” を見かけたなら、それは数年前の話であることがほとんどです。現在 Home Connect Alt を使う利点は、SSE(Server Sent Events)技術を採用していることです。
- 公式連携:ポーリング方式のため状態更新が遅い(例えばドアが開いても、HA が把握するのは 1 分後になることもあります)。
Home Connect Alt:常時接続を確立するため、家電の状態変化がほぼリアルタイムで HA にプッシュされます(通常 1〜3 秒の遅延)。ローカル制御に非常に近い体験です。
3. 中国語のエンティティ名をうまく設定するには?
インストール後、エンティティ ID は英語のことがあります(例:switch.dishwasher_power)。エンティティ設定で手動で「食洗機の電源」などに名前変更できます。
4. API のクォータ制限
開発者アカウントには 1 日あたりの API 呼び出し回数制限があります(通常 1000 回)。Home Connect Alt は呼び出しロジックを最適化しているため、通常の家庭利用で上限を超えることはありません。デバイスが急に反応しなくなった場合は、その日のクォータを使い切った可能性があり、翌日には自動的に回復します。
まとめ:名前に “Local” が含まれていなくても、Home Connect Alt(HACS)は現在、Bosch/Siemens の家電を Home Assistant に接続する最良のソリューションです。
中心となる流れ:開発者アカウントを登録 -> ID/Secret を取得 -> HACS で Alt 連携をインストール -> ID/Secret を入力 -> Web 認証 -> 完了。