Skip to content

ChrisHaPunkt/ha-stihl-imow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

92 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Home Assistant STIHL iMow

CI CI CI

HomeAssistant custom component for STIHL iMow lawn mower

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

Limitations

This integration is only compatible to STIHL iMow Generation up to 4. For alle mowers who are using the https://app.imow.stihl.com/#/ ui. See ChrisHaPunkt/stihl-imow-webapi#13

Known Issues

  • #25 Version v1.0.3: There is currently something leading to timeouts on the upstream STIHL server. This causes some HomeAssistant log entries stating a timeout. Everything is nevertheless working as expected.

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.

Screenshots

Integration

grafik

Overview

grafik

Service

grafik

Support

If you want to buy me a coffee, feel free: :) "Buy Me A Coffee"