Was macht homelab?
HomeLab Agent – Verwaltet Home Assistant, ESP32-Satelliten, Zigbee/Matter/Thread-Geräte, physische Automatisierungen, Kameras und Sensoren. Entscheidungs- und Ausführungsebene auf der Hardware (keine Software-Orchestrierung wie Automatisierung/n8n).
Funktionen
- Steuerung von Home Assistant: Senden von Befehlen an Lichter, Thermostate, Jalousien, Szenen, Benachrichtigungen und mehr.
- ESP32-Satelliten: Direkte Kommunikation mit ESP32-Geräten für dezentrale Sensorik und Aktorik.
- Zigbee/Matter/Thread: Vollständige Kompatibilität mit Geräten über diese Protokolle (z. B. Phillips Hue, Ikea TRÅDFRI, Apple HomeKit-fähige Geräte).
- Kameras und Sensoren: Auslesen von Bildströmen und Messwerten (Temperatur, Luftfeuchtigkeit, Bewegung, Tür/Fenster-Kontakte).
- Aktionen auf Hardwareebene: Lokale Entscheidungsfindung und Ausführung ohne Cloud-Abhängigkeit.
- Protokollierung: Jeder Befehl und jede Aktion wird lokal protokolliert für Transparenz und Optimierung.
Schnellstart
- Voraussetzungen: Installierter und laufender Home Assistant (Version 2023.9 oder höher).
- ESP32-Firmware: Flashen Sie die Satelliten-Firmware auf Ihre ESP32-Geräte (z. B. über ESPHome oder Arduino).
- Integration: Konfigurieren Sie die Integration in Ihrer
configuration.yaml(siehe Beispiel unten). - Token: Erstellen Sie ein langfristiges Zugriffstoken in Home Assistant unter „Profil“ → „Langfristige Zugriffstoken“.
- Konfiguration:
# Beispiel für configuration.yaml
homelab_agent:
hass_url: "http://localhost:8123"
hass_token: "YOUR_LONG_LIVED_ACCESS_TOKEN"
esp32_devices:
- name: "Wohnzimmer-Sensor"
ip: "192.168.1.100"
port: 8266
- name: "Küchen-Licht"
ip: "192.168.1.101"
port: 8266
camera_feeds:
- url: "rtsp://192.168.1.200:554/stream1"
name: "Eingangskamera"
- Start: Starten Sie Home Assistant neu, nachdem Sie die Konfiguration hinzugefügt haben.
- Kommandos: Senden Sie Befehle über die CLI oder API (siehe
caiqueDeOliveira-dev/homelab -h).
Befehlsreferenz
| Befehl | Beschreibung | Beispiel |
|---|---|---|
licht an | Schaltet ein bestimmtes Licht ein | licht an Wohnzimmer |
licht aus | Schaltet ein bestimmtes Licht aus | licht aus Küche |
temperatur | Liest die Temperatur eines Sensors aus | temperatur Wohnzimmer-Sensor |
kamera snapshot | Macht einen Screenshot einer Kamera | kamera snapshot Eingangskamera |
szene aktivieren | Aktiviert eine Home Assistant Szene | szene aktivieren Gute Nacht |
benachrichtigen | Sendet eine Benachrichtigung an alle registrierten Geräte | benachrichtigen Alarm ausgelöst |
Fehlerbehebung
- Keine Verbindung zu Home Assistant: Überprüfen Sie die URL und das Token. Stellen Sie sicher, dass Home Assistant läuft und erreichbar ist.
- ESP32 antwortet nicht: Prüfen Sie die IP-Adresse und den Port. Starten Sie das ESP32-Gerät neu und überprüfen Sie die Serienausgabe.
- Protokolldatei: Überprüfen Sie
~/.homelab_agent/logs/für detaillierte Fehlermeldungen.
Lizenz
MIT