Skip to content

Latest commit

 

History

History
65 lines (39 loc) · 3.75 KB

README.md

File metadata and controls

65 lines (39 loc) · 3.75 KB
Raw

Hildebrand Glow (DCC) Integration

hacs_badge CodeFactor Grade DeepSource "Buy Me A Coffee"

Home Assistant integration for energy consumption data from UK SMETS (Smart) meters using the Hildebrand Glow API.

This integration works without requiring a consumer device provided by Hildebrand Glow and can work with your existing smart meter. You'll need to set up your smart meter for free in the Bright app on Android or iOS. This will only work when using the Data Communications Company (DCC) backend, which all SMETS 2 meters and some SMETS 1 meters do (more information). Once you can see your data in the app, you are good to go.

The data provided will be delayed by around 30 minutes. To get real-time consumption data, you can buy Hildebrand Glow hardware. Although this integration will work with their hardware, you should use the MQTT version here to get real-time consumption data.

This integration will currently emit one sensor for the daily usage of each detected smart meter.

Installation

Automated installation through HACS

You can install this component through HACS and receive automatic updates.

After installing HACS, visit the HACS Integrations pane and add https://github.com/HandyHat/ha-hildebrandglow-dcc as an Integration by following these instructions. You'll then be able to install it through the Integrations pane.

Manual installation

Copy the custom_components/hildebrandglow_dcc/ directory and all of its files to your config/custom_components directory. You'll then need to restart Home Assistant for it to detect the new integration.

Configuration

Visit the Integrations section within Home Assistant's Configuration panel and click the Add button in the bottom right corner. After searching for "Hildebrand Glow", you'll be asked for your Glow credentials.

Once you've authenticated, the integration will automatically set up a sensor for each of the smart meters on your account.

Debugging

To debug the integration, add the following to your configuration.yaml

logger:
  default: warning
  logs:
    custom_components.hildebrandglow_dcc: debug

Development

To begin, it is recommended to create a virtual environment to install dependencies:

python -m venv dev-venv
. dev-venv\Scripts\activate

You can then install the dependencies that will allow you to develop: pip3 install -r requirements-dev.txt

This will install homeassistant, autopep8, isort and pylint.

Code Style

This project makes use of isort, pylint and autopep8 to enforce a consistent code style across the codebase.

Credits

Thanks to the original project from which this project is forked, and to this python library for helping me troubleshoot.