Configuration DE

Konfiguration

Sprache: Deutsch · English

Die Integration wird vollständig über die Home-Assistant-Oberfläche konfiguriert. Es ist keine YAML-Konfiguration nötig.

Schritt 1 — Husqvarna-Application anlegen

Vor der Konfiguration der Integration wird eine Application auf dem Husqvarna Developer Portal benötigt, um API-Zugangsdaten zu erhalten.

1. Auf das Husqvarna Developer Portal gehen und ein Konto erstellen oder mit dem bestehenden Husqvarna-Konto anmelden.
2. Zu My Applications wechseln und Create Application klicken.
3. Einen Namen vergeben (z. B. Home Assistant) und als Redirect-URI https://localhost eintragen.
4. Unter Connected APIs die gewünschten APIs aktivieren:
   • Gardena Smart System API — für Gardena-Sensoren, -Ventile, -Steckdosen und SILENO-Mäher.
   • Automower Connect API — für Husqvarna-Automower-Mähroboter.
   • Beide können gleichzeitig in derselben Application aktiviert werden.
5. Application Key (Client ID) und Application Secret notieren — beide werden in Home Assistant für die Einrichtung benötigt.

Tipp: Eine dedizierte Application für Home Assistant verwenden. Jede Application hat ihr eigenes Kontingent von ~10.000 Anfragen/Monat. Wird eine Application zwischen mehreren Smart-Home-Plattformen geteilt, wird die Budgetüberwachung ungenau. Siehe API-Rate-Limits.

Schritt 2 — Integration in Home Assistant hinzufügen

1. Zu Einstellungen → Geräte & Dienste → Integration hinzufügen wechseln.
2. Nach Gardena Smart System suchen und auswählen.
3. Application Key (Client ID) und Application Secret aus dem Husqvarna Developer Portal eintragen.
4. API auswählen:
   • Gardena Smart System — für Gardena-Geräte (Sensoren, Ventile, Steckdosen, SILENO-Mäher).
   • Automower Connect — für Husqvarna-Automower-Mähroboter.
5. Für die Gardena Smart System API: Hat das Konto mehrere Gärten (Locations), wird abgefragt, welcher hinzugefügt werden soll. Bei nur einem Garten wird dieser automatisch ausgewählt.
6. Für die Automower Connect API: Alle dem Husqvarna-Konto zugeordneten Mäher werden automatisch erkannt.

Beide APIs gleichzeitig nutzen

Um sowohl Gardena- als auch Automower-Geräte zu verwenden, die Integration zweimal hinzufügen — einmal mit Gardena Smart System und einmal mit Automower Connect. Beide können dieselben Application-Zugangsdaten verwenden.

Erneute Authentifizierung

Sind die Zugangsdaten abgelaufen oder ungültig geworden, fordert Home Assistant zur erneuten Anmeldung auf.

1. Die Integrationsseite öffnen.
2. Auf Neu konfigurieren klicken.
3. Die aktualisierten Zugangsdaten eintragen.

Wichtig: Beim Wechsel der Husqvarna-Application (neue Client ID) wird der API-Budget-Zähler bei Reauth/Reconfigure zurückgesetzt, damit der Budget-Sensor zum frischen Server-Kontingent passt. Wird nur das Secret derselben Client ID erneuert, bleibt der Zähler erhalten.

MQTT-Bridge (optional)

Die Integration kann Gerätezustände an einen lokalen MQTT-Broker spiegeln. Details siehe MQTT-Bridge.

---

Weiter: Unterstützte Geräte