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이 표시됩니다. 이 두 문자열을 복사해 보관하세요. 나중에 사용합니다.
주의
: 개발자 계정은 기본적으로 ‘모의 가전’에만 접근할 수 있습니다. 집의 실제 기기를 제어하려면 개인 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 웹 로그인 페이지로 이동합니다.
중요: 여기서 로그인할 때는 휴대폰 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 할당량 제한
개발자 계정에는 일일 API 호출 횟수 제한이 있습니다(보통 1000회). Home Connect Alt는 호출 로직을 최적화했기 때문에 일반적인 가정 사용으로는 한도를 넘지 않습니다. 기기가 갑자기 반응하지 않는다면 그날의 할당량을 다 쓴 것일 수 있으며, 다음 날 자동으로 복구됩니다.
요약: 이름에 “Local”이 없더라도 Home Connect Alt(HACS)는 현재 Bosch/Siemens 가전을 Home Assistant에 연동하는 최선의 방법입니다.
핵심 흐름: 개발자 계정 등록 -> ID/Secret 획득 -> HACS에서 Alt 통합 설치 -> ID/Secret 입력 -> 웹 인증 -> 완료.
