vault backup: 2026-03-12 08:35:13

Projects/Home Assistant/Home Assistant.md

@@ -0,0 +1,100 @@
+# Home Assistant
+
+## Environment
+- **URL:** http://192.168.0.39:8123
+- **Auth Token:** eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiIxMTRhMDMwYjNhNjg0N2JiYWY2YmUxNmY4YTBhYjVkZiIsImlhdCI6MTc3MDE3NTU0NSwiZXhwIjoyMDg1NTM1NTQ1fQ.8xxRzURj0NoFoo_UdtH34IXcuBX6fSpofdA8GjCK-B4
+- **MQTT Broker:** 192.168.0.39:1883 (corey/41945549)
+- **Status:** 🔄 In Progress (entity cleanup ongoing)
+- **Discord Channel:** #home-assistant (1466074219829006599)
+
+---
+
+## Room-Assistant (Bluetooth Presence) - WORKING! ✅
+
+**What it does:**
+- Pi Zero W BLE scans for known phones
+- Reports to HA via MQTT
+- Creates device_tracker entities per room
+- Multi-Pi setup gives room-level presence
+
+### Hardware
+- **Pi 1:** livingroom-pi (192.168.0.95)
+- **Bluetooth MAC:** B8:27:EB:50:C9:40
+- **SSH:** admin / 41945549
+- **SSH Key:** ~/.ssh/id_ed25519 (Windows SSH quirk - needs manual workarounds)
+
+### Phone Tracking
+- **Corey's Phone:** B0:C2:C7:07:28:B4 (motorola razr 2024)
+- **Phone MAC Discovery:**
+  - iPhone: Settings → About → Bluetooth
+  - Android: Settings → About Phone → Status → Bluetooth address
+
+### Room-Assistant Config (`/home/admin/config/local.yml`)
+```yaml
+mqtt:
+  host: "192.168.0.39"
+  port: 1883
+  username: "corey"
+  password: "41945549"
+bluetooth:
+  adminToken: "AF07072FBAC1FD6281FBE765DF6D841E"
+  timeout: 60
+  addresses:
+    - "b0:c2:c7:07:28:b5"  # Corey's phone MAC
+settings:
+  room: "LivingRoom"
+```
+
+### Home Assistant Entities Created
+- `sensor.livingroom_cluster_size`
+- `sensor.livingroom_cluster_leader`
+- `device_tracker.livingroom_phone` (when phone in range)
+
+### Key Config Notes
+- Config location: `/home/admin/config/local.yml` (NOT in room-assistant subdir)
+- Config format: keys at root level (v2.x), no "global." prefix
+- mdns module needed: `sudo npm install -g mdns` (for cluster discovery)
+- RSSI threshold: `-70` (adjustable for range)
+
+---
+
+## Current Tasks
+
+### High Priority
+- [ ] Entity cleanup (972 devices in spreadsheet)
+- [x] Fix hallway sensor battery (1%)
+- [ ] Add Kathy's phone to room-assistant config
+
+### In Progress
+- [x] Room-assistant setup and working
+- [x] Phone MAC paired and tracking
+- [ ] Multi-Pi expansion (clone SD after first Pi stable)
+
+---
+
+## Setup Workflow (for future Pis)
+1. Flash Pi OS Lite to SD card
+2. Enable SSH + WiFi via Pi Imager
+3. Copy config files to Pi
+4. Run `sudo ./setup-room-assistant.sh`
+5. Script prompts for: room name, MQTT creds, phone MACs
+
+---
+
+## Files Created
+- `room-assistant-config.yml` — BLE presence config template
+- `setup-room-assistant.sh` — Automated Pi setup script
+- `ROOM_ASSISTANT_SETUP.md` — Complete setup documentation
+- `temp/write_ha_names.py` — Push entity changes back to HA
+
+---
+
+## Integration Points
+- HA REST API (native)
+- MQTT (for room-assistant)
+- Mission Control dashboard (for display)
+- Discord notifications (alerts)
+
+---
+
+*Status: Room presence working, entity cleanup ongoing | Updated: 2026-02-22*