diff --git a/CLAUDE.md b/CLAUDE.md index c8fe08f..ace80e5 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -315,6 +315,19 @@ git add -A && git commit -m "Update docs" && git push ## Recent Changes +### 2026-01-14 +- **Guitar Room Humidity Automation** setup complete + - Homebridge installed on Mac Mini with `homebridge-plugin-govee` for BLE sensor access + - Govee H5074 temperature/humidity sensor bridged to Home Assistant + - VeSync integration added for Levoit LV600S humidifier control + - Automations created: turn ON below 45%, turn OFF above 47% + - Target: maintain 45-47% humidity for Lowden guitar storage +- **New Home Assistant integrations:** + - VeSync (vesync@htsn.io) - humidifier control + - HomeKit Controller - Homebridge bridge +- **Homebridge service:** `~/Library/LaunchAgents/com.homebridge.server.plist` +- **New HA entities:** `sensor.goveeh5074_5059_humidity`, `humidifier.lv600s` + ### 2026-01-11 - **BlueMap web map** for Minecraft Hutworld server - URL: https://map.htsn.io (password protected: hutworld / Suwanna123) @@ -372,8 +385,8 @@ git add -A && git commit -m "Update docs" && git push --- -**Last Updated**: 2026-01-05 -**Documentation Status**: ✅ Phase 1 Complete + Gateway Monitoring + MetaMCP + Tailscale +**Last Updated**: 2026-01-14 +**Documentation Status**: ✅ Phase 1 Complete + Gateway Monitoring + MetaMCP + Tailscale + Humidity Automation --- diff --git a/HOMEASSISTANT.md b/HOMEASSISTANT.md index 3c23476..3cb4262 100644 --- a/HOMEASSISTANT.md +++ b/HOMEASSISTANT.md @@ -132,6 +132,8 @@ curl -s -H "Authorization: Bearer $HA_TOKEN" \ - **Sonos** - Speakers - **Motion Sensors** - Various locations - **NUT (Network UPS Tools)** - UPS monitoring (added 2025-12-21) +- **VeSync** - Levoit humidifier control (added 2026-01-14) +- **HomeKit Controller** - Homebridge bridge for Govee sensors (added 2026-01-14) ### NUT / UPS Integration @@ -168,9 +170,76 @@ entities: name: Input Voltage ``` +### VeSync / Levoit LV600S Integration + +Controls the Levoit LV600S humidifier via VeSync cloud API. + +**Account:** vesync@htsn.io + +**Entities:** +| Entity ID | Description | +|-----------|-------------| +| `humidifier.lv600s` | Main humidifier on/off control | +| `sensor.lv600s_humidity` | Built-in humidity sensor (reads high near mist) | +| `number.lv600s_mist_level` | Mist intensity (1-9) | +| `switch.lv600s_display` | Display on/off | +| `binary_sensor.lv600s_low_water` | Low water warning | +| `binary_sensor.lv600s_water_tank_lifted` | Tank removed detection | + +### HomeKit Controller / Homebridge Integration + +Connects to Homebridge running on Mac Mini to access BLE devices (Govee sensors). + +**Homebridge Details:** +- Host: Mac Mini (localhost) +- Port: 51826 +- PIN: 031-45-154 +- Config: `~/.homebridge/config.json` +- Logs: `~/.homebridge/homebridge.log` +- LaunchAgent: `~/Library/LaunchAgents/com.homebridge.server.plist` + +**Govee H5074 Entities:** +| Entity ID | Description | +|-----------|-------------| +| `sensor.goveeh5074_5059_humidity` | Room humidity (accurate reading) | +| `sensor.goveeh5074_5059_temperature` | Room temperature | +| `sensor.goveeh5074_5059_battery` | Sensor battery level | + +**Homebridge Management:** +```bash +# Check status +launchctl list | grep homebridge + +# View logs +tail -f ~/.homebridge/homebridge.log + +# Restart Homebridge +launchctl stop com.homebridge.server +launchctl start com.homebridge.server + +# Stop Homebridge +launchctl unload ~/Library/LaunchAgents/com.homebridge.server.plist + +# Start Homebridge +launchctl load ~/Library/LaunchAgents/com.homebridge.server.plist +``` + ## Automations -TODO: Document key automations +### Guitar Room Humidity Control + +Maintains 45-47% humidity for guitar storage (Lowden recommends 49% ±2%). + +**Automations:** +| Automation | Trigger | Action | +|------------|---------|--------| +| `guitar_room_humidity_low_turn_on_humidifier` | Govee H5074 < 45% | Turn ON humidifier, set mist to 6 | +| `guitar_room_humidity_reached_turn_off_humidifier` | Govee H5074 > 47% | Turn OFF humidifier | + +**Why two thresholds (hysteresis):** +- Prevents rapid on/off cycling +- 45% turn-on, 47% turn-off creates a 2% buffer +- Target range: 45-47% (conservatively below Lowden's 49% spec) ## TODO