fake666 / 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.
  • option to directly reload component only
  • provide an integration picture
  • switch to enable/disable AP Mode/Hotspot of device -> Did somebody find a corresponding functionality wihtin the Wattpilot APP?

Known Errors:

  • config_flow Options workflow (if you press "configure" button within Integrations view) does not work. WORKAROUND: If you want to change options remove and re-add the entity.

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

Installation

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

Optional:

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%