ChrisHaPunkt / ha-stihl-imow

Using https://github.com/ChrisHaPunkt/stihl-imow-webapi to provide STIHL iMow lawn mower information to Home Assistant
19 stars 1 forks source link
homeassistant-components imow sithl smarthome

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 https://github.com/ChrisHaPunkt/stihl-imow-webapi/issues/13

Known Issues

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:

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"