홈킷 기기 추가 안됨 증상별로 원인이 다르다

홈킷 기기 추가 안됨 문제는 원인이 하나가 아니다.

우리 집에 기기가 20대 붙어 있는데, 그걸 붙이면서 5가지 다른 상황을 겪었다. 하나는 반나절이 걸렸다

다음에서 홈킷 기기 추가 안됨을 검색한 결과

증상부터 나눠야 한다

같은 "추가가 안 된다"인데 원인이 다르다.

홈킷 기기 추가 실패 증상별 원인 분기

기기가 목록에 아예 안 뜬다        →  페어링 모드에 안 들어간 것
QR 코드를 못 읽는다              →  조명 문제인 경우가 많다
"이미 다른 홈에 추가되어 있음"     →  이전 등록이 남아 있다
코드는 먹는데 마지막에 실패        →  연결 방식(Thread·Matter·WiFi) 확인
추가는 됐는데 응답 없음           →  보더 라우터 쪽

증상을 안 나누고 리셋만 반복하면 시간만 간다. 나는 그걸 반나절 했다

1. 목록에 아예 안 뜰 때

리셋이 안 걸린 것이다. 이게 제일 흔하다.

나노리프 스카이라이트가 그랬다. 컨트롤러 버튼을 눌렀는데 살살 눌러서 리셋이 안 됐다

세게 누르니까 됐다. 어디에도 "세게"라고 안 적혀 있었다

기기가 살아 있는지는 따로 확인할 수 있다. 세팅용 와이파이가 뜨는지 보면 된다

아이폰 → 와이파이 목록에 기기 이름의 AP 가 보이면
전원과 무선은 살아 있는 것이다

그거 하나로 반나절 쓴 기록은 따로 적어놨다

2. QR이 안 읽힐 때

코드는 멀쩡한데 카메라가 못 읽는 경우가 있다.

QR 코드가 안 읽힐 때 확인할 것

다른 폰 후레시로 비추면 읽힌다. 스티커가 광택이 있거나 각도가 나쁘면 자기 폰 조명으로는 반사만 된다

숫자 8자리를 직접 입력하는 방법도 있다. QR 아래에 적혀 있는 그 숫자다

3. "이미 다른 홈에 추가되어 있음"이 뜰 때

중고로 샀거나 전에 등록했던 기기에서 난다.

기기 안에 이전 홈 정보가 남아 있는 것이라 기기 쪽 초기화를 해야 한다. 홈 앱에서 지우는 걸로는 안 된다

이 에러만 따로 적은 글도 있다

4. 코드는 먹는데 마지막에 실패할 때

여기서부터는 연결 방식을 봐야 한다.

홈킷 기기의 세 가지 연결 방식과 확인 지점

WiFi     공유기에 직접 붙는다        2.4GHz 인지 확인
Thread   보더 라우터를 거친다        홈팟·애플TV·일부 조명이 그 역할
Matter   기기마다 주소를 갖는다      네트워크에서 조회된다

표시만 보고 사면 안 되는 이유가 여기 있다. 홈킷 로고가 붙어 있어도 연결 방식이 다르면 준비물이 다르다

표시만 보고 샀다가 생긴 일은 따로 적었다

5. 추가는 됐는데 응답 없음

이건 붙는 문제가 아니라 경로 문제다.

Thread 기기는 보더 라우터를 거쳐야 하는데 그게 없거나 멀면 응답이 끊긴다

스마트커튼이 그랬다

터미널로 어디서 끊겼는지 본다

맥이 있으면 이게 제일 빠르다.

dns-sd 명령으로 홈킷 기기와 보더 라우터를 조회한 결과

dns-sd -B _hap._tcp local        홈킷 기기
dns-sd -B _matter._tcp local     등록된 매터 기기
dns-sd -B _matterc._udp local    페어링 대기 중인 기기
dns-sd -B _meshcop._udp local    Thread 보더 라우터

우리 집에서 돌리면 매터 노드가 7개, 보더 라우터가 3군데 나온다

읽는 법은 이렇다.

_matterc._udp 에 뜬다        페어링 대기 중 → 앱에서 잡으면 된다
아무 데도 안 뜬다             기기가 네트워크에 못 올라온 것 → 리셋부터
_meshcop 이 비어 있다        보더 라우터가 없다 → Thread 기기는 못 붙는다

보더 라우터는 따로 살 필요가 없는 경우가 많다. 홈팟이나 애플TV가 이미 하고 있다. 우리 집은 천장 조명도 하고 있었다

확인 순서

• 세팅용 AP가 뜨는지 본다. 안 뜨면 전원·리셋 문제다
• 리셋 버튼은 세게 누른다. 살살 누르면 안 걸린다
• QR은 다른 폰 후레시로 비춘다. 안 되면 숫자 8자리를 직접 넣는다
• "이미 다른 홈"이면 기기 쪽을 초기화한다. 앱에서 지우는 걸로는 안 된다
• 연결 방식을 확인한다. Thread면 보더 라우터가 있어야 한다
• 맥이 있으면 dns-sd 로 어디서 끊겼는지 본다

정리하면

• 증상마다 원인이 다르다. 리셋만 반복하면 시간만 간다
• 목록에 안 뜨면 리셋이 안 걸린 것이다. 버튼을 세게 누른다
• QR은 조명 문제인 경우가 많다. 다른 폰으로 비추면 읽힌다
• "이미 다른 홈"은 기기 초기화가 답이다
• 마지막에 실패하면 연결 방식을 본다. Thread·Matter·WiFi가 준비물이 다르다
• 추가 후 응답 없음은 보더 라우터 쪽이다
• dns-sd 한 줄이면 어디서 끊겼는지 보인다

기기 20대를 붙이면서 같은 방법으로 풀린 적이 없었다. 증상을 먼저 나누는 게 제일 빨랐다