Custom component to support Automower.
This integration is based on the offical API. The integration is using the Husqvarna websocket API for pushed updates, so no polling is performed. You need a API key to use this integration, refer to this guide on how to get one.
Only mowers with built-in Automower® Connect or with the Automower® Connect Module are supported. e.g.
- AUTOMOWER® 315X
- AUTOMOWER® 405X
- AUTOMOWER® 415X
- AUTOMOWER® 430X
- AUTOMOWER® 435X AWD
- AUTOMOWER® 450X
Requires Home Assistant 2022.5.0 or newer.
If you have not yet installed HACS, go get it at https://hacs.xyz/ and walk through the installation and configuration.
Then find the Husqvarna Automower integration in HACS and install it.
Restart Home Assistant!
Install the new integration through Configuration -> Integrations in HA (see below).
Download the husqvarna_automower.zip file from the release section. Extract it and copy the content into the path /config/custom_components/husqvarna_automower of your HA installation. Do not download directly from the main branch.
In order to use this integration you must get a API-Key from Husqvarna.
-
Create an account if needed, otherwise sign in with your Husqvarna account.
-
After signing in you will be automatically redirected to "Your applications". (Otherwise go to: https://developer.husqvarnagroup.cloud/apps)
-
Create an new application, name it for example "My Home Assistant" (doesn't matter), leave the other fields empty.
-
Click on "+ Connect new API" and connect the Authentication API and the Husqvarna Automower API.
-
Copy your Application Key, this is what you need when you add the integration in Home Assistant.
Setup under Integrations in Home Assistant, search for "husqvarna_automower" and click on it, or use the My button:
If the integration is not shown, try to refresh your browser (F5) or (Shift+F5). Maybe you need to reopen your browser.
Login with API-Key and Application Secret. You can find them on the Husqvarna site
[
On the Husqvrana site edit your Application and add your Home Assistant instance as redirect URL. Use My HomeAssistant https://my.home-assistant.io/redirect/oauth
You will be re-directed to the Husqvarna site and have to login there with username and password to authorize Home Assistant.
The optional camera entity is disabled by default. The camera entity will plot the current coordinates and location history of the mower on a user provided image. To configure the entity you need to upload your desired map image and determine the coordinates of the top left corner and the bottom right corner of your selected image.
The camera entity is configured via the configure option on the integration. To enter the coordinates, ensure that they are in Signed Degree format and seperated by a comma for example (40.689209, -74.044661)
You can then provide the path to the image you would like to use for the map and mower, this has been tested with the PNG format, other formats may work.
vacuum.start
The mower continues to mow, within the specifed schedule
vacuum.pause
Pauses the mower until a new command
vacuum.stop
The mower returns to the base and parks there until the next schedule starts
vacuum.return_to_base
The mower returns to the base and parks there until it gets a new start command
husqvarna_automower.park_and_start
With the this command you can override the curent schedule for a specific time. For more details see the Services chapter
| Name | Type | Possible values | Description |
|---|---|---|---|
| command | string | Start | Park |
Start or park the mower |
| duration | int | 1...60480 |
Duration for this command in minutes |
| target | string | The entity_id of your mower |
Example for starting without the schedule for 120 minutes:
service: husqvarna_automower.park_and_start
data:
command: Start
duration: 120
target:
entity_id: vacuum.automower_r_315x_haffi
Example for parking indepentend from the schedule for 5 minutes:
service: husqvarna_automower.park_and_start
data:
command: Park
duration: 5
target:
entity_id: vacuum.automower_r_315x_haffi
To enable debug logging for this integration and related libraries you
can control this in your Home Assistant configuration.yaml
file. Example:
logger:
default: info
logs:
custom_components.husqvarna_automower: debug
aioautomower: debug
After a restart detailed log entries will appear in /config/home-assistant.log.