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)
- 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)
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.
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
Le mode historique est le plus commun (existant pré Linky) : il est activé par défault à moins que vous soyez producteur d'énergie.
Les 23 champs des compteurs mono-phasé configurés en mode historique sont supportés:
ADCOAdresse du compteur (avec parsing EURIDIS en attributs étendus et périphérique agrégateur sous Home Assistant)OPTARIFOption tarifaire choisieISOUSCIntensité souscriteBASEIndex option BaseHCHCIndex option Heures Creuses - Heures CreusesHCHPIndex option Heures Creuses - Heures PleinesEJPHNIndex option EJP - Heures NormalesEJPHPMIndex option EJP - Heures de Pointe MobileBBRHCJBIndex option Tempo - Heures Creuses Jours BleusBBRHPJBIndex option Tempo - Heures Pleines Jours BleusBBRHCJWIndex option Tempo - Heures Creuses Jours BlancsBBRHPJWIndex option Tempo - Heures Pleines Jours BlancsBBRHCJRIndex option Tempo - Heures Creuses Jours RougesBBRHPJRIndex option Tempo - Heures Pleines Jours RougesPEJPPréavis Début EJP (30 min)PTECPériode Tarifaire en coursDEMAINCouleur du lendemainIINSTIntensité Instantanée 1ADPSAvertissement de Dépassement De Puissance Souscrite 2IMAXIntensité maximale appeléePAPPPuissance apparente 1HHPHCHoraire Heures Pleines Heures CreusesMOTDETATMot d'état du compteur
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 !
ADCOAdresse du compteur (avec parsing EURIDIS en attributs étendus et périphérique agrégateur sous Home Assistant)OPTARIFOption tarifaire choisieISOUSCIntensité souscriteBASEIndex option BaseHCHCIndex option Heures Creuses - Heures CreusesHCHPIndex option Heures Creuses - Heures PleinesEJPHNIndex option EJP - Heures NormalesEJPHPMIndex option EJP - Heures de Pointe MobileBBRHCJBIndex option Tempo - Heures Creuses Jours BleusBBRHPJBIndex option Tempo - Heures Pleines Jours BleusBBRHCJWIndex option Tempo - Heures Creuses Jours BlancsBBRHPJWIndex option Tempo - Heures Pleines Jours BlancsBBRHCJRIndex option Tempo - Heures Creuses Jours RougesBBRHPJRIndex option Tempo - Heures Pleines Jours RougesPEJPPréavis Début EJP (30 min)PTECPériode Tarifaire en coursDEMAINCouleur du lendemainIINST1Intensité Instantanée (phase 1) 1 pour les trames longues 2 pour les trames courtesIINST2Intensité Instantanée (phase 2) 1 pour les trames longues 2 pour les trames courtesIINST3Intensité Instantanée (phase 3) 1 pour les trames longues 2 pour les trames courtesIMAX1Intensité maximale (phase 1)IMAX2Intensité maximale (phase 2)IMAX3Intensité maximale (phase 3)PMAXPuissance maximale triphasée atteintePAPPPuissance apparente 1HHPHCHoraire Heures Pleines Heures CreusesMOTDETATMot d'état du compteurADIR1Avertissement de Dépassement d'intensité de réglage (phase 1) 2 trames courtes uniquementADIR2Avertissement de Dépassement d'intensité de réglage (phase 2) 2 trames courtes uniquementADIR3Avertissement de Dépassement d'intensité de réglage (phase 3) 2 trames courtes uniquement
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 !
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 -crtsctsVérifiez que celui-ci fonctionne correctement en lancant la commande (Ctrl+C pour quitter):
cat /dev/ttyUSB0Vous devriez voir défiler les informations du TIC.
Choississez l'une des 2 méthodes.
Plus d'informations sur HACS ici.
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 dans votre dossier de configuration Home Assistant. Vous devriez maintenant avoir le dossier /votre/config/dir/custom_components/linkytic si vous avez /votre/config/dir/configuration.yaml.
Redémarrez votre Home Assistant !
Une fois Home Assistant redémarré, allez dans: Paramètres -> Appareils et services -> Ajouter une intégration. Dans la fenêtre modale qui s'ouvre, cherchez linky et sélectionnez l'intégration s'appelant Linky TIC dans la liste (une petite icône d'un carton ouvert avec un texte de survol indiquant Fourni par une extension personnalisée devrait se trouver sur la droite).
Vous devriez passer sur le formulaire d'installation vous présentant les 3 champs suivants:
Chemin/Adresse vers le périphérique sérieIci renseignez le path de votre périphérique USB testé précédement. Le champ est rempli par default avec la valeur/dev/ttyUSB0: Il ne s'agit pas d'une auto détection mais simplement de la valeure la plus probable dans 99% des installations. Il est aussi possible d'utiliser une URL supporté par pyserial, ce qui peut s'avérer utile si le port série est connecté sur un appareil distant (support de la rfc2217 par exemple).Mode TICChoississez entreStandardetHistorique. Plus de détails sur ces 2 modes en début de ce document.TriphaséÀ cocher si votre compteur est un compteur... triphasé. À noter que cette option n'a d'effet que si vous êtes en mode historique (le mode standard gère le mono et le tri de manière indifférente).
Validez et patientez pendant le temps du test. Celui-ci va tenter d'ouvrir une connection série sur le périphérique désigné et d'y lire au moins une ligne. En cas d'erreur, celle-ci vous sera retourné à l'écran de configuration. Sinon, votre nouvelle intégration est prête et disponible dans la liste des intégrations de la page où vous vous trouvez.
Pour ceux intéressé par le mode "temps réel", localisez l'intégration Linky TIC dans les tuiles de la page et cliquez sur Configurer.
Je ne suis pas un habitué du python et encore moins du framework Home Assistant ! Ce module doit donc être largement améliorable. Néanmoins il permet le support simple et natif d'un maximum d'éléments transmis par le compteur Linky dans Home Assistant au travers d'une connection série du TIC dont certains en temps réel.
Le document de référence du protocole TIC dévelopé par Enedis est archivé dans ce repo. Vous y trouverez toutes les informations nécessaire au dévelopement ainsi que des détails sur les informations remontées par ce plugin. Celui-ci et tout autre document de référence d'implémentation pouvant se trouver dans ce répertoire ne sont évidement pas couvert par la license MIT de ce repo et reste la propriété de leurs auteurs respectifs.