Skip to content

V0.5.5

Pre-release
Pre-release

Choose a tag to compare

View all tags
@David2766 David2766 released this 19 Jul 14:59
· 19 commits to main since this release
V0.5.5
db26351

v0.5.5 - Developer Beta Release

This release adds optional LD2410C sensor fusion, assist-sensor tuning, expanded validation, and the NAMO project identity. Back up the current device configuration before updating.

English

v0.5.5 expands NAMO with optional LD2410C static-presence assistance while preserving the existing PIR and LD2450 tracking behavior.

Presence Sensor Fusion

  • Added optional LD2410C support alongside the existing LD2450 and PIR sensors.
  • LD2410C cannot start a new presence session by itself. It only assists a session already confirmed by PIR or LD2450.
  • Arms static-presence assistance after 2 seconds of overlap with an existing presence session.
  • Allows an armed LD2410C to maintain presence when LD2450 loses its target without confirmed exit evidence.
  • Prevents a new static-radar hold after a confirmed exit-zone or room-boundary exit.
  • Added one 30-second same-session reentry window when presence ends without exit or filter evidence.
  • Returns to normal combined PIR and LD2450 evidence immediately when either sensor detects presence again.
  • Devices without LD2410C continue operating normally and quietly report the assist sensor as unavailable.

Distance and Target Display

  • Stabilized LD2410C detection distance using a rate-limited three-sample median.
  • Brief invalid distance samples retain the most recent stable value while static presence remains active.
  • Preserves the last unambiguous LD2450 coordinate while LD2410C is maintaining presence.
  • Displays a distance-matched retained target normally and marks a mismatched position in gray.
  • Retained display targets do not affect target counts, zones, rooms, calibration, or heatmaps.

Dashboard and Tuning

  • Added assist-sensor status directly below the main presence status.
  • Added an LD2410C sensitivity editor to the Zones page.
  • Displays all nine distance gates over the existing radar map.
  • Shows live moving and still energy only while the tuning view is open.
  • Highlights the currently detected distance gate.
  • Supports per-gate sensitivity adjustment.
  • Automatically disables engineering telemetry when the tuning session closes.
  • Disables the tuning control with a clear explanation when LD2410C is unavailable.
  • Updated the public demo with simulated LD2410C status, distance gates, energy, sensitivity changes, and assist-held targets.

NAMO Project and Distribution

  • Renamed the primary firmware entry to namo.yaml.
  • Moved shared firmware packages to packages/namo/.
  • Renamed public firmware images to namo-v<version>-factory.bin and namo-v<version>-ota.bin.
  • Preserved the existing ESPHome device identity for upgrade compatibility.
  • Updated repository, documentation, demo, CI, and release paths for NAMO-aint-motion-only.
  • Expanded the README with visual workflow documentation and separate hardware guides.
  • Added PCB, schematic, and enclosure resources under CC BY-NC-SA 4.0.
  • Added generated third-party notices and bundled license texts.
  • Current dual-radar PCB and enclosure release files are still under validation and will be published separately.

Validation and Fixes

  • Expanded native tracker tests to cover sensor-fusion arming, exit veto, reentry, missing hardware, retained-target confidence, and distance stabilization.
  • Added dashboard tests for LD2410C tuning geometry, API behavior, and demo interactions.
  • Added ESLint, TypeScript checks, dashboard tests, and ESPHome configuration validation to the public workflow.
  • Improved export validation for required files, YAML includes, private files, tests, and generated build artifacts.
  • Fixed stale static-radar availability and presence-off diagnostic states.
  • Fixed brief invalid LD2410C samples repeatedly exposing the detection distance as unknown.
  • Updated the demo so it no longer lags behind current dashboard functionality.

Installation

  • Use the factory image for a new USB installation.
  • Use the ota image when updating an existing device.
  • LD2410C is optional; existing LD2450/PIR installations remain supported.
  • Back up the current configuration before updating.
  • Verify downloaded files with the provided checksums.txt.

한국어

이번 릴리즈에는 선택적 LD2410C 센서 융합, 보조센서 감도 설정, 검증 체계 확장과 NAMO 프로젝트 명칭 변경이 포함됩니다. 업데이트 전에 현재 기기 설정을 백업하세요.

v0.5.5는 기존 PIR 및 LD2450 추적 방식을 유지하면서 선택적인 LD2410C 정적 재실 보조 기능을 추가한 개발자 베타 릴리즈입니다.

재실 센서 융합

  • 기존 LD2450 및 PIR과 함께 사용할 수 있는 선택적 LD2410C 지원을 추가했습니다.
  • LD2410C 단독으로 새로운 재실 세션을 시작하지 않으며, PIR 또는 LD2450이 확인한 세션만 보조합니다.
  • 기존 재실과 LD2410C 감지가 2초간 겹치면 정적 재실 보조가 준비됩니다.
  • 확인된 퇴실 근거 없이 LD2450이 타깃을 놓치면 준비된 LD2410C가 재실 상태를 유지할 수 있습니다.
  • 퇴실지점 또는 방 경계 퇴실이 확인된 경우 새로운 정적 레이더 유지를 시작하지 않습니다.
  • 퇴실 또는 필터 근거 없이 재실이 종료되면 동일 세션을 복구할 수 있는 30초 재진입 기회를 한 번 제공합니다.
  • PIR 또는 LD2450이 다시 감지되면 별도의 센서 우선순위 전환 없이 기존 결합 판정으로 돌아갑니다.
  • LD2410C가 없는 기기는 기존 방식대로 정상 작동하며 보조센서를 조용히 사용할 수 없음으로 처리합니다.

거리 및 타깃 표시

  • LD2410C 감지 거리를 1초 간격의 최근 3개 샘플 중앙값으로 안정화했습니다.
  • 정적 재실이 유지되는 동안 짧은 무효 거리 샘플은 마지막 안정 거리로 보완합니다.
  • LD2410C가 재실을 유지할 때 마지막으로 명확했던 LD2450 좌표를 표시용으로 보존합니다.
  • 보조센서 거리와 일치하면 기존 타깃처럼 표시하고, 차이가 크면 회색으로 표시합니다.
  • 보존된 표시용 타깃은 대상 수, 구역, 방, 보정 및 히트맵 계산에 포함되지 않습니다.

대시보드 및 감도 설정

  • 대시보드의 재실 상태 아래에 보조센서 감지 상태를 추가했습니다.
  • 구역 설정 화면에 LD2410C 감도 편집 기능을 추가했습니다.
  • 기존 레이더맵 위에 9개 거리 띠를 표시합니다.
  • 감도 설정 화면이 열려 있을 때만 이동 및 정지 energy를 실시간으로 표시합니다.
  • 현재 감지 중인 거리 띠를 강조해서 표시합니다.
  • 거리 띠별 감도를 개별 조절할 수 있습니다.
  • 감도 설정 화면을 닫으면 engineering telemetry가 자동으로 비활성화됩니다.
  • LD2410C가 없으면 버튼을 비활성화하고 원인을 안내합니다.
  • 공개 Demo에서도 LD2410C 상태, 거리 띠, energy, 감도 변경 및 보조 재실 타깃을 체험할 수 있도록 갱신했습니다.

NAMO 프로젝트 및 배포

  • 공식 펌웨어 진입 파일을 namo.yaml로 변경했습니다.
  • 공통 펌웨어 패키지를 packages/namo/로 이동했습니다.
  • 공개 펌웨어 파일명을 namo-v<version>-factory.bin 및 namo-v<version>-ota.bin으로 변경했습니다.
  • 기존 기기의 업데이트 호환성을 위해 ESPHome 장치 식별자는 유지했습니다.
  • 저장소, 문서, Demo, CI 및 릴리즈 경로를 NAMO-aint-motion-only 기준으로 갱신했습니다.
  • README에 주요 기능 이미지와 작업 흐름을 추가하고 하드웨어 문서를 분리했습니다.
  • PCB, 회로도 및 케이스 자료에 CC BY-NC-SA 4.0 라이선스를 적용했습니다.
  • 서드파티 고지 및 관련 라이선스 원문을 자동 생성해 배포에 포함하도록 했습니다.
  • 최신 듀얼 레이더 PCB 및 케이스 파일은 아직 검증 중이며 추후 별도로 공개할 예정입니다.

검증 및 수정된 문제

  • 센서 융합 준비, 퇴실 차단, 재진입, 하드웨어 미탑재, 보존 타깃 신뢰도 및 거리 안정화를 네이티브 테스트에 추가했습니다.
  • LD2410C 감도 UI geometry, API 동작 및 Demo 기능에 대한 대시보드 테스트를 추가했습니다.
  • 공개 workflow에 ESLint, TypeScript 검사, 대시보드 테스트 및 ESPHome config 검증을 추가했습니다.
  • 필수 파일, YAML include, 개인 파일, 테스트 및 생성된 빌드 부산물에 대한 export 검증을 강화했습니다.
  • 보조센서 가용 상태와 재실 OFF 진단 사유가 오래된 값으로 남던 문제를 수정했습니다.
  • 짧은 LD2410C 무효 샘플마다 감지 거리가 반복해서 알 수 없음으로 표시되던 문제를 수정했습니다.
  • 공개 Demo가 최신 대시보드 기능보다 뒤처져 있던 문제를 수정했습니다.

설치

  • 신규 USB 설치에는 factory 이미지를 사용하세요.
  • 기존 기기 업데이트에는 ota 이미지를 사용하세요.
  • LD2410C는 선택 사항이며 기존 LD2450/PIR 구성도 계속 지원됩니다.
  • 업데이트 전에 현재 설정을 백업하세요.
  • 제공되는 checksums.txt로 다운로드한 파일을 검증할 수 있습니다.
Assets 6
Loading