100 lines
2.9 KiB
Markdown
100 lines
2.9 KiB
Markdown
# 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* |