V0.6.0

NAMO v0.6.0

English | 한국어

---

English

NAMO v0.6.0 is the largest update to the project so far.

This release expands NAMO from a standalone presence sensor into a local multi-device spatial sensing platform. It introduces secure device pairing, shared floorplans, coordinate calibration, distributed role recovery, multi-radar fusion, signed firmware updates, manual floorplan drawing, and Home Assistant integration.

Highlights

Multi-Device Spatial Fusion

• Added secure local pairing between NAMO devices.
• Added shared floorplan and spatial configuration replication.
• Added coordinate calibration between connected devices.
• Supports up to seven NAMO devices in a single Fusion Group.
• Supports up to three logical targets from local and fused observations.
• Added automatic assignment and recovery for:
  • Configuration Owner
  • Site Leader
  • Group Leader
• Fusion and automation can continue on surviving devices while a role-holding device is temporarily unavailable.
• Improved convergence when previous role holders return to the network.
• Added participant quarantine, activation, removal, and recovery workflows.

Pairing and Calibration

• Added a complete pairing wizard covering:
  • Device discovery
  • Secure code confirmation
  • Floorplan selection and transfer
  • Radar position calibration
  • Participant activation
• Pairing can resume from the floorplan selection stage after cancellation.
• Improved handling of devices with missing, matching, or different floorplans.
• Added clearer recovery guidance for interrupted pairing.
• Improved participant removal and local-record override handling.
• Reduced unnecessary fusion disruption while adding devices or changing automatic replacement settings.
• Added pairing trace capture and diagnostic tools.

Floorplans and Radar Placement

• Added manual floorplan drawing without requiring an uploaded image.
• Supports polygonal building outlines and logical rooms.
• Added a large drawing canvas with grid snapping and zoom controls.
• Added physical wall representation independent of logical room regions.
• Added adjustable hinged and sliding doors.
• Doors can automatically define exit locations.
• Added participant position validation when replacing a floorplan.
• Improved radar placement, rotation, scaling, and wall occlusion previews.
• Unified wall occlusion rendering across setup, editing, floorplan, and dashboard views.
• Improved cropping, labels, target markers, and responsive floorplan presentation.

Presence and Tracking

• Improved local target stabilization and cross-device association.
• Reduced duplicated tracks and delayed coasting tracks.
• Improved behavior near radar field-of-view boundaries.
• Added more stable fused target continuity during short observation gaps.
• LD2410C can help retain an already established presence session.
• LD2410C does not independently create spatial targets or start a presence session.
• Added LD2410 stream health monitoring and LD2450 startup protection.
• Expanded native tests for tracking, observation transport, and fusion behavior.

Home Assistant

• Added the NAMO Home Assistant custom integration.
• Added configuration flow and coordinator-based state updates.
• Added sensor, binary sensor, number, select, switch, and update entities.
• Added device actions, repair guidance, translations, and diagnostics.
• Added HACS metadata and English/Korean integration documentation.

Signed Firmware Updates

• Added signed .namo-ota firmware packages.
• Added separate Root, Release, and Developer signing roles.
• Release firmware can be installed without additional approval.
• Developer builds require a one-time Alpha firmware installation approval.
• Alpha approval is stored temporarily in RAM and is cleared after use or reboot.
• Added firmware package metadata and cryptographic verification.
• Added Security Epoch anti-rollback protection.
• Added firmware update completion dialogs.
• Added release manifests and SHA-256 checksums.

Dashboard and Demo Mode

• Redesigned major dashboard workflows and dialogs.
• Added consistent status, warning, progress, and completion dialogs.
• Added richer mock device pairing and multi-device simulation.
• Mock mode can simulate:
  • Up to seven devices
  • Fused and unfused targets
  • Floorplan selection
  • Calibration
  • Participant removal
• Improved mobile layouts and text scaling throughout floorplan workflows.

Hardware

• Added dual-sensor PCB production files and schematics.
• Added the new dual-sensor enclosure:
  • top_dual.3mf
  • bottom_dual.3mf
• Updated the enclosure locking mechanism.
• The new dual-sensor top is not compatible with the legacy single-sensor bottom.
• Retained the legacy single-sensor PCB and enclosure files in separate locations.

Build, Test, and Release Tooling

• Added signed firmware build and validation tools.
• Added automatic Patch, Minor, and Major version updates.
• Added synchronized firmware and dashboard version management.
• Added release export, checksum, manifest, and third-party notice generation.
• Added distributed cluster simulation and role-failure testing.
• Added pairing trace, role capture, observation capture, and analysis tools.
• Expanded frontend, native C++, security, capacity, and regression tests.
• Updated vulnerable frontend dependencies, including PostCSS.
• Reduced the GitHub Pages workflow to the minimum steps required to build and deploy the demo.

Documentation

• Reorganized the README as a concise project entry point.
• Added a complete GitHub Wiki for users.
• Added English and Korean developer documentation.
• Added architecture, API contract, signing, Home Assistant, protocol, and ADR documents.
• Updated the implementation roadmap and documented validated and pending scenarios.

Upgrade Instructions

Upgrading from v0.5.5 or Earlier

Install the following image once:

namo-v0.6.0-legacy-ota.bin

This unsigned image exists only to migrate older firmware that does not understand signed .namo-ota packages.

After upgrading to v0.6.0, use signed .namo-ota packages for all future updates.

Normal OTA Update

Use:

namo-v0.6.0-ota.namo-ota

This is the signed Release OTA package.

Initial Installation or Recovery

Use:

namo-v0.6.0-factory.bin

Flash this image through USB for a new device or recovery installation.

Important Notes

• Back up the device configuration before upgrading.
• Never expose a NAMO device directly to the public Internet.
• Multi-device installations use a shared canonical floorplan and Site configuration.
• Shared floorplan changes must be performed through the Configuration Owner.
• The new dual-sensor enclosure uses a different locking interface from the legacy enclosure.

Validation Status

The complete five-device, single-Fusion-Group workflow has been physically tested, including:

• Pairing
• Floorplan transfer
• Calibration
• Activation
• Single role-holder failure
• Simultaneous failure of two role holders
• Role reassignment
• Device rejoin and convergence
• Participant removal
• Automatic replacement changes
• Continued fusion and automation on surviving devices

The following areas remain scheduled for additional physical validation:

• Four-, six-, and seven-device installations
• Multiple Fusion Groups
• Rolling upgrades with mixed firmware versions

Security

See the project Wiki and firmware signing documentation for full installation, security, and recovery procedures.

---

한국어

NAMO v0.6.0은 지금까지 진행된 업데이트 중 가장 큰 규모의 릴리스입니다.

이번 릴리스에서는 NAMO가 단일 재실 센서에서 로컬 다중 기기 공간 감지 플랫폼으로 확장되었습니다. 안전한 기기 연결, 공유 평면도, 좌표 보정, 분산 역할 복구, 다중 레이더 융합, 서명된 펌웨어 업데이트, 직접 평면도 그리기 및 Home Assistant 통합이 추가되었습니다.

주요 변경사항

다중 기기 공간 융합

• NAMO 기기 간 안전한 로컬 연결 기능을 추가했습니다.
• 평면도와 공간 설정을 연결된 기기 사이에서 공유할 수 있습니다.
• 연결된 기기 사이의 레이더 좌표 보정을 지원합니다.
• 하나의 Fusion Group에서 최대 7대의 NAMO 기기를 사용할 수 있습니다.
• 로컬 및 융합 관측으로 최대 3개의 논리 타깃을 추적할 수 있습니다.
• 다음 역할의 자동 배정과 장애 복구 기능을 추가했습니다.
  • Configuration Owner
  • Site Leader
  • Group Leader
• 역할을 맡은 기기가 일시적으로 연결되지 않아도 생존 기기에서 융합과 자동화를 계속할 수 있습니다.
• 이전 역할 기기가 네트워크에 복귀했을 때 현재 구성으로 다시 수렴하도록 개선했습니다.
• 참여 기기의 격리, 활성화, 제거 및 복구 절차를 추가했습니다.

기기 연결 및 위치 보정

• 다음 단계를 포함하는 기기 연결 마법사를 추가했습니다.
  • 기기 검색
  • 보안 코드 확인
  • 평면도 선택 및 전송
  • 레이더 위치 보정
  • 참여 기기 활성화
• 평면도 선택 중 취소한 연결을 해당 단계부터 다시 진행할 수 있습니다.
• 평면도가 없거나, 같거나, 서로 다른 기기의 연결 처리를 개선했습니다.
• 연결이 중단되었을 때 상태와 복구 방법을 더 명확하게 안내합니다.
• 참여 기기 제거와 로컬 기록 강제 삭제 절차를 개선했습니다.
• 기기 추가 및 자동 대체 설정 변경 중 기존 융합이 불필요하게 흔들리는 문제를 줄였습니다.
• 기기 연결 과정을 분석할 수 있는 추적 및 캡처 도구를 추가했습니다.

평면도 및 레이더 배치

• 평면도 이미지 없이 직접 건물 평면도를 그릴 수 있습니다.
• 다각형 건물 외곽선과 논리적인 방 구역을 지원합니다.
• 격자 스냅과 확대·축소를 지원하는 대형 그리기 화면을 추가했습니다.
• 논리적인 방 구역과 독립된 물리 벽 구조를 지원합니다.
• 길이와 위치를 조절할 수 있는 여닫이문과 미닫이문을 추가했습니다.
• 문 위치를 퇴실 지점으로 자동 설정할 수 있습니다.
• 평면도 교체 시 좌표계 밖에 놓인 레이더 위치를 검사합니다.
• 레이더 위치, 회전, 축척 및 벽 차폐 미리보기를 개선했습니다.
• 생성, 편집, 평면도 및 대시보드 화면에서 동일한 벽 차폐 렌더링을 사용합니다.
• 평면도 여백, 글자 크기, 타깃 표시 및 반응형 화면 구성을 개선했습니다.

재실 감지 및 타깃 추적

• 로컬 타깃 안정화와 기기 간 타깃 연결 알고리즘을 개선했습니다.
• 중복 타깃과 오래 남는 coasting track을 줄였습니다.
• 레이더 시야각 경계에서 타깃이 분리되는 현상을 완화했습니다.
• 짧은 관측 누락 중에도 융합 타깃이 더 안정적으로 유지됩니다.
• LD2410C가 이미 확립된 재실 세션의 유지를 보조할 수 있습니다.
• LD2410C만으로 새로운 재실 세션이나 공간 타깃을 생성하지는 않습니다.
• LD2410 스트림 상태 검사와 LD2450 초기화 보호 기능을 추가했습니다.
• 타깃 추적, 관측 전송 및 융합 동작에 대한 Native 테스트를 확장했습니다.

Home Assistant

• NAMO Home Assistant 사용자 정의 통합을 추가했습니다.
• Config Flow와 Coordinator 기반 상태 갱신을 지원합니다.
• Sensor, Binary Sensor, Number, Select, Switch 및 Update Entity를 제공합니다.
• 기기 작업, 복구 안내, 진단 정보 및 다국어 번역을 추가했습니다.
• HACS 메타데이터와 한국어·영어 통합 문서를 추가했습니다.

서명된 펌웨어 업데이트

• 서명된 .namo-ota 펌웨어 패키지를 추가했습니다.
• Root, Release 및 Developer 서명 역할을 분리했습니다.
• Release 펌웨어는 별도 승인 없이 설치할 수 있습니다.
• Developer 펌웨어는 일회성 알파 펌웨어 설치 승인이 필요합니다.
• 알파 펌웨어 승인은 RAM에 임시 저장되며 사용하거나 재부팅하면 해제됩니다.
• 펌웨어 패키지 메타데이터와 암호학적 서명 검증을 추가했습니다.
• Security Epoch 기반 다운그레이드 방지 기능을 추가했습니다.
• 펌웨어 업데이트 완료 안내 화면을 추가했습니다.
• 릴리스 manifest와 SHA-256 체크섬을 제공합니다.

대시보드 및 데모 모드

• 주요 대시보드 작업 흐름과 대화상자를 개편했습니다.
• 상태, 경고, 진행 및 완료 안내 디자인을 통일했습니다.
• 다중 기기 연결을 시험할 수 있는 Mock 환경을 확장했습니다.
• Mock 모드에서 다음 기능을 모사할 수 있습니다.
  • 최대 7대의 기기
  • 융합 및 미융합 타깃
  • 평면도 선택
  • 위치 보정
  • 참여 기기 제거
• 평면도 관련 모바일 화면과 글자 크기를 개선했습니다.

하드웨어

• 듀얼 센서 PCB 생산 파일과 회로도를 추가했습니다.
• 새로운 듀얼 센서 인클로저를 추가했습니다.
  • top_dual.3mf
  • bottom_dual.3mf
• 인클로저 결합 구조를 변경했습니다.
• 새로운 듀얼 센서 상판은 기존 단일 센서 하판과 호환되지 않습니다.
• 기존 단일 센서 PCB와 인클로저 파일은 별도 경로에 유지됩니다.

빌드, 테스트 및 릴리스 도구

• 펌웨어 빌드, 서명 및 검증 도구를 추가했습니다.
• Patch, Minor 및 Major 버전 증가 방식을 지원합니다.
• 펌웨어와 대시보드 버전을 함께 관리하도록 개선했습니다.
• 공개 저장소 export, checksum, manifest 및 제3자 고지 생성 기능을 추가했습니다.
• 분산 클러스터 시뮬레이션과 역할 장애 테스트를 추가했습니다.
• 연결 추적, 역할 상태, 관측 데이터 캡처 및 분석 도구를 추가했습니다.
• 프론트엔드, Native C++, 보안, 용량 및 회귀 테스트를 확장했습니다.
• PostCSS를 포함한 보안 취약 프론트엔드 의존성을 업데이트했습니다.
• GitHub Pages는 데모 빌드와 배포에 필요한 최소 작업만 수행하도록 축소했습니다.

문서

• README를 간결한 프로젝트 진입 문서로 개편했습니다.
• 사용자를 위한 GitHub Wiki 문서를 추가했습니다.
• 한국어와 영어 개발자 문서를 추가했습니다.
• 아키텍처, API 계약, 펌웨어 서명, Home Assistant, 프로토콜 및 ADR 문서를 정리했습니다.
• 구현 로드맵과 검증 완료·미완료 범위를 최신화했습니다.

업데이트 방법

v0.5.5 이하에서 업데이트

다음 파일을 한 번만 설치하십시오.

namo-v0.6.0-legacy-ota.bin

이 파일은 서명된 .namo-ota 패키지를 지원하지 않는 구형 펌웨어를 v0.6.0으로 이전하기 위한 서명 없는 OTA 이미지입니다.

v0.6.0으로 업데이트한 이후에는 모든 후속 업데이트에 서명된 .namo-ota 패키지를 사용하십시오.

일반 OTA 업데이트

다음 파일을 사용하십시오.

namo-v0.6.0-ota.namo-ota

서명된 정식 Release OTA 패키지입니다.

최초 설치 또는 복구

다음 파일을 USB로 설치하십시오.

namo-v0.6.0-factory.bin

새 기기의 최초 설치 또는 펌웨어 복구에 사용합니다.

중요 안내

• 업데이트 전에 기기 설정을 백업하십시오.
• NAMO 기기를 공개 인터넷에 직접 노출하지 마십시오.
• 다중 기기 구성에서는 하나의 평면도와 Site 설정을 공유합니다.
• 공유 평면도 변경은 Configuration Owner에서 진행해야 합니다.
• 새로운 듀얼 센서 인클로저는 기존 인클로저와 결합 구조가 다릅니다.

검증 현황

다음 항목을 포함한 5대 단일 Fusion Group 환경의 전체 흐름을 실제 기기에서 검증했습니다.

• 기기 연결
• 평면도 전송
• 위치 보정
• 참여 기기 활성화
• 단일 역할 기기 장애
• 역할 기기 2대의 동시 장애
• 역할 재선출
• 기기 복귀와 재수렴
• 참여 기기 제거
• 자동 대체 설정 변경
• 생존 기기의 융합 및 자동화 유지

다음 항목은 추가 실기기 검증이 예정되어 있습니다.

• 4대, 6대 및 7대 구성
• 여러 Fusion Group을 사용하는 구성
• 서로 다른 펌웨어 버전이 혼합된 순차 업데이트

보안

자세한 설치, 보안 및 복구 절차는 프로젝트 Wiki와 펌웨어 서명 문서를 참고하십시오.