📘 Home Assistant + Matter + Google Home

초보자 완전 설치 · 설정 · 동작 가이드

이번에는 초보자가 처음부터 끝까지 이해할 수 있도록,

• 📌 전체 구조 설명

• 📌 실제 설치 단계

• 📌 설정 방법

• 📌 QR 등록

• 📌 음성 동작 원리

• 📌 왜 그런지까지

를 그림 포함 + 단계별 설명으로 정리해드립니다.

(페이지 구분 없이 이해 중심 구성)

1️⃣ 전체 구조 먼저 이해하기

🔷 전체 그림

🟢 쉽게 설명하면

• Google은 "말을 듣는 역할"

• Matter는 "통역"

• Home Assistant는 "실제 집행자"

• 기기는 "실제 동작하는 것"

2️⃣ 준비물

✅ 반드시 준비

• Home Assistant 설치 완료 (HAOS)

• Google Home 앱

• Google 계정

• 동일 WiFi 네트워크

• VPN 끄기

3️⃣ Home Assistant에 기기 준비

3-1 엔티티란?

HA에 보이는 것:

이것을 엔티티(Entity) 라고 합니다.

3-2 Google에 보낼 기기만 표시하기 (라벨)

왜 필요한가?

→ 모든 기기를 Google에 보내면 복잡해짐

방법

1. 설정 → 장치 및 서비스 → 엔티티

2. Google에 보낼 기기 선택

3. 라벨 추가

예:

4️⃣ Matter-Hub 설치 방법

(통합 방식 – 추천)

4-1 설치

1. 설정 → 통합

2. "Home-Assistant-Matter-Hub" 추가

3. 브리지 생성

4-2 브리지 설정

예:

• 이름: google_speaker

• 포트: 5550

• Include Label: google_only

🔷 구조 그림

5️⃣ Matterbridge Add-on 방식 (대안)

5-1 애드온 설치

1. 설정 → 애드온

2. Matterbridge 설치

5-2 include 설정

5-3 QR 생성

Web UI에서 QR 확인

6️⃣ QR 등록 방법

6-1 Google Home 앱에서

1. • 버튼

2. 새 기기

3. Matter 지원 기기

4. QR 스캔

6-2 "미인증 기기" 경고

왜 뜨는가?

→ 상용 인증 제품이 아니기 때문

정상입니다.

👉 "무시하고 설정" 누르면 됩니다.

7️⃣ 등록 후 Google에 보이는 구조

Matterbridge aggregator
├ 거실등
├ PC_power
├ 에어컨

❗ 중요한 것

aggregator를 삭제하면
아래 기기 전부 사라집니다.

이유:

→ 부모 브리지이기 때문

8️⃣ 음성 명령이 동작하는 과정

예:

"OK Google, 거실등 켜줘"

단계별 그림

실제 내부 흐름

9️⃣ 왜 중복 기기가 생길까?

원인:

• Smart Home(Cloud) + Matter 동시에 사용

• 재등록 전에 초기화 안 함

🔧 중복 방지 4원칙

1. Google 연동은 한 방식만

2. 재등록 전 Factory Reset

3. 라벨 사용

4. 1플랫폼 1브리지

🔟 Factory Reset이 필요한 이유

Fabric이 남아있으면:

• Google이 이전 연결 기억

• 등록 실패 또는 중복 발생

Reset = 신뢰 관계 삭제

11️⃣ 네트워크 문제 해결

QR 등록 실패 시 확인:

• 같은 WiFi?

• VPN 꺼졌는가?

• 공유기 mDNS 허용?

• HA 재시작 했는가?

12️⃣ 완전 이해 핵심 요약

🎯 한 문장으로 정리

내가 말하면 Google이 해석하고,
Matter가 전달하고,
HA가 실행한다.

📌 초보자가 반드시 기억해야 할 것

• Google은 직접 기기를 켜지 않는다.

• HA가 실제 제어한다.

• Matter는 연결 통로이다.

• 브리지는 부모 장치이다.

• 중복은 구조 혼용 때문에 생긴다.

여기까지가 완전 초보 이해용 전체 구조 + 설치 + 동작 설명입니다.