Entities and Services EN

Entities and Services

Sprache: English · Deutsch

This page documents all entities and custom services exposed by the integration.

Gardena Sensors

Entity	Device Class	Unit	Category	Default
Battery	battery	%	Diagnostic	Enabled
Battery state	enum	--	Diagnostic	Enabled
Signal strength	--	%	Diagnostic	Disabled
Soil moisture	moisture	%	--	Enabled
Soil temperature	temperature	°C	--	Enabled
Ambient temperature	temperature	°C	--	Enabled
Light intensity	illuminance	lx	--	Enabled
Operating hours (mower)	--	h	Diagnostic	Disabled
Activity (mower)	--	--	Diagnostic	Enabled
State (mower)	--	--	Diagnostic	Enabled
Last error code	--	--	Diagnostic	Disabled
Power socket remaining time	timestamp	--	--	Enabled
Power socket state	--	--	Diagnostic	Enabled
Power socket last error	--	--	Diagnostic	Disabled
Remaining watering time (per valve)	timestamp	--	--	Enabled
Valve error code (per valve)	--	--	Diagnostic	Disabled
Valve state (per valve)	--	--	Diagnostic	Enabled
Valve set error code	--	--	Diagnostic	Disabled

Remaining duration sensors (valve and power socket) display a live countdown in the HA frontend. When inactive, they show no value. If a new watering command is sent while the valve is already active (e.g. via start_watering), the countdown automatically adjusts to the new duration. The countdown uses the API-provided timestamp of when the duration was set, so it remains accurate even after a Home Assistant restart or integration reload.

Gardena Binary Sensors

Entity	Device Class	Category	Default
Battery low	battery	Diagnostic	Enabled
Valve error	problem	Diagnostic	Enabled
Error (mower)	problem	Diagnostic	Enabled
RF link	connectivity	Diagnostic	Enabled

Gardena Valve

Entity	Device Class	Features
Valve	water	Open, Close

One valve entity is created per physical valve. Smart Water Control devices have a single valve, while Smart Irrigation Control devices create one valve entity per zone. Valve entities use the name configured in the Gardena app (e.g. "Rasen vorne"); if no name is set, they fall back to "Zone 1", "Zone 2", etc. Opening a valve starts watering for 60 minutes (default). Use the start_watering service for a custom duration.

Smart Irrigation Control — concurrent valve limit: The Smart Irrigation Control hardware allows at most 2 valves open at the same time per controller. The integration enforces this locally with a preflight check: if two valves on the same controller are already open, opening a third one is rejected immediately with a translated error message (too_many_open_valves) — no failed API call, no silent half-states. Close one of the running valves first, or wait for its timer to expire. Standalone Smart Water Control devices are single-valve and not affected.

Gardena Switch

Entity	Device Class
Power	outlet

Created for Gardena Smart Power Adapter devices. Supports turn on (indefinitely), turn off, and timed on via the turn_on_for service. The switch applies an optimistic local state update immediately after a successful API call, so the HA toggle flips instantly instead of waiting for the confirming WebSocket event — and the entity renders as a single toggle rather than two separate on/off buttons.

Gardena Lawn Mower (SILENO)

Entity	Features
Mower	Start mowing, Dock, Pause

Created for Gardena SILENO robotic mowers. Reports current activity: mowing, docked, paused, or error.

---

Automower Lawn Mower

Entity	Features
Mower	Start mowing, Dock, Pause

Reports current activity mapped to Home Assistant states:

Automower Activity	HA State
MOWING, LEAVING, GOING_HOME	Mowing
CHARGING, PARKED_IN_CS	Docked
(state = PAUSED)	Paused
STOPPED_IN_GARDEN, (state = ERROR/FATAL_ERROR)	Error

Automower Sensors

Entity	Device Class	Unit	Category	Default
Battery	battery	%	Diagnostic	Enabled
Cutting height	--	--	--	Enabled
Next start	timestamp	--	--	Enabled
Total cutting time	--	h	Diagnostic	Enabled
Total charging time	--	h	Diagnostic	Enabled
Charging cycles	--	--	Diagnostic	Enabled
Collisions	--	--	Diagnostic	Enabled
Total drive distance	--	m	Diagnostic	Enabled
Blade usage time	--	h	Diagnostic	Enabled
Total running time	--	h	Diagnostic	Enabled
Total searching time	--	h	Diagnostic	Enabled
Activity	enum	--	Diagnostic	Enabled
State	enum	--	Diagnostic	Enabled
Inactive reason	--	--	Diagnostic	Enabled
Restricted reason	enum	--	Diagnostic	Enabled
Error code	--	--	Diagnostic	Enabled
Last error time	timestamp	--	Diagnostic	Enabled
Schedule override	enum	--	Diagnostic	Enabled
Last seen	timestamp	--	Diagnostic	Enabled
Operating mode	enum	--	Diagnostic	Enabled

Time-based statistics (cutting time, charging time, blade usage, running time, searching time) are reported by the API in seconds and converted to hours for display.

Automower Binary Sensors

Entity	Device Class	Category
Error	problem	Diagnostic
Connected	connectivity	Diagnostic

Error is on when the mower is in ERROR or FATAL_ERROR state. Connected reflects the mower's cloud connectivity.

Automower Switches

Entity	Description
Headlight	Turn headlights always on or always off
Stay-out zone: {name}	Enable or disable individual stay-out zones
Work area: {name}	Enable or disable individual work areas

Headlight, stay-out zone, and work area switches are only created if the mower model supports them (capability-based).

Automower Select Controls

Entity	Options	Description
Headlight mode	Always on, Always off, Evening only, Evening and night	Fine-grained headlight mode control

The headlight mode select complements the simple on/off headlight switch with all four modes supported by the mower.

Automower Number Controls

Entity	Range	Step	Description
Cutting height	1--9	1	Global cutting height setting
Cutting height: {work area}	0--100 %	1	Per-work-area cutting height percentage

Work-area cutting-height entities are only created if the mower supports work areas.

Automower Device Tracker

Entity	Source Type	Default
Position	GPS	Disabled

Shows the mower's latitude and longitude from the most recent GPS position. Only created for mower models with GPS capability. Disabled by default for privacy — enable it manually in the entity settings if you want GPS tracking.

Automower Calendar

Entity	Description
Mowing schedule	Read-only calendar showing scheduled mowing tasks

Each schedule task appears as a calendar event with the summary "Mowing" (or "Mowing (work area name)" for work-area-specific schedules). To modify schedules, use the Husqvarna Automower app.

Automower Button

Entity	Description
Confirm error	Acknowledge and clear the current mower error

Event Entities

Both Gardena and Automower devices expose event entities for state transitions, useful for automations.

Entity	Events
Gardena Mower event	started_cutting, stopped, leaving, searching, charging, parked, paused, error, error_cleared
Gardena Valve event	started_watering, stopped_watering, error, error_cleared
Gardena Power socket event	turned_on, turned_off, error, error_cleared
Automower event	started_mowing, stopped, going_home, charging, leaving, parked, paused, error, error_cleared

Hub Diagnostic Sensors

Each config entry creates a virtual "hub" device with integration-level diagnostic sensors.

Entity	Description	Category
Device count	Number of devices managed by this entry	Diagnostic
Polling interval	Current polling interval in seconds	Diagnostic
API requests this month	Total API requests in the current calendar month	Diagnostic
API budget remaining	Remaining monthly API budget as a percentage	Diagnostic

The API requests this month sensor exposes month and budget as extra state attributes, making it easy to build dashboard cards or automations that warn when the budget is running low.

See API Rate Limits for details on budget tracking and how the integration stays within the Husqvarna quota.

---

Custom Services

The integration registers five custom services for Gardena and mower devices.

gardena_smart_system.start_watering

Start watering a valve for a specific duration, overriding any active schedule.

Parameter	Type	Required	Description
target	entity	Yes	A valve entity from this integration
duration	number	Yes	Duration in minutes (1--1440)

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

gardena_smart_system.turn_on_for

Turn on a smart power socket for a specific duration.

Parameter	Type	Required	Description
target	entity	Yes	A switch entity from this integration
duration	number	Yes	Duration in minutes (1--1440)

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

gardena_smart_system.override_schedule

Force the mower to mow for a specific duration, ignoring its configured schedule.

Parameter	Type	Required	Description
target	entity	Yes	A lawn_mower entity from this integration
duration	number	Yes	Duration in minutes (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

Park the mower indefinitely. It will stay in the charging station until manually resumed.

Parameter	Type	Required	Description
target	entity	Yes	A lawn_mower entity from this integration

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

gardena_smart_system.resume_schedule

Resume the mower's automatic mowing schedule.

Parameter	Type	Required	Description
target	entity	Yes	A lawn_mower entity from this integration

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

---

See also: Automation Examples