# 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*