Linky TIC - Support Linky dans Home Assistant

Cette intégration pour Home Assistant ajoute le support des Linky au travers de n'importe quelle connection série en provenance du module TIC (Télé Information Client) du compteur Linky.

Par exemple:

~~Module série USB développé par LiXee (celui que j'utilise)~~ n'est plus disponible à la vente
LiXee TIC-DINv2.0 validé par (@Zehir)
Téléinfo 1 compteur USB rail DIN de Cartelectronic (validé par un utilisateur)
Circuit à faire soi-même, nécessitant peu de composants (autre article avec un circuit similaire). Validé par un utilisateur.
Module Micro Téléinfo V3.0 à fabriquer soi-même ou pré-assemblé sur Tindie
Teleinfo ADTEK attention cependant le baudrate ne semble pas standard.
et certainement bien d'autres ! (n'hésitez pas à m'ouvrir une issue pour rajouter le votre si vous avez validé que celui-ci fonctionne avec cette intégration afin d'aidez de potentiels futurs utilisateurs qui n'en auraient pas encore choisi un)

Exemple sous Home Assistant.

⚠️ Cette intégration n'est pas comptatible avec les modules zigbee ! Seulement ceux apportant la connection série du TIC directement à votre ordinateur !

Théoriquement cette intégration est compatible avec les compteurs pré Linky qui possèdent un module TIC en choisissant le mode historique. Mais n'en ayant aucun dans mon entourage, je n'ai pas pu le vérifier.

Si votre module série n'est pas branché sur la même machine que celle hébergeant votre Home Assistant, ce n'est pas un problème : vous pouvez transmettre la connection série au travers de votre réseau. Voir le dossier serialserver pour mettre en oeuvre une retransmission TCP au travers de votre réseau.

Informations remontées

Cette intégration va lire de manière continue les informations envoyées sur le TIC et stocker en mémoire la dernière valeur lue pour chacun des compteurs. Ensuite, Home Assistant viendra régulièrement lui même "récolter" les valeurs des différents sondes que l'intégration lui a déclaré. La fréquence observée semble être de 30 secondes. C'est largement suffisement pour la très grande majoritée des sondes.

Cependant, certaines sondes peuvent avoir de la valeur dans leur "instantanéité" (relative). Pour cela, l'intégration possède une option "temps réel" qui peut être activée. Celle-ci ne passera pas toutes les sondes en temps réel mais seulement celles pour qui cela peut avoir du sens (voir ci-dessous). Cette option temps réel notifiera Home Assistant qu'une nouvelle valeure est prête à être lue et lui demandera de venir la lire (et l'enregistrer) au plus vite à la différence des autres sondes dont les valeurs sont récupérées par Home Assistant, à son rythme.

Suivant la configuration que vous choisirez pour votre installation vous trouverez dans ce fichier dans la liste des sondes avec les annotations suivantes:

1 sonde compatible avec le mode temps réel: si celui-ci est activé par l'utilisateur, les mises à jours seront bien plus fréquentes (dès qu'elles sont lues sur la connection série)
2 sonde dont le mode temps réel est forcé même si l'utilisateur n'a pas activé le mode temps réèl dans le cas où la valeur de la sonde est importante et/ou éphémère

Mode historique

Le mode historique est le plus commun (existant pré Linky) : il est activé par défault à moins que vous soyez producteur d'énergie.

Compteurs mono-phasé

Les 23 champs des compteurs mono-phasé configurés en mode historique sont supportés:

ADCO Adresse du compteur (avec parsing EURIDIS en attributs étendus et périphérique agrégateur sous Home Assistant)
OPTARIF Option tarifaire choisie
ISOUSC Intensité souscrite
BASE Index option Base
HCHC Index option Heures Creuses - Heures Creuses
HCHP Index option Heures Creuses - Heures Pleines
EJPHN Index option EJP - Heures Normales
EJPHPM Index option EJP - Heures de Pointe Mobile
BBRHCJB Index option Tempo - Heures Creuses Jours Bleus
BBRHPJB Index option Tempo - Heures Pleines Jours Bleus
BBRHCJW Index option Tempo - Heures Creuses Jours Blancs
BBRHPJW Index option Tempo - Heures Pleines Jours Blancs
BBRHCJR Index option Tempo - Heures Creuses Jours Rouges
BBRHPJR Index option Tempo - Heures Pleines Jours Rouges
PEJP Préavis Début EJP (30 min)
PTEC Période Tarifaire en cours
DEMAIN Couleur du lendemain
IINST Intensité Instantanée 1
ADPS Avertissement de Dépassement De Puissance Souscrite 2
IMAX Intensité maximale appelée
PAPP Puissance apparente 1
HHPHC Horaire Heures Pleines Heures Creuses
MOTDETAT Mot d'état du compteur

Compteurs tri-phasés

⚠️ Actuellement en beta ⚠️

Des retours de log en DEBUG pendant l'émission de trames courtes sont nécessaires pour valider le bon fonctionnement de l'intégration sur ces compteurs, n'hésitez pas à ouvrir une issue si vous avec un compteur triphasé pour aider à sa finalisation !

ADCO Adresse du compteur (avec parsing EURIDIS en attributs étendus et périphérique agrégateur sous Home Assistant)
OPTARIF Option tarifaire choisie
ISOUSC Intensité souscrite
BASE Index option Base
HCHC Index option Heures Creuses - Heures Creuses
HCHP Index option Heures Creuses - Heures Pleines
EJPHN Index option EJP - Heures Normales
EJPHPM Index option EJP - Heures de Pointe Mobile
BBRHCJB Index option Tempo - Heures Creuses Jours Bleus
BBRHPJB Index option Tempo - Heures Pleines Jours Bleus
BBRHCJW Index option Tempo - Heures Creuses Jours Blancs
BBRHPJW Index option Tempo - Heures Pleines Jours Blancs
BBRHCJR Index option Tempo - Heures Creuses Jours Rouges
BBRHPJR Index option Tempo - Heures Pleines Jours Rouges
PEJP Préavis Début EJP (30 min)
PTEC Période Tarifaire en cours
DEMAIN Couleur du lendemain
IINST1 Intensité Instantanée (phase 1) 1 pour les trames longues 2 pour les trames courtes
IINST2 Intensité Instantanée (phase 2) 1 pour les trames longues 2 pour les trames courtes
IINST3 Intensité Instantanée (phase 3) 1 pour les trames longues 2 pour les trames courtes
IMAX1 Intensité maximale (phase 1)
IMAX2 Intensité maximale (phase 2)
IMAX3 Intensité maximale (phase 3)
PMAX Puissance maximale triphasée atteinte
PAPP Puissance apparente 1
HHPHC Horaire Heures Pleines Heures Creuses
MOTDETAT Mot d'état du compteur
ADIR1 Avertissement de Dépassement d'intensité de réglage (phase 1) 2 trames courtes uniquement
ADIR2 Avertissement de Dépassement d'intensité de réglage (phase 2) 2 trames courtes uniquement
ADIR3 Avertissement de Dépassement d'intensité de réglage (phase 3) 2 trames courtes uniquement

Mode standard

Une beta est actuellement en cours pour la future v3 supportant le mode standard, vous la trouverez dans les releases. N'hésitez pas à faire vos retours dans #19 afin d'accélére la sortie de beta du mode standard !

Installation

Configuration du module

Une fois que votre module TIC est installé et connecté à votre compteur ainsi qu'un votre box domotique au travers de son cable USB, vous devriez voir apparaitre le périphérique /dev/ttyUSB0 (ou /dev/ttyUSB1 si vous aviez déjà une /dev/ttyUSB0).

Exemple de configuration pour le module de LiXee:

Mode historique

stty -F /dev/ttyUSB0 1200 sane evenp parenb cs7 -crtscts

Mode standard

stty -F /dev/ttyUSB0 9600 sane evenp parenb cs7 -crtscts

Vérifiez que celui-ci fonctionne correctement en lancant la commande (Ctrl+C pour quitter):

cat /dev/ttyUSB0

Vous devriez voir défiler les informations du TIC.

Téléchargement

Choississez l'une des 2 méthodes.

Avec HACS

Plus d'informations sur HACS ici.

Manuellement

Dans la page des releases sélectionnez la version que vous souhaitez et téléchargez l'archive zip.

Copiez le dossier custom_components/linkytic da

Linkytic

Install / Use

README