README.md

My Energy - MijnEnergie.be Home Assistant integration

Mijn Energie Home Assistant custom component integration for Belgium. This custom component has been built from the ground up to bring MijnEnergie.be site data into Home Assistant sensors in order to follow up the cheapest energy electricty and gas prices. This integration is built against the public website provided by MijnEnergie.be for Belgium and has not been tested for any other countries.

This integration is in no way affiliated with MijnEnergie.

⚠️ Please don't report issues with this integration to MijnEnergie.be, they will not be able to support you.

For local gas station fuel prices and mazout, please check out my other custom integration Carbu.com

Installation

• HACS: add url https://github.com/myTselection/MyEnergy as custom repository (HACS > Integration > option: Custom Repositories)

  • 

• Restart Home Assistant

• Add 'MyEnergy' integration via HA Settings > 'Devices and Services' > 'Integrations'

Integration

Device MyEnergy should become available with the following sensors:

• MyEnergy [postalcode] [FuelType] [ContractType] with details on cheapest market energy rate that can be available to you (if you'd change contract), taking into account your configured criteria

  Attribute	Description
  State	cost in € per kWh
  Last update	Timestamp of last data refresh, throttled to limit data fetch to 1h
  Postalcode	Postalcode used to retrieve the prices
  Fuel type	Fuel type (Electricity or Gas) used to retrieve the prices
  Contract type	Contract type (Fixed or Variable) used to retrieve the prices
  Url	Full url that was used to retrieve the data, throught this url, full details can be seen and contract can be requested
  Provider Name	Name of the provider of the cheapest subscription for which a match was found
  Contract Name	Name of the cheapest subscription for which a match was found
  Energycost	Energycost (provider dependent part of subscription cost) of the cheapest subscription for which a match was found
  Netrate	Netrate (fixed part of subscription cost) of the cheapest subscription for which a match was found
  Promo	Promo (provider dependent promotion, part of subscription cost) of the cheapest subscription for which a match was found
  Total price per year	Total price per year of the cheapest subscription for which a match was found
  Total kWh per year	Total kWh per year on wich the lookup is based (total combination of day/night/... consumptions)
  fulldetail	If configuration option to add product and price detail json is enabled, all site data will be added as a json to enable fetching extra contract specific data. Example to fetch data out of it {{state_attr('sensor.myenergy_1190_electricity_fixed','fulldetail')[0].Dagtarief[0]}}

Status

Still some optimisations are planned, see Issues section in GitHub.

Technical pointers

The main logic and API connection related code can be found within source code MyEnergy/custom_components/MyEnery:

• sensor.py
• utils.py -> mainly ComponentSession class

All other files just contain boilerplat code for the integration to work wtihin HA or to have some constants/strings/translations.

If you would encounter some issues with this custom component, you can enable extra debug logging by adding below into your configuration.yaml:

Click to show example

logger:
  default: info
  logs:
     custom_components.myenergy: debug

Statistics

In order to keep long term statistics, you could create statistics sensors such as example below (I'm still experimenting with best config): in configuration.yaml:

Click to show example

sensor: 
  - platform: statistics
    name: "MyEnergy Electricity Fixed statistics"
    entity_id: sensor.myenergy_[postalcode]_electricty_fixed
    state_characteristic: average_linear
    sampling_size: 20
    max_age:
      hours: 24
  - platform: statistics
    name: "MyEnergy Electricity Variable statistics"
    entity_id: sensor.myenergy_[postalcode]_electricty_variable
    state_characteristic: average_linear
    sampling_size: 20
    max_age:
      hours: 24
  - platform: statistics
    name: "MyEnergy Gas Fixed statistics"
    entity_id: sensor.myenergy_[postalcode]_gas_fixed
    state_characteristic: average_linear
    sampling_size: 20
    max_age:
      hours: 24
  - platform: statistics
    name: "MyEnergy Gas Variable statistics"
    entity_id: sensor.myenergy_[postalcode]_gas_variable
    state_characteristic: average_linear
    sampling_size: 20
    max_age:
      hours: 24

Statistics Graph

Based on these statistics sensors that will become available after HA rebooted, you can add a Statistics Graph.

Click to show example

Dashboard:

      - chart_type: line
        period: month
        type: statistics-graph
        entities:
          - sensor.myenergy_electricity_fixed_statistics
          - sensor.myenergy_electricity_variable_statistics
          - sensor.myenergy_gas_fixed_statistics
          - sensor.myenergy_gas_variable_statistics
        stat_types:
          - mean
          - min
          - max
        title: Mijn Energie