- Notifications
You must be signed in to change notification settings - Fork0
🔌 Easily retrieve your Linky™ power consumption
License
Inf3rnus187/linky
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
N.B: Because this tool is targeted for french people, the documentation is...in french
Ce module vous permet de récupérer votre consommation électrique Linky via les nouvelles API"Authorize V1" et"Metering Data V4" d'Enedis
Il peut s'utiliser de 2 façons :
- En ligne de commande
- En tant que module Node.js, depuis un autre programme
Notez qu'il vous faut un compteur Linky et un espace client Enedis pour pouvoir utiliser ce module
Si vous avez Node.js sur votre machine :
npm i -g linky
Dans le cas contraire, vous pouvez télécharger le binaire correspondant à votre plateforme dans lesassets de la dernière release.
N.B : Si vous choisissez d'utiliser un binaire, il faudra adapter les exemples de cette documentation en replaçant la commande
linkypar le nom du binaire.Par exemple, au lieu de faire
linky --help, il faudra faire./linky-win.exe --help
Avant toute chose, il faudra vous connecter à votre espace client Enedis et leur donner l'autorisation de partager vos données avec une application extérieure.
Rendez-vous surconso.vercel.app pour donner votre accord et récupérer un jeu de tokens.
Puis, créez une connexion à votre compte avec la commande suivante :
linky auth -a<access token> -r<refresh token> -u<usage point ID>
Attention : Les tokens générés ont une durée de vie de quelques heures. Ils seront renouvelés automatiquement par cet outil et stockés sur votre ordinateur.
Nerelancez pas
linky authavec de vieux tokens, cela rendrait votre connexion invalide et vous devrez recommencer le process depuis le début.
Une fois vos tokens sauvegardés, vous pourrez récupérer votre consommation quotidienne, votre courbe de charge (consommation par demi-heure), et votre consommation maximale par jour.
# Récupère la consommation quotidienne du 1er au 7 septembre 2020 incluslinky daily --start 2020-09-01 --end 2020-09-08# Récupère la puissance moyenne consommée le 1er septembre 2020, sur un intervalle de 30 minlinky loadcurve --start 2020-09-01 --end 2020-09-02# Récupère la puissance maximale de consommation atteinte quotidiennement du 24 au 31 août incluslinky maxpower --start 2020-08-24 --end 2020-09-01
Vous pouvez sauvegarder vos résultats dans un fichier JSON grâce à l'option--output
linky loadcurve --start 2020-09-01 --end 2020-09-02 --output data/ma_conso.json
Pour voir l'aide détaillée :
linky --help
# Depuis un projet Node.jsnpm i linkyconstlinky=require('linky');// Créez une sessionconstsession=newlinky.Session({accessToken:'access token',refreshToken:'refresh token',usagePointId:'usage point ID',onTokenRefresh:(accessToken,refreshToken)=>{// Cette fonction sera appelée si les tokens sont renouvelés// Les tokens précédents ne seront plus valides// Il faudra utiliser ces nouveaux tokens à la prochaine création de session// Si accessToken et refreshToken sont vides, cela signifie que les tokens ne peuvent plus// être utilisés. Il faut alors en récupérer des nouveaux sur conso.vercel.app},});// Récupère la consommation quotidienne du 1er au 7 septembre 2020 inclussession.getDailyConsumption('2020-09-01','2020-09-08').then((result)=>{console.log(result);/* { "unit": "Wh", "data": [ { "date": "2020-09-01", "value": 12278 }, { "date": "2020-09-02", "value": 15637 }, ... */});// Récupère la puissance moyenne consommée le 1er septembre 2020, sur un intervalle de 30 minsession.getLoadCurve('2020-09-01','2020-09-02').then((result)=>{console.log(result);/* { "unit": "W", "data": [ { "date": "2020-09-01 00:00:00", "value": 582 }, { "date": "2020-09-01 00:30:00", "value": 448 }, ... */});// Récupère la puissance maximale de consommation atteinte quotidiennement du 24 au 31 août inclussession.getMaxPower('2020-08-24','2020-09-01').then((result)=>{console.log(result);/* { "unit": "VA", "data": [ { "date": "2020-08-24 13:54:04", "value": 1941 }, { "date": "2020-08-25 01:48:26", "value": 1648 }, ... */});
About
🔌 Easily retrieve your Linky™ power consumption
Resources
License
Stars
Watchers
Forks
Packages0
Languages
- TypeScript54.6%
- HTML34.6%
- JavaScript10.8%