Home Assistant - Récupérer la consommation d'un compteur Linky avec l'API Enedis

Aujourd’hui, nous allons voir comment récupérer sa consommation électrique dans Home Assistant via l’API Enedis.

Le compteur Linky est le compteur électrique communicant déployé par Enedis en France. Il permet notamment de suivre sa consommation électrique à distance.

Cette solution peut s’avérer bien pratique si vous vivez en appartement et que votre compteur Linky est situé dans les parties communes, hors de portée de votre réseau domestique.

C’est une solution qui peut également être envisagée si vous êtes locataire et que vous ne souhaitez pas apporter de modification au compteur de votre logement.

⚠️ Important : cette solution permet de récupérer la consommation électrique à J+1, vous n’aurez pas votre consommation en temps réel.

Pré-requis

Pour réaliser ce projet, vous aurez besoin de :

• Une installation Home Assistant fonctionnelle
• Un compteur électrique Linky
• Un compte Enedis

Enedis - Activer le partage de données

Aller dans la section Gérer l’accès à mes données de votre compteur.

⚠️ L’activation peut prendre plusieurs jours.

Activer ensuite “Enregistrement de la consommation horaire” et “Collecte de la consommation horaire”.

Ces options permettrons la récupération des informations par API.

Installation du module ha-linky

Le module Home Assistant Linky est disponible sur GitHub : ha-linky.

Celui-ci permet de synchroniser les données de votre compteur Linky avec les tableaux de bord énergie de Home Assistant.

Tout d’abord, nous allons suivre le readme et cliquer sur le lien pour ajouter le module dans notre instance de Home Assistant.

Lien pour ajouter le module : Intégrer ha-linky dans Home Assistant

La page suivante va s’ouvrir pour ajouter le module :

Cliquer sur “Open Link”, vous devez être redirigé dans votre Home Assistant avec la modale d’ajout du module. Cliquer sur “Ajouter” pour ajouter le dépôt à la liste des sources de modules complémentaires.

Nous allons maintenant installer le module. Pour cela, rechercher le module Linky dans la liste des modules complémentaires puis l’installer.

L’installation est terminée, nous allons pouvoir passer à la configuration !

Récupération des tokens API et configuration du module ha-linky

Token API

Le module fourni dans sa documentation GitHub une page très bien faite pour récupérer un token API.

Nous allons nous rendre sur la page https://conso.boris.sh/exemples/ puis cliquer sur le lien “J’accède à mon espace client Enedis”.

Une fois dans votre espace Enedis, on vous demande de valider le partage de vos données avec le service Conso-API

La validation faite, vous devez obtenir le token d’API ainsi qu’un rappel du numéro PRM de votre compteur.

Nous allons pouvoir utiliser ces informations pour configurer la collecte des données.

Configuration du module ha-linky

Pour configurer la collecte, nous allons nous rendre dans l’onglet “Configuration” du module ha-linky installé sur notre instance Home Assistant.

Dans la section Options > meters, nous allons coller le bloc suivant :

- prm: "votre code PRM"
  token: >-
    votre token API    
  name: Linky consumption
  action: sync
  production: false

Explication :

• prm : Le code d’identification unique de votre compteur (visible sur votre facture ou l’interface Enedis)
• token : Le jeton API généré précédemment
• name : Le nom qui sera affiché dans Home Assistant pour cette source d’énergie
• action : Le type d’action à effectuer (sync pour la synchronisation, reset pour réinitialiser les données)
• production : À définir sur true si vous produisez de l’électricité (panneaux solaires par exemple)

⚠️ Si vous avez une production d’électricité, vous pouvez ajouter un bloc de configuration avec le paramètre production à true.

Vous pouvez également configurer le prix du kWh dans la section Options > costs.

La configuration des coûts permet de définir différents tarifs selon les plages horaires (par exemple pour les heures creuses/pleines).

Voici à quoi resemble la configuration pour mon logement :

- price: 0.2047
  after: "01:34"
  before: "07:34"
- price: 0.2816
  after: "07:34"
  before: 12h34
- price: 0.2047
  after: "12:34"
  before: "14:34"
- price: 0.2816
  after: "14:34"
  before: "01:34"

Voici à quoi ressemble le paramétrage complet :

Une fois la configuration effectuée, le module ha-linky va pouvoir synchroniser la consommation de notre compteur par API.

Configuration du tableau de bord énergie

Rendons nous dans l’onglet “Énergie” de Home Assistant.

Si vous n’avez pas encore configuré de sources de consommation ou production, vous devez vous retrouver devant cet écran :

Nous allons maintenant ajouter notre source de consommation d’électricité. Cliquer sur “Ajouter une consommation” puis sélectionner la source Linky créée précédemment.

Dans mon cas, j’utilise l’entité costs de la source de données pour suivre les coûts vu que j’ai paramétré les tarifs du kWh en fonction des plages horaires.

Visualisation de la consommation éléctrique

Maintenant que notre source de consommation électrique est paramétrée dans le tableau de bord énergie, nous pouvons visualiser la consommation de notre compteur Linky directement depuis Home Assistant !

Si vous souhaitez également avoir l’empreinte carbone du réseau électrique affiché avec votre consomation, il suffit d’activer “Electricity Maps dans l’écran de configuration du tableau de bord énergie.

Resources

• https://github.com/bokub/ha-linky

Conclusion

Nous avons vu aujourd’hui comment récupérer notre consommation électrique via l’API Enedis. Cette solution à l’avantage de fonctionner avec tous les compteurs Linky, quelle que soit leur localisation.

Son inconvénient reste la disponibilité des informations à J+1 mais dans mon cas d’usage cela ne pose pas de problème.

Si votre compteur Linky est à porté de réseau, il existe des solutions physique comme le module ZLinky qui vont se brancher directement sur sortie TIC du compteur pour fournir les informations en temps réel.