Linky et téléinfo : ESPHome 2026.10 configure enfin vos capteurs TIC pour Home Assistant

Ce qui change : ESPHome 2026.10, publié le 21 octobre 2026, apprend enfin au composant teleinfo à reconnaître les étiquettes du compteur Linky. Une puce ESP32 ou ESP8266 branchée sur la sortie TIC (télé-information client) remonte désormais à Home Assistant des capteurs avec la bonne unité, la bonne classe d’appareil et la bonne classe d’état, sans que vous ayez à les écrire à la main pour chaque index. C’est le genre de détail qui décide si vos courbes atterrissent proprement dans le tableau de bord Énergie ou s’il faut bricoler des templates pendant une soirée. Voici ce qui est réellement dans la version, ce qui ne l’est pas encore, et une configuration complète pour les modes historique et standard.

Le changement en une phrase (et sa source)

Le journal des modifications d’ESPHome 2026.10.0 liste la contribution « [teleinfo] Add predefined properties for main tags of TIC standard and historical » (esphome#9167, par FredM67), marquée breaking change, ainsi qu’un correctif de lecture hors limites lors du découpage d’une trame en groupes (#20513). La documentation du composant détaille la correspondance entre préfixes d’étiquettes et propriétés. Le billet de version, lui, met surtout en avant les compilations natives pour ESP8266 et les mises à jour OTA compressées (annonce officielle).

Rappel : la TIC du Linky en 60 secondes

Le Linky expose sous son cache une sortie série, la TIC, sur les bornes I1 et I2 (la borne A fournit une petite alimentation). Il émet en continu des trames composées d’étiquettes (par exemple EAST pour l’énergie active soutirée totale) suivies de leur valeur. Deux modes coexistent :

	Mode historique	Mode standard
Vitesse	1200 bauds	9600 bauds
Format série	7 bits, parité paire, 1 bit de stop	7 bits, parité paire, 1 bit de stop
Étiquettes typiques	BASE, HCHC, HCHP, IINST, PAPP	EAST, EASF01…, IRMS1, URMS1, SINSTS
Usage	Mode par défaut de la plupart des Linky, compatible anciens compteurs électroniques	Plus riche (tensions, injection, index fournisseur et distributeur) ; activable sur demande auprès du fournisseur
Option ESPHome	historical_mode: true	historical_mode: false

Le tableau qui compte : préfixe d’étiquette → propriétés automatiques

Depuis la 2026.10, le composant applique ces valeurs par défaut selon le début du nom de l’étiquette, d’après la documentation officielle :

Mode	Préfixe	Unité	Classe d’appareil	Classe d’état
Standard	EA… (EAST, EASF, EASD, EAIT)	Wh	energy	total_increasing
Standard	ER… (énergie réactive)	varh	reactive_energy	total_increasing
Standard	IRMS	A	current	measurement
Standard	URMS, UMOY	V	voltage	measurement
Standard	SINST, SMAX	VA	apparent_power	measurement
Standard	PREF, PCOUP	kVA	apparent_power	measurement
Standard	CC… (courbe de charge)	W	power	measurement
Historique	BASE, HCH…, EJP…, BBRH…	Wh	energy	total_increasing
Historique	IINST, IMAX, ISOUSC, ADPS, ADIR	A	current	measurement
Historique	PAPP	VA	apparent_power	measurement
Historique	PMAX	W	power	measurement

Deux règles à garder en tête. D’abord, une étiquette qui ne correspond à aucun préfixe reçoit par défaut Wh / energy / total_increasing. Ensuite, toute valeur que vous définissez explicitement dans le YAML l’emporte sur ces valeurs par défaut.

Pourquoi c’est un « breaking change »

Avant la 2026.10, tous les capteurs teleinfo recevaient par défaut Wh / energy / total_increasing, quelle que soit l’étiquette. Résultat absurde : PAPP (une puissance apparente en VA) ou IINST (une intensité en ampères) étaient présentés à Home Assistant comme des compteurs d’énergie cumulée. Désormais, les étiquettes reconnues prennent la bonne unité : la documentation cite l’exemple de PAPP, qui passe de Wh à VA.

C’est « cassant » parce que les statistiques à long terme de Home Assistant sont liées à l’unité d’un capteur : après la mise à jour, Home Assistant peut signaler un changement d’unité et vous proposer de corriger ou d’effacer l’historique de ces capteurs. Pour garder l’ancien comportement, la documentation indique de définir explicitement unit_of_measurement, device_class, state_class et icon. Petite subtilité utile : si vous fixez une unité compatible (par exemple kWh avec un filtre multiply: 0.001 sur un index d’énergie), la classe d’appareil prédéfinie est conservée ; si elle est incompatible, elle n’est pas appliquée, pour éviter une combinaison incohérente.

Configuration complète, mode historique

uart:
  id: uart_tic
  rx_pin: GPIO3        # selon votre carte
  baud_rate: 1200
  parity: EVEN
  data_bits: 7

teleinfo:
  id: linky
  uart_id: uart_tic
  historical_mode: true

sensor:
  - platform: teleinfo
    teleinfo_id: linky
    tag_name: "HCHC"
    name: "Linky heures creuses"
  - platform: teleinfo
    teleinfo_id: linky
    tag_name: "HCHP"
    name: "Linky heures pleines"
  - platform: teleinfo
    teleinfo_id: linky
    tag_name: "PAPP"
    name: "Linky puissance apparente"
  - platform: teleinfo
    teleinfo_id: linky
    tag_name: "IINST"
    name: "Linky intensité"

Plus besoin d’ajouter unit_of_measurement: Wh, device_class: energy et state_class: total_increasing sous chaque index : la 2026.10 s’en charge.

Configuration complète, mode standard

uart:
  id: uart_tic
  rx_pin: GPIO3
  baud_rate: 9600
  parity: EVEN
  data_bits: 7

teleinfo:
  id: linky
  uart_id: uart_tic
  historical_mode: false

sensor:
  - platform: teleinfo
    teleinfo_id: linky
    tag_name: "EAST"
    name: "Linky énergie soutirée totale"
  - platform: teleinfo
    teleinfo_id: linky
    tag_name: "EAIT"
    name: "Linky énergie injectée"   # utile avec des panneaux solaires
  - platform: teleinfo
    teleinfo_id: linky
    tag_name: "SINSTS"
    name: "Linky puissance apparente"
  - platform: teleinfo
    teleinfo_id: linky
    tag_name: "URMS1"
    name: "Linky tension"

Le matériel, sans se ruiner

• Un module d’interface TIC à optocoupleur : la sortie du Linky est un signal modulé qu’on ne branche pas en direct sur une broche de l’ESP. Les cartes prêtes à l’emploi pour Wemos D1 mini ou ESP32 se trouvent pour quelques euros à quelques dizaines d’euros.
• Un ESP32 ou ESP8266 : la 2026.10 améliore justement la chaîne de compilation pour l’ESP8266, qui reste parfait pour cet usage.
• Deux fils vers I1 et I2, éventuellement la borne A pour alimenter le module. La TIC est une sortie accessible au client, sans plomb à casser.

Ce qui n’est pas encore dans la 2026.10.0

Un second correctif concerne directement vos statistiques : quand une valeur non numérique arrivait sur un capteur, le composant publiait 0. Pour un capteur total_increasing, Home Assistant interprète cette chute comme une remise à zéro du compteur, puis compte toute la valeur suivante comme une consommation nouvelle : un pic absurde dans le tableau de bord Énergie. Le correctif (#20960) ignore désormais les valeurs non numériques. Il a été fusionné le 16 octobre, comme l’a relevé OHF Daily ; il devrait arriver dans une version corrective ou dans la prochaine version mensuelle. En attendant, un filtre suffit :

    filters:
      - filter_out: 0

Checklist de mise à jour

1. Sauvegardez vos fichiers YAML et notez l’entity_id de chaque capteur Linky.
2. Mettez à jour le module complémentaire ESPHome, puis recompilez et flashez (OTA compressée bienvenue).
3. Vérifiez les unités dans Outils de développement > Statistiques ; corrigez les éventuels conflits d’unité proposés par Home Assistant.
4. Ajoutez vos index EAST ou HCHC/HCHP au tableau de bord Énergie.
5. Ajoutez le filtre filter_out: 0 sur les index tant que #20960 n’est pas dans votre version.

L’avis de Rocks

Rien de spectaculaire, mais c’est la meilleure nouvelle de l’année pour les foyers français qui suivent leur consommation en local : un Linky lu par un ESP à quelques euros, sans cloud ni API du distributeur, qui tombe désormais juste dans Home Assistant presque sans configuration. Mettez à jour, contrôlez vos statistiques et gardez un œil sur le prochain correctif. Pour aller plus loin, voir notre guide complet Home Assistant 2026 et notre article sur la nouvelle carte OpenStreetMap de Home Assistant 2026.10.

FAQ

Faut-il passer le Linky en mode standard ?

Non. Le mode historique suffit pour suivre la consommation. Le mode standard apporte tension, injection et plus d’index ; il se demande au fournisseur.

Mes anciens réglages manuels vont-ils être écrasés ?

Non : une valeur définie explicitement dans le YAML garde la priorité sur les valeurs par défaut.

Home Assistant me signale un changement d’unité sur PAPP, c’est normal ?

Oui : PAPP passe de Wh (valeur par défaut erronée) à VA. Acceptez la correction proposée, ou fixez l’ancienne unité dans le YAML si vous tenez à garder l’historique tel quel.

Le pic de consommation après une coupure est-il corrigé ?

Le correctif #20960 a été fusionné le 16 octobre, mais n’est pas listé dans la 2026.10.0. Utilisez un filtre en attendant.

Ça marche avec un ESP8266 ?

Oui, et la 2026.10 accélère justement la compilation pour cette puce.

Sources : changelog ESPHome 2026.10.0, documentation du composant Teleinfo, annonce ESPHome 2026.10, OHF Daily, 17 octobre 2026.