TOUG : passerelle PAC Aldes T.One - la fabrication de A à Z (partie 2)

Le guide complet pour fabriquer votre passerelle sans stress

Vous avez découvert la TOUG dans mon précédent article et la perspective de piloter votre PAC Aldes T.One en 100% local vous a séduit ? Vous en avez assez de l'application officielle ou vous voulez optimiser votre autoconsommation solaire ?

TOUG : passerelle DIY ESPHome pour PAC Aldes T.One

Reprenez le contrôle de votre PAC Aldes T.One avec la TOUG ! Une passerelle DIY 100% locale et open-source pour Home Assistant. Fini le cloud : gérez chauffage, clim et surplus solaire en toute fiabilité via Ethernet.

Home Assistant Communauté Francophonedjtef

Peut-être que, comme beaucoup, vous vous êtes dit :

“OK, le projet est génial… mais est-ce que je peux vraiment la fabriquer moi-même ?”

Bonne nouvelle : ce projet a été conçu pour être accessible. Que vous soyez un expert du fer à souder ou un grand débutant qui n'a jamais touché une résistance, il existe sûrement une solution pour vous.

🧩 Un projet modulaire : assemblez ce dont VOUS avez besoin

L'une des grandes forces de la TOUG, c'est qu'elle n'est pas un bloc monolithique. C'est un ensemble de briques que vous pouvez ajouter selon vos compétences et vos besoins.

Vous n'êtes pas obligé de tout monter d'un coup ! Vous pouvez très bien commencer "léger" et ajouter des fonctionnalités plus tard.

Les différentes fonctions possibles de la TOUG

• Alimentation → obligatoire
• ESP32 → obligatoire
• Modbus utilisateur → recommandé (T.One récentes)
• Télécommande → obligatoire pour les anciennes générations Ribo / RBUV, recommandé sinon
• USB → recommandé (T.One récentes)
• Falsification température → obligatoire pour routeur solaire
• Lecture sondes haut / bas ballon → recommandé pour routeur solaire
• Lecture alimentation bouches → facultatif

Mon conseil : le meilleur rapport simplicité/fonctionnalités

Si vous hésitez, pour simplifier la réalisation et couvrir le maximum de besoin, mon conseil est de choisir le Pack Access :

• Alimentation
• ESP32 (WT32-ETH01)
• Modbus utilisateur
• Interface télécommande
• USB

On est ainsi sur une complexité comparable aux PCB des premières passerelles du forum, tout en gardant la possibilité d’étendre la TOUG par la suite.

Les fonctions plus avancées (ADC, routeur solaire, etc.) restent documentées et accessibles pour plus tard.

Voici ce que ça donne :

Avouez, c’est moins impressionnant d’un coup 😉

🛠️ Choisissez votre aventure : 3 niveaux de difficulté

Pour rendre ce projet accessible à tous, je vous propose trois parcours. Choisissez celui qui correspond à votre expérience et à votre équipement.

🥉 Parcours Bronze : "Je débute / Je veux aller vite" (Recommandé)

C'est la méthode "Lego". Vous déléguez la partie compliquée.

• Le principe : Vous commandez le PCB avec les composants du Pack Access déjà soudés en usine (option d'assemblage JLCPCB).
• Votre mission : Vous n'avez plus qu'à souder les broches des gros modules et les enficher (ESP32, RS485...).
• Niveau requis : Soudure traversante basique (très facile).
• Coût : ~50€
• Temps : ~3h00.

🥈 Parcours Argent : "Le Maker équilibré"

Le meilleur compromis prix/apprentissage.

• Le principe : Vous commandez le PCB nu. Vous soudez vous-même les composants du Pack Access.
• Votre mission : Un peu de patience et de minutie.
• Niveau requis : Soudure traversante + un composant CMS.
• Coût : ~40€
• Temps : ~6h00.

🥇 Parcours Or : "DIY Intégral"

Pour les puristes et les experts.

• Le principe : Vous commandez le PCB nu. Vous soudez vous-même 100% des composants de la TOUG, c'est le Pack All inclusive.
• Votre mission : Maîtriser le fer et l'électronique.
• Niveau requis : Soudure traversante + plusieurs composants CMS.
• Coût : ~50€
• Temps : ~10h00+.

🧰 La boîte à outils

Pas besoin d'un atelier de la NASA. Voici le nécessaire pour le Parcours Bronze :

• Un fer à souder et de l'étain.
• Des tournevis (pour les borniers, fixer le PCB).
• Un multimètre (Indispensable pour vérifier les tensions avant de brancher l'ESP32 !).
• Une lime à métaux ou Dremel (pour faire l'encoche dans le boîtier)
• ☕ De la patience et un café.

Si vous visez les Parcours Argent ou Or prévoyez en plus :

• une pince Brucelle (pour tenir les composants CMS)
• 🔍 une loupe.

Pour réaliser les câbles, il faudra également :

• Une pince à dénuder
• Une pince à sertir les connecteurs JST-XH

📋 Résumé

Ce tutoriel vous accompagne dans la fabrication complète de votre TOUG, de la commande des composants jusqu'à la première connexion à Home Assistant. Suivez les étapes dans l'ordre, prenez votre temps, et vous aurez bientôt une passerelle fonctionnelle !

⏱️ Temps de réalisation : 3h à 1 journée complète

💰 Coût matériel : 40 à 50€

🛠️ Outillage : fer à souder, multimètre, pinces coupantes, pince à dénuder, pince à sertir, pince Brucelle, lime à métaux, tournevis

🆘 Et si je galère ?

Vous n'êtes pas seul !

• 💬 Forum HACF : Sujet dédié TOUG avec une communauté réactive
• 📚 GitHub : Documentation complète, schémas, FAQ
• 📸 N'hésitez pas à poster des photos si vous avez un doute sur une soudure

Vous êtes rassuré et toujours motivé ?

Alors c'est parti ! 🚀

Étape 0 : Définir son besoin

Vous êtes à présent pressé d'avoir votre TOUG, mais il est primordial de se poser 30 minutes pour savoir ce dont on a réellement besoin, et comment on va s'y prendre.

Quel est mon modèle de T.One ?

☐ T.One AIR (sans ballon ECS)
☐ T.One AquaAIR (avec ballon ECS)
☐ Génération ancienne Ribo/RBUV (sans Modbus utilisateur)

Quelles fonctions ai-je absolument besoin ?

☐ Pilotage de base (thermostats, modes) → ESP32 + Modbus
☐ Remplacement télécommande → + Interface télécommande
☐ Interface USB (développement en cours) → + MCP2221A
Tout est coché ? ➡️ C'est le Pack Access

☐ Détection bouches motorisées → + Cartes optocoupleurs
☐ Routeur solaire (AquaAIR uniquement) → + Composants routeur
Tout est coché ? ➡️ C'est le Pack All Inclusive

Quel parcours je choisis ?

☐ Bronze (PCB + Pack Access pré-assemblé)
☐ Argent (PCB + Pack Access à souder soi-même)
☐ Or (Pack All Inclusive à souder soi-même)
☐ Personnalisé : je soude (ou fais souder) seulement les composants dont j'ai besoin

Quel temps je veux y consacrer ?

☐ Je veux aller vite / j'ai pas trop de temps ➡️ Parcours Bronze
☐ Je ne suis pas pressé / j'ai un peu de temps ➡️ Parcours Bronze ou Argent
☐ J'ai tout mon temps ➡️ Parcours Bronze, Argent ou Or

Vous savez maintenant ce que vous voulez faire ? Alors prenez un chariot, on va faire les courses 🛒!

Étape 1 : Commander les composants

Dans cette étape, nous allons commander les PCB et les composants nécessaires pour fabriquer la TOUG dont vous avez besoin.

Le PCB

Qu'est-ce que c'est ?

Le PCB (printed circuit board) ou circuit imprimé en bon français, est la plaque vierge de composants qui contient tous les trous et les pistes. Il a été réalisé préalablement par un logiciel de conception électronique, tels que KiCAD, EasyEDA (utilisé pour la TOUG), Altium... à partir du schéma électronique.

Afin de pouvoir l'envoyer pour production, ce PCB doit être exporté dans un fichier au format gerber. Il contient toutes les informations du circuit imprimé (les différentes couches, les pistes, les trous, la sérigraphie...).

Importer le PCB

Le fichier gerber.zip peut être téléchargé directement depuis le Github de la TOUG.

On peut à présent se rendre sur le site qui produira notre PCB. Dans ce guide, nous utiliserons JLCPB.

Le plus simple pour commencer est de cliquer sur Voir mon devis

On arrive alors sur un formulaire dans lequel on doit importer notre fichier gerber.

Commencer par se connecter (ou créer un compte), puis ajouter le fichier gerber.

Au bout de quelques secondes le fichier est téléchargé et un aperçu s'affiche :

Les dimensions se mettent automatiquement à jour :

Pour la suite du formulaire, on peut tout laisser par défaut sauf deux champs :

• La quantité à commander (par multiple de 5)

• La couleur du PCB

Importer ses composants à souder

Afin de faire souder nos composants sur le PCB, il faut activer l'option Assemblage PCB

On peut laisser toutes les options par défaut et cliquer sur Suivant.

On peut ensuite admirer notre PCB en gros plan et vérifier les options principales sur la droite. Cliquer sur Suivant.

Nous avons à présent besoin de récupérer deux nouveaux fichiers.

• BOM (Bill of Materials) : il s'agit de la liste des composants qu'on voudra faire souder, dans un format tabulé (csv ou xls). Il comporte la référence, le fabricant ou la quantité de chaque pièce.
• CPL (Pick and Place) : ce fichier décrit la position et l'orientation de chaque composant sur le PCB pour qu'un robot puisse automatiquement le souder.

Ajouter les deux fichiers BOM et CPL qui viennent d'être téléchargés.

Cliquer sur Appliquer BOM & CPL.

On nous affiche alors la nomenclature des composants qu'on a importés dans un tableau.

En haut du tableau, si tous les composants ont été trouvés, on a autant de pièces détectées que de pièces confirmées.

Mais il arrive souvent que certains composants soient en pénuries :

Dans ce cas, il faut trouver une référence équivalente en cliquant sur la loupe.

Une fois tous les composants trouvés, cliquer sur Suivant.

Le PCB avec les composants en 3D sont à présent affichés... mais pas forcément dans le bon sens.

Pour tourner un composant, il faut d'abord le sélectionner, il devient bleu :

Puis à l'aide du bandeau supérieur, on va pouvoir le tourner dans un sens ou dans l'autre.

On se retrouve alors avec un bornier bien positionné.

Il faut faire ceci pour tous les composants mal tournés. Voici le résultat final :

Cliquer sur Suivant.

Commander le PCB

On nous affiche à présent le devis détaillé du PCB.

Sur la partie droite, sélectionner la Description du produit.

Puis cliquer sur SAUVEGARDER DANS LE PANIER.

Sélectionner ensuite tous les articles du panier.

Sur la partie droite, on peut changer l'estimation des frais de port, le moins cher étant Global Standard Direct Line, mais aussi le plus long. Ils pourront être définitivement choisis à l'étape suivante.

Cliquer ensuite sur Paiement sécurisé.

Sélectionner dans l'ordre (en cliquant sur Continuer) :

• Son adresse de livraison
• Sa méthode d'expédition
• Sa méthode de paiement

Des coupons de réductions sont souvent disponibles, penser à les sélectionner.

La commande est terminée, le prix s'affiche, on peut cliquer sur Payer.

Les composants

Les aventuriers des Parcours Or 🥇 et Argent 🥈 doivent à présent commander les composants qui sont assemblés avec le PCB dans le Parcours Bronze à l'étape précédente.

Pour cela, je préconise d'utiliser la même méthode, c'est-à-dire envoyer le fichier BOM qui référence tous les composants à commander (voir Importer ses composants à souder).

Télécharger sous le Github de la TOUG le fichier :

• BOM du Pack Access pour le Parcours Argent
• BOM du Pack All Inclusive pour le Parcours Or

Pour commander les composants, j'ai utilisé le site LCSC qui fait partie du même groupe que EasyEDA et JLCPCB, ça permet d'avoir un fichier BOM dans un format compatible avec trois sites. Mais n'importe quel site de composants qui vend les mêmes références peut être utilisé.

Une fois sur le site LCSC, se connecter (ou créer un compte la première fois).

Dans la barre de recherche, cliquer sur Upload a BOM et choisir son fichier BOM téléchargé précédemment.

Une fois le fichier BOM importé, un tableau BOM Mapping s'affiche pour valider la correspondance des lignes et des colonnes.

Bien que le template officiel soit utilisé, il faut lui spécifier que la Colonne 1 correspond à Quantity.

Laisser la deuxième ligne sélectionnée.

Cliquer sur Create BOM en bas.

LCSC affiche alors un tableau avec tous les composants qu'il a trouvé à partir du fichier BOM.

En haut, on trouve le nombre de composants qui correspondent exactement, partiellement ou pas du tout. Dans notre cas tout doit être trouvé.

À droite, sont affichés les nombres de composants en stock ou en rupture de stock (Backordered).

Les composants concernés auront la mention "0 In-Stock" dans la colonne Stock Availability.

Dans ce cas, plusieurs choix sont possibles :

• Attendre quelques jours que le composant soit de retour en stock,
• Supprimer la ligne et ajouter un autre composant équivalent en cliquant sur Add Parts en bas,
• Supprimer la ligne et commander sur un autre site.

Une fois que le tableau ne contient que des composants en stock, cliquer sur Submit BOM en bas, puis sur Checkout.

Remplir son adresse, choisir son mode de livraison (Shipping Method) et remplir les champs Compliance statement comme indiqué ci-dessous :

Le prix est alors affiché et il est possible de payer en cliquant sur Submit Order.

Les modules

Avant de voir la liste, une précision importante : la TOUG est conçue autour de modules.

Ce sont des mini-cartes électroniques déjà assemblées et testées en usine. Plutôt que de souder des puces microscopiques une par une sur le circuit principal, nous allons utiliser ces modules comme des briques de construction.

Pourquoi est-ce génial pour le DIY ?

• 🧱 Simplicité : Le travail complexe est déjà fait. Vous n'avez qu'à les enficher sur les barrettes du PCB, exactement comme des LEGO.
• 🛡️ Sécurité & Maintenance : C'est l'atout majeur. Si vous faites une fausse manipulation et qu'un composant grille (par exemple l'ESP32), pas besoin de tout jeter ! Vous retirez le module défectueux et vous en clipsez un neuf en 5 secondes.
• 📈 Progressivité : Cela permet de monter et de tester votre carte petit à petit, fonction par fonction, sans risque.

C'est cette architecture modulaire qui transforme la fabrication d'un appareil complexe en un véritable jeu d'assemblage accessible à tous.

Voici les modules à commander (Amazon/Aliexpress ) :

Les accessoires et finition

Tous les composants devraient être commandés à présent. Il reste cependant à commander le boîtier et les vis pour fixer le PCB. De plus, il faudra ajouter quelques cavaliers pour configurer la TOUG.

Je n'ai trouvé le boîtier que sur Aliexpress. Il a exactement les bonnes dimensions, car le PCB a été conçu à partir de celui-ci. Je conseille de choisir le blanc, car le noir nécessitera de casser les languettes pour faire passer les connecteurs.

Pour fixer la carte, de simples vis autotaraudeuses M2.6x6 ou M3x6 feront l'affaire, il en faudra 4.

Concernant les cavaliers (ou jumpers), il faut juste penser à prendre un pas de 2.54mm.

Récapitulatif :

Les câbles

Les câbles servent à connecter la TOUG sur la carte mère du T.One. Bien qu'on puisse brancher directement la télécommande ou les sondes sur la TOUG, il est conseillé de fabriquer des rallonges pour pouvoir déporter le boîtier.

Pour le câble, j'ai choisi une nappe de 4 fils 22 AWG (0,326 mm²).

Voici la liste des câbles et de leurs connecteurs :

Récapitulatif du matériel :

Routeur solaire

Pour piloter la résistance d'appoint ECS via un routeur solaire, il va falloir s'intercaler sur le câblage d'origine. Pour cela, nous utilisons les mêmes connecteurs que la carte mère Universal MATE-N-LOK de chez TE Connectivity.

Où les acheter ?

Deux solutions sont possibles :

1. Solution "Prêt à l'emploi" (Recommandée) : Sur Aliexpress, les connecteurs "MATE-N-LOK 2 points" sont déjà vendus avec des bouts de fils sertis. C'est la solution la plus simple, car elle ne nécessite aucune pince spéciale.
2. Solution "À composer" (LCSC ou distributeurs pro) : Pour un montage sur-mesure, il faut commander les boîtiers ET les contacts séparément
   • Boîtier Mâle (Plug) : 1-480698-0 (LCSC)
   • Boîtier Femelle (Cap) : 350778-1 (LCSC)
   • Contacts Mâles (Pins) : 350547-1 (pour fils 0.75 à 1.5mm²) (LCSC)
   • Contacts Femelles (Sockets) : 350550-1 (pour fils 0.75 à 1.5mm²) (LCSC)

Résumé de vos commandes par parcours

Voici votre "Checklist" finale avant de valider vos paniers :

🥉 Parcours Bronze

• JLCPCB : PCB avec option Assemblage (Pack Access déjà soudé).
• Amazon / Aliexpress : Les 5 modules + Accessoires (Boîtier, vis, cavaliers, câble, cosses).
• LCSC : Les connecteurs et contacts pour fabriquer vos 3 câbles.

🥈 Parcours Argent

• JLCPCB : PCB nu (sans composants).
• Amazon / AliExpress : Les 5 modules + Accessoires (Boîtier, vis, câble, cosses).
• LCSC : Tous les composants (BOM Pack Access) + connecteurs/contacts pour 3 câbles.

🥇 Parcours Or

• JLCPCB : PCB nu (sans composants).
• Amazon / AliExpress : Les 7 modules + Accessoires (Boîtier, vis, câble, cosses) + 2 connecteurs résistance d'appoint ECS (Aliexpress recommandé)
• LCSC : Tous les composants (BOM Pack All Inclusive) + connecteurs/contacts pour 5 câbles

En attendant l'arrivée du facteur :

• Relisez le premier article pour bien comprendre le fonctionnement théorique.
• Lisez la suite de ce guide pour vous préparer et éviter les pièges classiques du montage.

On se retrouve dès que vos colis sont arrivés pour l'Étape 2 ! 🚀

Étape 2 : Souder les composants

Vos colis sont là ? Café en main ? Fer à souder branché ? C'est parti.

Quelques conseils pour votre plan de travail :

• Lumière : S'assurer d'avoir un éclairage puissant et direct. La soudure demande de la précision.
• Espace : Dégagez votre plan de travail. Utilisez des petites coupelles ou une boîte à compartiments pour ne pas mélanger les composants.
• Stabilité : Si vous avez une "troisième main" (support avec pinces) ou un étau, c'est le moment de le sortir. Sinon, de la pâte à fixe (Patafix) peut aider à tenir les composants en place sur le PCB (ce sera la méthode utilisée ici).

La méthode d'assemblage : "Fonction par Fonction"

En théorie, il est conseillé de souder tous les composants du plus petit au plus grand (du plus plat au plus haut), notamment pour faciliter la soudure quand on retourne la carte.

Cependant, pour ce tutoriel, j'ai choisi une approche différente : nous allons assembler la carte fonction par fonction (Alimentation, puis ESP32, puis Modbus...).

Pourquoi ?

• Compréhension : Cela vous permet de comprendre concrètement le rôle de chaque bloc de composants.
• Modularité : Comme vu en introduction, vous n'avez peut-être pas besoin de tout. Cette méthode vous permet de sauter les parties qui ne concernent pas votre installation (ex : gestion de la télécommande).

Alimentation

Nous allons commencer par la partie la plus importante : l'alimentation.

Liste des composants :

Le premier module à souder et le convertisseur DC-DC MP1584.

Pour souder les modules et les embases, je préconise tout d'abord tout poser à blanc et souder ensuite. Cela permet d'avoir un écartement parfait des broches mâles et des embases.

Disposer les 4 barrettes femelles sur la carte (sans souder).

Insérer le côté long des barrettes mâles.

Poser le module sur ses broches.

Souder à présent les 8 broches du module.

Retourner la carte en gardant bien les embases insérées dans les trous, puis les souder sur la carte.

Insérer l'interrupteur latéral ON/OFF dans son emplacement (SW2).

Pour éviter que le composant tombe en retournant la carte, il est possible d'utiliser de la Patafix.

Retourner la carte puis souder toutes les pattes de l'interrupteur (y compris les latérales). Attendre que ça refroidisse avant d'enlever la Patafix pour éviter qu'elle file.

De la même manière, souder dans l'ordre :

• La barrette 3 broches au-dessus de l'interrupteur, sur l'emplacement 5V Select (H2)
• Le condensateur 10µF à sa gauche, sur l'emplacement C8

• Le connecteur JST XHP-4 sur l'emplacement Modbus (H8)
• La barrette 3 broches juste dessous, sur l'emplacement Source 12V (H7)

Couper les pattes du condensateur au ras de la carte à l'aider d'une petite pince coupante. On obtient ceci :

ESP32

Passons au cerveau de notre TOUG : l'ESP32 WT32-ETH01.

Liste des composants :

Le WT32-ETH01 est le seul module de la TOUG où les broches seront soudées sur la face avant.

Comme pour le module précédent, commencer par positionner les embases femelles sur la carte, insérer les barrettes mâles et poser l'ESP32 à l'envers (port Ethernet face au PCB). Maintenir les embases avec la Patafix.

Souder les 2 rangées de 13 broches sur l'ESP32 puis les embases sur la carte après l'avoir retournée.

Souder ensuite :

• le condensateur de 100nF sur son côté gauche à l'emplacement C9 (il n'y a pas de sens pour celui-ci)
• la barrette coudée femelle FTDI (entre l'USB-C U5 et le connecteur J7)
• l'interrupteur latéral FLASH MODE (SW1)

Couper les pattes du condensateur au ras de la carte à l'aider d'une petite pince coupante. On obtient ceci :

On pourrait dès à présent régler l'alimentation et flasher l'ESP32 pour vérifier que ça fonctionne. J'ai préféré ici tout souder et tester ensuite.

Modbus utilisateur

Continuons en ajoutant notre première interface de communication : le Modbus.

Liste des composants

Dans cette partie, il faudra souder 2 modules. Commençons par le Level Shifter.

Vous savez faire à présent :

• ajouter la Patafix et retourner la carte
• souder les embases
• le positionner à blanc (attention au sens) puis souder ses broches

Le convertisseur TTL-RS485 comporte une petite subtilité : les broches A, B et GND ont un pas de 5mm alors que nous avons une embase avec un pas de 2.54mm.

Il faut effectuer une petite modification sur l'embase de 5 broches : retirer les broches 2 et 4 en les tirant avec une pince.

On peut à présent positionner les 2 embases et le module sur la carte à l’emplacement Mod TTL-RS485 Modbus (U2) (on ne peut pas se tromper de sens), puis le souder en suivant toujours la même méthode.

Notre carte peut désormais communiquer avec le T.One !

On obtient ici la TOUG minimale exploitable ! On pourrait l'appeler le Pack Eco 🛒.

Mais ne le dévalorisons pas, il convient à 80% des utilisateurs ! Il permet notamment de régler les thermostats et changer les modes ECS, Chauffage et Clim, sans rien débrancher sur la carte mère.

Télécommande

La prochaine étape consiste à ajouter la communication avec la télécommande. Le protocole utilisé étant également du Modbus, le même module que l'étape précédente est utilisé.

Liste des composants

Commencer par souder le convertisseur TTL-RS485 de la même manière qu'à l'étape précédente à l'emplacement Mod TTL-RS485 Télécommande (U3).

Souder ensuite :

• Le connecteur JST S04B-XASK (celui avec l'ergot) sur l'emplacement Télécommande (H5)
• Le connecteur JST XHP-4 à sa droite sur l'emplacement Télécommande (H6)
• L'interrupteur en dessous, à l'emplacement SW4

USB

Venons-en à l'USB, la seule partie qui va demander un peu de précision.

Liste des composants

Commençons par le composant le plus délicat : le MCP2221A en CMS.

Préparation : Étamez très légèrement chaque pastille sur la carte (emplacement U4). Le but est de déposer un film d'étain très fin et bien plat.

Se munir de la pince brucelles (une grosse pince à épiler peut convenir).

Positionnement : À l'aide de la pince brucelles, poser le composant sur son emplacement (qui vient d'être étamé).

Soudure : Tout en maintenant le composant avec la pince, chauffer une patte dans un angle pour le fixer. Une fois aligné, souder le reste des pattes.

Ne pas hésiter à refaire une passe rapide sur chaque soudure : posez la panne du fer de manière à ce qu'elle touche simultanément l'extrémité de la patte et la pastille. L'étain doit couler et former un joli petit cône brillant autour de la patte.

La suite est classique, continuer en soudant les deux condensateurs C2 (470 nF) et C1 (4,7 µF) sous le MCP2221.

Le module USB-C ne peut pas être inséré dans une embase, car il serait trop haut pour le boîtier ; il doit être soudé directement au ras de la carte.

Positionnement : Insérer le côté court des barrettes mâles dans l'emplacement USB-C (U5), puis posez le module directement dessus.

Stabilité : Ajouter une petite boule de Patafix entre le module USB-C et le PCB pour le maintenir bien horizontal et éviter qu'il ne bascule.

Soudure : Souder les broches sur le dessus du module, puis retournez la carte pour souder les broches côté circuit imprimé.

Finition : Couper l'excédent des broches à l'aide de la pince coupante pour une finition propre.

Pour finir, souder l'interrupteur à glissière sur son emplacement SW6 (on ne peut pas se tromper de sens).

C'est déjà fini pour le Parcours Argent 🥈 ! Vous voici avec le Pack Access au complet, au même stade que le Parcours Bronze 🥉. Avouez, c’était pas si compliqué, non ? 😉

Détection bouches K1 à K4

Continuons le Parcours Or avec la détection des quatre premières bouches.

Liste des composants

Rien de compliqué dans cette partie, souder :

• le module optocoupleurs sur l'emplacement OP71A04 (U7),
• la barrette 3 broches PULLUP/DOWN SELECT située entre l'ESP32 et le précédent module,
• les 3 résistances 4,7K R5, R6 et R7 au-dessus du module
• le bornier débrochable 8 bornes à l'emplacement Entrées bouches (CN2) au-dessus des résistances

Couper les pattes des résistances sous la carte avec la pince coupante.

Ajouter le cavalier sur la position Pull Up.

Borniers additionnels

La TOUG bénéficie de borniers pour étendre ses possibilités.

Liste des composants

Souder :

• le connecteur JST XHP-4 à l'emplacement I2C, entre l'ESP32 et le bornier Entrée bouches CN2,
• la barrette mâle 3 broches H1, juste dessous,
• le bornier à vis simple 12V à l'emplacement J6, en bas à gauche,
• le premier bornier débrochable KF2EDGR J1 pour le 5V, à côté du précédent,
• le deuxième bornier débrochable KF2EDGR pour le 3,3V à l'emplacement J7, entre le connecteur FTDI et l'inerrupteur FLASH MODE.

Ajouter le cavalier entre VCC et 3,3V pour alimenter l'I2C.

Détection bouches K5 et K6 / Résistance d'appoint

Finissons la partie détection en ajoutant le deuxième module optocoupleurs.

Liste des composants

Commencer par souder le module optocoupleurs, de la même façon que le premier, sur l'emplacement OP71A04 (U14).

Souder ensuite les deux borniers débrochables KF2EDGR aux emplacements CN3 et CN4, à la gauche du module précédent.

Finir en soudant la barrette 3 broches RES APP REF sur l'emplacement H10, à droite du module. Positionner le cavalier en fonction de comment sera détectée la résistance d'appoint : GND ou 3.3V.

Lecture et falsification des sondes

Nous arrivons à la dernière étape : la lecture des sondes de températures ECS.

Liste des composants

Lecture des sondes

Pour lire la température haut et bas du ballon d'eau chaude, il faut souder :

• le module ADS1115 à gauche de l'ESP32 à l'emplacement ADC1,
• le connecteur JST S06B-XASK-1 Entrée sondes à l'emplacement CN1,
• le connecteur coudé JST XHP-4 Sortie sondes à l'emplacement H4.

Falsification des sondes

Pour faire croire à la carte mère que les sondes ne dépassent pas 60°C, il faut souder :

• le relais à l'emplacement U6 (en surface),

• la diode de roue libre 1N4148PF D1,

• les 2 transistors 2N2222A Q1 et Q2 en respectant le sens du dessin sur le PCB,
• le MOSFET AO3401 à l'emplacement Q3 (en surface),
• les 10 résistances.

Couper les pattes qui dépassent à ras du PCB avec la pince coupante.

🎉Félicitations ! Vous voilà avec la TOUG All Inclusive !

Votre carte est maintenant terminée et prête à l'action !

Dans la prochaine étape, nous allons passer à la finition : l'assemblage final dans le boîtier et la fabrication des câbles sur mesure pour relier la TOUG à votre T.One.

Étape 3 : Assembler les composants

C'est ici que tous les parcours (Bronze 🥉, Argent 🥈 et Or 🥇) se rejoignent.

Câbles

Les câbles vont permettre de relier la TOUG à la carte mère du T.One. Certains sont obligatoires, d'autres servent uniquement de rallonges pour pouvoir déporter la TOUG du T.One.

Pour que votre installation soit propre et durable, nous allons fabriquer nos propres câbles sur mesure. Oubliez les dominos ou le ruban adhésif : nous allons utiliser des connecteurs JST, les mêmes que ceux utilisés par Aldes sur ses propres cartes.

Le matériel nécessaire

• Câble : Utilisez du câble souple (type 22-24 AWG). Un ruban de 4 couleurs est idéal pour ne pas se tromper dans les polarités.

• Boîtiers (Housings) : La partie en plastique blanc qui vient se clipser. Il faudra des JST XH (standard) ou JST XA (Aldes).

• Contacts (Pins) : Les petites fiches métalliques qui viennent se loger dans les boîtiers une fois serties.

• Pince à sertir : L'outil indispensable pour un travail propre (type SN-28B ou équivalent).

Câble vers carte mère Modbus

Ce câble est l'élément central : il permet la communication du Modbus utilisateur entre la TOUG et le T.One.

Commencer par couper la longueur nécessaire pour les 4 fils avec la pince coupante.

S'il s'agit d'une nappe composée de 4 fils, séparer chaque fils sur environ 2 à 3cm.

Connecteur JST XHP-4

Dénuder entre 2 et 3mm avec la pince à dénuder.

Couper une bande 4 connecteurs JST SXH-001T-P0.6 avec la pince coupante.

Détacher le premier contact en le coupant au ras de la bande avec la pince coupante.

Fermer la pince de manière à laisser assez d'espace pour faire glisser le contact dans l'encoche numéro 1. La pince doit maintenir sa position grâce à un cran.

• Si elle est trop fermée, le contact ne rentre pas.
• Si elle est trop ouverte le contact ne tient pas dans l'encoche.

Insérer le contact dans la première encoche, en laissant complètement sorti l'ergot (la petite languette métallique qui dépasse), qui doit être positionné contre la dent.

L'ergot doit rester intact et ne surtout pas être écrasé par la pince, sinon le contact ne se clipsera jamais dans le connecteur plastique.

Une fois le contact inséré et bien plaqué, fermer d'un cran supplémentaire la pince. Le contact doit être bloqué, il ne doit plus pouvoir sortir en tirant.

L'étape critique : L'insertion du fil

C'est ici que tout se joue. Pour bien comprendre, voici le rôle des deux parties du contact :

• La bague large (arrière) : Sertissage sur l'isolant (pour la solidité mécanique).
• La bague étroite (avant) : Sertissage sur le cuivre (pour le contact électrique).

L'objectif : Insérez le fil dénudé dans le contact maintenu par la pince de manière à ce que :

1. La gaine (isolant) s'arrête pile entre les deux bagues.
2. Le cuivre repose seul sur la bague avant.

Une fois bien positionné (environ 2mm), serrer la pince à fond. La bague arrière "verrouille" le câble tandis que la bague avant assure la connexion.

Une fois serti, tirer légèrement sur le fil en tenant le contact métallique. Si le fil glisse, le sertissage est raté. Si ça tient, c'est gagné !

Répéter la même opération pour les trois autres contacts.

La partie la plus compliquée est passée, il suffit maintenant d'enquiller chaque contact dans le connecteur en clipsant l'ergot dans la fente. On doit entendre un "clic".

Terminer le connecteur en insérant les trois autres fils.

Je vous mets une vidéo (traduite automatiquement) qui résume toute cette étape.

L'autre extrémité : Les embouts de câblage

L'autre côté du câble est plus simple : il doit se connecter au bornier à vis de la carte mère.

On pourrait se contenter de dénuder les fils et de les serrer directement sous la vis. Cependant, visser du fil souple (multibrins) dans un bornier n'est pas fiable : les brins s'écrasent, s'écartent et le contact finit par se desserrer avec le temps.

Pour une connexion durable ("comme les pros"), il faut utiliser des embouts de câblage (taille 0,34mm² ou 0,5mm² selon votre câble). Ils transforment l'extrémité souple en une tige rigide indéformable.

Insertion : Insérez le fil dénudé dans l'embout jusqu'à ce que l'isolant du câble vienne buter contre la collerette en plastique. Le cuivre ne doit pas (ou très peu) dépasser du tube métallique.

Sertissage : Placez l'embout dans votre pince à sertir (idéalement une pince pour embouts qui crée une empreinte carrée ou hexagonale) et serrez fermement.

Vérification : Comme pour les connecteurs JST, faites le test de traction : l'embout ne doit pas bouger.

Répéter la même opération pour les 3 autres fils.

🎉 C'est fini pour le premier câble ! Vous pouvez maintenant connecter votre connecteur JST sur la TOUG.

Câble vers carte mère Remote

Ce câble permet à la TOUG de "prendre la main" sur l'entrée télécommande du T.One. C'est grâce à lui que vous pourrez piloter votre PAC à distance comme si vous étiez devant l'écran d'origine.

Couper la même longueur de câble que le précédent.

Connecteur JST XHP-4

Reprendre exactement les mêmes étapes que pour le câble précédent.

Connecteur JST XAP-04V-1

La procédure pour ce connecteur ressemble comme deux gouttes d'eau au précédent. Les seules différences sont le boîtier qui possède un loquet de verrouillage et les contacts JST SXA qui ont une troisième bague à l'arrière.

Les contacts JST SXA-001T-P0.6 étant un peu plus longs, il faudra dénuder les fils entre 3 et 5mm.

Préparation : Fermer la pince, insérer le contact (dans le même sens que la photo), plaquer le petit ergot contre la dent et fermer d'un cran supplémentaire pour maintenir le contact.

Sertissage : Insérer le fil pour que l'isolant se situe entre la première et la deuxième bague (environ 2-3 mm dans le contact) puis serrer fermement la pince.

Sertir de la même manière les trois autres fils.

Montage du boîtier : Insérer le premier contact dans le boîtier afin que l'ergot se clipse dans la fente.

Clipser les trois autres fils de la même façon.

Le deuxième câble est prêt ! Brancher le côté JST XHP-4 sur la TOUG (port Vers Carte mère Remote).

Rallonge télécommande

La TOUG utilisant les mêmes standards que la carte mère, on pourrait théoriquement y brancher la télécommande directement. Cependant, le câble d'origine est souvent trop court et tendu. Il est donc vivement conseillé de fabriquer une rallonge adaptatrice :

• D'un côté, elle se branche sur la TOUG (connecteur JST XAP-04V-1).
• De l'autre, elle offre une prise pour accueillir le câble de la télécommande (connecteur JST XARR-04V).

Connecteur JST XAP-04V-1

Reprendre exactement les mêmes étapes que pour le câble précédent.

Connecteur JST XARR-04V

La procédure va ressembler fortement à ce que nous avons vu jusqu'à présent. Seuls les contacts JST SXAM-001T-P0.6 sont vraiment différents (ce sont des pointes), mais on s'en sort très bien avec notre pince SN-28B.

Préparation : Fermer la pince, insérer le contact (dans le même sens que la photo), faire dépasser uniquement la partie carrée et fermer d'un cran supplémentaire pour maintenir le contact.

Sertissage : Insérer le fil pour que l'isolant se situe entre la première et la deuxième bague (environ 2-3 mm dans le contact) puis serrer fermement la pince.

Sertir de la même manière les trois autres fils.

Montage du boîtier : Ici pas de fente visible pour clipser, le sens est moins évident à deviner. Il faut insérer la partie creuse du contact côté opposé à l'ergot du boîtier, comme sur la photo suivante.

Une fois les 4 contacts clipsés, les pointes doivent toutes se trouver au même niveau. Vérifier qu'elles ne bougent pas en tirant légèrement sur les fils.

Le troisième câble est prêt ! Brancher le côté JST XAP-04V-1 sur la TOUG (port Vers Télécommande).

Félicitations ! Les câbles sont finis pour les Parcours Argent 🥈 et Bronze 🥉 !

Câble vers carte mère Tank

Ce câble permet d'envoyer la température des sondes au T.One.

• Le rôle de la TOUG : En dessous de 60°C, elle relaie simplement les infos des sondes. Au-delà, elle "bride" l'information envoyée à la PAC à 60°C pour éviter les erreurs côté T.One.

Connecteur JST XHP-4

Reprendre exactement les étapes expliquées pour le câble vers carte mère modbus.

Connecteur JST XAP-06V-1

Il s'agit de la même famille que le connecteur Carte mère Remote (JST XA avec loquet), mais avec 6 emplacements. Seuls quatre fils sont à sertir sur les six disponibles.

Rallonge vers les sondes

Comme pour la télécommande, il est techniquement possible de brancher les sondes directement sur la TOUG, mais une rallonge offre plus de souplesse.

Connecteur JST XAP-06V-1

Réaliser exactement le même connecteur que pour le câble Tank précédent (4 fils sur les 6 emplacements).

Connecteur JST XARR-06V

Il s'agit du "grand frère" du connecteur de la rallonge télécommande. Il possède 6 emplacements, mais seuls quatre sont utilisés.

🥇 Le Parcours Or est maintenant achevé ! Tous les câbles de votre Pack All Inclusive sont prêts à être installés.

Boîtier

Continuons en fixant le PCB au boîtier. Cela facilitera sa manipulation et le protégera pour la suite des opérations.

Préparation de l'encoche Ethernet : Le connecteur Ethernet de l'ESP32 dépasse légèrement et empêche de plaquer le PCB contre le support. Il faut donc réaliser une petite encoche :

1. Positionnez le PCB sur ses supports de vis.
2. Enfichez l'ESP32 dans son embase.
3. Repérez au feutre l'emplacement du port Ethernet sur le rebord du boîtier.

Retirer le PCB du boîtier. Le port Ethernet fait 16mm de large et doit rentrer de 3mm. Ainsi, afin de laisser un peu de jeu, dessiner une encoche de 16,5mm x 3,5mm.

Découpe : Si vous possédez un outil rotatif multifonction (type Dremel), c'est l'idéal. Sinon, une petite lime à métaux avec un angle droit fera parfaitement l'affaire.

Une fois l'encoche réalisée, enficher l'ESP32 au maximum et plaquer le PCB : le port Ethernet ne doit pas toucher le boîtier.

Se munir des 4 vis autotaraudeuses pour PVC M2.6x6 ou M3x6 et les positionner dans chaque angle.

Vissez sans serrer au maximum dans un premier temps pour vérifier l'alignement.

Une fois que tout est d'équerre (le PCB ne doit pas dépasser du support), serrez définitivement.

La carte est désormais sécurisée, nous allons pouvoir passer aux réglages finaux !

Alimentation

Cette étape est la plus critique du montage. Nous allons transformer le 12V de la PAC en 5V pour l'ESP32 et les autres composants.

Configuration des cavaliers (Jumpers)

Avant d'alimenter, vérifier la position des cavaliers pour un fonctionnement standard (via la PAC) :

• H7 (Source 12V) : Position sur Modbus.
• H12 (12V SELECT) : Position sur Convertisseur 12->5V.

Branchement du 12V

Il faut maintenant amener du 12V sur la carte.

• Option A (Sur table) : Utiliser une alimentation secteur 12V DC (type chargeur de vieille box ou de disque dur externe). Brancher le + (VCC) et le - (GND) sur le bornier Modbus (seuls les 2 fils d'alim VCC et GND suffisent).
• Option B (In-situ) : Si vous êtes téméraire, vous pouvez le faire directement sur la PAC, mais c'est moins pratique pour mesurer.

Réglage du convertisseur

Mettre le multimètre en position Voltmètre DC (V=).

Mesurer la tension en entrée du convertisseur (en haut) : vous devez trouver environ 12V.

Mesurer la tension en sortie (en bas) : Noter la valeur affichée.

Se munir d'un petit tournevis de précision. Tout en maintenant les pointes du multimètre sur la sortie, tourner la petite vis argentée.

Regarder le multimètre : la tension doit varier

• Dans le sens des aiguilles d'une montre, elle doit diminuer
• Dans le sens contraire, elle doit augmenter

Ajuster finement jusqu'à obtenir 5.0V (entre 4.95V et 5.05V c'est parfait).

Vérification finale

Sans brancher les modules, vérifier (au dos de la carte si besoin) les tensions aux bornes :

• 5V / GND de l'ESP32.
• VCC / GND des modules RS485.

Si toutes les mesures sont à 5V, bravo ! La carte est correctement alimentée.

Optionnel : Test de l'alimentation USB

• débrancher le 12V du connecteur Modbus
• positionner le cavalier 12V SELECT (H12) sur 5V USB
• brancher un câble USB C entre la TOUG et un PC
• vérifier la présence de 5V également sur l'ESP32 et les convertisseurs TTL-RS485
• vérifier que le PC détecte un port série (COM) sur l'USB

ESP32

Nous allons à présent vérifier que l'ESP32 est alimenté correctement, soit par le 12V, soit par l'USB.

Brancher l'ESP32 sur ses embases.

La LED rouge intégrée sur l'ESP32 doit s'allumer et rester fixe. Si elle clignote ou ne s'allume pas, couper tout immédiatement et revérifier le réglage du convertisseur 5V.

🎉 Objectif atteint !

Côté matériel, le gros œuvre est terminé ! Mais avant de brancher les modules restants, nous allons donner vie à la carte en flashant son logiciel.

Étape 4 : Installer le logiciel

Nous allons à présent configurer, compiler et flasher le logiciel de la TOUG.

Configuration du logiciel

Récupérer le template qui permettra de télécharger le code de la TOUG directement sur Github, en cliquant sur la flèche en haut à droite (Download raw file).

Ouvrez ce fichier et éditez les 5 étapes en commentaires pour personnaliser ESPHome en fonction de votre installation. Remplacez les exemples par vos valeurs :

1. Définir le T.one connecté à la TOUG (T.One AIR ou T.One AquaAIR)

   # Exemple
   TOne: aquaair
   

2. Indiquer le nombre de thermostats (nombre entre 1 et 9)

   # Exemple
   nombre_thermostats: 4
   

3. (optionnel) Remplacer le nom et la description par défaut si besoin en décommentant les lignes

   # Exemple
   name: T.One RDC
   description: Pompe à chaleur du Rez-de-chaussée
   

4. (optionnel) Remplacer le nom des cannaux/bouches/thermostats (par exemple par pièce) en décommentant les lignes

   # Exemple
   K1a: Salon
   K2: Bureau
   K3: Chambre Jean
   K4: Chambre Marie
   

5. Décommenter la configuration à télécharger correspondant au T.One

   # Exemple
   packages:
     remote_package:
       url: https://github.com/djtef/toug
       ref: main
       refresh: 300s
       files:
         - esphome/toug_aquaair_eth.yaml #T.One AquaAIR avec connexion ethernet
   
   

Renommer le fichier en toug.yaml.

C'est ce fichier qu'il faudra compiler et flasher suivant la méthode choisie.

Afin de ne pas laisser ses mots de passe en clair, créer un nouveau fichier nommé secrets.yaml. Le placer dans le même répertoire que toug.yaml. Copier et remplir le contenu ci-dessous avec ses données :

wifi_ssid: "mon_wifi"
wifi_password: "mon_mot_de_passe_wifi"
esphome_api_key: "ma_clé_esphome"
esphome_ota_password: "mon_mot_de_passe_ota"
esphome_web_server_username: "mon_utilisateur_web"
esphome_web_server_password: "mon_mot_de_passe_web"

Brancher l'ESP32

Pour flasher le logiciel (basé sur ESPhome) la première fois, il faut connecter la TOUG à un PC ou à la box Home Assistant. En général, le PC est plus puissant, la compilation sera donc plus rapide.

L'ESP32 WT32-ETH01 utilisé pour la TOUG n'a pas de port USB, il faut utiliser un convertisseur USB/TTL pour le flasher (souvent appelé FTDI).

Bonne nouvelle : un connecteur directement compatible a été prévu sur la TOUG ! Il suffit d'y brancher l'adaptateur.

Positionner l'interrupteur latéral FLASH MODE sur FLASH, puis brancher l'USB au PC.

Flasher le logiciel

Deux méthodes sont possibles pour flasher le logiciel d'un ESP32 : depuis le navigateur, ou en ligne de commande.

Depuis le navigateur web

On peut utiliser directement l'Add On ESPHome depuis Home Assistant, un article expliquant la méthode existe déjà.

Home Assistant : vos premiers pas avec ESPHome

Si la domotique vous passionne, il est tentant de créer vos propres objets connectés. C’est ce que propose ESPHome. Cet article permet de comprendre à quoi sert ESPHome, comment l’installer et l’utiliser, ce que sont les micro-contrôleurs ESP32 et ESP8266.

Home Assistant Communauté FrancophoneArgonaute

Vu que ce n'est pas mentionné dans l'article précédent, nous allons détailler ci-dessous la procédure en ligne de commande.

En ligne de commande

Installation de Python

Avant d'installer ESPhome sur le PC, il est nécessaire d'avoir la bonne version de python. Au moment de la rédaction de cet article, il est demandé d'installer Python 3.11, 3.12, ou 3.13 depuis le site officiel, mais il est recommandé de vérifier sur le lien donné juste au-dessus.

Pour Windows, cliquer sur Download Windows installer (64-bit).

Lancer l'installateur et cocher Add python.exe to PATH.

Cliquer sur Install Now.

À la fin de l'installation, redémarrer le PC.

Lancer l'Invite de commandes en tapant cmd dans la barre de recherche Windows.

Vérifier que la version de python correspond à celle installée précédemment en exécutant la commande :

python --version

Dans notre cas ça doit afficher :

Python 3.13.12

Installation de ESPhome

Toujours dans le terminal, installer ESPHome avec ces commandes :

pip3 install wheel
pip3 install esphome

La dernière version de ESPHome est automatiquement téléchargée et installée. On peut le vérifier en tapant :

esphome version

La commande doit renvoyer une version pas trop loin de la date actuelle:

Version: 2026.1.5

ESPHome est installé !

Compilation

Naviguer dans le dossier contenant les fichiers toug.yaml et secrets.yaml à l'aide de la commande cd

cd C:\Users\djtef\projets\toug

Lancer la compilation avec la commande :

esphome compile toug.yaml

ESPHome télécharge tout le code source, dont celui de la TOUG, et le compile. Cette opération prend plusieurs minutes suivant la puissance du PC.

Flashage

L'envoi du binaire dans l'ESP32 (le flashage) est très rapide comparé à la compilation. Il suffit d'exécuter la commande :

esphome upload toug.yaml

ESPhome demande ensuite de choisir la méthode d'envoi.

Found multiple options for uploading, please choose one:
  [1] COM4 (USB Serial Port (COM4))
  [2] Over The Air (toug-air.local)
(number):

Sélectionner l'option USB Serial Port (COMx) correspondant à l'adapateur FTDI (1 dans l'exemple ci-dessus).

Une barre de progression apparaît pendant l'envoi du binaire dans l'ESP32.

esptool v5.1.0
Connected to ESP32 on COM4:
Chip type:          ESP32-D0WD-V3 (revision v3.1)
Features:           Wi-Fi, BT, Dual Core + LP Core, 240MHz, Vref calibration in eFuse, Coding Scheme None
Crystal frequency:  40MHz
MAC:                d4:e9:f4:c3:b6:e8

Stub flasher running.
Changing baud rate to 460800...
Changed.

Configuring flash size...
Auto-detected flash size: 8MB
Flash will be erased from 0x00010000 to 0x000bbfff...
Flash will be erased from 0x00001000 to 0x00007fff...
Flash will be erased from 0x00008000 to 0x00008fff...
Flash will be erased from 0x00009000 to 0x0000afff...
Wrote 702304 bytes (437686 compressed) at 0x00010000 in 11.3 seconds (497.1 kbit/s).
Hash of data verified.
Flash parameters set to 0x023f.
SHA digest in image updated.
Compressed 26240 bytes to 16492...
Writing at 0x00040868 [=====>                        ]  22.5% 98304/437686 bytes...

Une fois terminé le message suivant apparaît :

Hard resetting via RTS pin...
INFO Successfully uploaded program.

La TOUG est programmée !

Premier démarrage de la TOUG

Débrancher l'USB du PC et repositionner l'interrupteur FLASH MODE sur NORMAL.

Rebrancher l'USB au PC : la TOUG démarre !

On peut alors se connecter à la page web de la TOUG en tapant son adresse IP dans le navigateur.

Une fenêtre nous demandant les identifiants apparaît.

Entrer les identifiants définis dans le fichier secrets.yaml.

esphome_web_server_username: "mon_utilisateur_web"
esphome_web_server_password: "mon_mot_de_passe_web"

Une page web ESPHome apparaît avec des valeurs NA et beaucoup de warning dans les logs : C'est tout à fait normal ! L'ESP32 cherche à communiquer avec la PAC, mais aucun composant n'est encore branché.

L'ESP32 est à présent fonctionnel, il ne reste plus qu'à tester avec tous les composants !

Étape 5 : Tester la TOUG

On est souvent tenté à ce moment précis de vouloir tout brancher pour tester, mais il est préférable d'être encore un peu patient et d'y aller petit à petit. Une erreur ou une mauvaise soudure et on grille un ou plusieurs composants.

USB

Nous allons commencer par vérifier qu'on arrive à alimenter la TOUG via l'USB et qu'il est bien reconnu en tant que port série par le PC.

Prérequis :

• Interrupteur latéral FLASH MODE (SW1) sur NORMAL
• Interrupteur latéral ON/OFF (SW2) sur OFF
• Interrupteur à glissière CHOIX UART USB (SW6) sur UART 0
• Cavalier 5V SELECT (H2) sur 5V USB
• Rien n'est branché sur la carte à part l'ESP32 (et son port Ethernet si besoin)

Se munir d'un câble USB C et brancher la TOUG au PC.

Alimenter la TOUG en positionnant l'interrupteur latéral ON/OFF (SW2) sur ON :

• La LED rouge de l'ESP32 s'éclaire.
• Les voyants du port Ethernet clignotent (si un câble réseau est branché).
• Windows émet le son caractéristique d'un nouveau périphérique USB.

Level shifter

Avant d'ajouter les modules Modbus (qui fonctionnent en 5V), nous allons vérifier que notre Level Shifter convertit bien les tensions pour protéger l'ESP32 (qui fonctionne en 3,3V). Laisser la TOUG branchée en USB.

Brancher le Level shifter sur son embase.

Mesurer la tension avec le voltmètre :

• Entre la broche HV et GND : on doit trouver 5V.
• Entre la broche LV et GND : on doit trouver 3,3V.

Vérifier que la page web est toujours accessible.

👉 Si tout est bon, on peut continuer.

Modbus utilisateur

Nous allons enfin préparer l'interface avec le T.One en testant la communication du Modbus utilisateur. Profitons que la TOUG est branchée en USB pour faciliter ce premier test.

Brancher le module TTL-RS485 (U2) du Modbus utilisateur (celui de droite) sur ses embases.

Test de continuité

Avant de remettre le courant, un test des pistes s'impose. Positionnez votre multimètre sur Continuité (il doit biper quand vous touchez les deux pointes).

Vérifier que le courant passe bien entre ces différents points :

• Masses et Alimentations :
  • GND du TTL-RS485 ↔️ GND de l'ESP32
  • VCC du TTL-RS485 ↔️ HV du Level Shifter
• Signaux Logiques :
  • TXD du TTL-RS485 ↔️ HV1 du Level Shifter
  • RXD du TTL-RS485 ↔️ HV2 du Level Shifter
  • LV1 du Level Shifter ↔️ TXD de l'ESP32
  • LV2 du Level Shifter ↔️ RXD de l'ESP32
• Câblage vers la PAC :
  • A+ du TTL-RS485 ↔️ Embout A du câble Modbus (ex: fil rouge ici)
  • B- du TTL-RS485 ↔️ Embout B du câble Modbus (ex: fil vert ici)
  • GND du TTL-RS485 ↔️ Embout GND du câble Modbus (ex: fil bleu ici)

Si tout a sonné, on peut alors alimenter la carte sans souci ! 👍

Test du module TTL-RS485

La LED TXD du module TTL-RS485 doit clignoter en rouge, ce qui signifie que la TOUG essaie de communiquer en Modbus, mais le T.One ne répond pas (normal, il n'est pas encore branché).

Vérifier que la page web est toujours accessible.

Test du Modbus alimenté en USB

Il faut à présent relier physiquement la TOUG à la carte mère du T.One pour voir s'ils se comprennent.

Accès à la carte mère du T.One :

1. Faire basculer la télécommande de façade pour la retirer de son emplacement et déconnectez-la.
2. Enlever la grande façade du T.One en la poussant vers le haut.
3. Dévisser les deux vis qui tiennent le capot de la carte mère (en haut).
4. Enlever le capot en le tirant vers l'avant.

Branchement : Retirer le bornier débrochable "Modbus" de la carte mère Aldes, et y visser les 4 embouts de votre câble Modbus (celui fabriqué à l'étape 3).

Rebrancher ensuite :

• le bornier Modbus sur la carte mère du T.One,
• l'USB à la place de la passerelle officielle (sur le dessus),
• le câble Ethernet, si nécessaire.

• La LED de l'ESP32 doit s'allumer fixe.
• Les DEUX LEDs (TXD et RXD) du module TTL-RS485 doivent maintenant clignoter brièvement toutes les 10 secondes. Le T.One répond !

Aller sur la page web de la TOUG :

• Les thermostats ont la bonne consigne
• La température de la pièce principale apparaît
• Le Mode Air peut être changé

Sur le T.One AquaAIR apparaissent en plus:

• La température ECS
• Le Mode ECS

🎉 Félicitations ! La communication bidirectionnelle entre la TOUG et le T.One est fonctionnelle !

Test du Modbus alimenté par le 12V

Nous allons à présent alimenter la TOUG par le 12V du Modbus.

Débrancher la TOUG du T.One. Le câble USB peut être mis de côté pour le moment.

Déplacer le cavalier 5V SELECT (H2) sur la position Convertisseur 12->5V.

Le cavalier Source 12V (H7) doit être sur Modbus.

Brancher le convertisseur DC-DC MP1584 sur ses 4 embases.

Rebrancher le bornier Modbus sur la carte mère (et le câble Ethernet si besoin).

La TOUG doit être alimentée et toujours communiquer en Modbus avec le T.One :

• La LED de l'ESP32 doit s'allumer fixe.
• Les DEUX LEDs (TXD et RXD) du module TTL-RS485 doivent maintenant clignoter brièvement toutes les 10 secondes.
• La page web doit afficher les mêmes informations qu'avec le câble USB.

👏 Une grosse étape est franchie : la carte est désormais autonome en énergie !

Télécommande

Nous allons nous attaquer à présent à la télécommande, dernière étape des Parcours Bronze 🥉 et Argent 🥈.

Test de l'alimentation

Dans un premier temps, la TOUG va simplement s'intercaler entre la carte mère et l'écran sans interagir, pour vérifier que le courant passe bien.

Débrancher la TOUG du T.One.

Rebrancher la télécommande au T.One si elle avait été déconnectée lors du démontage de la façade avant. Vérifier qu'elle fonctionne toujours.

Positionner l'interrupteur Téléco (SW4) sur OFF (gauche). Dans cette position, la TOUG remplace la télécommande qui n'est plus alimentée.

Débrancher le connecteur Remote de la carte mère.

Brancher le câble Vers Télécommande de la TOUG (tout à gauche) sur le câble qui vient d'être déconnecté.

Brancher le câble Vers Carte mère Remote à la place (en bas à droite de la carte mère).

Rebrancher le connecteur Modbus (et le câble Ethernet si nécessaire).

Positionner l'interrupteur Téléco (SW4) sur ON (doite) : Dans cette position, la TOUG ne fait que "passe-plat" entre le T.One et la télécommande. Elle doit être alimentée et fonctionnelle.

Vérifier que la page web est toujours accessible.

Test de la communication

Nous allons pouvoir tester la communication en remplaçant la télécommande.

Positionner l'interrupteur Téléco (SW4) sur OFF (gauche).

Débrancher les 3 câbles de la TOUG vers la carte mère et la télécommande.

Brancher le deuxième adaptateur TTL-RS485 Télécommande (U3) de la TOUG sur ses embases.

Rebrancher les 3 câbles de la TOUG vers la carte mère et la télécommande (et le câble Ethernet si nécessaire).

Le test final :

• La LED de l'ESP32 doit s'allumer fixe.
• Les LEDs (TXD et RXD) des DEUX modules TTL-RS485 doivent maintenant clignoter brièvement toutes les 10 secondes.

Aller sur la page web de la TOUG :

🤩 une multitude de nouvelles données apparaissent !

Détection des bouches / résistance d'appoint

Dans cette partie, nous allons ajouter les modules d'optocoupleurs. Ils permettent à la TOUG de "lire" les commandes envoyées par la PAC (ouverture des bouches d'air et activation de la résistance d'appoint ECS) de manière totalement isolée et sécurisée.

Premier module

Ce premier module (U7) va gérer les 4 premières bouches (K1 à K4).

Préparation du câblage

Couper autant de paires de fils que de bouches à détecter d'une longueur d'environ 50 cm.

Dénuder chaque extrémité sur environ 5 mm.

Débrocher le connecteur 8 bornes de la TOUG et vissez chaque paire de fils.

Connexion à la carte mère du T.One

Connecter les autres extrémités des fils en parallèle des commandes des bouches, directement sur le bornier à vis de la carte mère du T.One.

• La première borne en haut est K1A+ puis K1A-.
• Les dernières en bas sont K4+ et K4-.

Installation du module sur la TOUG

Débrancher les 3 câbles de la TOUG (vers la carte mère et la télécommande) pour manipuler la carte librement.

Connecter le premier module d'optocoupleurs OP71A04 (U7) sur ses embases.

Positionner le cavalier PULLUP/DOWN SELECT (à gauche du précédent module) sur UP.

Brancher le connecteur 8 bornes (qui vient d'être câblé) sur la TOUG.

Rebrancher les 3 autres câbles de la TOUG vers la carte mère et la télécommande.

Test et Validation

Aller sur la page web de la TOUG : les commandes des bouches de chaque pièce doivent être à OFF.

Activer un Test Chauffage ou Clim.

Les commandes des bouches doivent s'activer les unes après les autres :

• Les LED vertes des borniers de la carte mère s'allument.

• Les LED du module à optocoupleurs s'éclairent.

• Des checks noirs apparaissent sur la page web.

Désactiver le mode Test en sélectionnant Aucun : tout s'éteint.

La détection des 4 premières commandes de bouches est opérationnelle !

Deuxième module

Le deuxième module d'optocoupleurs (U14) est polyvalent. Il permet de gérer soit deux bouches supplémentaires (K5 et K6), soit une bouche (K5) et la résistance d'appoint ECS.

Installation du module sur la TOUG

Débrancher tous les câbles de la TOUG (vers la carte mère et la télécommande) pour manipuler la carte librement.

Connecter le deuxième module d'optocoupleurs OP71A04 (U14) sur ses embases.

Positionner le cavalier H9 sur :

• Position droite (K6+) : Pour détecter deux bouches (K5 et K6).
• Position gauche (Résistance Appoint) : Pour détecter K5 et la résistance d'appoint.

Option A : Détection des bouches

La procédure est identique à celle des 4 premières bouches. Connectez une paire de fils entre les borniers K+/K- de la carte mère et les borniers débrochables de la TOUG :

• Bornier de droite sur la TOUG pour la bouche K5.
• Bornier de gauche sur la TOUG pour la bouche K6.

Option B : Détection de la résistance d'appoint ECS (routeur solaire)

Le principe : Nous allons remplacer le 230V qui entre dans le relais de la carte mère par un signal 3,3V. La TOUG détectera ainsi l'activation du relais sans danger pour l'ESP32.

Câblage technique :

1. Sur la TOUG : Positionnez le cavalier RES APP REF (H10) sur 3.3V.
2. Bornier noir AUX HEATER [rectangle rouge] (Alimentation) : Débranchez-le en tirant dessus. Déconnectez la phase (L1) et reliez-la à la borne Ref/K6- de la TOUG avec un fil.
   Ce fil devient la 'source de signal'. Il permet d'injecter la référence nécessaire pour que l'optocoupleur fonctionne.

3. Connecteur blanc TANK HW [rectangle bleu](Résistance) : Débranchez-le. C'est ici qu'on utilise nos connecteurs de sécurité MATE-N-LOK.

Branchement sécurisé (MATE-N-LOK)

Pour un montage propre, utilisez les connecteurs TE Connectivity:

• Côté Carte Mère (Sortie Signal) : Boîtier Mâle (1-480698-0) avec Contacts Femelles/Sockets (350550-1)
  • Le relier à l'entrée RA/K6+ de la TOUG.
• Côté Résistance (Vers Routeur) : Boîtier Femelle (350778-1) avec Contacts Mâles/Pins (350547-1).+1
  • Le relier à la sortie du routeur solaire.

Avant de remettre le courant, prendre le temps de comparer l'installation avec la photo ci-dessous. C’est le moment de vérifier que rien n’a été oublié, surtout les débranchements de sécurité.

La photo ci-dessous récapitule tous les branchements (et débranchements) nécessaires.

✅ Checklist de fin d'étape :

• Module U14 : Bien enfoncé sur ses embases avec le cavalier H9 sur la bonne position (gauche pour le routeur).
• Bornier noir AUX HEATER : Fil de phase (L1) déporté vers la TOUG (Ref/K6-)
• Bornier blanc TANK HW : Débranché de la carte mère, remplacé par le connecteur MATE-N-LOK mâle qui va à la TOUG (RA/K6+)
• Bornier HA1 (Appoint Air) : IMPÉRATIVEMENT débranché pour éviter tout retour de phase.
• Résistance d'appoint : connectée directement au routeur avec le connecteur MATE-N-LOK femelle.
• Sécurité 230V : Les contacts femelles (Sockets) sont bien du côté de la source de tension (carte mère) pour éviter tout contact accidentel.

Test et validation

Rebrancher les autres câbles de la TOUG vers la carte mère et la télécommande (brancher le câble Ethernet si nécessaire).

Vérifier que la page web est bien accessible.

Pour tester :

• la détection de bouches
  • relancer un test Chauffage ou Clim
  • vérifier que les nouvelles commandes de bouches sont détectées
• la détection de la résistance d'appoint
  • lancer un test Appoint ECS
  • vérifier que la résistance d'appoint s'active

Lecture des températures ECS

Passons à la toute dernière fonction matérielle à tester : la lecture des températures de l'Eau Chaude Sanitaire (ECS) et leur falsification (le fameux leurre pour la pompe à chaleur).

Installation du convertisseur analogique

Débrancher tous les câbles de la TOUG (vers la carte mère et la télécommande) pour manipuler la carte librement. Il commence à y en avoir un paquet, on comprend vite l'intérêt des borniers débrochables !

Connecter le module ADS1115 (ADC1) sur son embase.

Câblage des sondes

Sur la carte mère du T.One (en haut), repérer et déconnecter le connecteur TANK (qui gère les sondes de température ECS).

Le pontage sur la TOUG :

• Brancher le câble des sondes (celui qui vient du ballon) sur le connecteur Entrée sondes de la TOUG (ou utiliser sa rallonge).
• Brancher le câble maison entre la Sortie sondes de la TOUG et le connecteur TANK de la carte mère.

Test de lecture

Aller sur la page web de la TOUG, de nouvelles valeurs apparaissent !

• les températures mesurées (Haut et Bas) : Elles doivent correspondre aux températures fournies par la télécommande (Sonde ECS bas et Sonde ECS haut)

• Les résistances brutes : On voit également la valeur en ohms des sondes NTC.

Test du Forçage (Falsification)

C'est le moment de tester le leurre, indispensable pour empêcher la PAC d'afficher une erreur si la température dépasse 60°C !

Activer la falsification des sondes en cliquant sur Forçage 60°.

Observer les réactions :

• On entend le relais qui bascule (léger "clic").
• Les températures ECS "vues" par le T.One sautent subitement à environ 60°C.

• Les températures réellement mesurées par la TOUG, quant à elles, ne changent pas et restent précises.

Désactivez le Forçage 60° : on entend un nouveau "clic" et les sondes ECS reprennent immédiatement leur vraie valeur aux yeux du T.One.

🎉 C'est officiel : la TOUG "All Inclusive" est 100% opérationnelle ! 🚀

Étape 6 : Intégrer dans Home Assistant

Intégration ESPHome

Maintenant que la TOUG est fonctionnelle, nous pouvons l'intégrer dans Home Assistant.

Si tout se passe bien, Home Assistant détecte automatiquement qu'un nouvel appareil ESPHome est disponible sur le réseau.

Aller dans Paramètres > Appareils et services. Dans l'onglet Intégrations, la TOUG apparaît dans la rubrique Découverte.

Cliquer sur Ajouter, puis confirmer en cliquant sur Valider.

Entrer la clé de chiffrement qui a été définie dans le secrets.yaml avec la variable esphome_api_key, puis cliquer sur Valider.

Le nom de l'appareil peut être modifié, et la TOUG affectée à une pièce.

Toutes les entités de la TOUG apparaissent alors dans Home Assistant (jusqu'à 80 !).

La TOUG est maintenant intégrée dans Home Assistant ! 📊

À ce stade, on peut déjà créer ses propres tableaux de bord avec les entités créées automatiquement. Mais nous allons voir comment aller plus loin pour obtenir un rendu plus ergonomique.

Installer HACS sur Home Assistant et profiter d’un magasin alternatif.

Malgré la multitude d’intégrations, d’add-ons ou de thèmes disponibles en natif dans Home Assistant, il y a une communauté qui en développe d’autres. Cette communauté, c’est HACS, pour Home Assistant Community Store. Voyons comment l’installer.

Home Assistant Communauté FrancophoneMcfly

Thermostats

On peut tout à fait modifier la consigne de température de chaque pièce avec le curseur, ou changer de mode avec la liste déroulante, automatiquement créés par Home Assistant.

Mais avoir une seule carte Thermostat qui permet de changer la consigne, voir la température actuelle, changer de mode ou de profil est beaucoup plus séduisant.

Installer hass-template-climate dans HACS et ajouter le thermostat dans le configuration.yaml.

L'exemple suivant est pour la pièce principale (K1) et doit être adapté en fonction du nom des entités de chacun :

• Séjour⁣ :Nom du thermostat à définir (au choix)
• sejour_k1a_climate_template : id du thermostat à définir (au choix)
• binary_sensor.toug_air_canal_sejour : entité du canal correspondant au thermostat
• sensor.aqara_temperature_et_humidite_thermostat_k1a_humidity: (optionnel) entité de l'humidité de la pièce (externe)
• sensor.toug_air_temperature_sejour⁣ :entité de la température de la pièce
• number.toug_air_thermostat_sejour⁣ :entité de la consigne du thermostat de la pièce

climate:
  - platform: climate_template
    name: Séjour
    unique_id: sejour_k1a_climate_template
    icon_template: mdi:home-thermometer
    availability_template: >- 
        {{ is_state('sensor.toug_air_aiguillage_vanne', 'Air') 
        or  is_state('sensor.toug_air_aiguillage_vanne', 'Standby')
        or  is_state('sensor.toug_air_aiguillage_vanne', 'ECS') }}
    modes:
      - "heat"
      - "cool"  # Si la climatisation est activée
      - "off"
    preset_modes:
      - comfort
      - eco
      - away
      - home
      - boost
      - none
    hvac_mode_template: >-
      {% if 'Chauffage' in states('select.toug_air_mode_air') %} 
          heat
      {% elif 'Clim' in states('select.toug_air_mode_air') %} 
          cool
      {% else %} 
          off      
      {% endif %}
    preset_mode_template: >-
      {% if is_state('select.toug_air_mode_air', 'Off') %}
        none
      {% elif 'Confort' in states('select.toug_air_mode_air') %}
        comfort
      {% elif 'Prog A' in states('select.toug_air_mode_air') or 'Prog C' in states('select.toug_air_mode_air') %}
        away
      {% elif 'Prog B' in states('select.toug_air_mode_air') or 'Prog D' in states('select.toug_air_mode_air') %}
        home
      {% elif 'Eco' in states('select.toug_air_mode_air') %}
        eco
      {% elif 'Boost' in states('select.toug_air_mode_air') %}
        boost
      {% else %}
        none
      {% endif %}
    set_preset_mode:
      - action: select.select_option
        data:
          entity_id: select.toug_air_mode_air
          option: >-
            {% if 'Chauffage' in states('select.toug_air_mode_air') %} 
                {% if preset_mode == 'none' %}
                    Off
                {% elif preset_mode == 'comfort' or preset_mode == 'boost' %}
                    Confort Chauffage
                {% elif preset_mode == 'away' %}
                   Prog A Chauffage
                {% elif preset_mode == 'home' %}
                   Prog B Chauffage
                {% elif preset_mode == 'eco' %}
                   Eco Chauffage
                {% endif %}
            {% elif 'Clim' in states('select.toug_air_mode_air') %} 
              {% if preset_mode == 'none' %}
                    Off
                {% elif preset_mode == 'comfort' or preset_mode == 'eco' %}
                    Confort Clim
                {% elif preset_mode == 'away' %}
                   Prog C Clim
                {% elif preset_mode == 'home' %}
                   Prog D Clim
                {% elif preset_mode == 'boost' %}
                   Boost Clim
                {% endif %}
            {% else %}
              Off
            {% endif %}
    set_hvac_mode:
      - action: select.select_option
        data:
          entity_id: select.toug_air_mode_air
          option: >-
            {% if hvac_mode == 'heat' %}
              Confort Chauffage
            {% elif hvac_mode == 'cool' %}
              Confort Clim
            {% elif hvac_mode == 'off' %}
              Off
            {% else %}
              Off
            {% endif %}
    hvac_action_template: >-
      {% if is_state('binary_sensor.toug_air_canal_sejour', 'off') %}
        off
      {% elif 'Chauffage' in states('select.toug_air_mode_air') %}
        heating
      {% elif 'Clim' in states('select.toug_air_mode_air') %}
        cooling
      {% else %}
        idle
      {% endif %}

    #current_humidity_template: "{{ states('sensor.aqara_temperature_et_humidite_thermostat_k1a_humidity') }}" # Avec capteur additionnel
    temp_step: 1
    current_temperature_template: "{{ states('sensor.toug_air_temperature_sejour') }}"     
    min_temp: 0
    max_temp_template: >-
      {% if 'Chauffage' in states('select.toug_air_mode_air') %} 
          24
      {% elif 'Clim' in states('select.toug_air_mode_air') %} 
           31
      {% else %} 
          24        {##  pas vraiment besoin  ##} 
      {% endif %}
    target_temperature_template: "{{ states('number.toug_air_thermostat_sejour') }}" 
    set_temperature:
      - action: number.set_value
        data:
          entity_id: number.toug_air_thermostat_sejour  
          value: "{{ temperature }}"

Valider la configuration en allant dans Outil de développement, onglet YAML et cliquer sur Vérifier la configuration. Un message doit apparaître en vert :

La configuration n'empêchera pas Home Assistant de démarrer !

Cliquer sur Climate Template en dessous pour prendre en compte le thermostat ajouté.

Revenir sur le Dashboard, cliquer sur Modifier puis Ajouter une carte. Sélectionner la carte Thermostat et l'entité du thermostat qui vient d'être créé.

On peut ajouter de manière permanente les modes et préréglages dans l'option Fonctionnalités.

Valider le dashboard en cliquant sur Terminer. Voici le résultat :

Programmation horaire

Avec la télécommande du T.One, il est possible de définir heure par heure si la clim ou le chauffage doit être activé ou en éco (off pour la clim). Il existe 2 programmes pour le chauffage (A et B), et 2 pour la clim (C et D).

La télécommande ayant été complètement implémentée, il est possible de modifier la programmation horaire depuis Home Assistant. Afin d’avoir une ergonomie semblable à la télécommande, plusieurs étapes sont nécessaires.

Intégration dans ESPHome

La programmation horaire a été intégrée dans la TOUG :

• En lecture
  • Au format texte

Lundi : 7h-9h, 17h-22h
Mardi : 7h-9h, 17h-22h
Mercredi : 7h-9h, 17h-22h
Jeudi : 7h-9h, 17h-22h
Vendredi : 7h-9h, 17h-22h
Samedi : 8h-22h
Dimanche : 8h-22h

• En représentation hexa du contenu des registres (voir explications)

003e0180003e0180003e0180003e0180003e0180003fff00003fff00

• En écriture via l'api

    - action: change_prog
      variables:
        prog: string
        dataset: string

• prog : A, B, C ou D
• dataset : représentation hexa du contenu des registres

Integration dans Home Assistant

Côté Home Assistant, une implémentation possible est d'utiliser la custom card button-card.

Pour obtenir une ergonomie fluide (sans latence) et synchronisée avec la PAC, nous utilisons un système de "tampon" (buffer) et une automatisation. Voici les étapes à suivre :

Tout le code yaml présenté ici est dans le dossier ha.

Étape 1 : Le Script de synchronisation

Créer un script envoie_prog. Ce script est le chef d'orchestre : il envoie vos réglages à la PAC, ou récupère ceux de la PAC s'ils ont été changés sur la télécommande physique.

description: Envoie la programmation horaire au T.One
fields:
  prog:
    description: Nom de la programmation (A,B,C ou D)
    example: A
    selector:
      select:
        options:
          - A
          - B
          - C
          - D
    required: true
  direction:
    description: Direction de la synchro
    example: esphome_vers_ha
    default: esphome_vers_ha
    required: true
    selector:
      select:
        options:
          - esphome_vers_ha
          - ha_vers_esphome
sequence:
  - variables:
      buffer_entity: "{{ 'input_text.prog' ~ prog | lower ~ '_buffer' }}"
      dataset_entity: "{{ 'sensor.toug_aquaair_progr_' ~ prog | lower ~ '_dataset' }}"
      buffer: "{{ states(buffer_entity) }}"
      dataset: "{{ states(dataset_entity) }}"
  - if:
      - condition: template
        value_template: "{{ direction == 'ha_vers_esphome' }}"
    then:
      - action: esphome.toug_aquaair_change_prog
        data:
          prog: "{{ prog }}"
          dataset: "{{ states(buffer_entity) }}"
    else:
      - action: input_text.set_value
        target:
          entity_id: "{{ buffer_entity }}"
        data:
          value: "{{ states(dataset_entity) }}"
alias: envoie_prog

Étape 2 : Création des "Buffers" (input_text)

Créer 4 entrées "saisie de texte" via l'IHM ou en yaml (helpers input_text). Ces 4 variables invisibles vont stocker les modifications sur le Dashboard avant qu'elles ne soient envoyées à la PAC.

input_text:
  progA_buffer:
    name: progA_buffer
    min: 56
    max: 56
    pattern: "[0-9A-Fa-f]+"
    mode: text
  progB_buffer:
    name: progB_buffer
    min: 56
    max: 56
    pattern: "[0-9A-Fa-f]+"
    mode: text
  progC_buffer:
    name: progC_buffer
    min: 56
    max: 56
    pattern: "[0-9A-Fa-f]+"
    mode: text
  progD_buffer:
    name: progD_buffer
    min: 56
    max: 56
    pattern: "[0-9A-Fa-f]+"
    mode: text

Étape 3 : Création des capteurs d'état (sensor template)

Créer 4 entrées Template Capteur via l'IHM ou en yaml (sensor template). Ces capteurs vérifient en temps réel si le Dashboard est bien synchronisé avec la pompe à chaleur.

• synchro : Home Assistant et ESPhome sont synchronisés
• maj : Mise à jour en cours, attente retour ESPHome
• dataset : ESPhome a été mis à jour
• buffer : Home Assistant est en train de changer la valeur via l'IHM

template:
  - sensor:
      - name: "proga_synchro"
        state: >
          {% if states('input_text.proga_buffer') == states('sensor.toug_aquaair_progr_a_dataset') %}
          synchro
          {% elif  states.input_text.proga_buffer.last_changed > states.sensor.toug_aquaair_progr_a_dataset.last_changed %}
          {% if  states.input_text.proga_buffer.last_changed > state_attr('script.envoie_prog','last_triggered') %}
          buffer
          {% else %}
          maj
          {% endif %}
          {% else %}
          dataset
          {% endif %}
      - name: "progb_synchro"
        state: >
          {% if states('input_text.progb_buffer') == states('sensor.toug_aquaair_progr_b_dataset') %}
          synchro
          {% elif  states.input_text.progb_buffer.last_changed > states.sensor.toug_aquaair_progr_b_dataset.last_changed %}
          {% if  states.input_text.progb_buffer.last_changed > state_attr('script.envoie_prog','last_triggered') %}
          buffer
          {% else %}
          maj
          {% endif %}
          {% else %}
          dataset
          {% endif %}
      - name: "progc_synchro"
        state: >
          {% if states('input_text.progc_buffer') == states('sensor.toug_aquaair_progr_c_dataset') %}
          synchro
          {% elif  states.input_text.progc_buffer.last_changed > states.sensor.toug_aquaair_progr_c_dataset.last_changed %}
          {% if  states.input_text.progc_buffer.last_changed > state_attr('script.envoie_prog','last_triggered') %}
          buffer
          {% else %}
          maj
          {% endif %}
          {% else %}
          dataset
          {% endif %}   
      - name: "progd_synchro"
        state: >
          {% if states('input_text.progd_buffer') == states('sensor.toug_aquaair_progr_d_dataset') %}
          synchro
          {% elif  states.input_text.progd_buffer.last_changed > states.sensor.toug_aquaair_progr_d_dataset.last_changed %}
          {% if  states.input_text.progd_buffer.last_changed > state_attr('script.envoie_prog','last_triggered') %}
          buffer
          {% else %}
          maj
          {% endif %}
          {% else %}
          dataset
          {% endif %}      

Étape 4 : Création du sélecteur (input_select)

Créer une entrée liste déroulante (via IHM) ou un input_select par yaml. C'est la liste déroulante qui apparaîtra sur le tableau de bord pour choisir le programme (Chauffage A/B ou Rafraîchissement C/D) à afficher et modifier.

input_select:
  programmation_horaire:
    name: Programmation horaire
    options:
      - Chauffage Progr. A
      - Chauffage Progr. B
      - Rafraîchissement Progr. C
      - Rafraîchissement Progr. C
    initial: Chauffage Progr. A
    icon: mdi:calendar-blank-multiple

Étape 5 : L'automatisation de mise à jour

Créer une automatisation Synchro prog T.One. Cette règle dit à Home Assistant : "Si quelqu'un change un horaire sur la vraie télécommande, mets le Dashboard à jour immédiatement".

  alias: Synchro prog T.One
  description: Met à jour la programmation horaire du T.One vers Home Assitant
  triggers:
  - trigger: state
    entity_id:
    - sensor.proga_synchro
    to: dataset
    id: A
  - trigger: state
    entity_id:
    - sensor.progb_synchro
    to: dataset
    id: B
  - trigger: state
    entity_id:
    - sensor.progc_synchro
    to: dataset
    id: C
  - trigger: state
    entity_id:
    - sensor.progd_synchro
    to: dataset
    id: D
  actions:
  - action: script.envoie_prog
    metadata: {}
    data:
      prog: '{{ trigger.id }}'
      direction: esphome_vers_ha
    alias: Copie dataset ESPHome vers buffer HA
  mode: single

Étape 6 : Le rendu visuel (Dashboard)

Ajouter une vue au dashboard en copiant le contenu de dashboard_prog.yaml dans l'éditeur de configuration du dashboard de Home Assistant :

On obtient ainsi un équivalent de la programmation horaire de la télécommande directement dans Home Assistant qu'on peut synchroniser avec ESPHome et donc le T.One.

Étape 7 : Profiter

La TOUG est montée, testée et intégrée dans Home Assistant. Après l'effort, le réconfort, il est temps de profiter !

• Surveiller son T.One en un coup d'œil :
  • Plus besoin d'aller dans chaque pièce pour savoir la consigne de chaque thermostat.
  • Plus besoin de vérifier que le chauffage a bien été arrêté.
  • Plus besoin d'aller voir la consommation sur la télécommande.
  • TOUT est à disposition sur une même page de Home Assistant !
• Seule l'imagination aura ses limites :
  • Passer en mode Éco lorsque plus personne n'est à la maison.
  • Chauffer 1h avant d'arriver à la maison.
  • Anticiper la clim suivant les prévisions météo.
  • Couper le chauffage quand on ouvre les fenêtres pour aérer.
  • Optimiser le chauffage en fonction de la tarification (Heures Creuses / Tempo).
  • TOUT est à présent possible en terme d'automatisation !
• L'allié parfait des panneaux photovoltaïques :
  • Lancer l'eau chaude, le chauffage ou la clim quand la production est à son maximum.
  • Réguler la clim en fonction du surplus de production solaire.
  • Connecter le routeur solaire à la résistance d'appoint.
  • TOUTE la production sera à présent consommée et optimisée !

Finalement, le meilleur moyen d'en profiter, c'est de ne plus y penser 😉

Conclusion

Si vous lisez ces lignes, c’est que vous êtes arrivé au bout de ce guide !

Avec tout ce niveau de détail, ce tutoriel peut paraître long et complexe. Mais rappelez-vous que la TOUG n'est finalement qu'un jeu de briques. Si vous ne prenez que ce dont vous avez besoin (par exemple, juste le pilotage de base), il n'y a peut-être que 4 composants à assembler (Pack Eco). La clé de la réussite, c'est simplement d'être méthodique dans vos tests à chaque nouvelle étape.

Le plus important désormais ? Partager vos difficultés comme vos succès, vos idées d'automatisations ou vos questions. Le but est de créer une véritable communauté autour de la TOUG. N'hésitez pas à venir discuter sur le forum, on a hâte de voir vos tableaux de bord ! 🚀

Ressources

• Explications, code, schémas, YAML, BOM : Github
• Sujet dédié au Aldes T.One
• Sujet dédié à la TOUG
• Page constructeur T.One