mk-maddin / wattpilot-HA

This is a custom component to allow control of Fronius Wattpilot wallbox/electro vehicle charging devices in Homeassistant.
Apache License 2.0
61 stars 11 forks source link

Wattpilot Custom Component for homeassistant

What This Is:

This is a custom component to allow control of Fronius Wattpilot wallbox/electro vehicle charging devices in Homeassistant using the unofficial/reverese enginered wattpilot python module.

WARNING: This is a work in progress project - it is still in early development stage, so there are still breaking changes possible.

Disclaimer:

As written this is an unofficial implementation. Currently there does not seem to be an official API available by fronius, so this is all based on the work of volunteers and hobby programmers. It might stop working at any point in time.

You are using this module (and it's prerequisites/dependencies) at your own risk. Not me neither any of contributors to this or any prerequired/dependency project are responsible for damage in any kind caused by this project or any of its prerequsites/dependencies.

What It Does:

Allows for control of Fronius Wattpilot wallbox/electro vehicle charging devices via home assistant with the following features:

Open Topics:

Known Errors:

Screenshots

Example Device (additional sensors + buttons can be enabled)

screenshot of Wattpilot Device

screenshot of Wattpilot Device

Next Trip via timing via Service Call

screenshot of Next Trip service

Installation and Configuration

ATTENTION: Default configuration is for wattpilot firmware version > 38.5 !! If you are using older firmware, please read "Known Errors" instructions.

Installation

Install with HACS

Do you you have HACS installed? You can manually add this repository to your HACS installation. Here is the manual process. Then search for "Wattpilot" and install it directy from HACS. HACS will keep track of updates and you can easily upgrade to latest version. See Configuration for how to add it in HA.

Install manually

Download the repository and save the "wattpilot" folder into your home assistant custom_components directory.

Once the files are downloaded, you’ll need to restart HomeAssistant and wait some minutes (probably clear your browser cache), for the integration to appear within the integration store.

Configuration

Using MyHA:

MyHA - Add Integration

Manually:

  1. Browse to your Home Assistant instance.
  2. In the sidebar click on Configuration.
  3. From the configuration menu select: Integrations.
  4. In the bottom right, click on the Add Integration button.
  5. From the list, search and select "Fronius Wattpilot".
  6. Follow the instruction on screen to complete the set up.

screenshot of Config Flow

Credits:

Big thank you go to @joscha82. Without his greate prework in the wattpilot python module it would be not possible to create this.

License

Apache-2.0. By providing a contribution, you agree the contribution is licensed under Apache-2.0. This is required for Home Assistant contributions.