Skip to content

Compatibility Limits ko

David2766 edited this page Aug 21, 2026 · 2 revisions

호환성과 알려진 제한

이 문서는 현재 공개 NAMO 펌웨어가 지원하는 기준 하드웨어, 용량 상한, 검증 범위와 알려진 제한을 정리합니다. 구매하거나 다른 부품으로 바꾸기 전에 확인하세요.

View in English

기준 컨트롤러

항목 현재 기준
보드 Seeed Studio XIAO ESP32S3
Flash 8MB
PSRAM 8MB, Octal
프레임워크 ESP-IDF 기반 ESPHome
파티션 NAMO 8MB 전용 파티션 구성

현재 펌웨어는 8MB Flash와 8MB PSRAM을 전제로 메모리, 웹 대시보드와 OTA 파티션을 구성합니다. Flash가 작거나 PSRAM이 없거나 다른 ESP32 계열인 보드는 핀만 맞춘다고 그대로 교체할 수 없습니다.

레이더와 선택 센서

부품 상태 현재 용도와 제한
LD2450 기준 주 레이더 좌표, 움직임, 최대 3개 타깃과 공간 융합을 제공합니다.
LD2454 조건부 호환 LD2450과 공유하는 주기 좌표 프레임과 제한된 시작 절차를 지원합니다. 전원 투입 중 잘못된 baud의 UART 트래픽에 민감한 실기기 현상이 확인되어 기준 레이더와 같은 수준으로 간주하지 않습니다. 영구 설치 전에 반복 부팅을 검증하세요.
LD2410C 선택 사항 이미 시작된 재실 세션을 보조합니다. 좌표, 움직임, 타깃 수와 방 상태를 만들지 않습니다.
Panasonic EKMC1603111 PIR 선택 기준 부품 추가 움직임 근거로 사용합니다. 다른 PIR은 전압, 출력 방식과 핀 안정성을 별도로 검증해야 합니다.
BH1750 선택 사항 주변 밝기를 측정합니다.
SHT4x 선택 사항 온도와 습도를 측정합니다.

LD2454는 유효 좌표 프레임이 이미 들어오면 이를 우선 사용합니다. 부팅 후 프레임이 없을 때에만 펌웨어가 한 번의 제한된 복구 절차를 실행하며 무한 재시작이나 반복 명령을 보내지 않습니다. 모듈이 전원 투입 단계에서 멈춘 경우에는 깨끗한 전원 재인가가 필요할 수 있습니다.

현재 용량 상한

범위 상한
하나의 Fusion Group에 참여하는 NAMO 현재 기기 포함 7대
한 기기에서 추가할 수 있는 원격 NAMO 6대
로컬 또는 융합 타깃 최대 3개
현재 기기가 담당하는 Fusion Group 1개

이 상한은 임베디드 메모리와 네트워크 사용량을 예측 가능하게 유지하기 위한 제품 계약입니다. 설정 파일이나 UI를 우회하여 상한을 넘기는 구성은 지원하지 않습니다.

평면도와 좌표

  • NAMO 좌표 융합은 2D 평면을 사용합니다.
  • 레이더 설치 높이와 상하 기울기는 3D로 자동 보정되지 않습니다.
  • 평면도 벽과 문은 공유 공간 구조와 시각적 차폐에 사용되지만 레이더의 물리적인 벽 투과를 바꾸지 않습니다.
  • 단독 감지는 평면도 없이 작동할 수 있습니다.
  • 방 단위 표시, 공유 좌표와 다중 기기 융합에는 평면도가 필요합니다.
  • 한 Fusion Group의 활성 기기들은 같은 공유 평면도와 도형 버전을 사용해야 합니다.

네트워크와 브라우저

  • NAMO는 비밀번호가 설정된 2.4GHz Wi-Fi를 사용하며 오픈 Wi-Fi를 거부합니다.
  • 대시보드, 페어링과 융합은 신뢰할 수 있는 로컬 네트워크를 전제로 합니다.
  • .local 주소는 mDNS 환경에 따라 실패할 수 있으므로 IP 주소를 사용할 수 있어야 합니다.
  • 게스트 Wi-Fi, AP 격리, VLAN과 VPN은 자동 검색이나 기기 간 통신을 막을 수 있습니다.
  • 최초 USB 설치의 ESPHome Web은 Web Serial을 지원하는 Chrome 또는 Edge 사용을 권장합니다.
  • NAMO 기기를 공개 인터넷에 노출하는 구성은 지원하지 않습니다.

자세한 내용은 네트워크와 보안을 확인하세요.

현재 검증된 범위

  • 단독 감지, 평면도, 구역, 페어링, 위치 맞추기와 좌표 융합이 구현되어 있습니다.
  • 5대 실기기 환경에서 페어링과 Configuration Owner, Site Leader, Group Leader의 단독·조합 장애 승계를 검증했습니다.
  • 코드의 고정 용량과 호스트 테스트는 하나의 Fusion Group에서 최대 7대를 대상으로 합니다.
  • 6~7대의 모든 물리 배치, 공유기, 장시간 장애 조합을 포괄하는 실기기 검증은 계속 진행 중입니다.
  • 서로 다른 펌웨어 버전을 섞어 한 대씩 업데이트하는 전체 순차 업그레이드 조합은 아직 완전한 릴리스 검증을 마치지 않았습니다.
  • NAMO Home Assistant 커스텀 통합은 개발 미리보기이며 실제 Home Assistant 배포 조합의 검증이 더 필요합니다.

알려진 제한

완전히 움직이지 않는 사람

NAMO는 움직임 센서만 사용하는 방식보다 재실을 안정적으로 유지하도록 설계되었지만, 모든 방과 자세에서 완전히 움직이지 않는 사람을 보장하지 않습니다. 거리, 방향, 가구, 유리와 신체 가림의 영향을 받습니다.

유리와 얇은 벽

주 레이더는 유리와 일부 얇은 벽 너머의 사람이나 인접 공간을 감지할 수 있습니다. 평면도 외곽선이나 벽을 그리는 것만으로 원시 감지가 차단되지는 않습니다.

최대 3개 타깃

레이더와 융합 출력은 최대 3개 타깃을 다룹니다. 사람이 가까이 겹치거나 시야 경계를 지날 때 잠시 합쳐지거나 나뉠 수 있습니다.

LD2410C의 역할

LD2410C는 재실 유지 보조 장치이며 두 번째 공간 레이더가 아닙니다. LD2410C 감지 거리로 정확한 2D 위치나 여러 사람을 만들 수 없습니다.

공개 케이스

현재 듀얼 센서 기준 하드웨어에는 top_dual.3mfbottom_dual.3mf를 사용하세요. 접미사가 없는 top.3mfbottom.3mf는 구형 단일 센서용입니다. _dual 케이스는 변경된 잠금 구조를 사용하므로 구형 bottom.3mftop_dual.3mf와 호환되지 않습니다.

로컬 네트워크 전제

내장 HTTP 대시보드와 API는 인터넷 공개 서비스가 아닙니다. HTTPS, 프록시 또는 터널을 추가해 직접 공개하는 구성은 지원하지 않습니다.

변경 전에 확인할 것

  1. 기준 보드, Flash와 PSRAM 사양이 같은지 확인합니다.
  2. 레이더 모델, 공급 전압, UART 논리 전압과 핀 순서를 확인합니다.
  3. 기준 부품과 다른 센서는 하나씩 추가하고 단독으로 검증합니다.
  4. 정식 설치 전에 빈 공간, 착석, 보행과 여러 사람 환경을 시험합니다.
  5. 다중 기기는 한 대씩 연결하고 위치 맞추기를 끝낸 뒤 다음 기기를 추가합니다.
  6. 중요한 자동화에는 unavailable을 빈 공간으로 처리하지 않는 보호를 둡니다.

관련 문서

Clone this wiki locally