Skip to content
This repository has been archived by the owner on Dec 3, 2022. It is now read-only.

Home Assistant integration for UK Smart Meters (SMETS) pulling data from the DCC via the free Hildebrand Glow API

License

Notifications You must be signed in to change notification settings

ColinRobbins/ha-hildebrandglow-dcc

 
 

Repository files navigation

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. Unfortunately this means the daily sensors lose the last 30 mins of the day. 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.

Installation

Automated installation through HACS

You can install this component through HACS to easily receive 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 to Glow, the integration will automatically set up the following sensors for each of the smart meters on your account:

Electricity Sensors

  • Electric Consumption (Today) - Consumption today (kWh)
  • Electric Consumption (Year) - Consumption for the year to date (kWh)
  • Electric Cost (Today) - Cost of electricity used today (GBP)
  • Electric Tariff Standing - Today's standing charge for electricity (GBP)
  • Electric Tariff Rate - Current tariff (GBP/kWh)

Gas Sensors

  • Gas Consumption (Today) - Consumption today (kWh)
  • Gas Consumption (Year) - Consumption for the year to date (kWh)
  • Gas Cost (Today) - Cost of gas used today (GBP)
  • Gas Tariff Standing - Today's standing charge for gas (GBP)
  • Gas Tariff Rate - Current tariff (GBP/kWh)

Energy Management

The sensors created integrate directly into Home Assistant's Home Energy Management. It is recommended you use the yearly sensors in the Energy integration.

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 go to: