-
Notifications
You must be signed in to change notification settings - Fork 1
Home Assistant ko
NAMO는 서로 목적이 다른 두 가지 로컬 연동 방식으로 Home Assistant에 연결할 수 있습니다. 필요한 엔티티에 맞춰 선택하세요.
Important
NAMO 커스텀 통합은 현재 개발 미리보기 상태입니다. 호스트 계약 테스트는 통과했지만 Home Assistant 컨테이너, 자동 검색, DHCP, 실제 역할 승계, HACS와 버전 업그레이드 검증은 아직 릴리스 관문으로 남아 있습니다. 평가 목적으로 사용하고, 정식 검증 전에는 중요한 자동화를 보수적으로 구성하세요.
| 연동 | 적합한 용도 | 식별 방식 |
|---|---|---|
| ESPHome | 각 NAMO 기기의 물리 센서와 제어 엔티티 | 물리 NAMO 기기마다 Home Assistant 기기 하나 |
| NAMO 커스텀 통합 | 안정적인 Site/Space 재실, 움직임, 타깃 수, 융합 상태와 공유 자동화 구역 | Site마다 항목 하나, 논리 Space마다 기기 하나 |
두 방식을 동시에 사용해도 됩니다. NAMO 통합이 기존 ESPHome 물리 엔티티를 대체하거나 삭제하지 않습니다.
NAMO 초기 설정에서 Home Assistant도 사용을 선택하세요. NAMO가 ESPHome Native API를 준비하고 기기마다 고유한 암호화 키를 생성합니다.
키는 별도로 보관하세요. 나중에 다시 확인하려면 다음과 같이 진행합니다.
- 실제 NAMO 기기에서 관리/백업을 엽니다.
- API 키 보기를 누릅니다.
- 일정 시간이 지나 자동으로 숨겨지기 전에 복사합니다.
이 키는 비밀번호처럼 취급하세요. 스크린샷, 로그, 이슈나 공개 설정 파일에 노출하면 안 됩니다.
[사진: 관리/백업의 API 키 보기 버튼과 임시 키 표시 팝업]
- Home Assistant에서 설정 > 기기 및 서비스를 엽니다.
- 자동 발견된 ESPHome 기기를 승인하거나 통합 구성요소 추가 > ESPHome을 선택합니다.
- NAMO의 IP 주소나
.local이름을 입력합니다. - NAMO에서 확인한 Native API 암호화 키를 입력합니다.
- 초기 설정 직후라면 첫 API 연결에 약 1분까지 걸릴 수 있으므로 기다립니다.
물리 센서 엔티티가 필요한 NAMO 기기마다 이 절차를 반복합니다.
기기에서 API 키 보기를 사용하세요. API 키 재발급을 누르면 기존 키를 사용하던 모든 ESPHome Native API 연결이 끊어집니다. 이후 Home Assistant에도 새 키를 입력해야 합니다.
시스템 초기화는 API 키를 표시하거나 삭제하거나 교체하지 않습니다.
현재 통합은 검증된 HACS 릴리스로 배포되지 않습니다. 개발 미리보기로 사용하려면 수동 설치합니다.
- 저장소의
custom_components/namo디렉터리를<Home Assistant 설정 디렉터리>/custom_components/namo로 복사합니다. - Home Assistant를 재시작합니다.
- 설정 > 기기 및 서비스 > 통합 구성요소 추가를 엽니다.
- NAMO를 선택합니다.
- 자동 검색이 나오지 않으면 같은 Site에 속한 온라인 NAMO 기기 중 한 대의 주소를 입력합니다.
등록 항목은 IP 주소가 아니라 안정적인 Site 식별자를 기준으로 합니다. 접속 경로나 조정 기기가 바뀌어도 중복 항목을 만들지 않고 기존 항목의 주소를 갱신하는 구조입니다.
[사진: NAMO 자동 검색 또는 호스트 직접 입력이 보이는 Home Assistant 통합 추가 화면]
각 논리 Space에는 다음 엔티티가 생성됩니다.
- 재실
- 움직임
- 타깃 수
- 상태:
healthy,degraded,unavailable - 감지 모드: 단독, 단일 센서, 다중 센서
- 융합 상태
- 온라인 기기 수
- 설정된 기기 수
- 원본 데이터 경과 시간
공유 평면도에서 활성화된 자동화 구역도 재실 엔티티로 생성됩니다. 설정 원본이나 그룹 담당 기기가 바뀌어도 엔티티 식별자는 유지됩니다.
각 기기에만 적용되는 제외, 둔감, 비활성, 보정 구역은 센서 필터이므로 공유 Home Assistant 구역 엔티티로 내보내지 않습니다.
NAMO는 응답이 없거나 오래된 데이터를 임의로 ‘비어 있음’으로 바꾸지 않습니다.
- 경로 변경이나 시간 초과가 발생하면 해당 엔티티를 사용할 수 없음으로 표시합니다.
- 짧은 재부팅만으로 Home Assistant 복구 알림을 만들지 않습니다.
- 비정상 Site 상태가 30초 동안 계속되면 복구 알림을 만듭니다.
- Site가 회복되면 복구 알림도 자동으로 사라집니다.
네트워크 장애를 빈방으로 오인해 조명이나 설비를 끄는 상황을 막기 위한 동작입니다.
조정 역할을 맡은 물리 기기가 바뀌어도 유지되어야 하는 자동화에는 Space 재실 엔티티를 사용하세요. 최근 움직임에만 반응해야 할 때는 움직임 엔티티를 사용합니다. 타깃 수는 레이더의 일반적인 다중 타깃 오차를 감수할 수 있는 자동화에만 사용하세요.
조명이나 냉난방처럼 중요한 종료 자동화에는 다음 원칙을 권장합니다.
- 재실 해제 상태가 일정 시간 유지된 뒤 실행합니다.
-
unavailable을 재실 해제로 취급하지 않습니다. - 동작 전에 Space 상태나 융합 상태를 확인합니다.
- 수동으로 덮어쓸 수 있는 방법을 남겨둡니다.
NAMO 커스텀 통합은 물리 기기마다 추가하지 말고 Site마다 한 번만 추가합니다. 하나의 Site 항목이 논리 Space를 찾고 현재 계산을 담당하는 기기로 요청을 전달합니다.
ESPHome 통합은 물리 기기마다 유지됩니다. 같은 설치 환경에 여러 ESPHome 기기와 하나의 NAMO Site 항목이 함께 보이는 것은 정상입니다.
- IP 주소로 직접 추가합니다.
- Home Assistant와 NAMO가 로컬 네트워크에서 서로 통신할 수 있는지 확인합니다.
- 초기 Native API 준비가 끝날 때까지 기다립니다.
- VLAN 사이에서 멀티캐스트 검색이 차단되지 않았는지 확인합니다.
관리/백업 > API 키 보기에서 다시 비교하세요. 키를 재발급했다면 기존 ESPHome 연결을 제거하거나 새 키로 다시 구성해야 합니다.
- 입력한 기기가 온라인이며 원하는 Site에 속하는지 확인합니다.
-
.local이름 대신 IP 주소를 사용해 봅니다. - 재부팅 직후 Site가 수렴 중이라면 기다린 뒤 통합을 다시 불러옵니다.
- 물리 노드마다 별도의 NAMO 항목을 만들지 마세요.
경로가 바뀌는 동안 짧게 발생할 수 있습니다. 계속 유지된다면 Home Assistant 항목을 제거하기 전에 NAMO 대시보드에서 Site 상태, 온라인 기기 수와 융합 상태를 먼저 확인하세요.