pantherale0 / haanglianwater

Home Assistant integration for Anglian Water

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Anglian Water

GitHub Release GitHub Activity License

Project Maintenance BuyMeCoffee

Discord Community Forum

Integration to integrate with haanglianwater.

This integration will set up the following platforms.

Platform Description
sensor Show the previous day water usage information.

This integration will also collect the past year worth of smart meter readings from your dashboard and import them into a statistic for use with your energy dashboard.

Installation

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called anglian_water.
  4. Download all the files from the custom_components/anglian_water/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Anglian Water"

Configuration is done in the UI

You should generally leave the Device ID field blank, the integration will generate this automatically after clicking submit.

Note, during first sign in, the integration needs to "register" Home Assistant as a mobile device to your Anglian Water account, to configure the access token and device IDs correctly a number of requests must be sent in a specific order. Enabling debug mode you will see it makes two requests to "register_device", a request to "get_dashboard_details" and finally a request to "get_bills_payments".

If the integration does not send the above queries in that order, the API to retrieve usage details continues to stay locked and this integration will not work. The integration does not store or process the data returned from the APIs for these extra endpoints, they are simply used to replicate the calls the mobile app creates.

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines


About

Home Assistant integration for Anglian Water

License:MIT License


Languages

Language:Python 95.9%Language:Shell 4.1%