143 lines
3.1 KiB
Markdown
143 lines
3.1 KiB
Markdown
# Room Presence Setup with Pi Zeros
|
|
|
|
## Prerequisites
|
|
|
|
- Raspberry Pi Zero W (or Pi Zero 2 W)
|
|
- MicroSD card (8GB+)
|
|
- Power supply for Pi
|
|
- MQTT broker running on Home Assistant
|
|
|
|
## Step 1: Flash Raspberry Pi OS
|
|
|
|
1. Download **Raspberry Pi Imager** from https://www.raspberrypi.com/software/
|
|
2. Flash **Raspberry Pi OS Lite** (no desktop, smaller footprint)
|
|
3. Enable SSH and WiFi in the imager settings:
|
|
- Set hostname: `livingroom-pi` (one per room)
|
|
- Enable SSH with password auth
|
|
- Set WiFi credentials
|
|
|
|
4. Insert SD card and boot the Pi
|
|
|
|
## Step 2: Copy Files to Pi
|
|
|
|
```bash
|
|
# From your computer, copy the files to the Pi
|
|
scp room-assistant-config.yml setup-room-assistant.sh pi@<pi-ip>:~/
|
|
|
|
# SSH into the Pi
|
|
ssh pi@<pi-ip>
|
|
# Default password: raspberry
|
|
```
|
|
|
|
## Step 3: Run Setup
|
|
|
|
```bash
|
|
# Make the script executable
|
|
chmod +x setup-room-assistant.sh
|
|
|
|
# Run as sudo
|
|
sudo ./setup-room-assistant.sh
|
|
```
|
|
|
|
The script will prompt for:
|
|
- Room name (e.g., LivingRoom, Kitchen)
|
|
- MQTT username and password
|
|
- Phone MAC addresses
|
|
|
|
## Step 4: Find Phone MAC Address
|
|
|
|
**On iPhone:**
|
|
Settings → About → Bluetooth → Copy address (xx:xx:xx:xx:xx:xx)
|
|
|
|
**On Android:**
|
|
Settings → About Phone → Status → Bluetooth address
|
|
|
|
## Step 5: Verify in Home Assistant
|
|
|
|
Once running, room-assistant will create MQTT discoveries. In HA:
|
|
|
|
1. **Settings → Devices & Services → MQTT**
|
|
2. Look for new `device_tracker` entities:
|
|
- `device_tracker.corey_phone_livingroom`
|
|
- `device_tracker.kathy_phone_livingroom`
|
|
|
|
3. These appear in HA's device tracker UI
|
|
|
|
## Step 6: Create Room Zones (Optional)
|
|
|
|
```yaml
|
|
# In HA, create zones for each room
|
|
# Configuration.yaml or in the UI:
|
|
homeassistant:
|
|
zone:
|
|
- name: Living Room
|
|
latitude: !secret home_lat
|
|
longitude: !secret home_lon
|
|
radius: 5 # meters
|
|
```
|
|
|
|
## Files Created
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| `room-assistant-config.yml` | Template config (edit per room) |
|
|
| `setup-room-assistant.sh` | Automated install script |
|
|
| `config/local.yml` | Generated config (lives on Pi) |
|
|
|
|
## Managing Multiple Pis
|
|
|
|
Create a config file per room:
|
|
|
|
| Room | Hostname | Instance Name |
|
|
|------|----------|---------------|
|
|
| Living Room | livingroom-pi | LivingRoom |
|
|
| Kitchen | kitchen-pi | Kitchen |
|
|
| Bedroom | bedroom-pi | Bedroom |
|
|
|
|
## Troubleshooting
|
|
|
|
**WiFi not connecting?**
|
|
- Check `/etc/wpa_supplicant/wpa_supplicant.conf` for WiFi config
|
|
- Pi Zero W supports 2.4GHz only
|
|
|
|
**Bluetooth not scanning?**
|
|
```bash
|
|
# Check Bluetooth status
|
|
hciconfig
|
|
# Restart Bluetooth
|
|
sudo systemctl restart hciuart
|
|
```
|
|
|
|
**MQTT not connecting?**
|
|
- Verify MQTT credentials in `/home/pi/.room-assistant/config/local.yml`
|
|
- Check HA MQTT add-on is running
|
|
|
|
**View logs:**
|
|
```bash
|
|
journalctl -u room-assistant -f
|
|
```
|
|
|
|
## Customize RSSI Threshold
|
|
|
|
Lower value = detects devices farther away
|
|
Higher value = must be closer to be detected
|
|
|
|
```yaml
|
|
bluetoothClassic:
|
|
rssiThreshold: -70 # Default, adjust as needed
|
|
```
|
|
|
|
## Adding New Devices
|
|
|
|
Edit `/home/pi/.room-assistant/config/local.yml` and add:
|
|
|
|
```yaml
|
|
knownDevices:
|
|
- name: 'New Device'
|
|
address: 'AA:BB:CC:DD:EE:FF'
|
|
```
|
|
|
|
Then:
|
|
```bash
|
|
sudo systemctl restart room-assistant
|
|
``` |