ura-presence-fusion-reference

Document URA's presence-fusion stack for Home Assistant integration development.

1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/ojiudezue/universal-room-automation --skill ura-presence-fusion-reference
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ura-presence-fusion-reference
Source: https://github.com/ojiudezue/universal-room-automation/tree/main/.claude/skills/ura-presence-fusion-reference
Command: npx skills add https://github.com/ojiudezue/universal-room-automation --skill ura-presence-fusion-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a detailed reference for URA's presence-fusion stack, offering insights into sensor kinds, occupancy substrates, and trust vetoes, aiding in planning and debugging.

Core Features & Use Cases

  • Sensor Kinds: Explains the different sensor types (motion, mmWave, occupancy, BLE, camera) and their trust rules.
  • OccupancySubstrate: Describes the raw occupancy layer and its role in the presence system.
  • Provenance Split: Discusses the derived occupancy view and its invariants.
  • Fan-Interference Mitigations: Details the strategies to handle fan interference in occupancy detection.
  • Boot-Settle Gates: Explains the mechanisms to prevent false away-actuation during boot.
  • Trust Vetoes: Describes the trust vetoes implemented for sleep and away states.
  • StateInferenceEngine: Differentiates between the house-state and zone-level presence detection.
  • House-State Aggregation Flow: Provides an overview of the house-state aggregation process.
  • Live-Verification Checklist: Offers a step-by-step guide for verifying the presence system's functionality.

Quick Start

Review the 'ura-presence-fusion-reference' skill to understand the occupancy detection mechanisms in URA.

Frequently Asked Questions about ura-presence-fusion-reference

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does presence fusion work in Home Assistant with multiple sensor kinds?

Presence fusion in Home Assistant combines motion, mmWave, BLE, and camera sensors via trust rules to maintain a raw occupancy substrate for accurate detection. It merges distinct sensor inputs into a unified occupancy layer, applying provenance splits and trust vetoes to ensure reliable state inference.

Why does my mmWave occupancy sensor trigger false away states during system restart?

False away states during system restart occur because occupancy sensors need time to stabilize. Boot-settle gates prevent false away-actuation by holding the presence-fusion stack in a transient state until sensor data normalizes, ensuring no incorrect away states are triggered during initialization.

How do I mitigate fan interference affecting mmWave occupancy detection in Home Assistant?

Fan interference in mmWave occupancy detection is mitigated using specific strategies within the presence-fusion stack. The reference details how to configure sensor trust rules and occupancy substrates to filter out false positives caused by moving air currents.

Do I need to understand Python programming to troubleshoot Home Assistant presence detection issues?

Yes, troubleshooting Home Assistant presence detection through this reference requires Python programming knowledge and familiarity with URA architecture. It covers custom integration development, state inference engines, and debugging techniques for occupancy substrates and trust vetoes.

What is the difference between house-state and zone-level presence detection?

House-state presence detection aggregates occupancy across the entire home, while zone-level detection focuses on individual areas. The StateInferenceEngine differentiates these two scopes, processing raw occupancy substrates to output both granular room-level and holistic house-level presence states.

How do I verify my Home Assistant occupancy detection system is functioning correctly?

You verify occupancy detection using the live-verification checklist, which provides a step-by-step guide for testing the presence system. It covers validating sensor kinds, checking provenance splits, and ensuring trust vetoes for sleep and away states operate correctly.