mk-maddin / wattpilot-HA

This is a custom component to allow control of Fronius Wattpilot wallbox/electro vehicle charging devices in Homeassistant.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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:

  • charging mode change
  • start / stop charging
  • configuration for different charging behaviours
  • sensors for charging box status
  • next trip timing configuration via service call (& event when next trip timing value is changed) -> you can create an input_datetime (example) entity & corresponding automation (example) which ensures the input_datetime is in sync with the setting wihtin your wattpilot charger
  • log value changes for properties of the wallbox as warnings (enable/disable via service call)
  • can enable/disable e-go cloud charging API (enable/disable via service call) -> this is at your own responsibility - is not clear if fronius/you "pay" in some way for the e-go cloud API and thus are legally allowed to use -> as it is not required at the moment for the functionality of this component, I do not recommend to enable

Open Topics:

  • create an update entity
  • create a light integration for LED color control etc.
  • OCPP values support

Known Errors:

  • after Wattpilot firmware update the device no longer establishes an active connection until next HA restart. WORKAROUND: Restart home assistant once after Wattpilot firmware upgrade
  • after Wattpilot has gone offline (due to power loss / Wattpilot GO / WiFi disconnect) the device no longer establishes an active connection until next HA restart. WORKAROUND: Restart home assistant once after Wattpilot was offline

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.

About

This is a custom component to allow control of Fronius Wattpilot wallbox/electro vehicle charging devices in Homeassistant.

License:Apache License 2.0


Languages

Language:Python 100.0%