-
Notifications
You must be signed in to change notification settings - Fork 1
Troubleshooting ko
가장 덜 파괴적인 확인부터 시작하세요. 일시적인 네트워크, 페어링 또는 역할 승계 상태를 모든 기기 초기화로 해결하려고 하면 안 됩니다.
- 문제가 발생한 정확한 현지 시각과 직전 행동을 기록합니다.
- 문제가 있는 기기의 전원을 유지합니다.
- 저장, 업데이트, 페어링, 위치 맞추기 또는 역할 승계가 끝날 때까지 기다립니다.
- 대시보드를 한 번 새로고침합니다.
-
.local이름이 안 되면 IP 주소로 접속합니다. - 관리/백업 > 시스템 정보를 확인합니다.
- 필요하면 문제가 있는 기기만 재시작합니다.
설정을 지우기 전에 백업하세요. 공장 초기화는 첫 진단 방법이 아니라 마지막 복구 단계입니다.
재현되는 문제를 보고할 때는 다음 정보를 함께 준비하세요.
- 펌웨어와 대시보드 버전
- 기기 모델과 연결된 레이더 모듈
- IP 주소 또는 짧은 기기 이름. 필요하면 사설망 정보 일부는 가립니다.
- 정확한 시각과 시간대
- 문제 직전에 수행한 사용자 행동
- 화면의 전체 오류 문구와 확인 가능한 HTTP 상태
- 문제 전후가 포함된 기기 로그
- 설정 원본 기기와 대상 기기가 각각 무엇이었는지
- 작업 중 전원이나 Wi-Fi가 바뀌었는지
Wi-Fi 비밀번호, Home Assistant API 키, 펌웨어 서명 키와 기기 보안 credential은 첨부하지 마세요.
- 휴대폰이나 PC가 NAMO와 같은 LAN에 있는지 확인합니다.
-
.local주소 대신http://<기기-IP>/로 접속합니다. - 게스트 Wi-Fi나 클라이언트 격리가 로컬 기기 통신을 막지 않는지 확인합니다.
- 초기 설정이나 업데이트 직후라면 재부팅이 끝날 때까지 기다립니다.
- 기기가 반복해서 사라지면 다른 데이터 지원 USB 케이블과 안정적인 전원을 사용해 봅니다.
.local은 mDNS 지원과 멀티캐스트 통신에 의존합니다. macOS와 iOS에서는 대체로 안정적으로 작동하지만, Windows나 일부 Android 기기·브라우저에서는 환경에 따라 실패할 수 있습니다. 공유기, VLAN, VPN, 게스트 Wi-Fi 또는 클라이언트 격리가 mDNS를 차단할 수도 있습니다. 반복해서 실패하면 DHCP 예약을 설정하고 기기의 IP 주소를 사용하세요.
작업이 끝난 뒤 한 번 새로고침하세요. 평면도 저장, 펌웨어 업데이트, 페어링 commit 또는 보정 활성화 중에는 반복해서 새로고침하지 마세요.
- 기기 부팅이 끝날 때까지 기다립니다.
- 올바른 factory 이미지를 설치했는지 확인합니다.
- strapping pin에 영향을 줄 수 있는 선택 모듈을 분리하고 재부팅합니다.
- USB 전원과 케이블 품질을 확인합니다.
- SSID와 비밀번호를 정확히 다시 입력합니다.
- 설치 위치에서 해당 네트워크 신호가 잡히는지 확인합니다.
- captive portal과 무선 클라이언트를 격리하는 네트워크를 피합니다.
- 설정 후 공유기가 할당한 IP 주소로 접속합니다.
첫 ESPHome Native API 확인에는 약 1분까지 걸릴 수 있습니다. NAMO 대시보드가 먼저 준비되고 Home Assistant 확인이 나중에 끝날 수 있습니다.
- 주 LD2450 계열 레이더를 사용할 수 있는지 확인합니다.
- UART를 교차 연결했는지 확인합니다. XIAO TX는 레이더 RX, XIAO RX는 레이더 TX입니다.
- 공통 GND와 올바른 공급 전압을 확인합니다.
- 비활성 또는 제외 구역이 타깃을 덮고 있지 않은지 확인합니다.
- 평면도에서 레이더 방향을 확인합니다.
정상 주 레이더 frame이 없어도 펌웨어는 부팅할 수 있지만 공간 감지는 정상 작동할 수 없습니다.
먼저 원시 레이더 좌표가 움직이는지, 융합 결과만 움직이는지 분리해서 확인합니다.
- 유리, 얇은 벽, 반사면, 몸의 일부만 보이는 상황과 설치 각도는 레이더 자체를 흔들 수 있습니다.
- 보정 구역을 추가하기 전에 레이더 원점, 회전과 평면도 축척을 확인합니다.
- 융합 문제로 판단하기 전에 레이더를 한 대씩 비교합니다.
- 물리 배치가 타당한 것을 확인한 뒤에만 오탐 보정을 사용합니다.
레이더 시야 경계를 지나거나 여러 기기 관측을 연결하는 동안 잠깐 중복될 수 있습니다. 계속 중복되면 로컬 원시 타깃, 기기 사이 위치 맞추기, 감지 범위 중첩과 실제 두 번째 타깃 여부를 확인하세요.
정상입니다. LD2410C는 이미 시작된 재실 세션을 유지할 수 있지만 단독으로 좌표, 타깃 수, 방 상태나 구역 재실을 만들지 않습니다.
수십 ms 수준의 경고가 드물게 한 번 나오는 것만으로 기기 crash를 뜻하지는 않습니다. 경고가 자주 또는 몰아서 나오고, 응답 불가, 메모리 부족 경고, watchdog 재부팅이나 실제 감지 공백과 함께 나타날 때 조사하세요.
레이더 원점과 회전을 바로잡으세요. 잘못된 레이더 배치를 모든 구역을 옮겨서 보상하지 마세요.
전체 평면도 축척, 외곽선, 물리 벽 선분, 문과 레이더 위치를 확인합니다. 크게 잘못된 레이더 좌표 변환을 평면도 외곽선으로 숨기면 안 됩니다.
평면도 > 편집 > 레이더 위치 변경 > 고급 옵션을 엽니다. 저장된 물리 벽을 확인하고 레이더가 실제로 투과해서 보는 벽에만 차폐 제외를 사용하세요.
대시보드가 안내하는 설정 원본 기기로 이동하세요. 연결된 기기가 방금 재부팅했다면 최신 공유 평면도와 연결 정보가 수렴할 때까지 기다립니다.
- 대상 기기에서 3분 동안 연결 허용을 켭니다.
- 주변 목록을 새로고침합니다.
- 대상 IP 주소를 직접 입력합니다.
- 대상이 다른 Site의 설정을 아직 관리하고 있지 않은지 확인합니다.
연결된 기기 목록을 새로고침하고 현재 설정 원본 기기에서 계속하세요. 이전 설정 원본에 같은 요청을 반복해서 보내지 마세요.
site_configuration_continuity_unavailable 또는 site_configuration_sync_timeout은 공유 연결 정보나 평면도가 화면 대기 시간 안에 수렴하지 않았다는 뜻입니다.
두 기기를 온라인으로 유지하고 추가 변경을 멈춘 뒤 상태가 안정되면 연결 설정 계속을 사용하세요. 재시작 후에도 같은 상태가 계속되면 연결을 초기화하기 전에 양쪽 기기 로그를 수집하세요.
두 기기가 서로 충돌하는 공유 연결 정보를 가지고 있습니다. 양쪽의 기존 연결된 기기 목록을 확인하세요. 중단된 제거를 마치거나 격리된 대상 기기의 오래된 기기 간 보안 연결을 초기화한 뒤 다시 페어링합니다.
자동 위치 맞추기는 다음 제한 안의 보정만 허용합니다.
- 두 보정 위치 사이 최소 0.8m
- 위치 보정 최대 750mm
- 회전 보정 최대 12도
- 잔차 오차 최대 350mm
이 범위를 넘으면 큰 자동 보정을 반복해서 승인하려 하지 말고 저장된 레이더 위치나 평면도 축척을 바로잡으세요. 한 사람만 사용하고 두 레이더가 모두 볼 수 있는 충분히 떨어진 두 위치를 선택합니다.
기기가 재부팅되거나 대체 기기가 역할을 넘겨받거나 공유 credential이 수렴하는 동안 잠시 나타날 수 있습니다. 전원이 켜진 기기의 로컬 감지는 계속됩니다. 회복되지 않으면 온라인/설정 기기 수와 각 기기의 연결 상태를 확인하세요.
두 기기를 온라인으로 유지하고 대기 중인 제거를 마칩니다. 대상 기기를 복구할 수 없을 때만 강제 제거하고, 나중에 대상이 돌아오면 기기 사이의 오래된 보안 연결을 초기화한 뒤 다시 페어링하세요.
재부팅을 기다리고 IP 주소로 대시보드를 다시 연 뒤 설치된 버전을 확인합니다. Flash가 성공했어도 마지막 응답만 잃을 수 있습니다.
- NAMO가 생성하고 수정하지 않은 백업을 사용합니다.
- 체크섬과 형식 버전 오류를 확인합니다.
- 파일에 포함된 항목만 가져옵니다.
- 공유 평면도는 설정 원본 기기에서 복원합니다.
부팅이 끝나고 저장 작업이 대기 상태인지 확인합니다. 연결된 Site에서는 공유 연결이나 공간 데이터를 초기화하기 전에 구성원 제거를 마치거나 설정 원본 기기를 사용하세요.
관리/백업 > API 키 보기에서 다시 확인합니다. 키를 재발급했다면 ESPHome 통합을 새 키로 수정하거나 다시 만들어야 합니다.
의도된 동작입니다. NAMO는 접속할 수 없는 원본을 빈방으로 보고하지 않습니다. 네트워크 연결과 Site 상태를 확인하세요.
커스텀 통합은 물리 노드마다가 아니라 Site마다 한 번만 추가합니다. 물리 기기별 ESPHome 항목은 별개이므로 여러 개가 있어도 정상입니다.
기기와 맞는 로컬 ESPHome YAML 및 환경이 있다면 다음 명령을 사용합니다.
esphome logs namo.yaml --device 192.168.1.50YAML과 IP 주소를 실제 기기 값으로 바꾸세요. 문제가 발생하기 전에 터미널을 열어 두어 해당 시점의 로그가 포함되게 합니다.
로그 연결을 반복해서 열면 ESPHome API 최대 연결 수를 소모할 수 있습니다. 새 로그를 열기 전에 사용하지 않는 esphome logs 프로세스를 닫으세요.
아니요. 감지, 내장 대시보드, 페어링과 좌표 융합은 로컬 네트워크에서 작동하도록 설계되었습니다.
안 됩니다. NAMO 기기를 공개 인터넷에 절대로 노출하지 마세요. 공유기의 포트 포워딩이나 DMZ, 공인 IP 직접 연결, 공개 리버스 프록시 또는 인터넷 터널로 대시보드와 API를 외부에 공개하면 안 됩니다. HTTPS 인증서를 붙이는 것만으로는 안전한 인터넷 공개 서비스가 되지 않습니다. 원격 접속이 필요하면 NAMO는 신뢰할 수 있는 LAN에 그대로 두고, 해당 LAN에 접속하는 VPN을 사용하세요.
단독 감지에는 필요하지 않습니다. 방 배치, 공유 좌표와 다중 기기 융합에는 필요합니다.
하나의 융합 그룹은 현재 기기를 포함해 NAMO 최대 7대를 지원합니다. NAMO는 최대 3개 타깃을 추적합니다.
아니요. 기기 재시작과 초기화는 별도 동작입니다. 초기화는 확인 창에서 선택한 범주만 삭제합니다.
먼저 배선, 전원, 레이더 위치, 평면도 축척과 기기 위치 맞추기를 바로잡으세요. 반복되는 물리 현상이 확인될 때만 보정 구역을 사용하고, 흔들리는 표본 하나마다 설정을 바꾸지 마세요.