/ha-brunata

Home Assistant integration to fetch utilities consumption data from Brunata Online

Primary LanguagePythonMIT LicenseMIT

Brunata Online Custom Integration for Home Assistant

hacs GitHub Release License

ko-fi

⚠️ This integration is still a work in progress ⚠️

Furthermore, this integration is not endorsed by Brunata, and could stop functioning at any time at their behest; your Brunata account might also be closed, although no EULA is provided for the Brunata Online Portal at the time of writing

⚠️ Please ensure your Brunata credentials work on online.brunata.com ⚠️

If your credentials don't work AND you use a different Brunata portal to view your metrics, please open a pull request and/or contact me on the Home Assistant Forum.

In most cases, you will likely have to add support for alternate portals yourself; I will gladly assist you in getting the login-flow working and finding the API endpoints. Then you can simply submit a Pull Request, and I'll review it when I have time 🙂


This integration allows Home Assistant to read meter values from the Brunata Online Portal. Brunata is an IoT-enabled utilities provider that's part of the Minol-ZENNER Group, mostly providing utilities to housing cooperatives in the EEA

✨ Planned Features

  • Add support for more metrics

    • 💧 Water consumption

    • 🔥 District heating / gas consumption

  • Expose metrics as Home Assistant sensors

  • Configure Python tests

  • Support writing historical metrics to sensor

The integration can fetch the following metrics

  • 📊 Available meter types — ⚠️ Only tested on two accounts so far ⚠️

  • ⚡ Energy meters

  • 💧 Water meters

  • 🔥 Heating meters — Thanks to WallyR on the Home Assistant Community forum

The following Home Assistant sensors have been implemented

⚠️ No sensors have been implemented yet ⚠️

Contributions are welcome!

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

Credits

This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template

Code template was mainly taken from @Ludeeus's integration_blueprint template

Active Directory B2C Login-flow was mostly based on @itchannel's FordPass Integration