# CorSec (Home Assistant) - Smart Home

Complete documentation for the Home Assistant smart home system — covering architecture, room-by-room device inventory, integrations, automations, voice pipeline, and add-ons.

# Home Assistant Overview

# Smart Home — System Overview

## Overview

This is a comprehensive Home Assistant installation running on **Home Assistant OS** (HAOS), managed via the Supervisor. It serves as the central hub for a fully automated multi-floor home in **Toronto, Ontario (America/Toronto timezone)**.

The system integrates 97 third-party services, 303 physical devices, and 1,431 entities across 17 rooms on 4 floors — covering lighting, security, climate, media, energy monitoring, irrigation, voice control, and appliances.

## System Vitals

| Property | Value |
|---|---|
| **HA Version** | 2026.6.4 |
| **OS Version** | HAOS 18.0 |
| **Supervisor** | 2026.06.2 |
| **Location** | Home (Toronto, ON) |
| **Timezone** | America/Toronto |
| **Language** | English |
| **State** | RUNNING |
| **Total Entities** | 1,431 |
| **Total Domains** | 44 |
| **Total Services** | 363 |
| **Total Areas** | 17 |
| **Total Devices** | 303 |
| **Total Integrations** | 97 |
| **Total Add-ons** | 26 (23 running) |
| **Total Automations** | 31 |
| **Total Scenes** | 25 |

## Floor & Area Structure

The home is organized across 4 floors with 17 named areas:

### Basement (Floor B1)
| Area | Entity Count |
|---|---|
| Basement | 76 |

### Ground Floor (Floor 1)
| Area | Entity Count |
|---|---|
| Backyard | 47 |
| Bar | 36 |
| Front Yard | 60 |
| Garage | 117 |
| Kitchen | 76 |
| Living Room | 94 |
| Patio | 12 |

### 2nd Floor (Floor 2)
| Area | Entity Count |
|---|---|
| Guest Bathroom | 5 |
| Guest Bedroom | 22 |
| Hallway | 6 |
| Laundry Room | 34 |
| Media Room | 123 |

### 3rd Floor (Floor 3)
| Area | Entity Count |
|---|---|
| Bedroom | 57 |
| Master Bathroom | 20 |
| Office | 48 |
| Upstairs Hallway | 6 |

## Domain Summary

| Domain | Count | Primary Use |
|---|---|---|
| sensor | 442 | Environmental, power, status |
| switch | 189 | Smart plugs, cameras, features |
| binary_sensor | 167 | Motion, doors, connectivity |
| button | 96 | Virtual triggers, remotes |
| update | 66 | HACS + integration updates |
| select | 61 | Mode/setting selectors |
| number | 61 | Numeric configuration |
| media_player | 48 | Audio/video playback |
| light | 39 | Lighting control |
| device_tracker | 38 | Presence detection |
| automation | 31 | Automated rules |
| notify | 26 | Push/TTS notifications |
| scene | 25 | Lighting presets |
| event | 20 | Button presses, backups |
| cover | 15 | Blinds/shades, garage door |
| calendar | 13 | Google + local calendars |
| fan | 7 | Ceiling fans, air purifiers |
| lock | 4 | Smart door locks |
| climate | 4 | Thermostat + appliances |
| valve | 4 | Irrigation zones |
| camera | 8 | Security cameras |
| alarm_control_panel | 5 | Eufy security system |

## Person Tracking

| Person | Tracked Devices |
|---|---|
| Rajeev Iyer | Iceheart (iPhone 17 Pro), Bacta (iPad Pro), Krytos (iPad) |

**Zones configured:**
- Home (primary)
- Work (downtown Toronto, ~47m radius)
- Rajeeta Home (~46m radius)

## Active Repairs (as of 2026-06-24)

> Three HACS integrations have pending updates that require an HA restart.

| Integration | Update Version | Severity |
|---|---|---|
| ge_home | v2026.2.1 | Warning |
| govee | v2026.6.20 | Warning |
| smartthinq_sensors | v0.43.0 | Warning |

**Action:** Apply HACS updates and restart HA.

## Last Updated

2026-06-24

# Home Assistant Platform & Infrastructure

## Overview

The system runs **Home Assistant OS (HAOS)** — the recommended production deployment method which provides the full Supervisor + add-on ecosystem, OTA OS updates, and snapshot backups. The host is not directly accessible via SSH by default; the Advanced SSH & Web Terminal add-on provides access.

## Software Stack

| Component | Version |
|---|---|
| Home Assistant Core | 2026.6.4 |
| Home Assistant OS | 18.0 |
| Home Assistant Supervisor | 2026.06.2 |
| Zigbee2MQTT | 2.12.0-1 |
| Music Assistant | 2.9.3 |
| Frigate NVR | 0.17.1 |
| Grafana | 12.1.0 |
| InfluxDB | 5.0.2 |
| Mosquitto MQTT Broker | 7.1.0 |
| AdGuard Home | 6.2.0 (add-on) |

## Mobile Clients

| Device | Model | OS | Integration |
|---|---|---|---|
| Iceheart | iPhone 17 Pro (iPhone17,1) | iOS 26.5 | HA iOS / mobile_app |
| Bacta | iPad Pro (iPad16,2) | iPadOS 26.5 | mobile_app |
| Krytos | iPad (iPad11,1) | iPadOS 26.3 | mobile_app |

## Add-on Ecosystem

26 add-ons installed, 23 currently running. See [addons-overview.md](../book-infrastructure/addons-overview.md) for the full inventory.

**Key add-ons by category:**

| Category | Add-ons |
|---|---|
| Zigbee | Zigbee2MQTT |
| NVR / Cameras | Frigate |
| Voice Pipeline | Whisper, Piper, Speech-to-Phrase, openWakeWord |
| Media | Music Assistant, VLC, YT Music PO Token Generator |
| Security | Eufy-security-ws, Tailscale |
| Monitoring | Grafana, InfluxDB, Log Viewer |
| Networking | Mosquitto broker, AdGuard Home, chrony |
| Utilities | Advanced SSH & Web Terminal, File editor, Samba share |
| Matter | Matter Server |
| HA MCP | Home Assistant MCP Server 7.8.1 |

## Zigbee Setup

Two Zigbee coordinators are in use:

| Coordinator | Driver | Firmware | Status |
|---|---|---|---|
| HA Connect ZBT-2 (via Zigbee2MQTT) | ZBT-2 (EmberZNet 7.5.1.0) | 2.12.0 | Active |
| HA Connect ZBT-2 (via ZHA) | Same hardware | — | **Disabled by user** |

> Both ZHA and Zigbee2MQTT are configured, but ZHA is disabled. All Zigbee traffic flows through Zigbee2MQTT via MQTT/Mosquitto.

## Matter Setup

Matter is handled by the **Matter Server add-on** (v9.0.2). The Aqara Hub M2 acts as a Thread/Matter border router, bridging multiple Aqara devices (water leak sensors, motion sensors, smart locks, wireless switches, temp/humidity sensors) into HA via Matter.

A second Matter hub, the **Aqara Camera Hub G3**, also bridges devices.

## Voice Pipeline

See [voice-pipeline.md](../book-infrastructure/voice-pipeline.md) for full details.

**Summary:**
- Wake word: openWakeWord
- STT: Whisper (local) + Speech-to-Phrase (local) + HA Cloud
- TTS: Piper (local) + Google Translate + HA Cloud
- LLM: Ollama (local — qwen3:4b-instruct at 192.168.1.85:11434)
- Hardware: Home Assistant Voice PE (ESPHome 2026.3.2) in Bedroom

## Remote Access

- **Tailscale** VPN (add-on v0.28.1) — zero-config mesh VPN
- **Home Assistant Cloud** (Nabu Casa) — remote UI, webhooks, voice relay

## Backup & Monitoring

- **Backup add-on** — automatic scheduled backups
- **Samba share** — exposes config/backup folders to local network
- **InfluxDB + Grafana** — long-term metrics storage and dashboarding
- **Network UPS Tools (NUT)** — UPS monitoring (CPS CP1500AVRLCD in Media Room)

## Networking Infrastructure

- **AdGuard Home** — network-wide DNS-based ad/tracker blocking (v0.107.74)
- **Mosquitto broker** — MQTT broker for Zigbee2MQTT and ESPHome
- **chrony** — local NTP server for IP cameras
- **DLNA** — Lusankya NAS (3× entries) + Giga Hub + HDHomeRun DMS

## Last Updated

2026-06-24

# Scenes & Helpers

# Helpers

## Overview

15 helper entities are configured via the UI (storage-based). They provide state storage, boolean flags, timers, person tracking, and geographic zones used by automations and dashboards.

---

## Boolean Helpers

### Guest Mode
| Property | Value |
|---|---|
| Entity | `input_boolean.guest_mode` |
| Icon | `mdi:account-group` |
| Default | on |
| Purpose | Flag indicating guests are present; can be used to adjust automations (e.g., suppress alarms, adjust lighting) |

---

## Number Helpers (Irrigation Watering Duration)

Four `input_number` helpers store the duration of the last watering run for each Front Yard irrigation zone. Values are set by irrigation tracking automations.

| Entity | Zone | Range | Unit |
|---|---|---|---|
| `input_number.front_planters_last_run_duration` | Front Planters | 0–480 | min |
| `input_number.front_yard_shrubs_last_run_duration` | Front Yard Shrubs | 0–480 | min |
| `input_number.front_fence_planters_last_run_duration` | Front Fence Planters | 0–480 | min |
| `input_number.side_yard_garden_bed_last_run_duration` | Side Yard Garden Bed | 0–480 | min |

All use `box` mode (manual entry) and 0.1 step.

---

## Date/Time Helpers (Last Watered Timestamps)

Four `input_datetime` helpers store the last watered date and time for each irrigation zone.

| Entity | Zone |
|---|---|
| `input_datetime.front_planters_last_watered` | Front Planters |
| `input_datetime.front_yard_shrubs_last_watered` | Front Yard Shrubs |
| `input_datetime.front_fence_planters_last_watered` | Front Fence Planters |
| `input_datetime.side_yard_garden_bed_last_watered` | Side Yard Garden Bed |

All have both date and time enabled (`has_date: true, has_time: true`).

---

## Timer Helpers

### Garage Light Timer
| Property | Value |
|---|---|
| Entity | `timer.garage_light_timer` |
| Duration | 20 minutes |
| Restore | false |
| Purpose | Auto-off timer for garage lights; started when motion or door triggers lights |

---

## Button Helpers

### Bin Button
| Property | Value |
|---|---|
| Entity | `input_button.bin_button` |
| Icon | `mdi:gesture-tap-button` |
| Purpose | Virtual button — likely triggers a garbage/recycling reminder or related action |

---

## Zones

Two named geographic zones in addition to the default Home zone:

### Work
| Property | Value |
|---|---|
| Entity | `zone.work` |
| Latitude | 43.641442 |
| Longitude | -79.377578 |
| Radius | 47 m |
| Icon | `mdi:briefcase` |
| Purpose | Presence tracking — Rajeev at downtown Toronto office |

### Rajeeta Home
| Property | Value |
|---|---|
| Entity | `zone.rajeeta_home` |
| Latitude | 43.656839 |
| Longitude | -79.383613 |
| Radius | 46 m |
| Icon | `mdi:account` |
| Purpose | Tracks when Rajeev is at Rajeeta's home location |

---

## Person

### Rajeev Iyer
| Property | Value |
|---|---|
| Entity | `person.rajeev_iyer` |
| User | `9c38d44ad18d49fbb4a18e892d4d8634` |
| Tracked devices | Iceheart (iPhone), Bacta (iPad), Krytos (iPad) |
| Current state | home |

The person entity aggregates location across all three mobile devices. Home/not_home state is determined by GPS proximity to the Home zone.

---

## Notes

- The `input_datetime` and `input_number` helpers for watering are **write-only from automations** — do not manually edit them unless correcting erroneous data.
- `input_boolean.guest_mode` is currently `on` (guests present). Remember to turn it off after guests leave if automations depend on this flag.
- Zones use lat/long from when they were created — verify they still accurately represent the locations if addresses change.

## Last Updated

2026-06-24

# Scenes

## Overview

25 lighting scenes are configured across the home, split between Philips Hue (Media Room), Lutron Caseta (Smart Bridge 2 whole-home scenes), and manually configured HA scenes for the Living Room and Bedroom.

---

## Bedroom

| Scene | Notes |
|---|---|
| Wake up Bedroom | Gradual sunrise lighting; used by `Wake up at home` automation |

---

## Living Room (4 scenes)

| Scene | Notes |
|---|---|
| Living Room Bright | Full brightness, all lights |
| Living Room Guest | Softer/warmer setting for guests |
| Living Room Off | All living room lights off |
| Living Room Partial | Partial lights on (ambient) |

---

## Media Room — Philips Hue (13 scenes)

These scenes are defined in the Hue app and synced to HA. They control all Hue lights in the Media Room.

| Scene | Type | Notes |
|---|---|---|
| Tropical twilight | Colour scene | Warm tropical tones |
| Relax | Colour scene | Soft warm white |
| Energize | Colour scene | Cool bright white |
| Read | Colour scene | Reading-optimized warm white |
| Bright | Colour scene | Full bright |
| Rio | Colour scene | Vibrant multi-colour |
| Nightlight | Colour scene | Very dim warm |
| Concentrate | Colour scene | Focused cool white |
| Epic Movie Night | Colour scene | Dynamic cinematic colours |
| Dimmed | Colour scene | Low ambient dimmed |
| Savanna sunset | Colour scene | Orange/red sunset tones |
| Movie Night | Colour scene | Dark ambient |
| Arctic aurora | Colour scene | Blue/green aurora tones |

---

## Smart Bridge 2 — Lutron Caseta (5 scenes)

These are Lutron-native scenes that control Caseta dimmers via the Smart Bridge 2.

| Scene | Notes |
|---|---|
| Smart Bridge 2 Night | Whole-home nighttime dim setting |
| Smart Bridge 2 Notifications | Lighting flash/pulse for notification alerts |
| Smart Bridge 2 Garage | Garage lighting preset |
| Smart Bridge 2 Off garage | Turn off garage lights |
| Smart Bridge 2 Movie downstairs | Dims/sets lights for movie watching |

---

## Bar (2 scenes)

| Scene | Notes |
|---|---|
| Bar On | Activates all bar lighting (spot lights, Govee bulbs, LED strip) |
| Bar Off | Turns off all bar lighting |

---

## Notes

- Hue scenes (Media Room) are activated via the `scene.*` HA entities or through the Hue dimmer switch 2.
- Lutron scenes (Smart Bridge 2) are activated via `scene.*` entities or through Lutron Pico remotes.
- The `Media room Epic Movie Night` and `Media room Movie Night` scenes pair well with the `Smart Bridge 2 Movie downstairs` Lutron scene for a full cinematic environment.
- Scene entities have `unknown` state unless they've been activated recently — this is normal for HA scene entities.

## Last Updated

2026-06-24

# Integrations

# Smart Appliances — LG, GE, Midea, Dyson, iQua, Orbit BHyve

## LG SmartThinQ Sensors

**Integration:** `smartthinq_sensors` (HACS) | **Status:** setup_retry | **Pending update:** v0.43.0

### Devices

| Device | Model | Area |
|---|---|---|
| Refrigerator | 2REF11EICD__2-FD (REFRIGERATOR) | Kitchen |
| WashTower (Dryer) | W3S1CVK2EVS_D_US-Dryer (TOWER_DRYER) | Laundry Room |
| Washer | F3S1CWK__-FL (TOWER_WASHER) | Laundry Room |

**Key entities:**
- `climate.fridge` / `climate.freezer` — fridge/freezer temperature control
- `sensor.dry_level` — dryer dry level
- `sensor.ge_profile_oven_srhv558129p_cook_mode` — oven state
- Wash/dry mode selectors, run state sensors

> **Action required:** Apply HACS update v0.43.0 and restart HA.

---

## GE Home (SmartHQ)

**Integration:** `ge_home` (HACS) | **Account:** jeeves5454@gmail.com | **Pending update:** v2026.2.1

### Devices

| Device | Model | Area |
|---|---|---|
| GE Profile Oven SRHV558129P | PCHS920YM3FS | Kitchen |

**Key entities:**
- `sensor.ge_profile_oven_srhv558129p_srhv558129p_cook_mode` — active cook mode
- `water_heater.ge_profile_oven_srhv558129p_srhv558129p_oven` — oven (water_heater domain used for temp control)

> **Action required:** Apply HACS update v2026.2.1 and restart HA.

---

## Midea Dehumidifier (LAN)

**Integration:** `midea_dehumidifier_lan` (HACS) | **Status:** loaded

### Device

| Device | Model | Area |
|---|---|---|
| Dehumidifier_71B6 | Midea Dehumidifier (sw 8.33.34) | Basement |

**Entities:**
- `humidifier.dehumidifier_71b6` — on/off, target humidity
- `fan.dehumidifier_71b6_fan` — fan speed
- `switch.dehumidifier_71b6_pump` / `switch.dehumidifier_71b6_pump_enabled`
- `sensor.dehumidifier_71b6_*` — humidity readings

---

## Dyson Pure Hot+Cool Link (Local)

**Integration:** `dyson_local` (HACS) | **Status:** loaded

### Device

| Device | Model | Area |
|---|---|---|
| Pure Hot+Cool Link | Model 455 | Bedroom |

**Entities:**
- `fan.dyson_fan` — speed, oscillation, night mode
- `climate.pure_hot_cool_link` — heat mode, temperature
- `sensor.pure_hot_cool_link_filter_life` — HEPA filter remaining life
- Air quality sensors (PM2.5, VOC, NO2, formaldehyde)

**Automation:** `Heat Bedroom` uses this device.

---

## iQua Water Softener

**Integration:** `iqua_softener` (HACS) | **Status:** loaded

### Device

| Device | Model | Area |
|---|---|---|
| Iqua Softener RHW4221-24178-4056 | Water Softener | Basement |

**Entities:**
- `switch.iqua_softener_rhw4221_24178_4056_water_shutoff_valve`
- `select.iqua_softener_rhw4221_24178_4056_efficiency_mode`
- Various water quality sensors

---

## Orbit BHyve (Irrigation)

**Integration:** `bhyve` (HACS) | **Status:** loaded

### Devices

| Device | Model | Area |
|---|---|---|
| Bhyve Hub | BH1G2-0002 (fw 0056) | (unassigned) |
| Front Yard Tap Timer | HT34A-0001 (fw 107) | Front Yard |

**Entities:**
- `valve.*` — 4 irrigation zone valves
- `switch.*_program` — watering programs
- `switch.*_rain_delay` — rain skip
- `sensor.*_next_watering` — next scheduled run
- `binary_sensor.bhyve_hub_connected`
- `binary_sensor.front_yard_tap_timer_fault`

See [area-front-yard.md](../book-areas-devices/area-front-yard.md) for full irrigation zone details.

---

## LetPot (Hydroponic Gardens)

**Integration:** `letpot` | **Status:** setup_retry | **Account:** jeeves5454@gmail.com

### Devices

| Device | Model | Area |
|---|---|---|
| Chrome 1 - Right | LetPot Senior | Media Room |
| Chrome 2 - Left | LetPot Senior | Media Room |

> Currently in `setup_retry` — likely an authentication/network issue.

---

## Notes / Gotchas

- Three integrations need HACS updates and HA restart: `smartthinq_sensors` (v0.43.0), `ge_home` (v2026.2.1), `govee` (v2026.6.20).
- Dyson Local uses local LAN communication — does not require Dyson cloud account to function after initial setup.
- The iQua Water Shutoff Valve is a safety-critical entity — automations should NOT accidentally toggle it.

## Last Updated

2026-06-24

# Audio & Media

## Overview

The home has a rich multi-room audio and media setup anchored by **Music Assistant** (MA) as the central music server, with Amazon Alexa devices, Apple TV, Samsung TVs, Sony BRAVIA, and a VLC media player providing playback targets across every room.

## Music Assistant

**Integration:** `music_assistant` | **Add-on:** Music Assistant v2.9.3 | **Entry:** `01KGVC9C8528A127QZ3ZQSFCDH`

Music Assistant (MA) is a free, open-source media library manager that aggregates streaming services and plays to speaker groups.

### MA Players

| Player | Source | Area |
|---|---|---|
| Living Room | Apple TV 4K Gen3 | Living Room |
| Kitchen | Amazon Echo | Kitchen |
| Everywhere | Speaker Group | (all rooms) |
| Rajeev's Samsung Soundbar | HW-Q930B | Media Room |
| Bedroom | Amazon Echo Show 5 | Bedroom |
| Office Dot Clock | Echo Dot w/ Clock | Office |
| Media Room | Amazon Echo Dot w/ Clock | Media Room |
| Guest | Amazon Echo Dot | Guest Bedroom |
| Rajeev's ecobee Smart Thermostat Premium | ecobee | Living Room |
| Basement Alexa | Amazon Echo Dot | Basement |
| Garage | Amazon Echo Dot | Garage |
| Rajeev's Samsung Soundbar S60B | Samsung HW-S61B | Living Room |
| Basement | Amazon Speaker Group | Basement |
| Full House | MA Sync Group | (all) |
| BRAVIA 4K UR2 | Sony BRAVIA | Media Room |
| Rajeev's TV | Amazon Fire TV | Basement |
| Soundbar | Samsung HW-Q930B | Media Room |
| Living Room soundbar | Samsung HW-S61B | Living Room |
| jeevesiy-ltmh242 | MacBook (AirPlay) | (mobile) |
| Rajeev's MacBook Air | MacBook Air (AirPlay) | (mobile) |
| Music Assistant | ShairportSync (AirPlay) | (system) |
| Home Assistant Voice 0919e8 | ESPHome (AirPlay) | Bedroom |

**YT Music PO Token Generator** add-on (v1.3.1) provides YouTube Music authentication tokens for MA.

---

## Amazon Alexa Devices

**Integration:** `alexa_devices` (HACS) | **Account:** jeeves5454@gmail.com

All Amazon Echo devices are integrated via the Alexa Devices integration, providing media player control and TTS announcements.

### Alexa Devices

| Device | Model | Area |
|---|---|---|
| Kitchen | Amazon Echo (4th gen) | Kitchen |
| Rajeev's Samsung Soundbar S60B | Samsung Soundbar S60B | Living Room |
| Basement Alexa | Amazon Echo Dot | Basement |
| Rajeev's ecobee Smart Thermostat Premium | ecobee (Alexa built-in) | Living Room |
| Everywhere | Speaker Group | (all) |
| Media Room | Amazon Echo Dot with Clock | Media Room |
| Bedroom | Amazon Echo Show 5 | Bedroom |
| Guest | Amazon Echo Dot | Guest Bedroom |
| Rajeev's TV | Amazon Fire TV 2-Series | Basement |
| Garage | Amazon Echo Dot | Garage |
| Basement | Speaker Group | Basement |
| Rajeev's Samsung Soundbar | Samsung Soundbar Q930B | Media Room |
| Office Dot Clock | Amazon Echo Dot with Clock | Office |

Each Alexa device exposes:
- `media_player.*` — play/pause/volume/track
- `sensor.*.next_alarm` — next alarm time
- `notify.*_speak` / `notify.*_announce` — TTS announcement

---

## Apple TV

**Integration:** `apple_tv` | **Device:** Apple TV 4K Gen3 (tvOS 26.5) | **Area:** Living Room

| Entity | Notes |
|---|---|
| `media_player.living_room` (Apple TV) | Play/pause/volume/app control |
| `remote.living_room` | Remote control (directional, menu) |

---

## Samsung TVs

### Samsung Frame 55 (Living Room)
- **Integrations:** `samsungtv_smart` (primary, HACS) + `samsungtv` (native) + `smartthings`
- **Model:** QN55LS03BAFXZC
- Entities: `media_player.samsung_frame_55`, `remote.samsung_frame_55`
- SmartThings adds energy monitoring: `sensor.living_room_tv_energy`

### Living Room TV (via SmartThings)
- **Integration:** `smartthings` | Model: QN55LS03BAFXZC
- `media_player.living_room_tv`

### Living Room Soundbar (HW-S61B)
- **Integration:** `smartthings` + `alexa_devices`
- Samsung soundbar model HW-S61B

### Media Room Soundbar (HW-Q930B)
- **Integration:** `smartthings` + `alexa_devices`
- Samsung soundbar model HW-Q930B (firmware HW-Q930BWWB-1010.0)

---

## Sony BRAVIA 4K UR2

**Integrations:** `androidtv_remote` + `cast` + `dlna_dmr` | **Area:** Media Room

The BRAVIA appears under three different integrations:
- `androidtv_remote` — full Android TV control (apps, directional, volume)
- `cast` — Google Cast receiver
- `dlna_dmr` — DLNA media renderer

---

## VLC (Local Media Player)

**Integration:** `vlc_telnet` | **Add-on:** VLC v1.0.0 | **Area:** Media Room

VLC is available as a local media player target for TTS and audio playback:
- `media_player.vlc_telnet`

---

## DLNA

Three DLNA DMS (media server) entries for the **Lusankya** NAS (3× UPnP discovery instances), plus a Giga Hub entry and HDHomeRun DMS.

---

## Notes / Gotchas

- The Samsung Frame 55 is registered three times — use `samsungtv_smart` as the primary control path; the native `samsungtv` entry may conflict.
- Music Assistant and Alexa Devices both register `media_player` entities for Echo devices — this creates duplicate entities. Use the MA entity for music control and the Alexa entity for TTS announcements.
- Apple TV integration can lose connection when the TV enters deep sleep; a retry is handled automatically.

## Last Updated

2026-06-24

# Energy Monitoring

## Overview

Energy monitoring is multi-layered: **Emporia Vue** provides granular circuit-level monitoring across 12 household circuits, **CO2 Signal** (Electricity Maps) provides real-time grid carbon intensity for Ontario, and the **Ontario Energy Board** integration provides local energy tariff data.

---

## Emporia Vue

**Integration:** `emporia_vue` (HACS) | **Account:** Customer 233316 | **Device:** VUE003 (Vue3-812 firmware)

The Emporia Vue whole-home energy monitor is installed on the main panel. The system uses a single VUE003 unit with multiple CT clamp circuits.

### Monitored Circuits

| Circuit | Device Name | Area |
|---|---|---|
| Main Panel (whole home) | Cornell Vue | (unassigned) |
| Main Floor Plugs | Main Floor Plugs | Living Room |
| Hot Water Heater / HRV | Hot water Heater/HRV | Basement |
| Furnace | Furnace | Basement |
| AC | AC | Basement |
| 2nd Floor Plugs | 2nd Floor Plugs | Media Room |
| Washer | Washer | Laundry Room |
| Kitchen Appliances | Kitchen Appliances | Kitchen |
| Microwave | Microwave | Kitchen |
| Stove | Stove | Kitchen |
| Fridge | Fridge | Kitchen |
| Kitchen Plugs | Kitchen Plugs | Kitchen |
| Kitchen Plug | Kitchen Plug | Kitchen |
| Dishwasher | Dishwasher | Kitchen |
| Dryer | Dryer | Laundry Room |
| Balance (remaining) | Balance | (unassigned) |
| Third Floor Plugs | Third Floor Plugs | Office |
| Main Floor Lights | Main Floor Lights | Living Room |

> The Kitchen has the most granular monitoring: 7 individual circuits (appliances + plugs).

### Key Entities

Each Emporia circuit exposes power (`sensor.*.power`) and energy (`sensor.*.energy_today`) sensors.

Notable:
- `sensor.cornell_vue_energy_today` — daily whole-home energy usage
- `sensor.ac_power` — HVAC power draw
- `sensor.furnace_power` — heating power

---

## CO2 Signal (Electricity Maps)

**Integration:** `co2signal` | **Device:** Electricity Maps

Provides real-time electricity grid carbon intensity data for the Ontario grid region.

| Entity | Notes |
|---|---|
| `sensor.electricity_maps_*` | Grid carbon intensity (gCO2eq/kWh) |

Useful for automations that shift non-essential loads to low-carbon grid hours.

---

## Ontario Energy Board

**Integration:** `ontario_energy_board` (HACS) | **Authors:** jrfernandes, n3rdp1um23

Provides Ontario Time-of-Use (TOU) electricity pricing data:
- On-peak, mid-peak, off-peak rate selectors
- Schedule-aware — useful for automations that avoid running high-draw appliances during on-peak hours

---

## Notes / Gotchas

- The Emporia Vue uses a cloud API — if Emporia cloud is down, data will be unavailable. Historical data is stored in HA's recorder database.
- For long-term storage and visualization, Emporia data flows into **InfluxDB** (add-on) and is visualized in **Grafana** (add-on).
- The HA Energy dashboard can be configured to use `sensor.cornell_vue_energy_today` as the grid consumption source.

## Last Updated

2026-06-24

# Infrastructure Integrations — AdGuard, Tailscale, MQTT, ESPHome, NUT

## AdGuard Home

**Integration:** `adguard` | **Add-on:** AdGuard Home v6.2.0 (add-on), integration v6.1.3 | **Area:** Office

Network-wide DNS-based ad and tracker blocking. All DNS queries on the home network route through AdGuard.

**AdGuard version:** v0.107.74

| Entity | Notes |
|---|---|
| `switch.adguard_home_protection` | Master toggle |
| `switch.adguard_home_parental_control` | Parental controls |
| `switch.adguard_home_safe_search` | Safe search enforcement |
| `switch.adguard_home_safe_browsing` | Phishing/malware protection |
| `switch.adguard_home_filtering` | DNS filter list |
| `switch.adguard_home_query_log` | Query logging |
| `sensor.adguard_home_dns_queries_blocked_ratio` | % of queries blocked |

---

## Tailscale

**Add-on:** Tailscale v0.28.1 | **Integration:** via hassio

Zero-config WireGuard-based mesh VPN. Provides secure remote access to HA and the home network from anywhere without port forwarding.

> Tailscale is not exposed as HA entities — it runs as a network-level service. HA can be accessed via the Tailscale IP from any connected device.

---

## MQTT (Mosquitto Broker)

**Integration:** `mqtt` | **Add-on:** Mosquitto broker v7.1.0 | **Entry:** `01KHEMPP6F5Y28VAB029MPY33M`

The local MQTT broker is the backbone for:
- Zigbee2MQTT device communication
- ESPHome device telemetry
- Frigate NVR events

**Zigbee2MQTT** publishes all Zigbee device state to MQTT topics (`zigbee2mqtt/<device_name>/...`).

| Entity | Notes |
|---|---|
| `sensor.zigbee2mqtt_bridge_signal_level` | Bridge signal |
| `binary_sensor.zigbee2mqtt_bridge_connection_state` | Bridge online |
| `switch.zigbee2mqtt_bridge_permit_join` | Pairing mode |

---

## ESPHome

**Integration:** `esphome` | **2 devices**

| Device | Firmware | Area |
|---|---|---|
| ratgdov2.5i e4d21f | ESPHome 2023.12.9 | Garage |
| Home Assistant Voice 0919e8 | ESPHome 2026.3.2 | Bedroom |

ESPHome devices communicate over local LAN via the native API — no MQTT required.

---

## Network UPS Tools (NUT)

**Integration:** `nut` | **Add-on:** Network UPS Tools v0.18.0 | **Host:** a0d7b954-nut:3493

Monitors the CPS CP1500AVRLCD UPS in the Media Room.

| Entity | Notes |
|---|---|
| `sensor.media_room_ups_load` | UPS load % |
| `sensor.media_room_ups_battery_charge` | Battery % |
| `sensor.media_room_ups_battery_runtime` | Estimated runtime |
| `sensor.media_room_ups_input_voltage` | Grid input voltage |
| `sensor.media_room_ups_output_voltage` | UPS output voltage |

**Automation:** `UPS Power Outage Notification` triggers when UPS switches to battery.

---

## go2rtc

**Integration:** `go2rtc` (system) | **Status:** loaded

Camera stream proxying and WebRTC support for the HA frontend and Lovelace dashboards. Enables low-latency camera card viewing.

---

## Chrony (NTP)

**Add-on:** chrony v6.0.1

Local NTP server for IP cameras. Cameras should point to the HA host IP as their NTP server to stay time-synchronized for accurate event timestamps.

---

## Version Monitoring

Two `version` integration entries track HA version:
- `Current Version` — tracks the installed HA Core version
- `Docker Hub` — tracks the latest available version (for update notifications)

**Entity:** `binary_sensor.home_assistant_version_docker_hub_update_available`

---

## InfluxDB & Grafana

**Add-ons:** InfluxDB v5.0.2 | Grafana v12.1.0

Long-term time-series storage (InfluxDB) and visualization (Grafana) for HA sensor data. Configured separately from HA's built-in recorder. Provides historical energy, climate, and sensor dashboards beyond what the HA frontend offers.

---

## iBeacon Tracker

**Integration:** `ibeacon` | **Status:** loaded

Passive BLE iBeacon tracking. Multiple `TELEMATIC-*` and vehicle-related iBeacon devices are detected in the environment (Rivian Phone Key, NIU scooter, vehicle telematics).

> Most iBeacon devices visible in the registry are external/neighbouring devices detected passively, not intentionally tracked assets. The Rivian Phone Key (`Rivian Phone Key DEEC`) is the most relevant.

---

## Mobile App

**Integration:** `mobile_app` | **3 registered devices**

| Device | Model | OS |
|---|---|---|
| Iceheart | iPhone 17 Pro | iOS 26.5 |
| Bacta (iPad) | iPad Pro (iPad16,2) | iPadOS 26.5 |
| Krytos (iPad) | iPad (iPad11,1) | iPadOS 26.3 |

Provides:
- Presence detection (`device_tracker.*`)
- Push notifications via `notify.iceheart` / `notify.mobile_app_*`
- Sensor data (battery, focus mode, location)

**Automation:** Multiple automations use `notify.mobile_app_iceheart` for push notifications.

---

## IFTTT

**Integration:** `ifttt` | **Title:** IFTTT Webhook

Provides IFTTT webhook trigger capability. A button entity (`jeeves5454@gmail.com IFTTTrigger-2 is pressed`) is exposed for IFTTT-initiated actions.

---

## Pushover

**Integration:** `pushover` | **Status:** loaded

Push notification service as an alternative to the mobile app. Used for alerts where broader notification reach is needed.

---

## Notes / Gotchas

- Mosquitto, Zigbee2MQTT, and MQTT integration must all be running for Zigbee to work. If any component restarts, the others may need re-initialization.
- NUT add-on version in the device registry shows v0.18.0 — this reflects the add-on version installed; the actual nut package may be newer.
- InfluxDB and Grafana are community add-ons (a0d7b954 repository) — they receive updates separately from core HA.

## Last Updated

2026-06-24

# Lighting Integrations — Lutron Caseta, Philips Hue, Govee

## Lutron Caseta

**Integration:** `lutron_caseta` | **Hub:** Smart Bridge 2 (L-BDGPRO2-WH) | **Area:** Media Room (hub location)

Lutron Caseta is the primary wired lighting control system in the home, covering dimmers and switches across all floors.

### Devices (14 Lutron devices)

| Device | Model | Area |
|---|---|---|
| Smart Bridge 2 (hub) | L-BDGPRO2-WH (SmartBridge) | Media Room |
| Master Bedroom Lights | DVRF-6L (DivaSmartDimmer) | Bedroom |
| Guest Bedroom Lights | DVRF-6L | Guest Bedroom |
| Upstairs Hallway Lights | DVRF-6L | Upstairs Hallway |
| Kitchen Lights | DVRF-6L | Kitchen |
| Kitchen Under Cabinet | DVRF-6L | Kitchen |
| Hallway Lights | DVRF-6L | Hallway |
| Garage Lights | PD-8ANS-XX (WallSwitch) | Garage |
| Basement Lights | PD-8ANS-XX (WallSwitch) | Basement |
| Living Room Main Spot Lights | DVRF-6L | Living Room |
| Living Room Powder Room Entry | DVRF-6L | Living Room |
| Living Room Pendants | DVRF-6L | Patio |
| Office Lights | DVRF-6L | Office |
| Bar Spot Lights | DVRF-6L | Bar |
| Kitchen Cabinet Pico | PJ2-1P-GXX (PaddleSwitchPico) | Kitchen |
| Kitchen Pico 1 | PJ2-1P-GXX | Kitchen |
| Hallway Pico | PJ2-1P-GXX | Hallway |
| Master Bedroom Pico | PJ2-3BRL-GXX-X01 (Pico3ButtonRaiseLower) | Bedroom |
| Guest Bedroom Pico | PJ2-1P-GXX | Guest Bedroom |
| Living Room Pico | PJ2-3BRL-GXX-X01 | Living Room |

### Lutron Scenes (Smart Bridge 2)
Night · Notifications · Garage · Off garage · Movie downstairs

### Notes
- Garage Lights and Basement Lights are exposed as `switch` entities and then wrapped as `light` entities via the `switch_as_x` integration.
- The Smart Bridge 2 also exposes a "Smart Away" switch that randomly turns lights on/off when away.

---

## Philips Hue

**Integration:** `hue` | **Hub:** Jeeves Hue Bridge (fw 1.77.1977138000) | **Area:** Hub unassigned

The Hue ecosystem covers the Media Room almost exclusively — providing full RGBW color lighting, scenes, and entertainment sync.

### Devices (11 Hue lights + dimmer + 2 rooms + bridge)

| Device | Model | Area |
|---|---|---|
| Jeeves Hue Bridge | Hue Bridge | (hub — no area) |
| Color Lamp 1 | Hue color lamp | Media Room |
| Color Lamp 2 | Hue color lamp | Media Room |
| Colour Lamp 3 | Hue color lamp | Media Room |
| Hue color lamp 2 | Hue color lamp | Media Room |
| Ceiling White Lamp 1 | Hue white lamp | Media Room |
| Ceiling White Lanp 2 | Hue white lamp | Media Room |
| Media Room Ceiling Lamp 3 | Hue white lamp | Media Room |
| Hue play 1 | Hue play (gradient) | Media Room |
| Hue play 2 | Hue play (gradient) | Media Room |
| Hue bloom 1 | Hue bloom | Media Room |
| Hue dimmer switch 2 | Hue dimmer switch (fw 2.85.1) | Media Room |
| Media room (Hue Room) | Room group | Media Room |
| Basement (Hue Room) | Room group | Basement |
| Basement Entryway | Hue white lamp | Basement |

### Hue Scenes (18 Media Room scenes)
Tropical twilight · Relax · Energize · Read · Bright · Rio · Nightlight · Concentrate · Epic Movie Night · Dimmed · Savanna sunset · Movie Night · Arctic aurora

### Notes
- `Jeeves Hue Entertainment area 1` binary sensor tracks active Hue Entertainment mode (game/movie sync).
- Two Hue automations (`Hue dimmer switch 2`, `Leaving home`) are managed in the Hue app but visible in HA as switch entities.

---

## Govee

**Integration:** `govee` (Cloud) + `govee_ble` (Bluetooth) | **Area:** Bar

### Govee Cloud Devices

| Device | Model | Area |
|---|---|---|
| UnderBar Lights | H6159 (LED strip) | Bar |
| Bar Bulb 1 | H6008 (color bulb) | Bar |
| Bar Bulb 2 | H6008 (color bulb) | Bar |

**Features:** Full RGB color, brightness, Music Mode (audio-reactive lighting).

### Govee BLE Sensors

| Device | Model | Area |
|---|---|---|
| H5075 0409 | Govee H5075 (Temp/Humidity) | Bar |
| H5075 9768 | Govee H5075 (Temp/Humidity) | Bar |

These use Bluetooth LE and connect via the host's Realtek Bluetooth adapter.

### Notes
- Govee cloud integration has a pending HACS update (v2026.6.20) — restart required.
- Govee BLE sensors are independent of the cloud integration and unaffected by the update.
- Music Mode is a switch entity per device; when on, the light syncs to ambient audio via the Govee cloud.

## Last Updated

2026-06-24

# Matter & Aqara

## Overview

Matter is handled by the **Matter Server add-on** (v9.0.2). The Aqara ecosystem provides the majority of Matter-bridged devices — two hubs bridge 15+ Aqara devices (water leak sensors, motion sensors, smart locks, wireless switch, temp/humidity sensor) into Home Assistant.

## Matter Hubs

| Hub | Model | Firmware | Purpose |
|---|---|---|---|
| Aqara Hub M2 | Aqara Hub M2 | 4.3.8 | Primary bridge hub (most devices) |
| Aqara Camera Hub G3 | Aqara Camera Hub G3 | 4.5.30 | Secondary bridge + camera |

Both hubs act as Thread/Matter border routers and connect to HA via the Matter integration.

## Matter Devices

### Via Aqara Hub M2

| Device | Model | Area |
|---|---|---|
| Aqara Water Leak Sensor (×4) | Aqara Water Leak Sensor (sw v6) | (unassigned — multiple locations) |
| Garage Smart Lock | Aqara Smart Lock U100 (sw 31) | Garage |

### Via Aqara Camera Hub G3

| Device | Model | Area |
|---|---|---|
| Aqara Water Leak Sensor (×2) | Aqara Water Leak Sensor (sw v6) | (unassigned) |
| Guest Bathroom Water Leak Sensor | Aqara Water Leak Sensor (sw v6) | Guest Bathroom |
| Bedroom Temp / Humidity Sensor | Aqara Temp/Humidity Sensor (sw v5) | Bedroom |
| Aqara Wireless Mini Switch | Aqara Wireless Mini Switch (sw v2) | (unassigned) |
| Upstairs Motion Sensor | Aqara Motion Sensor P1 (sw v10) | Upstairs Hallway |
| Garage Motion Sensor | Aqara Motion Sensor P1 (sw v10) | Garage |
| Kitchen Smart Lock | Aqara Smart Lock U100 (sw 300) | Kitchen |
| Downstairs Motion Sensor | Aqara Motion Sensor P1 (sw v10) | Media Room |
| Hallway Aqara Motion Sensor P1 | Aqara Motion Sensor P1 (sw v10) | Hallway |

## Key Entity Types

### Water Leak Sensors
Each sensor provides:
- `binary_sensor.*.water_leak` — triggers `Water Leak Alert` automation
- Battery sensors (CR2032 type, voltage, %)

**Deployed locations:** multiple bathroom, kitchen, utility areas (exact sensor-to-location mapping should be labelled on the physical devices).

### Motion Sensors (Aqara P1)
Each provides:
- `binary_sensor.*.occupancy` — used in motion lighting automations
- Battery sensors

| Sensor | Area | Automation |
|---|---|---|
| Upstairs Motion Sensor | Upstairs Hallway | Motion Activation Upstairs Hallway 2 |
| Garage Motion Sensor | Garage | Motion Activation Garage |
| Downstairs Motion Sensor | Media Room | — |
| Hallway Aqara Motion Sensor P1 | Hallway | Motion Activation Hallway Lights |

### Smart Locks (Aqara U100)

| Lock | Area | State |
|---|---|---|
| Kitchen Smart Lock | Kitchen | locked |
| Garage Smart Lock | Garage | unlocked |

Both provide:
- `lock.*` control entity
- `binary_sensor.*_actuator` — physical bolt status
- Operating mode selector

**Automation:** `Smart Lock Unlocked 30 Min Alert` monitors all locks.

### Wireless Mini Switch (Aqara)
- `event.aqara_wireless_mini_switch_button` — single, double, long press events
- Area: unassigned (portable button)

## Thread

The Thread integration is loaded (entry: `890ec7b4`) and supports Thread networking. The Aqara hubs function as Thread border routers, enabling Thread-based device connectivity in future expansions.

## Notes / Gotchas

- If either Aqara hub goes offline, all devices bridged through it become unavailable in HA. The Hub M2 and Hub G3 are both critical infrastructure.
- The 4 unassigned water leak sensors should be physically labelled and area-assigned in HA (Settings → Devices) to improve observability.
- Kitchen Smart Lock shows `sw v300` while Garage Smart Lock shows `sw v31` — different firmware tracks (U100 has multiple hardware revisions).

## Last Updated

2026-06-24

# Overview - Integrations

## Overview

97 integrations are configured in Home Assistant. 90 are loaded successfully, 5 are in `setup_retry`, and 2 are `not_loaded`. This page provides a complete inventory table.

## State Summary

| State | Count |
|---|---|
| loaded | 90 |
| setup_retry | 5 |
| not_loaded | 2 |

## Integration Inventory

| Integration | Title | Domain | State | Source |
|---|---|---|---|---|
| Sun | Sun | sun | loaded | import |
| Google Cast | Google Cast | cast | loaded | zeroconf |
| Shopping List | Shopping list | shopping_list | loaded | onboarding |
| Google Translate TTS | Google Translate TTS | google_translate | loaded | onboarding |
| Met.no Weather | Home | met | loaded | onboarding |
| Radio Browser | Radio Browser | radio_browser | loaded | onboarding |
| Lutron Caseta | 067cfcc8 | lutron_caseta | loaded | zeroconf |
| Bond | My Bridge | bond | loaded | zeroconf |
| Philips Hue | Hue Bridge 00178826a08c | hue | loaded | zeroconf |
| ecobee | ecobee | ecobee | loaded | user |
| SpeedTest | SpeedTest | speedtestdotnet | loaded | user |
| Uptime | Uptime | uptime | loaded | user |
| Home Assistant iOS | Home Assistant iOS | ios | loaded | user |
| IFTTT | IFTTT Webhook | ifttt | loaded | user |
| Version (Core) | Current Version | version | loaded | user |
| Version (Docker) | Docker Hub | version | loaded | user |
| DLNA DMS | Lusankya (×3) | dlna_dms | loaded | ssdp |
| DLNA DMS | Giga Hub | dlna_dms | loaded | ssdp |
| DLNA DMS | HDHomeRun DMS | dlna_dms | loaded | ssdp |
| Android TV Remote | BRAVIA 4K UR2 | androidtv_remote | loaded | zeroconf |
| HACS | — | hacs | loaded | user |
| SmartThinQ Sensors | LGE Devices | smartthinq_sensors | **setup_retry** | user |
| Google Calendar | jeeves5454@gmail.com | google | loaded | user |
| Local Calendar | 2074 Donald Cousens House Calendar | local_calendar | loaded | user |
| Local Calendar | Car Service | local_calendar | loaded | user |
| Local Calendar | Markham House Things | local_calendar | loaded | user |
| TP-Link | Smart Plug KP401 | tplink | loaded | user |
| TP-Link | Basement Switch 2 KS205 | tplink | loaded | integration_discovery |
| TP-Link | Living Room Lamp Switch KS205 | tplink | loaded | integration_discovery |
| TP-Link | Porch KS205 | tplink | loaded | integration_discovery |
| TP-Link | Christmas Plug KP125M | tplink | loaded | integration_discovery |
| TP-Link | Bathroom Towel Heater KS205 | tplink | loaded | integration_discovery |
| TP-Link | Bathroom Shower Switch KS205 | tplink | loaded | integration_discovery |
| TP-Link | Backyard Light KS205 | tplink | loaded | integration_discovery |
| TP-Link | Bar Sign KP125M | tplink | loaded | integration_discovery |
| TP-Link | New Christmas Switch HS103 | tplink | **setup_retry** | integration_discovery |
| TP-Link | 2774 KS220M | tplink | **not_loaded** (ignored) | ignore |
| TP-Link | None EP40M | tplink | **setup_retry** | integration_discovery |
| GE Home | jeeves5454@gmail.com | ge_home | loaded | user |
| Midea Dehumidifier LAN | Midea Air Appliance | midea_dehumidifier_lan | loaded | user |
| Emporia Vue | Customer 233316 | emporia_vue | loaded | user |
| CO2 Signal | CO2 Signal | co2signal | loaded | user |
| Mobile App | Iceheart | mobile_app | loaded | registration |
| Mobile App | iPad (Bacta) | mobile_app | loaded | registration |
| Mobile App | Rajeev's iPad (Krytos) | mobile_app | loaded | registration |
| go2rtc | go2rtc | go2rtc | loaded | system |
| ESPHome | ratgdov2.5i e4d21f | esphome | loaded | zeroconf |
| ESPHome | Home Assistant Voice 0919e8 | esphome | loaded | zeroconf |
| Backup | Backup | backup | loaded | system |
| Orbit BHyve | jeeves5454@gmail.com | bhyve | loaded | user |
| Motionblinds | Motionblinds Gateway | motion_blinds | loaded | user |
| Supervisor (HA OS) | Supervisor | hassio | loaded | system |
| AdGuard Home | AdGuard Home | adguard | loaded | hassio |
| Bluetooth | Realtek (40:9C:A7:99:40:DF) | bluetooth | loaded | integration_discovery |
| Govee BLE | H5075 0409 | govee_ble | loaded | bluetooth |
| Govee BLE | H5075 9768 | govee_ble | loaded | bluetooth |
| Matter | Matter | matter | loaded | user |
| iBeacon Tracker | iBeacon Tracker | ibeacon | loaded | bluetooth |
| Ollama | http://192.168.1.85:11434 | ollama | loaded | user |
| Xbox | jeeves54 | xbox | loaded | dhcp |
| ZHA | HA Connect ZBT-1 | zha | **not_loaded** (disabled by user) | hardware |
| switch_as_x | Garage Lights | switch_as_x | loaded | user |
| switch_as_x | Basement Lights | switch_as_x | loaded | user |
| switch_as_x | porch | switch_as_x | loaded | user |
| Wyoming | Whisper | wyoming | loaded | hassio |
| Wyoming | Speech-to-Phrase | wyoming | loaded | hassio |
| Wyoming | Piper | wyoming | loaded | hassio |
| Wyoming | openWakeWord | wyoming | loaded | hassio |
| Music Assistant | Music Assistant | music_assistant | loaded | hassio |
| Apple TV | Living Room | apple_tv | loaded | zeroconf |
| Govee | Govee (Cloud) | govee | loaded | user |
| LetPot | jeeves5454@gmail.com | letpot | **setup_retry** | user |
| SmartThings | My home | smartthings | loaded | user |
| Eufy Security | 127.0.0.1 | eufy_security | loaded | user |
| WebRTC Camera | WebRTC Camera | webrtc | loaded | user |
| IPP Printer | Xerox B205 | ipp | **setup_retry** | zeroconf |
| MQTT | Mosquitto broker | mqtt | loaded | hassio |
| YoLink | YoLink | yolink | loaded | user |
| VLC Telnet | core-vlc | vlc_telnet | loaded | hassio |
| Alexa Devices | jeeves5454@gmail.com | alexa_devices | loaded | user |
| Pushover | Pushover | pushover | loaded | user |
| Reolink | Driveway | reolink | loaded | dhcp |
| Reolink | Front Yard | reolink | loaded | dhcp |
| iQua Softener | RHW4221-24178-4056 | iqua_softener | loaded | user |
| Home Assistant Cloud | Home Assistant Cloud | cloud | loaded | system |
| Thread | Thread | thread | loaded | zeroconf |
| Samsung TV | Living room tv (QN55LS03BAFXZC) | samsungtv | loaded | zeroconf |
| Samsung TV Smart | Samsung Frame 55 | samsungtv_smart | loaded | user |
| DLNA DMR | Living room tv | dlna_dmr | loaded | ssdp |
| DLNA DMR | BRAVIA 4K UR2 | dlna_dmr | loaded | ssdp |
| Dyson Local | Pure Hot+Cool Link | dyson_local | loaded | user |
| HA Connect ZBT-2 | HA Connect ZBT-2 | homeassistant_connect_zbt2 | loaded | usb |
| NUT | a0d7b954-nut:3493 | nut | loaded | user |
| Template | Outdoor Humidity | template | loaded | user |
| Analytics | Analytics | analytics | loaded | system |
| Zigbee2MQTT | (via MQTT) | zigbee2mqtt | loaded | mqtt |
| ZHA (secondary) | HA Connect ZBT-2 | zha | loaded | hardware |

## HACS Custom Integrations

The following integrations are installed via HACS (not built-in):

| Name | Author | Notes |
|---|---|---|
| SmartThinQ Sensors | ollo69 | LG washer/dryer/fridge |
| SamsungTV Smart | jaruba, ollo69 | Samsung Frame 55 |
| Emporia Vue | magico13 | Energy monitoring |
| GE Home (SmartHQ) | simbaja | GE Oven |
| Midea Air Appliances (LAN) | nbogojevic | Dehumidifier |
| Ontario Energy Board | jrfernandes, n3rdp1um23 | Energy tariff data |
| Dyson (local) | libdyson-wg et al | Dyson Pure Hot+Cool |
| Eufy Security | fuatakgun | Camera system |
| Alexa Media Player | alandtse, keatontaylor | Alexa integration |
| Orbit BHyve | sebr | Irrigation |
| iQua Softener | mutilator et al | Water softener |
| WiCAN | jay-oswald | Vehicle CAN bus |
| Epic Games | hudsonbrendon | Game library |
| Govee Cloud | lasswellt | Govee lighting |

## HACS Frontend Plugins

| Name | Author |
|---|---|
| Bubble Card | Clooos |
| Slider Button Card | custom-cards |
| Comfortable Environment Card | argaar |
| Keep Texts in Tabs | elchininet |
| Weather Chart Card | mlamberts78 |
| Energy Sankey Card | davet2001 |
| Zigbee2mqtt Networkmap Card | azuwis |
| TrashCard | idaho |

## Last Updated

2026-06-24

# Security & Cameras — Eufy, Reolink, Frigate

## Overview

The home has a comprehensive security camera system combining **Eufy Security** (indoor/outdoor cameras + doorbells) and **Reolink** (PoE floodlight cameras), processed locally by **Frigate NVR** (add-on v0.17.1). All cameras stream via go2rtc (built-in) and WebRTC.

## Camera Inventory

| Camera | Manufacturer | Model | Integration | Area |
|---|---|---|---|---|
| Living Room | Eufy Security | T8416 | eufy_security | Basement* |
| Basement | Eufy Security | T8410 | eufy_security | Basement* |
| Backyard | Eufy Security | T8424 | eufy_security | Backyard |
| Garage | Eufy Security | T8441 | eufy_security | Garage |
| Front Door | Eufy Security | T8530 | eufy_security | (unassigned) |
| Back door doorbell | Eufy Security | T8214 | eufy_security | (unassigned) |
| Front Doorbell Chime | Eufy Security | T8021 | eufy_security | (unassigned) |
| Driveway | Reolink | Elite Pro Floodlight PoE | reolink | Garage |
| Front Yard | Reolink | E1 Outdoor SE PoE | reolink | Front Yard |

*Living Room (T8416) and Basement (T8410) cameras are physically in those rooms but associated with the Eufy HomeBase in the Basement.

---

## Eufy Security

**Integration:** `eufy_security` (HACS) | **Host:** 127.0.0.1 | **Add-on:** eufy-security-ws v3.0.1

The Eufy integration connects via the local WebSocket server (eufy-security-ws add-on), providing camera streams and sensor data without relying on cloud.

### Infrastructure

| Device | Model | Firmware |
|---|---|---|
| Eufy HomeBase | T8030 | 3.8.3.4 |
| Eufy Passport | T87B2 | 1.5.6 |

> The HomeBase is the central hub for all Eufy cameras. It must be running for any Eufy entity to be available.

### Per-Camera Features

Each Eufy camera exposes:
- `camera.*` — live stream
- `image.*.event_image` — last motion event snapshot
- `alarm_control_panel.*` — arm/disarm (all currently `armed_home`)
- Motion detection switches (Human, Pet, Vehicle, etc.)
- Notification switches (Person, Pet, Crying, Sound)
- RTSP stream switch
- Microphone / Speaker switches (where applicable)
- Audio Recording switch

### Doorbells

| Device | Model | Notes |
|---|---|---|
| Front Door | T8530 | Video doorbell; Front Yard area |
| Back door doorbell | T8214 | Video doorbell; Back door |
| Front Doorbell Chime | T8021 | Wireless chime; `alarm_control_panel.front_doorbell_chime` |

---

## Reolink

**Integration:** `reolink` (native HA) | **Source:** DHCP discovery

### Driveway Camera

- **Model:** Elite Pro Floodlight PoE
- **Firmware:** v3.2.0.5932_2601201959
- **Area:** Garage
- Entities: Driveway Fluent (RTSP), Driveway Floodlight, Driveway Siren, Driveway Volume, Vehicle/Person/Pet binary sensors, Infrared mode, AI Detection type selector, Motion sensitivity number

### Front Yard Camera

- **Model:** E1 Outdoor SE PoE
- **Firmware:** v3.1.0.5223_2510172104
- **Area:** Front Yard
- Entities: Front Yard Camera, Floodlight, Siren, Auto tracking, Guard return, AI detection, Motion sensitivity, FTP/Email/Push notification switches

---

## Frigate NVR

**Add-on:** `ccab4aaf_frigate` v0.17.1 | **State:** started

Frigate provides local real-time object detection for IP cameras using hardware-accelerated inference. It integrates with HA via the MQTT integration and the `frigate` integration (HACS).

> Frigate configuration (cameras, detectors, zones, objects) is managed in the Frigate add-on config file, not in HA directly.

---

## go2rtc & WebRTC

**go2rtc** is a built-in HA integration (system) that provides camera stream proxying, RTSP-to-WebRTC conversion, and low-latency viewing in the HA frontend.

**WebRTC Camera** (HACS, AlexxIT) provides enhanced WebRTC card support for dashboards.

---

## Notes / Gotchas

- All Eufy cameras depend on the HomeBase. Power-cycle or network loss of the HomeBase will take all Eufy entities offline simultaneously.
- Front Door (T8530) and Back Door Doorbell (T8214) have no area assignment — these should be added to appropriate areas for better dashboard organization.
- Reolink cameras are discovered via DHCP — ensure they have static IP reservations in the router to prevent config entry issues after reboots.
- The Eufy integration uses a local WebSocket bridge (eufy-security-ws) — avoid using the Eufy cloud app to log out or change account settings, as this can invalidate the local bridge credentials.

## Last Updated

2026-06-24

# Voice & AI Integrations

## Overview

The home runs a fully **local voice pipeline** using HA's Assist framework. All components — wake word detection, speech-to-text, text-to-speech, and LLM conversation — run on local hardware with no cloud dependency. HA Cloud is also configured as a fallback/alternative.

## Voice Pipeline Architecture

```
Microphone (HA Voice PE)
       ↓
Wake Word: openWakeWord
       ↓
STT: Whisper (local) or Speech-to-Phrase (local) or HA Cloud
       ↓
Intent / LLM: Home Assistant Assist OR Ollama (qwen3:4b)
       ↓
TTS: Piper (local) or Google Translate or HA Cloud
       ↓
Speaker (HA Voice PE)
```

---

## Hardware

### Home Assistant Voice PE

**Device:** Home Assistant Voice 0919e8 | **Manufacturer:** Nabu Casa | **Model:** Home Assistant Voice PE | **ESPHome:** 2026.3.2 | **Area:** Bedroom

The dedicated voice satellite device for local Assist.

| Entity | Notes |
|---|---|
| `assist_satellite.home_assistant_voice_0919e8_assist_satellite` | Satellite control |
| `media_player.home_assistant_voice_0919e8` | Audio playback |
| `light.home_assistant_voice_0919e8_led_ring` | LED ring indicator |
| `switch.home_assistant_voice_0919e8_mute` | Microphone mute |
| `switch.home_assistant_voice_0919e8_wake_sound` | Chime on wake |
| `event.home_assistant_voice_0919e8_button_press` | Physical button |
| `select.home_assistant_voice_0919e8_assistant_2` | Pipeline selector |

---

## Wake Word Detection

**Add-on:** openWakeWord v2.1.0 | **Wyoming protocol**

openWakeWord is an open-source wake word detection library. It processes the audio stream locally to detect activation phrases before sending to STT.

| Integration | Entry |
|---|---|
| `wyoming` (openWakeWord) | `01KSAJTKT9G4SPH8F262Y0R656` |

**Entity:** `wake_word.openwakeword`

---

## Speech-to-Text (STT)

Two local STT options + HA Cloud:

| Option | Add-on | Version | Notes |
|---|---|---|---|
| **Whisper** | core_whisper | 3.2.0 | General-purpose neural STT |
| **Speech-to-Phrase** | core_speech-to-phrase | 1.4.3 | Fast, intent-optimized local STT |
| **HA Cloud** | — | — | Nabu Casa cloud fallback |

**Recommended:** Speech-to-Phrase for speed; Whisper for accuracy with free-form speech.

---

## Text-to-Speech (TTS)

| Option | Add-on | Notes |
|---|---|---|
| **Piper** | core_piper v2.2.2 | Local neural TTS (English) |
| **Google Translate** | — | Cloud TTS (en-com) |
| **HA Cloud** | — | Nabu Casa cloud TTS |

**Entity:** `tts.piper`, `tts.google_translate_en_com`, `tts.home_assistant_cloud`

---

## Conversation / LLM

### Home Assistant (Assist)
**Entity:** `conversation.home_assistant` — built-in intent recognition for HA commands.

### Ollama (Local LLM)
**Integration:** `ollama` | **Host:** http://192.168.1.85:11434 | **Model:** qwen3:4b-instruct | **Firmware:** 4b-instruct

Ollama runs a local LLM on the home server at 192.168.1.85. The `qwen3` model (4B parameters, instruction-tuned) handles natural language conversations and complex commands beyond Assist's built-in intents.

**Entity:** `conversation.ollama_conversation`

> The Ollama server at 192.168.1.85 must be running for this conversation agent to be available. HA Assist falls back to the built-in agent if Ollama is unreachable.

---

## Home Assistant Cloud (Nabu Casa)

**Integration:** `cloud` | **Status:** loaded

Nabu Casa Cloud provides:
- Remote access (no port forwarding required)
- Cloud STT/TTS as fallbacks
- Google Assistant / Amazon Alexa voice control relay (if configured)
- Webhook relay for IFTTT and mobile notifications

---

## Notes / Gotchas

- The `select.home_assistant_voice_0919e8_assistant_2` entity allows switching the Voice PE between different conversation pipelines (e.g., Assist built-in vs Ollama).
- Whisper accuracy improves with higher model variants — the add-on may be configured with a small model for speed; check the add-on config for model selection.
- Speech-to-Phrase is purpose-built for HA commands and significantly faster than Whisper for home control tasks.
- Google Translate TTS requires internet access; Piper works fully offline.

## Last Updated

2026-06-24

# Zigbee — Zigbee2MQTT + ZHA + HA Connect ZBT-2

## Overview

Zigbee is the primary short-range wireless protocol for sensors and smart plugs. The home uses a single **HA Connect ZBT-2** USB stick as the Zigbee coordinator, running **Zigbee2MQTT** (the primary active stack). ZHA is also installed but is **disabled by the user** to avoid coordinator conflicts.

## Hardware

| Component | Details |
|---|---|
| Coordinator | Home Assistant Connect ZBT-2 (Nabu Casa) |
| IEEE Address | `44:e2:f8:ff:fe:8c:7d:98` |
| Firmware | EmberZNet Zigbee 7.5.1.0 |
| Active Stack | Zigbee2MQTT 2.12.0 |
| Disabled Stack | ZHA (disabled_by: user) |

## Zigbee2MQTT

**Add-on version:** 2.12.0-1 | **Bridge device:** `723747744690709ec853190a975e567b`

Zigbee2MQTT communicates via the **Mosquitto MQTT broker** add-on. All Zigbee device data flows through MQTT topics.

### Zigbee2MQTT Devices

| Device | Manufacturer | Model | Area |
|---|---|---|---|
| Zigbee2MQTT Bridge | Zigbee2MQTT | Bridge | (system) |
| Bedroom Gen1 Soil Sensor | Third Reality | Smart Soil Moisture Sensor | (unassigned) |
| Living Room Gen1 Soil Sensor | Third Reality | Smart Soil Moisture Sensor | (unassigned) |
| Media Room Gen1 Soil Sensor | Third Reality | Smart Soil Moisture Sensor | (unassigned) |
| Outdoor1 Gen2 Soil Sensor | Third Reality | Smart Soil Moisture Sensor Gen2 | (unassigned) |
| Outdoor2 Gen2 Soil Sensor | Third Reality | Smart Soil Moisture Sensor Gen2 | (unassigned) |
| Outdoor3 Gen2 Soil Sensor | Third Reality | Smart Soil Moisture Sensor Gen2 | (unassigned) |
| Generic Gen2 Soil Sensor | Third Reality | Smart Soil Moisture Sensor Gen2 | (unassigned) |
| Living Room 4 Button Switch | Tuya | Wireless 4-button switch | Living Room |
| Christmas Lights Living Room | Third Reality | Zigbee/BLE smart plug | (unassigned) |
| Upstairs Hallway Switch | Third Reality | Zigbee/BLE smart plug | (unassigned) |

**Bridge entities:**
- `switch.zigbee2mqtt_bridge_permit_join` — enable Zigbee device pairing
- `binary_sensor.zigbee2mqtt_bridge_connection_state`
- `sensor.zigbee2mqtt_bridge_signal_level` (Bar Shelves sensor)

### Soil Sensors

Third Reality soil moisture sensors are the backbone of the **Plants dashboard**. They report temperature, humidity, and soil moisture levels.

| Sensor | Generation | IEEE |
|---|---|---|
| Bedroom Gen1 | Gen1 (3RSM0147Z) | `0xffffb40e0605ce4d` |
| Living Room Gen1 | Gen1 (3RSM0147Z) | `0xffffb40e0605cc50` |
| Media Room Gen1 | Gen1 (3RSM0147Z) | `0xffffb40e0605e062` |
| Outdoor1 Gen2 | Gen2 | `0x7c3e82d6dc780000` |
| Outdoor2 Gen2 | Gen2 | `0x7c3e82d6f52a0000` |
| Outdoor3 Gen2 | Gen2 | `0x7c3e82d716ef0000` |
| Generic Gen2 | Gen2 | `0x7c3e82d6f3ff0000` |

> These sensors also have ZHA registrations (Soil Sensor 1, 2, 3) — this is because the same coordinator serves both Zigbee2MQTT and ZHA paths, but ZHA is disabled. The ZHA sensor entities may appear but are likely inactive.

## ZHA (Disabled)

ZHA is configured but **disabled by the user** (`disabled_by: user`). The original entry `01KGV9QD6568DF9P3S4JQE53X8` (HA Connect ZBT-1) is not loaded.

A second ZHA entry for the ZBT-2 (`homeassistant_connect_zbt2` hardware integration) is loaded but only provides the hardware device — Zigbee traffic goes through Zigbee2MQTT.

## Notes / Gotchas

- Do not enable ZHA while Zigbee2MQTT is active — both cannot share the same coordinator simultaneously.
- The `permit_join` switch should be turned off when not actively pairing devices (security best practice).
- Third Reality Gen1 soil sensors (3RSM0147Z) appear in both ZHA device registry (paired historically) and Zigbee2MQTT — the active entities are the Zigbee2MQTT ones.
- Upstairs Hallway Switch (Third Reality Zigbee plug) acts as a Zigbee mesh router, extending coverage to the 3rd floor.
- Christmas Lights Living Room (Third Reality plug) is seasonal and may be physically disconnected.

## Last Updated

2026-06-24

# Infrastructure

# Add-ons Overview

## Overview

26 add-ons are installed via the Home Assistant Supervisor. 23 are currently running; 3 are stopped. 1 has an available update (HA MCP Server).

| State | Count |
|---|---|
| Running | 23 |
| Stopped | 3 |
| Updates available | 1 |

---

## Add-ons by Category

### Core HA Add-ons (Official)

| Add-on | Version | State | Purpose |
|---|---|---|---|
| Matter Server | 9.0.2 | running | Matter/Thread protocol server |
| Samba share | 12.6.1 | running | SMB/CIFS share for config/backup access |
| File editor | 6.0.0 | running | Browser-based YAML config editor |
| Speech-to-Phrase | 1.4.3 | running | Fast local STT for HA Assist |
| Whisper | 3.2.0 | running | Neural local STT (Faster Whisper) |
| Piper | 2.2.2 | running | Local neural TTS |
| openWakeWord | 2.1.0 | running | Local wake-word detection |
| Mosquitto broker | 7.1.0 | running | Local MQTT broker |
| VLC | 1.0.0 | running | VLC media player endpoint |
| RPC Shutdown | 3.0 | running | Remote Windows PC shutdown |
| Get HACS | 1.3.1 | **stopped** | One-time HACS installer (safe to leave stopped) |
| CEC Scanner | 4.0 | **stopped** | HDMI CEC device discovery (used once) |

### Community Add-ons (a0d7b954)

| Add-on | Version | State | Purpose |
|---|---|---|---|
| AdGuard Home | 6.2.0 | running | Network-wide DNS ad/tracker blocking |
| Advanced SSH & Web Terminal | 24.0.1 | running | SSH access + web terminal |
| Tailscale | 0.28.1 | running | Zero-config VPN (WireGuard mesh) |
| Network UPS Tools (NUT) | 0.18.0 | running | UPS monitoring (CPS CP1500AVRLCD) |
| chrony | 6.0.1 | running | Local NTP server for cameras |
| Grafana | 12.1.0 | running | Metrics visualization dashboards |
| InfluxDB | 5.0.2 | running | Time-series database for HA sensor data |
| Log Viewer | 0.17.1 | **stopped** | Browser-based log viewer |

### Third-Party / HACS Repository Add-ons

| Add-on | Version | State | Purpose |
|---|---|---|---|
| Music Assistant | 2.9.3 | running | Multi-room music server |
| eufy-security-ws | 3.0.1 | running | Local Eufy camera WebSocket bridge |
| YT Music PO Token Generator | 1.3.1 | running | YouTube Music auth tokens for MA |
| Zigbee2MQTT | 2.12.0-1 | running | Zigbee coordinator + MQTT bridge |
| Frigate | 0.17.1 | running | Local NVR with object detection |
| Home Assistant MCP Server | 7.8.1 | running | AI assistant MCP integration (**update available**) |

---

## Stopped Add-ons

| Add-on | Reason Stopped |
|---|---|
| Get HACS | One-time installer — safe to leave stopped after HACS is installed |
| CEC Scanner | On-demand tool — run when scanning for HDMI-CEC devices |
| Log Viewer | On-demand debugging tool |

---

## Update Available

| Add-on | Current | Notes |
|---|---|---|
| Home Assistant MCP Server | 7.8.1 | Update available — check changelog before upgrading |

---

## Key Dependencies

```
Zigbee2MQTT → depends on → Mosquitto broker
Frigate → depends on → Mosquitto broker (for events)
Music Assistant → depends on → (network, streaming services)
eufy-security-ws → depends on → Eufy cloud account
Whisper/Piper/Speech-to-Phrase/openWakeWord → depends on → Wyoming protocol (HA built-in)
NUT → exposes → UPS data to HA via nut integration
AdGuard Home → exposes → DNS stats to HA via adguard integration
```

## Last Updated

2026-06-24

# Monitoring Stack — InfluxDB, Grafana, AdGuard, NUT

## Overview

Long-term monitoring uses the **InfluxDB + Grafana** stack for time-series storage and visualization, complemented by **AdGuard Home** for DNS query analytics and **NUT** for UPS status.

---

## InfluxDB

**Add-on:** a0d7b954_influxdb v5.0.2 | **State:** running

InfluxDB stores long-term time-series sensor data from Home Assistant. HA's built-in recorder uses SQLite/PostgreSQL for short-term history; InfluxDB provides the long-term archive.

**Use cases:**
- Energy consumption history (Emporia Vue circuits)
- Climate and temperature trends (ecobee, Aqara, Govee sensors)
- Motion event frequency
- UPS load and battery history

**Configuration:** InfluxDB integration is configured via HA's `configuration.yaml` or through the add-on's web UI.

---

## Grafana

**Add-on:** a0d7b954_grafana v12.1.0 | **State:** running

Grafana provides visualization dashboards on top of InfluxDB data.

**Typical dashboards:**
- Whole-home energy (Cornell Vue — `sensor.cornell_vue_energy_today`)
- Per-circuit power (kitchen appliances, HVAC, floors)
- Temperature/humidity trends per room
- AdGuard DNS query statistics
- UPS status over time

> Grafana is accessible on the HA host at port 3000 (or configured reverse proxy path). Not directly integrated into HA Lovelace.

---

## AdGuard Home

**Add-on:** a0d7b954_adguard v6.2.0 | **Integration:** adguard | **Area:** Office

Network-wide DNS-based ad and tracker blocking. All LAN DNS queries are routed through AdGuard.

**HA entities:**
- `sensor.adguard_home_dns_queries_blocked_ratio` — shows % of queries blocked
- Protection, filtering, parental control, safe search switches

**Dashboard:** AdGuard Home has its own web UI accessible on the LAN.

---

## Network UPS Tools (NUT)

**Add-on:** a0d7b954_nut v0.18.0 | **Integration:** nut | **UPS:** CPS CP1500AVRLCDa | **Area:** Media Room

Monitors the APC-compatible CPS UPS protecting the Media Room AV equipment.

**Key entities:**

| Entity | Notes |
|---|---|
| `sensor.media_room_ups_load` | % of UPS capacity in use |
| `sensor.media_room_ups_battery_charge` | Battery charge % |
| `sensor.media_room_ups_battery_runtime` | Estimated runtime on battery |
| `sensor.media_room_ups_input_voltage` | AC input voltage |
| `sensor.media_room_ups_output_voltage` | UPS output voltage |
| `sensor.media_room_ups_status` | Online / On Battery / Bypass |

**Automation:** `UPS Power Outage Notification` triggers when status → On Battery.

---

## Uptime & SpeedTest

| Integration | Entity | Notes |
|---|---|---|
| Uptime | `sensor.uptime` | HA instance continuous uptime |
| SpeedTest | `sensor.speedtest_download` / `sensor.speedtest_upload` | Periodic internet speed tests |

Both are assigned to the Office area.

---

## Notes / Gotchas

- InfluxDB must be configured in HA settings to forward sensor data — confirm the `influxdb:` component is active in configuration.yaml.
- Grafana dashboards are independent of HA Lovelace — they require a separate login (unless SSO is configured).
- The CPS UPS shows as "CP1500AVRLCDa" in NUT — this is compatible with most APC-format NUT drivers.

## Last Updated

2026-06-24

# Voice Pipeline

## Overview

The home runs a fully local, cloud-independent voice pipeline using HA's Assist framework. The pipeline is anchored by a **Home Assistant Voice PE** device in the Bedroom and composed of four add-on components. An Ollama LLM provides conversational AI beyond basic HA commands.

---

## Pipeline Components

### 1. Wake Word — openWakeWord

| Property | Value |
|---|---|
| Add-on | core_openwakeword v2.1.0 |
| Protocol | Wyoming |
| Entity | `wake_word.openwakeword` |
| Purpose | Passively listens for wake phrase on the HA Voice PE microphone |

### 2. Speech-to-Text

Two local STT options:

| Option | Add-on | Version | Best For |
|---|---|---|---|
| **Speech-to-Phrase** | core_speech-to-phrase | 1.4.3 | Fast home control commands |
| **Whisper** | core_whisper | 3.2.0 | Free-form speech, better accuracy |
| HA Cloud | — | — | Fallback cloud STT |

**Recommendation:** Use Speech-to-Phrase as primary for HA commands — it's significantly faster than Whisper for intent-matched phrases.

### 3. Conversation / Intent Processing

| Option | Entity | Notes |
|---|---|---|
| **Home Assistant** | `conversation.home_assistant` | Built-in intent matching for HA commands |
| **Ollama** | `conversation.ollama_conversation` | Local LLM (qwen3:4b-instruct at 192.168.1.85:11434) |

### 4. Text-to-Speech

| Option | Add-on | Version | Notes |
|---|---|---|---|
| **Piper** | core_piper | 2.2.2 | Local neural TTS (offline) |
| Google Translate | — | — | Cloud TTS (requires internet) |
| HA Cloud | — | — | Nabu Casa cloud TTS |

---

## Hardware — HA Voice PE

| Property | Value |
|---|---|
| Device | Home Assistant Voice 0919e8 |
| Model | Home Assistant Voice PE |
| Manufacturer | Nabu Casa |
| Firmware | ESPHome 2026.3.2 |
| Area | Bedroom |

The Voice PE connects to HA via the ESPHome integration over local LAN.

**Controls:**
- Physical button on device
- LED ring (color/pattern indicates pipeline state)
- Mute switch
- Wake sound toggle
- Pipeline selector (`select.home_assistant_voice_0919e8_assistant_2`)

---

## Conversation Pipelines

HA supports multiple named pipelines. The Voice PE's `assistant_2` select entity allows switching between pipelines at runtime.

**Typical pipelines:**
1. **Default** — Speech-to-Phrase → Home Assistant Assist → Piper
2. **LLM** — Whisper → Ollama → Piper
3. **Cloud** — HA Cloud STT → HA Cloud TTS

---

## Announcement Targets

Beyond the Voice PE, TTS announcements can be pushed to any `media_player` entity. Key announcement targets:

| Target | Entity | Notes |
|---|---|---|
| HA Voice PE | `media_player.home_assistant_voice_0919e8` | Primary |
| Bedroom Echo Show 5 | `media_player.bedroom` | Alexa |
| VLC | `media_player.vlc_telnet` | Local fallback |
| Everywhere (MA group) | `media_player.everywhere` | All speakers |

---

## Notes / Gotchas

- The Ollama server runs on a separate machine at `192.168.1.85:11434`. If that machine is off, the Ollama conversation agent will be unavailable — HA Assist built-in handles fallback.
- Whisper model size affects accuracy vs. speed. Check the Whisper add-on configuration for the selected model (tiny/base/small/medium).
- Speech-to-Phrase requires a custom vocabulary configuration to recognize non-standard commands — check add-on settings for custom phrase lists.
- The Voice PE LED ring color indicates pipeline state: idle (off/dim), listening (blue), processing (yellow), error (red) — exact colors depend on ESPHome firmware version.

## Last Updated

2026-06-24

# Dashboards Overview

## Overview

3 custom Lovelace dashboards are configured in Home Assistant (storage mode), plus the default Lovelace dashboard. All use the storage-mode editor (not YAML mode).

---

## Dashboard Inventory

| Title | URL Path | Icon | Admin Only | Mode |
|---|---|---|---|---|
| Home View | `/home-view` | `mdi:home` | Yes | storage |
| Map | `/map` | `mdi:map` | No | storage |
| Plants | `/plant-care` | `mdi:flower` | No | storage |

---

## Home View

**URL:** `/home-view` | **Admin only:** yes | **Icon:** `mdi:home`

The primary home control dashboard. Restricted to admin users.

**Likely content (inferred from devices):**
- Room-by-room light and switch controls
- Climate/thermostat control (ecobee)
- Media player controls (Samsung TV, soundbars)
- Security camera feeds (go2rtc WebRTC)
- Cover/blind controls
- Lock status
- Presence indicators (Rajeev Iyer)
- Energy monitoring tiles
- UPS status

**HACS cards likely used:**
- Bubble Card (Clooos) — modern room/device cards
- Slider Button Card — dimmer controls
- Comfortable Environment Card — climate display
- Keep Texts in Tabs — tab navigation
- Energy Sankey Card — energy flow visualization
- TrashCard — garbage collection schedule

---

## Map

**URL:** `/map` | **Admin only:** no | **Icon:** `mdi:map`

Standard HA map dashboard showing:
- Person/device tracker locations
- Configured zones (Home, Work, Rajeeta Home)
- Device tracker entities for mobile devices and vehicle telematics

---

## Plants

**URL:** `/plant-care` | **Admin only:** no | **Icon:** `mdi:flower`

Dedicated plant care dashboard using data from:
- Third Reality soil moisture sensors (Gen1 + Gen2, via Zigbee2MQTT + ZHA)
- Irrigation watering history helpers (`input_datetime.*_last_watered`, `input_number.*_last_run_duration`)
- Orbit BHyve zone status

**Likely content:**
- Per-plant moisture level gauges
- Last watered date/time
- Last run duration
- BHyve next watering schedule
- Zone valve status

---

## Default Dashboard

The built-in default Lovelace dashboard (auto-generated) also exists at `/lovelace` but is not listed as a custom storage-mode dashboard — it uses HA's auto-entities feature.

---

## Frontend Customizations (HACS Plugins)

These HACS plugins extend dashboard capabilities:

| Plugin | Author | Use |
|---|---|---|
| Bubble Card | Clooos | Modern pop-up room/device cards |
| Slider Button Card | custom-cards | Dimmer/fan slider controls |
| Comfortable Environment Card | argaar | Temperature + humidity comfort display |
| Keep Texts in Tabs | elchininet | Tab labels in card navigation |
| Weather Chart Card | mlamberts78 | Multi-day weather forecast chart |
| Energy Sankey Card | davet2001 | Energy flow Sankey diagram |
| Zigbee2mqtt Networkmap Card | azuwis | Zigbee mesh network topology map |
| TrashCard | idaho | Garbage collection schedule card |

---

## Notes / Gotchas

- The Home View dashboard is admin-only — non-admin Lovelace users will not see it in the sidebar.
- WebRTC camera cards (using the WebRTC Camera HACS integration by AlexxIT) provide low-latency live views; they require go2rtc to be running.
- The Plants dashboard data is only as accurate as the automation-populated helpers — if an irrigation cycle is manually interrupted before completion, the last run duration may be incorrect.
- Weather Chart Card uses the Met.no `Forecast Home` weather entity.

## Last Updated

2026-06-24

# Automations

# Device Control Automations

## Overview

10 automations handle device and light control — basement lights, bedroom climate, bedroom fan timer, living room lamp schedules, and Bar 4-button switch mappings.

---

## Turn On Basement

**Entity:** `automation.turn_on_basement` | **State:** on

Turns on the Basement lights.

| Property | Value |
|---|---|
| Trigger | Various (switch, button, time) |
| Action | `light.basement_lights` → on |

---

## Turn Off Basement by Switch

**Entity:** `automation.turn_off_basement_by_switch` | **State:** on

Turns off the Basement lights via a switch trigger.

| Property | Value |
|---|---|
| Trigger | Basement Switch 2 or Bar Switch Button 2 |
| Action | `light.basement_lights` → off |

---

## Heat Bedroom

**Entity:** `automation.heat_bedroom` | **State:** on

Activates the Dyson Pure Hot+Cool Link heater in the bedroom based on a schedule or temperature threshold.

| Property | Value |
|---|---|
| Trigger | Schedule (morning) OR temperature drops below threshold |
| Action | Activate Dyson heating mode |

---

## Turn Off Bedroom Fan in X Time

**Entity:** `automation.turn_off_bedroom_fan_in_x_time` | **State:** on

Starts a timer to automatically turn off the bedroom ceiling fan after a configurable period.

| Property | Value |
|---|---|
| Trigger | Bedroom Fan turns on |
| Action | Schedule `fan.bedroom_fan` → off after delay |

---

## Living Room Lamps On Automation

**Entity:** `automation.living_room_lamps_on_automation` | **State:** on | **Area:** Living Room

Turns on the Living Room Lamp Switch (TP-Link KS205) on a schedule or trigger.

---

## Living Room Lamps Off Automation

**Entity:** `automation.living_room_lamps_off_automation` | **State:** on | **Area:** Living Room

Turns off the Living Room Lamp Switch on a schedule or trigger.

---

## Bar Switch — Button 1

**Entity:** `automation.bar_switch_button_1` | **State:** on

The Bar 4-button Zigbee switch Button 1 action.

| Property | Value |
|---|---|
| Trigger | Bar 4-button switch Button 1 press (ZHA event) |
| Action | Turn On Basement |

---

## Bar Switch — Button 2

**Entity:** `automation.bar_switch_button_2` | **State:** on

| Property | Value |
|---|---|
| Trigger | Bar 4-button switch Button 2 press |
| Action | Turn Off Basement |

---

## Bar Switch — Button 3 — Kitchen Lights

**Entity:** `automation.bar_switch_button_3_kitchen_lights` | **State:** on

| Property | Value |
|---|---|
| Trigger | Bar 4-button switch Button 3 press |
| Action | Toggle Kitchen Lights |

---

## Bar Switch — Button 4

**Entity:** `automation.bar_switch_button_4` | **State:** on

| Property | Value |
|---|---|
| Trigger | Bar 4-button switch Button 4 press |
| Action | (configurable — check automation details in HA UI) |

---

## Notes

- The Bar 4-button switch triggers use ZHA device events. The same physical device also has a Zigbee2MQTT registration (`Living Room 4 Button Switch`) — ensure only one integration's events are triggering these automations to avoid double-firing.
- `automations.heat_bedroom` depends on the `dyson_local` integration being available.

## Last Updated

2026-06-24

# Irrigation Tracking Automations

## Overview

4 automations track watering activity for the 4 front yard irrigation zones. Each automation captures the last watered timestamp and run duration into helper entities whenever a zone completes a watering cycle.

---

## How It Works

When the Orbit BHyve timer completes a watering cycle for a zone, the corresponding automation:
1. Records the completion time into `input_datetime.*_last_watered`
2. Records the run duration into `input_number.*_last_run_duration` (in minutes)

This data feeds the **Plants dashboard** and provides watering history for each garden zone.

---

## Track Front Planters Watering

**Entity:** `automation.track_front_planters_watering` | **State:** on

| Property | Value |
|---|---|
| Trigger | `valve.front_yard_tap_timer_front_planters_zone` → closed (cycle complete) |
| Actions | Set `input_datetime.front_planters_last_watered` = now |
| | Set `input_number.front_planters_last_run_duration` = elapsed minutes |

---

## Track Front Yard Shrubs Watering

**Entity:** `automation.track_front_yard_shrubs_watering` | **State:** on

| Property | Value |
|---|---|
| Trigger | `valve.front_yard_tap_timer_front_yard_shrubs_zone` → closed |
| Actions | Set `input_datetime.front_yard_shrubs_last_watered` = now |
| | Set `input_number.front_yard_shrubs_last_run_duration` = elapsed minutes |

---

## Track Front Fence Planters Watering

**Entity:** `automation.track_front_fence_planters_watering` | **State:** on

| Property | Value |
|---|---|
| Trigger | `valve.front_yard_tap_timer_front_fence_planters_zone` → closed |
| Actions | Set `input_datetime.front_fence_planters_last_watered` = now |
| | Set `input_number.front_fence_planters_last_run_duration` = elapsed minutes |

---

## Track Side Yard Garden Bed Watering

**Entity:** `automation.track_side_yard_garden_bed_watering` | **State:** on

| Property | Value |
|---|---|
| Trigger | `valve.front_yard_tap_timer_side_yard_garden_bed_zone` → closed |
| Actions | Set `input_datetime.side_yard_garden_bed_last_watered` = now |
| | Set `input_number.side_yard_garden_bed_last_run_duration` = elapsed minutes |

---

## Related Helpers

| Helper | Type | Zone |
|---|---|---|
| `input_datetime.front_planters_last_watered` | Date/Time | Front Planters |
| `input_number.front_planters_last_run_duration` | Number (min, 0–480) | Front Planters |
| `input_datetime.front_yard_shrubs_last_watered` | Date/Time | Front Yard Shrubs |
| `input_number.front_yard_shrubs_last_run_duration` | Number (min, 0–480) | Front Yard Shrubs |
| `input_datetime.front_fence_planters_last_watered` | Date/Time | Front Fence Planters |
| `input_number.front_fence_planters_last_run_duration` | Number (min, 0–480) | Front Fence Planters |
| `input_datetime.side_yard_garden_bed_last_watered` | Date/Time | Side Yard Garden Bed |
| `input_number.side_yard_garden_bed_last_run_duration` | Number (min, 0–480) | Side Yard Garden Bed |

---

## Notes

- These automations only run when a valve closes (cycle completion). They do not handle manually interrupted cycles.
- Duration up to 480 minutes is supported (8 hours max per the input_number configuration).
- Last watered timestamps shown in the Plants dashboard use these helpers as the data source.

## Last Updated

2026-06-24

# Motion Lighting Automations

## Overview

6 automations handle motion-activated lighting across the home. All use Aqara Motion Sensor P1 entities (via Matter) as triggers.

---

## Motion Activation Hallway Lights

**Entity:** `automation.motion_activation_hallway_lights` | **State:** on

Triggers the 2nd Floor Hallway lights when the Hallway Aqara Motion Sensor P1 detects occupancy.

| Property | Value |
|---|---|
| Trigger | `binary_sensor.hallway_aqara_motion_sensor_p1_occupancy` → on |
| Action | Turn on Hallway Lights (Lutron) |

---

## Motion Activation Upstairs Hallway 2

**Entity:** `automation.motion_activation_upstairs_hallway_2` | **State:** on

Triggers the 3rd Floor Upstairs Hallway light when the Upstairs Motion Sensor detects occupancy.

| Property | Value |
|---|---|
| Trigger | `binary_sensor.upstairs_motion_sensor_occupancy` → on |
| Action | Turn on Upstairs Hallway Lights (Lutron) |

---

## Motion Activation Kitchen Lights

**Entity:** `automation.motion_activation_kitchen_lights` | **State:** on

Triggers kitchen lighting when motion is detected in the kitchen area.

| Property | Value |
|---|---|
| Trigger | Motion sensor in kitchen area |
| Action | Turn on Kitchen Lights (Lutron) |

---

## Motion Activation Garage

**Entity:** `automation.motion_activation_garage` | **State:** on

Turns on garage lights when the Aqara Motion Sensor P1 in the garage detects occupancy.

| Property | Value |
|---|---|
| Trigger | `binary_sensor.garage_motion_sensor_occupancy` → on |
| Action | Turn on Garage Lights |

---

## Garage Door Opening Lights

**Entity:** `automation.garage_door_opening_lights` | **State:** on

When the garage door opens, turns on the garage lights to illuminate entry/exit.

| Property | Value |
|---|---|
| Trigger | `cover.garage_door` → opening |
| Action | Turn on Garage Lights |

---

## Link Hallway Lights to Upstairs When Turning On Lights

**Entity:** `automation.link_hallway_lights_to_upstairs_when_turning_on_lights` | **State:** on

Syncs the 2nd Floor Hallway lights and 3rd Floor Upstairs Hallway lights so they activate together — useful for nighttime navigation.

| Property | Value |
|---|---|
| Trigger | Hallway OR Upstairs Hallway light turns on |
| Action | Turn on the paired hallway light |

---

## Notes

- All motion sensors are Aqara Motion Sensor P1 devices connected via Matter (Aqara Camera Hub G3 or Hub M2 bridges).
- These automations do not include auto-off timers — lights stay on until manually turned off or a separate time-based rule applies. Consider adding time-limited auto-off for energy saving.

## Last Updated

2026-06-24

# Notification Automations

## Overview

6 automations handle proactive notifications — low battery alerts, garbage collection reminders, soil moisture alerts, and wake-up routines.

---

## Low Battery Notification

**Entity:** `automation.low_battery_notification` | **State:** on

Monitors battery levels across all battery-powered devices and sends a notification when any drops below threshold.

| Property | Value |
|---|---|
| Trigger | Any battery sensor falls below ~20% |
| Devices covered | Aqara sensors (water leak, motion, wireless switch, temp/humidity), Lutron Picos |
| Action | Push notification listing affected devices |

> This is one of the most valuable automations for maintaining sensor reliability.

---

## Battery Level Sensor

**Entity:** `automation.battery_level_sensor` | **State:** on

A companion automation to Low Battery Notification — may update a helper or calculate aggregate battery status across all devices.

---

## Soil Sensor Low Moisture Alert

**Entity:** `automation.soil_sensor_low_moisture_alert` | **State:** on

Sends a notification when any plant soil moisture sensor drops below a defined threshold.

| Property | Value |
|---|---|
| Trigger | Any Third Reality soil sensor moisture level drops below threshold |
| Sensors | Bedroom, Living Room, Media Room (Gen1); Outdoor 1-3 (Gen2) |
| Action | Push notification identifying the specific plant |

---

## Remind Me When Garbage Event

**Entity:** `automation.remind_me_when_garbage_event` | **State:** on

Triggers when a garbage/recycling calendar event is approaching and sends a reminder notification.

| Property | Value |
|---|---|
| Trigger | `calendar.garbage_collection_schedule` event start approaching |
| Action | Notification reminder |

---

## Trash Reminder to iPhone

**Entity:** `automation.trash_reminder_to_iphone` | **State:** on

A companion to the garbage reminder — sends a push notification directly to the iPhone app.

| Property | Value |
|---|---|
| Trigger | Scheduled time before collection day |
| Action | `notify.mobile_app_iceheart` push notification |

---

## Wake Up at Home

**Entity:** `automation.wake_up_at_home` | **State:** on

A morning wake-up routine triggered when Rajeev Iyer's phone alarm fires, activating lights and routines.

| Property | Value |
|---|---|
| Trigger | `sensor.iceheart_next_alarm` (iPhone alarm time) |
| Condition | Person is home (`person.rajeev_iyer` = home) |
| Actions | Activate `Wake up Bedroom` scene; potentially other wake routines |

---

## Notes

- All notification automations use `notify.mobile_app_iceheart` and/or `notify.pushover` as delivery channels.
- The `Trash Reminder to iPhone` and `Remind me when Garbage Event` automations may be redundant; they likely serve slightly different timing or delivery scenarios.
- The `TrashCard` HACS frontend card (idaho) may display garbage schedule on dashboards independently of these automations.

## Last Updated

2026-06-24

# Security Automations

## Overview

5 automations cover security and safety alerting — water leaks, smart lock timeout, garage door left open, UPS power loss, and backyard light control.

---

## Water Leak Alert

**Entity:** `automation.water_leak_alert` | **State:** on

Sends an immediate notification when any Aqara Water Leak Sensor detects water.

| Property | Value |
|---|---|
| Trigger | Any `binary_sensor.aqara_water_leak_sensor_water_leak` → on |
| Sensors covered | Multiple locations (kitchen, bathrooms, basement, guest bathroom) |
| Action | Push notification (iOS / Pushover) |

> **Critical automation.** Aqara Water Leak Sensors are deployed in multiple locations. All sensors feed this single automation.

---

## Smart Lock Unlocked 30 Min Alert

**Entity:** `automation.smart_lock_unlocked_30_min_alert` | **State:** on

Sends a reminder notification if any smart lock remains in the `unlocked` state for more than 30 minutes.

| Property | Value |
|---|---|
| Trigger | `lock.kitchen_smart_lock` OR `lock.aqara_smart_lock_u100` (Garage) → unlocked for 30 min |
| Action | Push notification warning |

---

## Notify if Garage Door Open

**Entity:** `automation.notify_if_garage_door_open` | **State:** on

Sends a notification if the garage door is left open for an extended period.

| Property | Value |
|---|---|
| Trigger | `cover.garage_door` remains open for configurable duration |
| Action | Push notification |

---

## UPS Power Outage Notification

**Entity:** `automation.ups_power_outage_notification` | **State:** on

Notifies when the Media Room UPS (CPS CP1500AVRLCD) switches from grid power to battery — indicating a power outage.

| Property | Value |
|---|---|
| Trigger | NUT UPS status → on battery |
| Action | Push notification |

---

## Control Backyard Light

**Entity:** `automation.control_backyard_light` | **State:** on

Manages the backyard light based on schedule, sunset/sunrise, or motion events.

| Property | Value |
|---|---|
| Trigger | Sunset / sunrise / motion |
| Action | Toggle Backyard Light (TP-Link KS205) |

---

## Notes

- Notification targets for security automations are typically `notify.mobile_app_iceheart` (iPhone push) and/or `notify.pushover`.
- The Smart Lock Unlocked 30 Min Alert covers only `kitchen_smart_lock` and `aqara_smart_lock_u100` (Garage lock). The `ratgdov2.5i lock remotes` is not a physical door lock.

## Last Updated

2026-06-24

# Areas & Devices

# Backyard

## Overview

The Backyard area covers the rear outdoor space with 47 entities. It includes a Eufy outdoor security camera, a TP-Link outdoor smart plug (EP40M) with two outlets (backyard lighting and HeatTrak mats), and a YoLink door sensor for the backyard entrance.

**Entity count:** 47 | **Floor:** Ground Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Backyard (Eufy Camera) | Eufy Security | T8424 | eufy_security |
| Backyard Light | TP-Link | KS205 | tplink |
| Outdoor Smart Plug EP40M | TP-Link | EP40M (outdoor dual-outlet) | tplink |
| Unnamed EP40M Smart Plug_2 | TP-Link | EP40M (outlet 2) | tplink |
| HeatTrak Mats | TP-Link | EP40M (outlet — via parent) | tplink |
| Door Sensor (Backyard) | YoLink | DoorSensor | yolink |

## Lighting

| Entity | Type | Notes |
|---|---|---|
| Backyard Light | TP-Link KS205 | General backyard light switch |

**Automation:** `Control Backyard Light` — automated control of the backyard light.

## Security / Cameras

| Entity | Notes |
|---|---|
| Backyard (Eufy T8424) | Outdoor security camera; firmware 2.1.1.5 |
| Backyard Alarm Panel | `alarm_control_panel.backyard` (armed_home) |
| Backyard Microphone | Switch to enable/disable camera microphone |
| Backyard Motion Detection Type | Select — Pet, Human, Vehicle, All Other |
| Backyard Motion Detection Sensitivity | Number entity |
| Door Sensor (YoLink) | Contact sensor on backyard door/gate |

**Camera features available:**
- Motion Detection (multiple type selectors)
- Siren on event
- Email on event
- FTP upload
- Push notifications

## Outdoor Power

| Entity | Notes |
|---|---|
| EP40M Outlet 1 (backyard) | Standard outdoor outlet |
| HeatTrak Mats | Heated driveway/walkway mat power |

## Notes / Gotchas

- The EP40M has two child outlets registered as separate devices under it. `HeatTrak Mats` is a child plug of `Outdoor Smart Plug EP40M`.
- The YoLink Door Sensor connects via the YoLink integration (cloud-based), not Zigbee or Z-Wave.
- Eufy cameras depend on the HomeBase in the basement — if the HomeBase goes offline, all Eufy entities become unavailable.

## Last Updated

2026-06-24

# Bar

## Overview

The Bar area is a dedicated home bar space on the Ground Floor with 36 entities. It features smart accent lighting (Govee color bulbs and LED strips), a Lutron dimmer for spot lights, a TP-Link KP125M smart plug for the bar sign, Govee Bluetooth temperature/humidity sensors, and a 4-button Zigbee wall switch that controls multiple zones.

**Entity count:** 36 | **Floor:** Ground Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Bar Spot Lights | Lutron | DVRF-6L (DivaSmartDimmer) | lutron_caseta |
| Bar Sign | TP-Link | KP125M (energy monitoring) | tplink |
| Bar Shelves | TP-Link | KP125M (energy monitoring) | tplink |
| UnderBar Lights | Govee | H6159 (LED strip) | govee |
| Bar Bulb 1 | Govee | H6008 (color bulb) | govee |
| Bar Bulb 2 | Govee | H6008 (color bulb) | govee |
| H5075 0409 | Govee | H5075 (Temp/Humidity) | govee_ble (Bluetooth) |
| H5075 9768 | Govee | H5075 (Temp/Humidity) | govee_ble (Bluetooth) |

> Note: Bar Shelves (KP125M) is assigned to the Living Room in HA but physically serves the Bar area. Bar Sign (KP125M) is correctly assigned to Bar.

## Lighting

| Entity | Type | Notes |
|---|---|---|
| Bar Spot Lights | Lutron dimmer | Overhead spot lights |
| Bar Sign | TP-Link KP125M | Neon/LED bar sign; energy metered |
| UnderBar Lights | Govee H6159 LED strip | RGB under-bar strip; Music Mode capable |
| Bar Bulb 1 | Govee H6008 | Color bulb above bar |
| Bar Bulb 2 | Govee H6008 | Color bulb above bar |

**Special modes:**
- `UnderBar Lights Music Mode` — switch to sync lights to audio
- `Bar Bulb 1 Music Mode` — sync to music
- `Bar Bulb 2 Music Mode` — sync to music

**Scenes:**
- `Bar On` — activates bar lighting preset
- `Bar Off` — turns off all bar lights

## 4-Button Wall Switch

The Bar has a 4-button Zigbee switch that drives automations for multiple areas:

| Button | Automation |
|---|---|
| Button 1 | `Bar Switch - Button 1` (turns on Basement) |
| Button 2 | `Bar Switch - Button 2` (turns off Basement) |
| Button 3 | `Bar Switch - Button 3 - Kitchen Lights` |
| Button 4 | `Bar Switch - Button 4` |

## Environment Sensors

| Device | Sensors | Integration |
|---|---|---|
| Govee H5075 0409 | Temperature, Humidity | govee_ble (Bluetooth) |
| Govee H5075 9768 | Temperature, Humidity | govee_ble (Bluetooth) |

Both sensors use BLE and connect via the Realtek Bluetooth radio on the HA host.

## Energy Monitoring

| Device | Notes |
|---|---|
| Bar Sign (KP125M) | Individual energy monitoring |
| Bar Shelves (KP125M) | Individual energy monitoring |

## Notes / Gotchas

- Govee Cloud integration (`govee`) has a pending HACS update (v2026.6.20) requiring restart. Govee BLE sensors (`govee_ble`) are unaffected.
- Bar Shelves is registered under `living_room` area in HA — this is a known assignment discrepancy.
- The Govee H5075 sensors connect via Bluetooth, so they require the HA host Bluetooth radio to be active. Range can be an issue if the bar is far from the HA hardware.
- The `Bar Sign Overloaded` binary sensor provides protection status from the KP125M.

## Last Updated

2026-06-24

# Basement

## Overview

The Basement is the home's utility and exercise area on Floor B1. It houses core infrastructure including the media UPS, water softener, dehumidifier, and HVAC equipment monitoring. It also has Amazon Alexa and Fire TV for entertainment.

**Entity count:** 76 | **Floor:** Basement (B1)

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Basement Lights | Lutron | PD-8ANS-XX (WallSwitch) | lutron_caseta |
| Basement Switch 2 | TP-Link | KS205 | tplink |
| Dehumidifier_71B6 | Midea | Dehumidifier | midea_dehumidifier_lan |
| Iqua Softener RHW4221-24178-4056 | Iqua | Water Softener | iqua_softener |
| Basement Alexa | Amazon | Echo Dot | alexa_devices |
| Rajeev's TV | Amazon | Fire TV 2-Series | alexa_devices |
| ecobee Room Sensor (Basement) | ecobee | Room Sensor | ecobee |
| Hot water Heater/HRV | Emporia | VUE003 | emporia_vue |
| Furnace | Emporia | VUE003 | emporia_vue |
| AC | Emporia | VUE003 | emporia_vue |
| Eufy HomeBase | Eufy Security | T8030 (firmware 3.8.3.4) | eufy_security |
| Eufy Living Room Camera | Eufy Security | T8416 | eufy_security |
| Eufy Basement Camera | Eufy Security | T8410 | eufy_security |

> Note: The Eufy Living Room and Basement cameras are physically homed to the Eufy HomeBase in the basement, though their camera views cover different areas of the house.

## Lighting

| Entity | Type | Integration |
|---|---|---|
| Basement Lights | Switch (via switch_as_x → light) | lutron_caseta + switch_as_x |
| Basement Entryway | Hue white lamp | hue |
| Basement Switch 2 | TP-Link KS205 (controls basement lamp) | tplink |

**Automations:** Basement lights are controlled via the Bar Switch (Button 1 / Button 2) and by a dedicated on/off automation triggered by switch state.

## Climate & Environment

| Entity | Type | Current State |
|---|---|---|
| ecobee Basement Room Sensor | Temperature / occupancy | Active |
| Dehumidifier_71B6 | Humidifier/fan control | on |
| Dehumidifier Fan | Fan entity | on |
| Dehumidifier Pump | Switch | Enabled |
| Iqua Water Softener | Water softener | Running |
| Iqua Water Shutoff Valve | Switch | — |

## Energy Monitoring (Emporia Vue)

| Circuit | Area |
|---|---|
| Hot Water Heater / HRV | Basement |
| Furnace | Basement |
| AC | Basement |

## Security

| Device | Type | Notes |
|---|---|---|
| Eufy HomeBase (T8030) | Security base station | Hub for all Eufy cameras; firmware 3.8.3.4 |
| Basement Camera (T8410) | Indoor camera | Alarm panel entity: `alarm_control_panel.basement` |
| Backyard Camera (T8424) | Outdoor camera | See Backyard area |

## Media / Voice

| Device | Model | Notes |
|---|---|---|
| Basement Alexa | Amazon Echo Dot | Music Assistant + Alexa Devices integration |
| Rajeev's TV | Amazon Fire TV 2-Series | Alexa Devices integration; used as a display |
| Basement (MA) | Music Assistant player | Groups into "Basement" speaker group |

## Notes / Gotchas

- The `smartthinq_sensors` integration is in `setup_retry` — LG washer/dryer are in the Laundry Room and may occasionally show as unavailable.
- Iqua Softener uses efficiency mode selector — default is set via the integration.
- The Eufy HomeBase must be online for all Eufy cameras to function; losing it takes down Living Room, Basement, Backyard, Garage, Front Door, Back Door, and Front Doorbell Chime entities.

## Last Updated

2026-06-24

# Bedroom (Master)

## Overview

The Master Bedroom on the 3rd Floor is the most sensor-rich sleeping space with 57 entities. It contains a Lutron dimmable light, Bond ceiling fan, Dyson Pure Hot+Cool Link air purifier/heater/fan, Motionblinds top-down/bottom-up shades, Amazon Echo Show 5, an **HA Voice PE** (local voice assistant device), Aqara temperature/humidity sensor, and an ecobee room sensor.

**Entity count:** 57 | **Floor:** 3rd Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Master Bedroom Lights | Lutron | DVRF-6L (DivaSmartDimmer) | lutron_caseta |
| Master Bedroom Pico | Lutron | PJ2-3BRL-GXX-X01 (Pico3ButtonRaiseLower) | lutron_caseta |
| Bedroom Fan | Olibra (Bond) | — | bond |
| Bedroom Shades | Motionblinds | TopDownBottomUp | motion_blinds |
| Pure Hot+Cool Link | Dyson | Model 455 | dyson_local |
| Home Assistant Voice 0919e8 | Nabu Casa | HA Voice PE (ESPHome 2026.3.2) | esphome |
| Bedroom (Amazon Echo Show 5) | Amazon | Echo Show 5 | alexa_devices |
| ecobee Room Sensor (Bedroom) | ecobee | Room Sensor | ecobee |
| Bedroom Temp / Humidity Sensor | Aqara | Aqara Temp/Humidity Sensor (sw v5) | matter |
| Soil Sensor 3 (Zigbee) | Third Reality | 3RSM0147Z | zha |

## Lighting

| Entity | Type | Notes |
|---|---|---|
| Master Bedroom Lights (Lutron) | Dimmer | Main overhead light |
| Bedroom Fan (light kit) | Bond fan light | Speed + light |
| Home Assistant Voice 0919e8 LED Ring | Light | LED ring on Voice PE |

**Scene:** `Wake up Bedroom` — gradual sunrise lighting scene.

**Automation:** `Heat Bedroom` — activates Dyson heater based on schedule/temperature.

## Climate / Comfort

| Entity | Notes |
|---|---|
| Bedroom Fan (Bond) | Ceiling fan; speed, direction, light |
| Pure Hot+Cool Link (Dyson) | Air purifier + heater + fan; HEPA filter tracked |
| Pure Hot+Cool Link Filter Life | Sensor — remaining filter life % |
| Dyson Fan | Fan entity (speed, oscillation) |
| ecobee Bedroom | Room temperature / occupancy |
| Bedroom Temp / Humidity Sensor | Aqara Matter — temperature + humidity |
| Bedroom Occupancy | Binary sensor |

**Automation:** `Turn off bedroom fan in X time` — auto-off timer for fan.

## Covers / Blinds

| Entity | Type |
|---|---|
| Bedroom Shades Top | Top-down shade |
| Bedroom Shades Bottom | Bottom-up shade |
| Bedroom Shades Combined | Combined TDBU control |

## Voice — Home Assistant Voice PE

The **Home Assistant Voice PE** (ESPHome fw 2026.3.2) is the local voice assistant device in the Bedroom.

| Entity | Notes |
|---|---|
| Home Assistant Voice 0919e8 Assist satellite | Assist satellite entity |
| Home Assistant Voice 0919e8 Media Player | Playback target |
| Home Assistant Voice 0919e8 LED Ring | Light entity |
| Home Assistant Voice 0919e8 Mute | Switch |
| Home Assistant Voice 0919e8 Wake sound | Switch |
| Home Assistant Voice 0919e8 Button press | Event |
| Home Assistant Voice 0919e8 Assistant 2 | Select (pipeline selector) |

The Voice PE runs openWakeWord for wake-word detection, Whisper for STT, and Piper for TTS — all locally.

## Media / Voice

| Device | Notes |
|---|---|
| Bedroom (Amazon Echo Show 5) | Alexa + Music Assistant player; screen display |
| Bedroom (MA) | Music Assistant room player |
| Home Assistant Voice PE | Local Assist voice pipeline |

## Environment

| Entity | Notes |
|---|---|
| Aqara Bedroom Temp/Humidity | Temperature + Humidity (Matter via Hub M2) |
| Soil Sensor 3 (ZHA) | Plant moisture sensor — third bedroom plant |

## Notes / Gotchas

- The Dyson Pure Hot+Cool Link uses the `dyson_local` HACS integration (local LAN, not cloud). Ensure the Dyson device stays on the same subnet.
- HA Voice PE firmware updates appear as `update` entities — keep ESPHome up to date.
- The Aqara Temp/Humidity Sensor is bridged via Aqara Camera Hub G3 (Matter).

## Last Updated

2026-06-24

# Front Yard

## Overview

The Front Yard covers the front outdoor space with 60 entities. Its primary function is irrigation management via the Orbit BHyve smart timer (4 zones), supplemented by a Reolink outdoor camera with auto-tracking, and a collection of Emporia Vue and automation-based watering duration helpers.

**Entity count:** 60 | **Floor:** Ground Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Front Yard Tap Timer | Orbit BHyve | HT34A-0001 (firmware 107) | bhyve |
| Bhyve Hub | Orbit BHyve | BH1G2-0002 (firmware 0056) | bhyve |
| Front Yard (Reolink) | Reolink | E1 Outdoor SE PoE | reolink |

## Irrigation

The **Orbit BHyve HT34A** is a 4-zone smart irrigation timer connected via the Bhyve Hub.

### Irrigation Zones (Valve entities)

| Zone | Entity |
|---|---|
| Front Yard Shrubs | `valve.front_yard_tap_timer_front_yard_shrubs_zone` |
| Side Yard Garden Bed | `valve.front_yard_tap_timer_side_yard_garden_bed_zone` |
| Front Planters | `valve.front_yard_tap_timer_front_planters_zone` |
| Front Fence Planters | `valve.front_yard_tap_timer_front_fence_planters_zone` |

All zones currently: **closed**

### Watering Programs (Switch entities)

| Program | Notes |
|---|---|
| Front Yard Shrubs smart watering | Smart schedule |
| Side Yard Garden Bed smart watering | Smart schedule |
| Front Planters smart watering | Smart schedule |
| Front Fence Planters moist program | Moisture-based |
| Germinating Program | Manual seeding schedule |
| Manual Water Zones | Manual override |
| Front Yard Watering Program | Combined front yard |

### Rain Delay

`switch.front_yard_tap_timer_rain_delay` — enables rain skip mode.

### Smart Watering Helpers

Four sets of input_number + input_datetime helpers track watering history per zone:

| Helper | Entity |
|---|---|
| Front Planters Last Watered | `input_datetime.front_planters_last_watered` |
| Front Planters Last Run Duration | `input_number.front_planters_last_run_duration` (min) |
| Front Yard Shrubs Last Watered | `input_datetime.front_yard_shrubs_last_watered` |
| Front Yard Shrubs Last Run Duration | `input_number.front_yard_shrubs_last_run_duration` (min) |
| Front Fence Planters Last Watered | `input_datetime.front_fence_planters_last_watered` |
| Front Fence Planters Last Run Duration | `input_number.front_fence_planters_last_run_duration` (min) |
| Side Yard Garden Bed Last Watered | `input_datetime.side_yard_garden_bed_last_watered` |
| Side Yard Garden Bed Last Run Duration | `input_number.side_yard_garden_bed_last_run_duration` (min) |

**Automations (4):** One per zone — track last watered timestamp and duration after each cycle completes.

## Camera

| Device | Notes |
|---|---|
| Front Yard (Reolink E1 Outdoor SE PoE) | Firmware v3.1.0.5223_2510172104 |

**Features:** Auto-tracking, Guard return, AI motion detection (Vehicle, Human, Pet), Infrared night mode, FTP/Email/Push notifications, Siren on event.

## Sensors

| Entity | Notes |
|---|---|
| Front Yard Tap Timer Next watering | Sensor showing next scheduled run |
| Front Yard Tap Timer Fault | Binary sensor |
| Front Yard Vehicle | Binary sensor (Reolink AI) |
| Bhyve Hub Connected | Binary sensor |

## Notes / Gotchas

- The Plants dashboard is linked to soil sensor data from the Zigbee2MQTT-based Third Reality Gen2 soil sensors (Outdoor1, Outdoor2, Outdoor3 Gen2) — these are currently unassigned to a specific area but physically in the front yard garden.
- The `bhyve` integration was recently added (entry ID: `01K3V102B7MY0TPYPRP67G7M15`). Ensure the Bhyve Hub stays connected.
- Watering duration helpers store data from HA automations — they are the source of truth for the Plants dashboard watering history.

## Last Updated

2026-06-24

# Garage

## Overview

The Garage is the most entity-rich area in the home with 117 entities. It contains a RATGDO-controlled garage door opener, an Aqara smart lock, a Reolink Driveway floodlight camera, Eufy Garage camera, Lutron wall switch lighting, Amazon Echo Dot, and motion sensors — all with robust automation coverage.

**Entity count:** 117 | **Floor:** Ground Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Garage Lights (Lutron) | Lutron | PD-8ANS-XX (WallSwitch) | lutron_caseta |
| ratgdov2.5i e4d21f | ratgdo | ESPHome 2023.12.9 | esphome |
| Garage Door Ratgdo (TP-Link) | TP-Link | KP401 | tplink |
| Garage Smart Lock | Aqara | Smart Lock U100 | matter |
| Driveway (Reolink) | Reolink | Elite Pro Floodlight PoE | reolink |
| Garage (Eufy Camera) | Eufy Security | T8441 | eufy_security |
| Garage Motion Sensor | Aqara | Motion Sensor P1 | matter |
| Garage (Amazon Echo Dot) | Amazon | Echo Dot | alexa_devices |

## Garage Door

Controlled by **RATGDO v2.5i** (ESPHome firmware 2023.12.9) via local LAN.

| Entity | Type | Notes |
|---|---|---|
| Garage Door | Cover | Open/close/stop control |
| RATGDO Power Switch | Switch | Power toggle for RATGDO module |
| Garage Door Ratgdo LED | Switch | Status LED |
| ratgdov2.5i e4d21f Lock remotes | Lock | Remote lock/enable state |
| Garage Door Light | Light | Garage opener light via RATGDO |

**Automations:**
- `Garage Door Opening Lights` — turns on garage lights when door opens
- `Notify if Garage Door open` — sends notification if door left open

## Lighting

| Entity | Type |
|---|---|
| Garage Lights | Lutron PD-8ANS switch (via switch_as_x → light) |
| Driveway Floodlight | Reolink floodlight (on/off) |
| Driveway Status LED | Reolink camera status LED |
| Garage Door Light | RATGDO-controlled opener light |

**Automation:** `Motion Activation Garage` — motion sensor triggers garage lights.

## Security

### Aqara Smart Lock U100 (Matter)
- State: `unlocked` (as of last check)
- Bridged via Aqara Hub M2
- `Garage Smart Lock Actuator` — binary sensor for bolt state
- `Garage Smart Lock Operating mode` — select entity

### Reolink Driveway Floodlight Camera
- Model: Elite Pro Floodlight PoE
- Firmware: v3.2.0.5932_2601201959
- Entities: Driveway (camera), Driveway Fluent (RTSP), Floodlight, Siren, Motion detection, AI detection (Vehicle, Pet, Human, etc.)
- **Vehicle detection** binary sensor: `Front Yard Vehicle`, `Driveway Vehicle` — actively used

### Eufy Garage Camera (T8441)
- Firmware: 2.1.0.2
- `alarm_control_panel.garage` (armed_home)
- Motion, Pet, Person detection notifications
- RTSP stream available

### Aqara Motion Sensor P1 (Matter)
- Entity: `Garage Motion Sensor Occupancy`
- Bridged via Aqara Camera Hub G3

## Voice / Media

| Device | Notes |
|---|---|
| Garage (Amazon Echo Dot) | Music Assistant player; Alexa Devices |
| Garage (MA) | Music Assistant group player |

## Notes / Gotchas

- The `ratgdov2.5i` ESPHome device has no HA area assigned in the device registry — entities are correctly assigned to `garage` area but the parent device shows `area_id: null`.
- Two separate Garage Smart Lock entities exist: one via Matter (Aqara Smart Lock U100) and the `ratgdov2.5i e4d21f Lock remotes` (which controls RATGDO's remote access, not the door lock itself).
- The Reolink Driveway camera uses the `reolink` native integration (not RTSP-only) — this provides full motion detection, AI detection, siren, and floodlight control.

## Last Updated

2026-06-24

# Guest Bathroom

## Overview

The Guest Bathroom is a small area with 5 entities. Its primary smart function is water leak detection via an Aqara Water Leak Sensor (Matter).

**Entity count:** 5 | **Floor:** 2nd Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Guest Bathroom Water Leak Sensor | Aqara | Aqara Water Leak Sensor (sw v6) | matter |

## Sensors

| Entity | Type | Notes |
|---|---|---|
| Guest Bathroom Water Leak Sensor Water leak | Binary sensor | Triggers `Water Leak Alert` automation |
| Guest Bathroom Water Leak Sensor Battery | Sensor | CR2032 |
| Guest Bathroom Water Leak Sensor Battery voltage | Sensor | — |
| Guest Bathroom Water Leak Sensor Battery type | Sensor | — |

## Automation

The `Water Leak Alert` automation monitors all Aqara Water Leak Sensors (including this one) and sends a notification if water is detected.

## Notes / Gotchas

- This sensor is bridged via the Aqara Camera Hub G3 (Matter). If the Hub G3 is offline, the sensor becomes unavailable.
- Battery replacement is CR2032; monitor the Battery sensor entity for low levels.

## Last Updated

2026-06-24

# Guest Bedroom

## Overview

The Guest Bedroom is a comfortable secondary bedroom on the 2nd Floor with 22 entities. It has Lutron dimmable lights, a Bond-controlled ceiling fan, Motionblinds motorized top-down/bottom-up shades, an ecobee room sensor, and an Amazon Echo Dot.

**Entity count:** 22 | **Floor:** 2nd Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Guest Bedroom Lights | Lutron | DVRF-6L (DivaSmartDimmer) | lutron_caseta |
| Guest Bedroom Pico | Lutron | PJ2-1P-GXX (PaddleSwitchPico) | lutron_caseta |
| Guest Fan | Olibra (Bond) | — | bond |
| Guest Bedroom Shades | Motionblinds | TopDownBottomUp | motion_blinds |
| Guest (Amazon Echo Dot) | Amazon | Echo Dot | alexa_devices |
| ecobee Room Sensor (Guest Bedroom) | ecobee | Room Sensor | ecobee |

## Lighting

| Entity | Type |
|---|---|
| Guest Bedroom Lights | Lutron DVRF-6L dimmer |
| Guest Fan (light kit) | Bond fan with light |

## Climate / Comfort

| Entity | Notes |
|---|---|
| Guest Fan | Bond ceiling fan (speed, direction, light) |
| ecobee Guest Bedroom | Room temperature / occupancy sensor |
| Guest Bedroom Occupancy | Binary sensor |

## Covers / Blinds

| Entity | Type |
|---|---|
| Guest Bedroom Shades Top | Top-down shade |
| Guest Bedroom Shades Bottom | Bottom-up shade |
| Guest Bedroom Shades Combined | Combined TDBU control |

## Voice / Media

| Device | Notes |
|---|---|
| Guest (Amazon Echo Dot) | Alexa + Music Assistant player |
| Guest (MA) | Music Assistant room group |

## Notes / Gotchas

- Guest Mode helper (`input_boolean.guest_mode`) is available system-wide to adjust automations when guests are present.

## Last Updated

2026-06-24

# Hallway

## Overview

The Hallway is a transition space on the 2nd Floor with 6 entities. It has a Lutron dimmable light, a Pico remote, and an Aqara Motion Sensor P1 for motion-activated lighting.

**Entity count:** 6 | **Floor:** 2nd Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Hallway Lights | Lutron | DVRF-6L (DivaSmartDimmer) | lutron_caseta |
| Hallway Pico | Lutron | PJ2-1P-GXX (PaddleSwitchPico) | lutron_caseta |
| Hallway Aqara Motion Sensor P1 | Aqara | Motion Sensor P1 (sw v10) | matter |

## Lighting

| Entity | Type |
|---|---|
| Hallway Lights | Lutron dimmer |

## Motion

| Entity | Notes |
|---|---|
| Hallway Aqara Motion Sensor P1 Occupancy | Binary sensor |

**Automation:** `Motion Activation Hallway Lights` — turns on hallway lights on motion.

**Automation:** `Link hallway lights to upstairs when turning on lights` — syncs hallway and upstairs hallway lights.

## Last Updated

2026-06-24

# Kitchen

## Overview

The Kitchen has 76 entities and is one of the most device-dense areas. It contains a smart lock, multiple Lutron dimmers, motorized blinds, LG refrigerator, GE Profile smart oven, an Amazon Echo for voice control, and extensive Emporia Vue energy monitoring across individual appliance circuits.

**Entity count:** 76 | **Floor:** Ground Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Kitchen Smart Lock | Aqara | Smart Lock U100 | matter |
| Kitchen Lights | Lutron | DVRF-6L (DivaSmartDimmer) | lutron_caseta |
| Kitchen Under Cabinet | Lutron | DVRF-6L (DivaSmartDimmer) | lutron_caseta |
| Kitchen Pico 1 | Lutron | PJ2-1P-GXX (PaddleSwitchPico) | lutron_caseta |
| Kitchen Cabinet Pico | Lutron | PJ2-1P-GXX (PaddleSwitchPico) | lutron_caseta |
| Kitchen Blinds | Motionblinds | RollerBlind | motion_blinds |
| Refrigerator | LG | 2REF11EICD__2-FD (REFRIGERATOR) | smartthinq_sensors |
| GE Profile Oven SRHV558129P | GE Profile | PCHS920YM3FS | ge_home |
| Kitchen (Alexa) | Amazon | Echo (4th gen) | alexa_devices |
| Kitchen Appliances | Emporia | VUE003 | emporia_vue |
| Microwave | Emporia | VUE003 | emporia_vue |
| Stove | Emporia | VUE003 | emporia_vue |
| Fridge | Emporia | VUE003 | emporia_vue |
| Kitchen Plugs | Emporia | VUE003 | emporia_vue |
| Kitchen Plug | Emporia | VUE003 | emporia_vue |
| Dishwasher | Emporia | VUE003 | emporia_vue |

## Lighting

| Entity | Type | Notes |
|---|---|---|
| Kitchen Lights | Lutron dimmer | Main overhead lights |
| Kitchen Under Cabinet | Lutron dimmer | Under-cabinet accent |
| Kitchen Pico 1 | Pico remote | Paddle switch remote |
| Kitchen Cabinet Pico | Pico remote | Cabinet area control |

**Automation:** `Bar Switch - Button 3 - Kitchen Lights` — Bar 4-button switch Button 3 triggers kitchen lights.

## Security / Access

| Entity | Notes |
|---|---|
| Kitchen Smart Lock (Aqara U100) | Matter lock; `lock.kitchen_smart_lock` |
| Kitchen Smart Lock Actuator | Binary sensor showing physical bolt state |

**Automation:** `Smart Lock Unlocked 30 Min Alert` — notifies if any smart lock remains unlocked for 30+ minutes.

## Covers / Blinds

| Entity | Type |
|---|---|
| Kitchen Blinds | Motionblinds RollerBlind |

## Appliances

### LG Refrigerator
- Model: 2REF11EICD__2-FD
- Integration: `smartthinq_sensors` (HACS) — currently in `setup_retry`; entities may be intermittently unavailable
- Climate entities: `Fridge` and `Freezer` (temperature control)

### GE Profile Oven
- Model: PCHS920YM3FS
- Integration: `ge_home` (HACS)
- Entities: Cook Mode sensor, Oven water heater entity
- **Note:** ge_home has a pending HACS update (v2026.2.1) requiring HA restart

## Voice

| Device | Notes |
|---|---|
| Kitchen (Amazon Echo) | Alexa Devices integration; Music Assistant player |

## Energy Monitoring (Emporia Vue)

| Circuit | Notes |
|---|---|
| Kitchen Appliances | General kitchen plug load |
| Microwave | Individual circuit |
| Stove | Individual circuit |
| Fridge | Individual circuit |
| Kitchen Plugs | Counter plug strip |
| Kitchen Plug | Single outlet |
| Dishwasher | Individual circuit |

> The Kitchen has the most granular energy monitoring in the home — 7 separate Emporia Vue circuits covering every major appliance.

## Notes / Gotchas

- `smartthinq_sensors` is in `setup_retry` status — LG appliance data may be stale or unavailable until the add-on is updated and HA is restarted.
- The `ge_home` integration requires a restart after the pending HACS update.
- The Kitchen Smart Lock (Aqara U100) is bridged via the Aqara Hub M2 (Matter). If the Hub M2 goes offline, the lock entity becomes unavailable — but the physical lock still works mechanically.
- `Kitchen Cabinet Pico` has no floor assignment (area_id: null) — this is a cosmetic registration issue; the device is physically in the kitchen.

## Last Updated

2026-06-24

# Laundry Room

## Overview

The Laundry Room is on the 2nd Floor with 34 entities. It contains an LG WashTower (combined washer/dryer unit) monitored via SmartThinQ, plus Emporia Vue energy monitoring for both washer and dryer circuits.

**Entity count:** 34 | **Floor:** 2nd Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| WashTower (Dryer) | LG | W3S1CVK2EVS_D_US-Dryer (TOWER_DRYER) | smartthinq_sensors |
| Washer | LG | F3S1CWK__-FL (TOWER_WASHER) | smartthinq_sensors |
| Washer (Emporia) | Emporia | VUE003 | emporia_vue |
| Dryer (Emporia) | Emporia | VUE003 | emporia_vue |

## Appliances

### LG WashTower
- **Washer:** TOWER_WASHER (F3S1CWK__-FL) — firmware clip_hna_v1.9.226
- **Dryer:** TOWER_DRYER (W3S1CVK2EVS_D_US) — firmware clip_hna_v1.9.226
- Integration: `smartthinq_sensors` (HACS) — currently in `setup_retry`
- Entities include: Dry level (sensor), wash/dry mode selectors, run state

> **Note:** `smartthinq_sensors` has a pending HACS update (v0.43.0) and is in `setup_retry` — washer/dryer entities may be unavailable until updated and HA restarted.

## Energy Monitoring (Emporia Vue)

| Circuit | Notes |
|---|---|
| Washer | Individual circuit monitoring |
| Dryer | Individual circuit monitoring |

## Notes / Gotchas

- The `smartthinq_sensors` integration needs a restart after the pending HACS update (v0.43.0). Until then, LG appliance sensors may be unavailable.
- Emporia Vue circuits for washer/dryer provide power monitoring independently of SmartThinQ — even if SmartThinQ fails, energy data continues.

## Last Updated

2026-06-24

# Living Room

## Overview

The Living Room is the primary common area on the Ground Floor. It is the most entity-rich ground-floor room (94 entities) and contains the main TV, ecobee thermostat, Apple TV 4K, ceiling fan, motorized blinds, and multiple smart lighting circuits.

**Entity count:** 94 | **Floor:** Ground Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Samsung Frame 55 | Samsung | QN55LS03BAFXZC | samsungtv_smart + samsungtv + smartthings |
| Apple TV 4K (Gen 3) | Apple | Apple TV 4K Gen3 (26.5) | apple_tv |
| ecobee Smart Thermostat Premium | ecobee | ecobee Smart Premium | ecobee |
| Living Room fan | Olibra (Bond) | — | bond |
| Living Room Lamp Switch | TP-Link | KS205 | tplink |
| Bar Shelves | TP-Link | KP125M (energy monitoring) | tplink |
| Christmas Lights | TP-Link | HS103 | tplink |
| Living Room Blinds | Motionblinds | RollerBlind | motion_blinds |
| Living Room Main Spot Lights | Lutron | DVRF-6L (DivaSmartDimmer) | lutron_caseta |
| Living Room Powder Room Entry | Lutron | DVRF-6L (DivaSmartDimmer) | lutron_caseta |
| Living Room Pico | Lutron | PJ2-3BRL-GXX-X01 (Pico3ButtonRaiseLower) | lutron_caseta |
| Samsung Soundbar S60B | Samsung | HW-S61B | alexa_devices + smartthings |
| Rajeev's Samsung Soundbar S60B | Amazon (Alexa) | Samsung Soundbar S60B | alexa_devices |
| YoLink Speaker Hub | YoLink | SpeakerHub | yolink |
| 4 Scene Switch | Tuya | TS0044 (4-button) | zha |
| Soil sensor 2 | Third Reality | 3RSM0147Z | zha |
| Living Room 4 Button Switch (Z2M) | Tuya | Wireless 4-button | zigbee2mqtt |
| Living Room Gen1 Soil Sensor (Z2M) | Third Reality | Smart Soil Moisture Sensor | zigbee2mqtt |
| Main Floor Plugs | Emporia | VUE003 | emporia_vue |
| Main Floor Lights | Emporia | VUE003 | emporia_vue |

## Lighting

| Entity | Type | Notes |
|---|---|---|
| Living Room Main Spot Lights | Lutron dimmer | Main overhead lighting |
| Living Room Powder Room Entry | Lutron dimmer | Entry/powder room transition |
| Living Room Lamp Switch | TP-Link KS205 | Controls floor lamp; automation on/off |
| Christmas Lights Living Room | Zigbee plug (Z2M) | Seasonal; Third Reality plug |
| Bar Shelves | TP-Link KP125M | Under-bar/shelf accent lights (energy metered) |

**Scenes:**
- Living Room Bright
- Living Room Guest
- Living Room Off
- Living Room Partial

**Automations:**
- `Living Room Lamps On Automation` — turns on lamp switch
- `Living Room Lamps Off Automation` — turns off lamp switch

## Climate

| Entity | Notes |
|---|---|
| ecobee Smart Thermostat Premium | Primary whole-home thermostat; cooling active (`cool` mode) |
| Living Room fan (Bond) | Ceiling fan speed control |

## Media

| Device | Notes |
|---|---|
| Samsung Frame 55 | Main TV; triple-integrated (SamsungTV Smart, SamsungTV native, SmartThings) |
| Apple TV 4K Gen3 (tvOS 26.5) | Primary streaming device; firewall/network managed |
| Living Room (Music Assistant) | MA player — Apple TV 4K as audio target |
| Living Room soundbar (HW-S61B) | Samsung soundbar via SmartThings + Alexa |
| Rajeev's Samsung Soundbar S60B | Alexa-accessible version of same device |

## Covers / Blinds

| Entity | Type |
|---|---|
| Living Room Blinds | Motionblinds RollerBlind |

## Energy Monitoring (Emporia Vue)

| Circuit | Notes |
|---|---|
| Main Floor Plugs | General plug load |
| Main Floor Lights | Lighting circuits |

## Presence / Sensors

| Entity | Notes |
|---|---|
| Living Room Occupancy | Binary sensor (ecobee room sensor) |

## Notes / Gotchas

- The Samsung Frame 55 is registered three times in HA (SamsungTV Smart, native SamsungTV via zeroconf, and SmartThings). The `samsungtv_smart` entry (`c5aba40a`) is the primary control path with full feature support.
- The 4-button Tuya scene switch (ZHA) and the Zigbee2MQTT version of the same device (`Living Room 4 Button Switch`) are separate device registrations — they represent the same physical device bridged through different Zigbee paths.
- Bar Shelves (KP125M) has energy monitoring — useful for tracking bar/accent light power draw.

## Last Updated

2026-06-24

# Master Bathroom

## Overview

The Master Bathroom is on the 3rd Floor with 20 entities. The primary smart devices are two TP-Link KS205 smart switches: one controlling a towel heater (for heated towel rail) and one for a shower timer/exhaust switch.

**Entity count:** 20 | **Floor:** 3rd Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Bathroom Towel Heater | TP-Link | KS205 | tplink |
| Bathroom Shower Switch | TP-Link | KS205 | tplink |

## Switches

| Entity | Notes |
|---|---|
| Bathroom Towel Heater | Smart switch for heated towel rail |
| Bathroom Towel Heater Auto-off enabled | Auto-off timer feature |
| Bathroom Shower Switch | Smart switch for shower exhaust or secondary circuit |
| Bathroom Shower Switch Turn off in | Number entity — auto-off timer (minutes) |

## Notes / Gotchas

- Both KS205 switches support auto-off timers — the `Bathroom Shower Switch Turn off in` number entity sets the auto-off duration.
- These switches do not currently have automation coverage — they are manually controlled or scheduled.

## Last Updated

2026-06-24

# Media Room

## Overview

The Media Room is the entertainment hub of the home and has the highest entity count of any room at 123 entities. It contains a full Philips Hue lighting setup (11 bulbs + Hue dimmer), Lutron SmartBridge 2 (whole-home Lutron hub), Sony BRAVIA TV, Samsung Soundbar Q930B, Motionblinds motorized shades, Bond Bridge ceiling fan, ecobee room sensor, CPS UPS, Xbox, LetPot hydroponic gardens, VLC media player, and a downstairs Aqara motion sensor.

**Entity count:** 123 | **Floor:** 2nd Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Smart Bridge 2 (Lutron Hub) | Lutron | L-BDGPRO2-WH (SmartBridge) | lutron_caseta |
| Jeeves Hue (Bridge) | Signify | Hue Bridge (fw 1.77) | hue |
| Media Room Shades | Motionblinds | TopDownBottomUp | motion_blinds |
| Motionblinds Gateway | Motionblinds | Wi-Fi bridge (A1.1.5) | motion_blinds |
| My Bridge (Bond) | Olibra | zermatt-2 (fw v4.29.42) | bond |
| Ceiling fan | Olibra (Bond) | — | bond |
| BRAVIA 4K UR2 | Sony | BRAVIA 4K UR2 | androidtv_remote + cast + dlna_dmr |
| Bell Streamer | — | Bell Streamer (Cast) | cast |
| Media Room Soundbar (Q930B) | Samsung | HW-Q930B | smartthings |
| Rajeev's Samsung Soundbar | Samsung | HW-Q930B | alexa_devices |
| ecobee Room Sensor (Media Room) | ecobee | Room Sensor | ecobee |
| Media Room UPS | CPS | CP1500AVRLCDa (BF01512B6L1) | nut |
| Hue dimmer switch 2 | Signify | Hue dimmer switch (fw 2.85.1) | hue |
| Xbox (jeeves54) | Microsoft | Xbox Network | xbox |
| LetPot Chrome 1 - Right | LetPot | LetPot Senior | letpot |
| LetPot Chrome 2 - Left | LetPot | LetPot Senior | letpot |
| VLC-TELNET | VideoLAN | VLC via Telnet | vlc_telnet |
| Downstairs Motion Sensor | Aqara | Motion Sensor P1 | matter |
| 2nd Floor Plugs | Emporia | VUE003 | emporia_vue |

## Hue Lighting

The Media Room has the most extensive Hue lighting in the home — 11 Philips Hue devices.

| Device | Model | Type |
|---|---|---|
| Color Lamp 1 | Hue color lamp | Color |
| Color Lamp 2 | Hue color lamp | Color |
| Colour Lamp 3 | Hue color lamp | Color |
| Hue color lamp 2 | Hue color lamp | Color |
| Ceiling White Lamp 1 | Hue white lamp | White |
| Ceiling White Lanp 2 | Hue white lamp | White |
| Media Room Ceiling Lamp 3 | Hue white lamp | White |
| Hue play 1 | Hue play | Color Gradient |
| Hue play 2 | Hue play | Color Gradient |
| Hue bloom 1 | Hue bloom | Color |
| Media room (Hue Room group) | Room group | All media room Hue lights |

**Hue Dimmer Switch 2** controls media room Hue lighting with 4 buttons.

**Hue Automation:** `Jeeves Hue Automation: Hue dimmer switch 2` and `Jeeves Hue Automation: Leaving home` — managed by Hue app but exposed in HA.

**Hue Entertainment:** `Jeeves Hue Entertainment area 1` binary sensor tracks active Hue Entertainment (Sync Box / game/movie sync).

**Hue Scenes (Media Room — 18 scenes):**
Tropical twilight · Relax · Energize · Read · Bright · Rio · Nightlight · Concentrate · Epic Movie Night · Dimmed · Savanna sunset · Movie Night · Arctic aurora

**Lutron Scenes (Smart Bridge 2 — for Media Room):**
Night · Notifications · Garage · Off garage · Movie downstairs

## Media / AV

| Device | Notes |
|---|---|
| BRAVIA 4K UR2 | Sony Android TV; triple-integrated (AndroidTV Remote, Cast, DLNA DMR) |
| Bell Streamer | Bell Fibe streaming box (Cast) |
| Media Room Soundbar (Q930B) | Samsung soundbar via SmartThings |
| Rajeev's Samsung Soundbar | Same device via Alexa Devices |
| VLC-TELNET | VLC media player add-on (core_vlc); `media_player.vlc_telnet` |
| Xbox (jeeves54) | Xbox Series via Xbox integration |
| BRAVIA 4K UR2 (Music Assistant) | Sony TV as Music Assistant player |
| Soundbar (Music Assistant) | Q930B as Music Assistant player |
| Media Room (MA) | Music Assistant room player |
| Rajeev's Samsung Soundbar (MA) | MA Q930B group |

## Motorized Shades

| Entity | Type |
|---|---|
| Media Room Shades Top | Top-down shade |
| Media Room Shades Bottom | Bottom-up shade |
| Media Room Shades Combined | Combined TDBU control |

## Environment / Sensors

| Entity | Notes |
|---|---|
| ecobee Media Room | Temperature / occupancy room sensor |
| Media Room Occupancy | Binary sensor |
| Downstairs Motion Sensor | Aqara P1 — covers media room/stairway area |
| Media Room UPS Load | Sensor — % load on UPS |
| Media Room UPS (full) | NUT integration; battery, load, runtime, voltage |

## Power

| Entity | Notes |
|---|---|
| Media Room UPS (CPS CP1500AVRLCD) | 1500VA UPS; NUT integration; protects AV equipment |
| `sensor.media_room_ups_load` | Real-time load % |
| 2nd Floor Plugs (Emporia) | Energy monitoring for 2nd floor outlets |

**Automation:** `UPS Power Outage Notification` — alerts when UPS switches to battery.

## Notes / Gotchas

- The Lutron SmartBridge 2 (`0024fcfce6e52a4465c4fbadc16d4ef2`) is assigned to the Media Room but serves as the hub for ALL Lutron Caseta devices in the whole home.
- BRAVIA 4K UR2 appears multiple times in device registry: Cast, AndroidTV Remote, DLNA DMR, and Music Assistant — each integration sees it separately.
- The `letpot` integration is in `setup_retry` — LetPot plant lights may intermittently drop.
- VLC-TELNET provides a local audio output target for TTS and Music Assistant.

## Last Updated

2026-06-24

# Office

## Overview

The Office is on the 3rd Floor with 48 entities. It contains a Lutron dimmer, Bond ceiling fan, Motionblinds top-down/bottom-up shades, an ecobee room sensor, Amazon Echo Dot with Clock, Xerox printer, AdGuard Home network-level DNS blocker, HACS device tracker, SpeedTest, Govee Cloud integration gateway, and Emporia Vue energy monitoring.

**Entity count:** 48 | **Floor:** 3rd Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Office Lights | Lutron | DVRF-6L (DivaSmartDimmer) | lutron_caseta |
| Office Fan | Olibra (Bond) | — | bond |
| Office Shades | Motionblinds | TopDownBottomUp | motion_blinds |
| Office Dot Clock | Amazon | Echo Dot with Clock | alexa_devices |
| ecobee Room Sensor (Office) | ecobee | Room Sensor | ecobee |
| SpeedTest | — | speedtestdotnet | speedtestdotnet |
| Uptime | — | uptime | uptime |
| HACS | hacs.xyz | v2.0.5 | hacs |
| Govee Integration | Govee | Cloud API | govee |
| AdGuard Home | AdGuard Team | v0.107.74 | adguard |
| Xerox B205 | Xerox | B205 Multifunction | ipp (setup_retry) |
| Third Floor Plugs | Emporia | VUE003 | emporia_vue |

## Lighting

| Entity | Type |
|---|---|
| Office Lights | Lutron dimmer |
| Office Fan (light kit) | Bond fan light |

## Climate / Comfort

| Entity | Notes |
|---|---|
| Office Fan (Bond) | Ceiling fan |
| ecobee Office | Room temperature / occupancy sensor |
| Office Occupancy | Binary sensor |

## Covers / Blinds

| Entity | Type |
|---|---|
| Office Shades Top | Top-down shade |
| Office Shades Bottom | Bottom-up shade |
| Office Shades Combined | Combined TDBU |

## Network / Infrastructure

| Device | Notes |
|---|---|
| AdGuard Home (v0.107.74) | DNS-based ad/tracker blocker; query logging; `adguard` integration |
| SpeedTest | Periodic internet speed tests (`speedtestdotnet`) |
| Uptime | HA instance uptime sensor |
| HACS (v2.0.5) | Home Assistant Community Store — manages custom integrations and frontend cards |

**AdGuard entities:**
- `switch.adguard_home_protection` — master toggle
- `switch.adguard_home_parental_control`
- `switch.adguard_home_safe_search`
- `switch.adguard_home_safe_browsing`
- `switch.adguard_home_filtering`
- `switch.adguard_home_query_log`
- `sensor.adguard_home_dns_queries_blocked_ratio`

## Voice / Media

| Device | Notes |
|---|---|
| Office Dot Clock (Amazon Echo Dot w/ Clock) | Clock display + Alexa + Music Assistant |
| Office Dot Clock (MA) | Music Assistant player |

## Printer

| Device | Notes |
|---|---|
| Xerox B205 Multifunction Printer | IPP integration; currently in `setup_retry` — may need network check |

## Energy Monitoring

| Circuit | Notes |
|---|---|
| Third Floor Plugs | Emporia Vue VUE003 — 3rd floor outlet load |

## Notes / Gotchas

- The Xerox B205 printer (`ipp` integration) is in `setup_retry` — likely an intermittent network connection issue. Check that the printer IP is static/reserved.
- Govee Cloud Integration gateway device is registered to the Office area, but actual Govee lights (Bar Bulbs, UnderBar Lights) are in the Bar area.

## Last Updated

2026-06-24

# Patio

## Overview

The Patio is a small outdoor entertaining area on the Ground Floor with 12 entities. It has a TP-Link KS205 switch (Porch light), a Lutron pendant dimmer, and a few associated switches.

**Entity count:** 12 | **Floor:** Ground Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Porch | TP-Link | KS205 | tplink + switch_as_x |
| Living Room Pendants | Lutron | DVRF-6L (DivaSmartDimmer) | lutron_caseta |

## Lighting

| Entity | Type | Notes |
|---|---|---|
| Porch | TP-Link KS205 → light (switch_as_x) | Porch/patio light; auto-off capable |
| Living Room Pendants | Lutron dimmer | Patio-adjacent pendant lights |

**TP-Link Porch features:**
- `Porch Auto-off enabled` — timed auto-off
- `Porch Auto-update enabled`
- `Porch LED` — status indicator

## Notes / Gotchas

- "Living Room Pendants" (Lutron) is registered under the `patio` area_id — this is because these pendants are physically on the patio side of the living/patio space.
- The Porch KS205 is exposed as both a `switch` and a `light` via the `switch_as_x` integration (entry ID: `01KGVC6667EY13D9V1M4F47RN2`).

## Last Updated

2026-06-24

# Upstairs Hallway

## Overview

The Upstairs Hallway connects the 3rd Floor rooms with 6 entities. It has a Lutron dimmable light, Aqara Motion Sensor P1, and a Zigbee2MQTT smart plug (used as a repeater/switch in the hallway).

**Entity count:** 6 | **Floor:** 3rd Floor

## Devices

| Device | Manufacturer | Model | Integration |
|---|---|---|---|
| Upstairs Hallway Lights | Lutron | DVRF-6L (DivaSmartDimmer) | lutron_caseta |
| Upstairs Motion Sensor | Aqara | Motion Sensor P1 (sw v10) | matter |
| Upstairs Hallway Switch | Third Reality | Zigbee/BLE smart plug | zigbee2mqtt |

## Lighting

| Entity | Type |
|---|---|
| Upstairs Hallway Lights | Lutron dimmer |
| Upstairs Hallway Switch | Zigbee2MQTT smart plug (outlet control) |

## Motion

| Entity | Notes |
|---|---|
| Upstairs Motion Sensor Occupancy | Binary sensor |

**Automation:** `Motion Activation Upstairs Hallway 2` — triggers upstairs hallway lights on motion.

**Automation:** `Link hallway lights to upstairs when turning on lights` — coordinates 2nd and 3rd floor hallway lights.

## Notes / Gotchas

- The Upstairs Hallway Switch (Third Reality Zigbee plug) via Zigbee2MQTT acts as a Zigbee mesh router in addition to its switch function — helps extend Zigbee coverage to the 3rd floor.

## Last Updated

2026-06-24