# 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