Entities and Services DE

Entities und Services

Sprache: Deutsch · English

Diese Seite dokumentiert alle Entitäten und benutzerdefinierten Services der Integration.

Gardena-Sensoren

Entität	Device Class	Einheit	Kategorie	Standard
Batterie	battery	%	Diagnose	aktiv
Batteriestatus	enum	--	Diagnose	aktiv
Signalstärke	--	%	Diagnose	deaktiviert
Bodenfeuchte	moisture	%	--	aktiv
Bodentemperatur	temperature	°C	--	aktiv
Umgebungstemperatur	temperature	°C	--	aktiv
Lichtintensität	illuminance	lx	--	aktiv
Betriebsstunden (Mäher)	--	h	Diagnose	deaktiviert
Aktivität (Mäher)	--	--	Diagnose	aktiv
Zustand (Mäher)	--	--	Diagnose	aktiv
Letzter Fehlercode	--	--	Diagnose	deaktiviert
Restzeit Steckdose	timestamp	--	--	aktiv
Steckdosen-Zustand	--	--	Diagnose	aktiv
Letzter Fehler Steckdose	--	--	Diagnose	deaktiviert
Restzeit Bewässerung (pro Ventil)	timestamp	--	--	aktiv
Ventil-Fehlercode (pro Ventil)	--	--	Diagnose	deaktiviert
Ventil-Zustand (pro Ventil)	--	--	Diagnose	aktiv
Fehlercode Ventilset	--	--	Diagnose	deaktiviert

Die Restzeit-Sensoren (Ventil und Steckdose) zeigen im HA-Frontend einen Live-Countdown. Bei Inaktivität bleiben sie ohne Wert. Wird ein neuer Bewässerungsbefehl gesendet, während das Ventil bereits aktiv ist (z. B. via start_watering), passt sich der Countdown automatisch an die neue Dauer an. Der Countdown verwendet den von der API gelieferten Zeitstempel des Befehls und bleibt damit auch nach einem Home-Assistant-Neustart oder Integrations-Reload korrekt.

Gardena-Binary-Sensoren

Entität	Device Class	Kategorie	Standard
Batterie schwach	battery	Diagnose	aktiv
Ventilfehler	problem	Diagnose	aktiv
Fehler (Mäher)	problem	Diagnose	aktiv
RF-Verbindung	connectivity	Diagnose	aktiv

Gardena-Ventil

Entität	Device Class	Funktionen
Ventil	water	Öffnen, Schließen

Pro physischem Ventil wird eine Entität erzeugt. Smart Water Control hat ein einzelnes Ventil; Smart Irrigation Control erzeugt eine Entität pro Zone. Ventil-Entitäten verwenden den in der Gardena-App konfigurierten Namen (z. B. "Rasen vorne"); ist kein Name gesetzt, fallen sie auf "Zone 1", "Zone 2" usw. zurück. Das Öffnen eines Ventils startet die Bewässerung mit einer Standarddauer von 60 Minuten. Für eine individuelle Dauer den Service start_watering verwenden.

Smart Irrigation Control — Limit gleichzeitig offener Ventile: Die Smart-Irrigation-Control-Hardware erlaubt pro Steuergerät maximal 2 gleichzeitig geöffnete Ventile. Die Integration prüft das lokal vorab: Sind bereits zwei Ventile am selben Steuergerät offen, wird das Öffnen eines dritten sofort mit einer übersetzten Fehlermeldung (too_many_open_valves) abgewiesen — kein fehlgeschlagener API-Aufruf, keine stillen Halbzustände. Erst eines der laufenden Ventile schließen oder den Timer abwarten. Eigenständige Smart-Water-Control-Geräte haben nur ein Ventil und sind nicht betroffen.

Gardena-Schalter

Entität	Device Class
Strom	outlet

Wird für Gardena-Smart-Power-Adapter erzeugt. Unterstützt Einschalten (unbegrenzt), Ausschalten und zeitgesteuertes Einschalten via turn_on_for-Service. Der Schalter setzt nach einem erfolgreichen API-Aufruf einen optimistischen lokalen Zustand, sodass der HA-Toggle sofort umschaltet, statt auf das bestätigende WebSocket-Event zu warten — und die Entität rendert als einzelner Toggle statt als zwei separate Ein/Aus-Buttons.

Gardena-Mähroboter (SILENO)

Entität	Funktionen
Mäher	Mähen starten, Andocken, Pause

Wird für Gardena-SILENO-Mähroboter erzeugt. Meldet die aktuelle Aktivität: mähend, angedockt, pausiert oder Fehler.

---

Automower

Entität	Funktionen
Mäher	Mähen starten, Andocken, Pause

Die aktuelle Aktivität wird auf Home-Assistant-Zustände abgebildet:

Automower-Aktivität	HA-Zustand
MOWING, LEAVING, GOING_HOME	Mähend
CHARGING, PARKED_IN_CS	Angedockt
(state = PAUSED)	Pausiert
STOPPED_IN_GARDEN, (state = ERROR/FATAL_ERROR)	Fehler

Automower-Sensoren

Entität	Device Class	Einheit	Kategorie	Standard
Batterie	battery	%	Diagnose	aktiv
Schnitthöhe	--	--	--	aktiv
Nächster Start	timestamp	--	--	aktiv
Gesamtmähzeit	--	h	Diagnose	aktiv
Gesamtladezeit	--	h	Diagnose	aktiv
Ladezyklen	--	--	Diagnose	aktiv
Kollisionen	--	--	Diagnose	aktiv
Gesamtfahrstrecke	--	m	Diagnose	aktiv
Klingen-Nutzungszeit	--	h	Diagnose	aktiv
Gesamtlaufzeit	--	h	Diagnose	aktiv
Gesamtsuchzeit	--	h	Diagnose	aktiv
Aktivität	enum	--	Diagnose	aktiv
Zustand	enum	--	Diagnose	aktiv
Inaktiv-Grund	--	--	Diagnose	aktiv
Eingeschränkt-Grund	enum	--	Diagnose	aktiv
Fehlercode	--	--	Diagnose	aktiv
Letzter Fehlerzeitpunkt	timestamp	--	Diagnose	aktiv
Schedule-Override	enum	--	Diagnose	aktiv
Zuletzt gesehen	timestamp	--	Diagnose	aktiv
Betriebsmodus	enum	--	Diagnose	aktiv

Zeitbasierte Statistiken (Mähzeit, Ladezeit, Klingennutzung, Laufzeit, Suchzeit) werden von der API in Sekunden geliefert und zur Anzeige in Stunden umgerechnet.

Automower-Binary-Sensoren

Entität	Device Class	Kategorie
Fehler	problem	Diagnose
Verbunden	connectivity	Diagnose

Fehler ist aktiv, wenn der Mäher im Zustand ERROR oder FATAL_ERROR ist. Verbunden spiegelt die Cloud-Verbindung des Mähers.

Automower-Schalter

Entität	Beschreibung
Scheinwerfer	Scheinwerfer immer an oder immer aus
Sperrzone: {Name}	Einzelne Sperrzonen aktivieren oder deaktivieren
Arbeitsbereich: {Name}	Einzelne Arbeitsbereiche aktivieren oder deaktivieren

Schalter für Scheinwerfer, Sperrzonen und Arbeitsbereiche werden nur erzeugt, wenn das Mähermodell sie unterstützt (capability-basiert).

Automower-Auswahl

Entität	Optionen	Beschreibung
Scheinwerfermodus	Immer an, Immer aus, Nur abends, Abends und nachts	Feingranulare Steuerung des Scheinwerfermodus

Der Scheinwerfermodus-Auswähler ergänzt den einfachen Ein/Aus-Schalter um alle vier vom Mäher unterstützten Modi.

Automower-Number

Entität	Bereich	Schritt	Beschreibung
Schnitthöhe	1--9	1	Globale Schnitthöhe
Schnitthöhe: {Arbeitsbereich}	0--100 %	1	Schnitthöhe pro Arbeitsbereich

Schnitthöhen-Entitäten pro Arbeitsbereich werden nur erzeugt, wenn der Mäher Arbeitsbereiche unterstützt.

Automower-Device-Tracker

Entität	Source Type	Standard
Position	GPS	deaktiviert

Zeigt Breiten- und Längengrad des Mähers aus der zuletzt empfangenen GPS-Position. Wird nur für Mähermodelle mit GPS-Funktion erzeugt. Aus Datenschutzgründen standardmässig deaktiviert — bei Bedarf manuell in den Entitätseinstellungen aktivieren.

Automower-Kalender

Entität	Beschreibung
Mähplan	Schreibgeschützter Kalender mit den geplanten Mähaufgaben

Jede Plan-Aufgabe erscheint als Kalender-Event mit der Bezeichnung "Mowing" (bzw. "Mowing (Arbeitsbereich)" für arbeitsbereichsspezifische Pläne). Zum Bearbeiten der Pläne die Husqvarna-Automower-App verwenden.

Automower-Button

Entität	Beschreibung
Fehler bestätigen	Den aktuellen Mäherfehler quittieren und löschen

Event-Entitäten

Sowohl Gardena- als auch Automower-Geräte stellen Event-Entitäten für Zustandsübergänge bereit, die sich gut für Automatisierungen eignen.

Entität	Events
Gardena-Mäher-Event	started_cutting, stopped, leaving, searching, charging, parked, paused, error, error_cleared
Gardena-Ventil-Event	started_watering, stopped_watering, error, error_cleared
Gardena-Steckdosen-Event	turned_on, turned_off, error, error_cleared
Automower-Event	started_mowing, stopped, going_home, charging, leaving, parked, paused, error, error_cleared

Hub-Diagnose-Sensoren

Jeder Konfigurationseintrag erzeugt ein virtuelles "Hub"-Gerät mit integrationsweiten Diagnose-Sensoren.

Entität	Beschreibung	Kategorie
Geräteanzahl	Anzahl der vom Eintrag verwalteten Geräte	Diagnose
Polling-Intervall	Aktuelles Polling-Intervall in Sekunden	Diagnose
API-Anfragen diesen Monat	Gesamtzahl der API-Anfragen im laufenden Kalendermonat	Diagnose
Verbleibendes API-Budget	Verbleibendes monatliches API-Budget in Prozent	Diagnose

Der Sensor API-Anfragen diesen Monat stellt zusätzlich month und budget als Extra-State-Attribute bereit — praktisch für Dashboard-Karten oder Automatisierungen, die warnen, sobald das Budget zur Neige geht.

Details zur Budgetüberwachung und wie die Integration innerhalb der Husqvarna-Quota bleibt: siehe API-Rate-Limits.

---

Benutzerdefinierte Services

Die Integration registriert fünf benutzerdefinierte Services für Gardena- und Mäher-Geräte.

gardena_smart_system.start_watering

Startet die Bewässerung eines Ventils für eine festgelegte Dauer und überschreibt einen aktiven Zeitplan.

Parameter	Typ	Pflicht	Beschreibung
target	Entity	ja	Eine valve-Entität dieser Integration
duration	Zahl	ja	Dauer in Minuten (1--1440)

service: gardena_smart_system.start_watering
target:
  entity_id: valve.garden_valve_1
data:
  duration: 30

gardena_smart_system.turn_on_for

Schaltet eine Smart-Steckdose für eine festgelegte Dauer ein.

Parameter	Typ	Pflicht	Beschreibung
target	Entity	ja	Eine switch-Entität dieser Integration
duration	Zahl	ja	Dauer in Minuten (1--1440)

service: gardena_smart_system.turn_on_for
target:
  entity_id: switch.garden_power_socket
data:
  duration: 120

gardena_smart_system.override_schedule

Lässt den Mäher für eine festgelegte Dauer mähen und ignoriert dabei den konfigurierten Zeitplan.

Parameter	Typ	Pflicht	Beschreibung
target	Entity	ja	Eine lawn_mower-Entität dieser Integration
duration	Zahl	ja	Dauer in Minuten (1--480)

service: gardena_smart_system.override_schedule
target:
  entity_id: lawn_mower.sileno_mower
data:
  duration: 60

gardena_smart_system.park_until_further_notice

Parkt den Mäher unbefristet. Er bleibt in der Ladestation, bis er manuell wieder freigegeben wird.

Parameter	Typ	Pflicht	Beschreibung
target	Entity	ja	Eine lawn_mower-Entität dieser Integration

service: gardena_smart_system.park_until_further_notice
target:
  entity_id: lawn_mower.automower_450x_mower

gardena_smart_system.resume_schedule

Setzt den automatischen Mähzeitplan des Mähers fort.

Parameter	Typ	Pflicht	Beschreibung
target	Entity	ja	Eine lawn_mower-Entität dieser Integration

service: gardena_smart_system.resume_schedule
target:
  entity_id: lawn_mower.automower_450x_mower

---

Siehe auch: Automatisierungsbeispiele