Home Assistant STIHL iMow

HomeAssistant custom component for STIHL iMow lawn mower

A platform which allows you to interact with the STIHL iMow lawn mower.

Known Issues

Beta v1.0.0: There is currently something leading to timeouts on the upstream STIHL server if Home Assistant in constantly pulling the data from the upstream STIHL server.
I reached out to STIHl about this issue, but I don't have a response yet. This may lead to showing the mower as "offline" in the smartphone apps as well, even if the mower itself have a valid connection to the upstream servers.

Features

This platform is using the STIHL iMow API via the unofficial STIHL iMow Python WebAPI wrapper to get the information from the mower via the upstream STIHL Server.

In Home Assistant, this enables me to provide the following:

Display current state, statistics and settings in Home Assistant,
Upstream localisation, display state messages in you configured language
Configure Update/Polling interval,
Switch settings like automatic mode or gps protection on or off,
Initiate an action to a Mower via Home Assistant service call (edgeMowing, toDocking, startMowingFromPoint)

Installation

1.a Using the Home Assistant Community Store ( HACS )

If you're using HACS, add this Github-Repo url as a custom repo:
HACS 🠊 custom repositories 🠊 Type: 'Integration' 🠊 URL:

https://github.com/ChrisHaPunkt/ha-stihl-imow.git

Afterwards go to your HACS 🠊 Integrations 🠊 '+ EXPLORE & ADD REPOSITORIES' 🠊 search for 'STIHL',
if you're not presented with a New repository banner, to install the component to your server.

1.b Without HACS

Otherwise install the component manually by putting the files from /custom_components/stihl_imow/ in your folder <config directory>/custom_components/stihl_imow/

2. Restart your Home Assistant

You have to restart Home Assistant to make you server recognize the new integration.

Configuration

After installing, you have to configure the new component in your Home Assistant. This is done via the UI.

To do so, add the STIHL iMow Integration in your Servers Configuration 🠊 Integrations 🠊 '+ ADD INTEGRATION'.

Within the configuration flow provide your https://app.imow.stihl.com/# credentials to let Home Assistant access the upstream API and configure your preferred language for the state messages.

If you want to, you can adjust the update (polling-)interval. This changes how often Home Assistant is aksing the upstream server for an update. The default and suggested value is 30 seconds.