Configurer et Installer le Routeur Solaire
Sommaire
- 00 Introduction
- 01 Paramétrage du routeur
- 1.1 Connexion Wi-Fi
- 1.2 Accès à l'interface web
- 1.3 Assistant de configuration
- 1.4 Configuration Chauffe-Eau
- 1.5 Configuration Système
- 1.6 Configuration Écran / ESP
- 1.7 Configuration Charge 2
- 1.8 Configuration MQTT
- 1.9 Configuration Wi-Fi
- 1.10 Mises à jour, journaux et commandes rapides
- 1.11 Routes techniques (API)
- 1.12 Écran tactile — accueil / graphique
- 02 Installation électrique
- 2.1 Branchement de la sonde de température
- 2.2 Branchement du routeur
- — Contact
Routeur Solaire
Document de référence — installation, configuration et maintenance
00 Introduction
Le Routeur Solaire est compatible avec les chauffe-eau mécaniques (à thermostat classique, sans électronique de gestion embarquée), en alimentation monophasée, d'une puissance maximale de 3000 W.
Le Routeur Solaire est livré avec une petite boîte contenant les accessoires suivants : un câble USB-C, un stylet, et un presse-étoupe (à visser sur le dessus du boîtier, pour le passage sécurisé des 2 fils de phase — voir 2.2 — Branchement du routeur). Si la sonde de température a été commandée, elle est également incluse dans le colis.
Le bon fonctionnement du routeur repose sur la mesure en temps réel de la puissance électrique consommée ou injectée par l'habitation. Cette information peut être récupérée par le routeur via l'un des dispositifs suivants :
- Module Shelly
- Home Assistant
- Jeedom
- Onduleur Fronius
- Ecojoko
- Passerelle Enphase
- Protocole MQTT
L'installation complète se déroule en deux étapes :
-
Paramétrage du routeur Connexion Wi-Fi et réglages via l'interface web du routeur.
-
Installation électrique Raccordement physique du routeur au chauffe-eau.
01 Paramétrage du routeur
1.1 Connexion Wi-Fi
Lors du premier démarrage, le routeur doit être connecté à votre réseau Wi-Fi.
Procédure à suivre :
- Brancher le routeur à l'aide d'un câble USB et d'un chargeur, puis le connecter à une prise électrique.
- Le routeur affiche les réseaux Wi-Fi disponibles dans l'environnement proche.
- Sélectionner le réseau sur lequel doit se connecter le routeur en appuyant sur son nom.
- Renseigner le mot de passe du réseau.
- Vérifier le mot de passe renseigné en appuyant sur « VOIR ».
- Valider.
1.2 Accès à l'interface web
Pour accéder à l'interface Web, vous devez connaître l'adresse IP de votre routeur solaire. Sans cette adresse, la configuration du routeur n'est pas possible.
Afficher l'adresse IP sur l'écran tactile
Appuyez sur l'écran pour faire défiler les pages jusqu'à la page indiquant la version du routeur et les paramètres réseau : adresse IP, passerelle, etc. Ce qui nous intéresse ici, c'est l'adresse IP.
Accéder à l'interface
Saisissez cette adresse IP dans la barre d'adresse d'un navigateur internet afin d'afficher la page d'accueil du Routeur Solaire.
Plusieurs informations sont affichées à l'écran : la date et l'heure, la version du logiciel, le nom du réseau Wi-Fi, ainsi que la qualité de la réception Wi-Fi.
Étapes indispensables avant utilisation
Avant que le routeur puisse fonctionner correctement, deux étapes importantes doivent être réalisées :
-
Configurer la page Chauffe-eau Réglages de régulation indispensables au fonctionnement du routage.
-
Configurer la page Système Source de mesure de la consommation de la maison et coordonnées géographiques.
1.3 Assistant de configuration
Un assistant de configuration par questions est accessible depuis un bouton en haut de la page « Configuration », ainsi que depuis la page d'accueil au tout premier démarrage (mis en avant tant que le routeur n'a pas encore été configuré). Il pose une question courte à la fois (barre de progression « Étape X / Y » en haut de l'écran), avec à chaque fois une explication et, si utile, un exemple concret.
Il couvre dans l'ordre : la source de mesure de la consommation de la maison (Shelly, Enphase, Fronius, Home Assistant, Jeedom, Ecojoko ou MQTT, avec tous les champs propres à l'appareil choisi), les réglages du chauffe-eau (puissance, sonde de température éventuelle, plages horaires de marche programmée), la puissance et la durée de la marche forcée manuelle, les coordonnées géographiques, la puissance de l'installation solaire, puis la présence éventuelle d'une batterie et sa priorité de charge. Il se termine par un écran récapitulatif qui explique, à l'aide d'exemples concrets, le mode de fonctionnement qui résultera des réponses données.
Un bouton permet alors d'enregistrer directement la configuration sur le routeur, qui redémarre automatiquement pour l'appliquer. Les pages de configuration détaillées (1.4 à 1.9) restent disponibles pour un réglage fin ultérieur ou pour les utilisateurs expérimentés qui préfèrent s'en passer.
1.4 Configuration Chauffe-Eau Obligatoire
Cette page regroupe tous les réglages qui pilotent la régulation du chauffe-eau. Voici le détail de chaque option.
Le routeur mesure en permanence la puissance échangée avec le réseau électrique : une valeur positive signifie que la maison consomme depuis le réseau, une valeur négative qu'elle injecte du surplus solaire. Ces deux réglages définissent les bornes de la zone où le routeur considère l'équilibre comme atteint et n'ajuste plus rien : au-dessus de la limite de consommation, il réduit le dimmer ; en dessous de la limite d'injection (trop de surplus non utilisé), il l'augmente.
Il est inutile de définir un intervalle trop serré : cela provoquerait des régulations inutiles, le dimmer oscillant en permanence pour de très faibles écarts.
Puissance nominale de la résistance du chauffe-eau, en watts (indiquée sur l'étiquette signalétique de l'appareil). Cette valeur sert de référence au routeur pour convertir un pourcentage de dimmer en puissance réelle, et pour calculer le seuil de déclenchement de la sécurité puissance (voir plus loin, page Configuration Système).
Ces deux réglages bornent le pourcentage de puissance que le routeur peut envoyer au chauffe-eau :
- Dimmer max limite la puissance maximale délivrée, même en cas de surplus solaire important.
- Dimmer min évite le micro-routage inefficace : en dessous de ce seuil, le routeur coupe totalement l'envoi plutôt que de laisser une ouverture trop faible pour être réellement utile.
Une fois activée, garantit l'envoi en continu d'une puissance minimale (en watts) au chauffe-eau en mode AUTO, quitte à prendre sur le réseau si le surplus solaire est insuffisant pour l'atteindre. La régulation normale par surplus continue de prendre le relais au-dessus de ce plancher. Respecte la réserve batterie (voir 1.5) et la plage horaire interdite ci-dessous.
Si une sonde de température Dallas (DS18B20) est raccordée au routeur, cochez cette option pour l'activer. Deux réglages deviennent alors disponibles :
- Température max : au-delà de cette température, le routeur coupe la chauffe (l'eau est considérée comme chaude).
- Hystérésis (delta) : écart de température à redescendre avant d'autoriser une nouvelle chauffe. Il évite les micro-coupures autour du seuil.
Sans marche forcée journalière, seul le surplus solaire chauffe l'eau. Or en hiver, ou lors de plusieurs jours nuageux consécutifs, ce surplus peut être insuffisant plusieurs jours d'affilée — au risque de se retrouver sans eau chaude. La marche forcée journalière agit comme un filet de sécurité : elle garantit une chauffe minimale, sur le réseau si nécessaire, chaque fois que le solaire ne suffit pas.
En cochant cette option, le routeur évalue une fois par jour, à l'entrée de cette plage horaire, s'il doit déclencher une marche forcée automatique (voir l'algorithme de décision ci-dessous).
Il est possible d'ajouter jusqu'à deux plages horaires supplémentaires, indépendantes de la première — utile par exemple pour cumuler une plage nocturne à tarif réduit et une plage en journée qui vient compléter la chauffe si le soleil a été insuffisant. Toutes les plages partagent les mêmes jours actifs et la même puissance (dimmer) que la première.
Ce champ n'apparaît que si une sonde Dallas est raccordée et activée. Il force le déclenchement de la marche programmée si, dans le créneau horaire indiqué, la température de l'eau est inférieure ou égale à cette valeur.
Sans sonde, la marche démarre systématiquement au créneau défini — ou selon l'estimation de production solaire du lendemain, si cette option est activée sur la page Configuration Système (voir 1.5).
La décision dépend de la combinaison de deux options : la présence d'une sonde de température Dallas (page Configuration Chauffe-Eau) et l'activation de l'estimation de production solaire (page Configuration Système, voir 1.5).
| Sonde Dallas | Estimation solaire | Comportement |
|---|---|---|
| Absente | Désactivée | Marche forcée systématiquement déclenchée dans le créneau défini, tous les jours. |
| Présente | Désactivée | Marche forcée déclenchée uniquement si la température de l'eau est sous le seuil « Température min ». |
| Absente | Activée | Marche forcée déclenchée si la production solaire prévue est insuffisante : la production restante de la journée si le créneau démarre avant 19 h, ou la production totale prévue pour le lendemain s'il démarre à partir de 19 h. |
| Présente | Activée | Même logique basée sur la production solaire prévue — mais si la température de l'eau est sous le seuil « Température min », la marche forcée se déclenche dans tous les cas : le confort et la sécurité priment sur la météo. |
Visible uniquement si la sonde Dallas n'est pas activée. Remplace entièrement la météo comme critère de décision pour la marche programmée du soir : si le chauffe-eau (mesuré par un Shelly dédié) a déjà absorbé au moins le seuil d'énergie défini (en kWh) depuis le début de la journée, le ballon est considéré comme déjà chargé et la marche programmée du soir est bloquée — même si la météo du lendemain l'aurait autorisée. En dessous de ce seuil, la marche programmée est autorisée, même si la météo annonce une production insuffisante.
Alternative au simple seuil ci-dessus : au lieu d'un critère tout ou rien, ce mode calcule chaque soir le complément d'énergie manquant par rapport à une cible quotidienne définie en kWh, et coupe la marche programmée dès que ce complément a été réellement délivré au chauffe-eau — sans attendre la fin du créneau horaire.
Le routeur additionne l'énergie déjà routée vers le chauffe-eau dans la journée (surplus solaire + marche forcée manuelle), calcule ce qu'il manque pour atteindre la cible, puis démarre la marche programmée uniquement si ce complément est positif. Il surveille ensuite l'énergie réellement délivrée pendant la nuit et arrête la chauffe dès que le complément est atteint, même avant la fin du créneau.
Si cette option est activée, la marche forcée journalière ne s'arrête plus automatiquement à l'heure de fin programmée si la température « Température min » définie ci-dessus n'est pas encore atteinte : elle se prolonge jusqu'à ce que ce soit le cas, dans la limite de la sécurité de température maximale.
Définit un créneau — typiquement la nuit ou les heures de pointe — pendant lequel le routage automatique du surplus est totalement bloqué, même en cas de surplus solaire disponible.
Ces deux valeurs définissent le comportement d'une marche forcée déclenchée manuellement — depuis la page 2 de l'écran tactile du routeur, ou depuis l'interface web. Elles ne concernent pas la marche forcée journalière (programmation automatique décrite ci-dessus), qui possède ses propres réglages.
- Durée : durée pendant laquelle la marche forcée reste active.
- Dimmer : pourcentage de puissance envoyé au chauffe-eau pendant toute la durée de la marche forcée.
Validation des réglages — à faire dans cet ordre
- Appliquer — envoie les réglages au routeur, qui les active aussitôt en mémoire vive, sans les enregistrer en mémoire flash : ils seraient perdus au prochain redémarrage.
- Sauvegarder — enregistre en mémoire flash les réglages qui viennent d'être appliqués, pour qu'ils soient conservés durablement, y compris après un redémarrage.
1.5 Configuration Système Obligatoire
Cette page regroupe les réglages généraux du routeur : source de mesure de la consommation de la maison, monitoring optionnel du chauffe-eau, estimation de production solaire, coordonnées géographiques, gestion d'une éventuelle batterie, et quelques options avancées.
Cette section est indispensable : elle permet au routeur de déterminer si votre habitation consomme ou injecte de l'électricité, l'information au cœur de tout le principe de routage du surplus.
La mesure de consommation / injection peut provenir de l'un des dispositifs suivants. En fonction de la source sélectionnée dans le menu déroulant, les champs nécessaires s'affichent automatiquement.
| Source | Informations à renseigner |
|---|---|
| Shelly | Type de module, adresse IP, canal / pince |
| Home Assistant | Adresse IP, nom du capteur (sensor), jeton d'accès (Bearer) |
| Jeedom | Adresse IP, clé API, identifiant de la commande |
| Fronius | Adresse IP de l'onduleur / passerelle, et éventuellement l'adresse Modbus du Smart Meter (à laisser vide dans la majorité des cas — à renseigner seulement si le routeur affiche 0 W en permanence alors que le Smart Meter est bien détecté) |
| Ecojoko | Identifiant et mot de passe du compte cloud (latence possible) |
| Enphase | Adresse IP de la passerelle Envoy, numéro de série, identifiant et mot de passe Enlighten |
| MQTT | Adresse IP du broker, port, topic de consommation, identifiant/mot de passe si authentification requise |
Renseignez les informations demandées par la source choisie afin de permettre au routeur de récupérer les données correctement.
850), un nombre avec l'unité « W » (850W), ou un objet JSON avec l'une de ces clés : {"power":...}, {"value":...} ou {"conso":...}.
Si vous disposez d'un module Shelly installé en amont du chauffe-eau, vous pouvez l'utiliser pour mesurer sa consommation réelle. Il suffit de sélectionner son modèle, de renseigner son adresse IP puis de compléter les champs demandés. Le routeur affiche alors en temps réel la puissance réellement consommée par le chauffe-eau, sur la page d'accueil comme sur l'écran tactile.
energie.dat, et un graphique jour par jour est disponible depuis la page d'accueil.Si le module Shelly est également utilisé comme relais du chauffe-eau (coupure/autorisation de son alimentation secteur), cochez cette option. Le mode de pilotage automatique du relais peut alors être choisi :
- à heure fixe,
- ou selon les heures de lever et de coucher du soleil.
Quand cette option est activée, le routeur interroge un service météo en ligne gratuit (aucune clé requise), à partir de la latitude et de la longitude renseignées, pour récupérer les prévisions horaires de rayonnement solaire d'aujourd'hui et de demain. Il convertit ces prévisions en kWh estimés grâce aux réglages ci-dessous, puis utilise cette estimation pour décider si la marche forcée journalière doit se déclencher (voir 1.4 — Marche forcée journalière), et l'affiche sur la page d'accueil comme sur l'écran tactile.
- Puissance totale de vos panneaux (kWc) : puissance crête de l'installation photovoltaïque.
- Production solaire minimale (kWh) : seuil en dessous duquel la production prévue est jugée insuffisante — la marche forcée journalière est alors autorisée à se déclencher.
- Facteur de correction (0,1 à 1,5, par défaut 0,8) : compense l'écart entre la production théorique et la production réelle (orientation, inclinaison, ombrage, rendement des panneaux et de l'onduleur).
Si cette case est cochée, un réglage supplémentaire apparaît :
- Prioriser la charge de la batterie avant le routage : le routeur retarde volontairement le démarrage du routage vers le chauffe-eau, pour laisser la batterie se charger en priorité sur le surplus solaire.
Si cette priorité est activée, deux réglages complémentaires deviennent disponibles :
- Réserve pour la batterie (W) : marge de sécurité (par défaut 300 W, réglable de 0 à 3000 W). Le routeur attend que la puissance réseau descende sous la limite d'injection moins cette réserve avant de commencer à router.
- Délai avant routage (s) : délai supplémentaire (par défaut 20 s, réglable de 0 à 300 s) que le routeur attend, une fois le seuil atteint, avant de démarrer réellement le routage.
Si une pince ampèremétrique a été installée à l'envers, les valeurs mesurées apparaissent inversées (une injection est lue comme une consommation, et inversement). Ces deux cases permettent de corriger le sens de lecture depuis le logiciel, sans avoir à retourner physiquement la pince.
Active la sécurité puissance décrite en introduction technique du routeur : si le dimmer reste au-dessus d'un seuil élevé pendant plus d'une heure en continu, le routeur bascule automatiquement en pause de sécurité, coupe le dimmer, et attend la durée réglée ici (1 à 15 minutes) avant de reprendre son fonctionnement normal.
Deux modes de pilotage de la charge sont proposés : Sigma-Delta (recommandé) et Burst intelligent.
1.6 Configuration Écran / Système ESP Optionnel
Cet onglet regroupe les réglages de l'écran tactile et du contrôleur (ESP32) du routeur. Elle est optionnelle : les valeurs par défaut conviennent dans la majorité des cas, mais elle permet d'ajuster l'affichage, la sensibilité tactile et le comportement du contrôleur à vos préférences.
Fait pivoter l'affichage de 180°. Utile si le boîtier a été monté « tête en bas » pour des raisons de câblage ou d'encombrement.
Ajuste la luminosité de l'écran tactile.
Ces deux curseurs ajustent la réactivité de l'écran tactile. Le threshold correspond au seuil de détection des faux appuis (vibrations, poussière…). En cas de tactile qui réagit mal — pas assez sensible ou au contraire trop sensible — ce sont ces deux réglages qu'il faut ajuster.
Délai d'inactivité au bout duquel l'écran revient automatiquement à la page d'accueil, si l'on est resté sur une autre page sans y toucher.
Si la case « Ne pas mettre en veille » est cochée, l'écran reste toujours allumé. Sinon, le champ « Mise en veille au bout de » devient disponible : il définit le délai d'inactivité après lequel l'écran s'éteint pour économiser de l'énergie.
Port utilisé par l'interface web du routeur (80 par défaut). À ne modifier qu'en cas de conflit avec un autre service sur le réseau local — l'adresse à saisir dans le navigateur devient alors http://[adresse IP]:[port] au lieu de http://[adresse IP].
En cochant cette case, le routeur redémarre automatiquement à heure fixe, à un intervalle réglable en jours (champ « Tous les X jours » + heure de redémarrage). Ce redémarrage périodique prévient les dérives mémoire qui peuvent s'accumuler sur de longues durées de fonctionnement continu.
1.7 Configuration Charge 2 Optionnel
Cet onglet permet de piloter une deuxième charge indépendante du chauffe-eau — un four, une pompe à chaleur de piscine, etc. — via un relais Shelly dédié, en tout-ou-rien (allumée ou éteinte, sans variation de puissance).
Active le pilotage d'une seconde charge, indépendante du chauffe-eau, via un relais Shelly dédié.
Si cette case est cochée, le routeur allume ou éteint automatiquement la charge 2 en fonction du surplus solaire disponible, selon les seuils définis ci-dessous. Si elle n'est pas cochée, la charge reste pilotée manuellement.
Modèle du module Shelly utilisé comme relais pour cette deuxième charge, et son adresse IP sur le réseau local.
N'apparaît que pour un modèle à deux relais indépendants (ex. Shelly Plus 2PM Gen2) : les deux relais ont chacun leur propre mesure de puissance, il faut choisir celui réellement câblé sur la charge 2 — Canal 0 (switch:0) ou Canal 1 (switch:1).
Consommation approximative de la charge une fois allumée. C'est cette valeur que le routeur compare au surplus disponible pour décider d'allumer ou non la charge.
Surplus supplémentaire exigé, au-delà de la puissance nominale, avant d'allumer la charge — une sécurité pour n'allumer que si le surplus est vraiment suffisant et stable.
Marge tolérée avant extinction de la charge. Elle évite qu'un léger passage sous le seuil ne provoque une coupure immédiate, ce qui limiterait les cycles répétés d'allumage/extinction.
Temporisation appliquée avant d'allumer ou d'éteindre la charge, pour ignorer les pics ou creux de courte durée (passage d'un nuage, démarrage bref d'un appareil dans la maison) plutôt que de réagir immédiatement.
Détermine quelle charge a priorité sur l'usage du surplus disponible lorsque les deux pourraient en profiter en même temps :
- Chauffe-eau prioritaire : le surplus alimente d'abord la régulation du chauffe-eau ; la charge 2 n'utilise que ce qu'il en reste.
- Charge 2 prioritaire : la charge 2 est allumée dès que le surplus le permet, avant le chauffe-eau.
1.8 Configuration MQTT Optionnel
Cet onglet permet de connecter le routeur à un broker MQTT, pour publier son état complet à intervalle régulier — utile pour l'intégrer à Home Assistant, Jeedom, Node-RED ou tout autre système domotique.
Active la connexion à un serveur (broker) MQTT.
Adresse IP du broker MQTT sur le réseau local, et son port (1883 par défaut).
Si le broker exige une authentification, cochez cette case et renseignez l'identifiant et le mot de passe MQTT à utiliser pour la connexion.
Le topic MQTT racine sur lequel le routeur publie son état (voir ci-dessous).
Une fois MQTT activé et connecté, le routeur publie un unique message JSON complet toutes les 30 secondes sur le topic configuré, en mode retained : le broker conserve la dernière valeur publiée, si bien qu'un client qui s'abonne après coup la reçoit immédiatement, sans attendre la prochaine publication.
| Champ | Type | Présence | Description |
|---|---|---|---|
dimmerCE | nombre (%) | toujours | Pourcentage de puissance actuellement envoyé au chauffe-eau par le gradateur. |
powerCE | nombre (W) | si Shelly CE configuré et valeur valide | Puissance réellement consommée par le chauffe-eau (mesure directe, différente de dimmerCE qui n'est qu'une consigne en %). |
puissanceMaison | nombre (W) | si mesure valide (≤ 9000 W en absolu) | Puissance échangée avec le réseau par la maison — positive si elle consomme, négative si elle injecte du surplus. |
etatMaison | texte | toujours | STABLE, RESEAU (la maison consomme depuis le réseau) ou INJECTION (du surplus part vers le réseau). |
ModeRouteur | texte | toujours | État courant : AUTO, MANUEL, MF (marche forcée manuelle), PROG (programmation journalière), ARRET, PAUSE (pause de sécurité), ou INCONNU. |
sondeTempPresente | booléen | toujours | La sonde de température Dallas est activée dans la configuration. |
sondeTempValide | booléen | toujours | La sonde est activée, physiquement détectée, et ne signale pas de perte de communication. |
tempCE | nombre (°C) | si sondeTempValide = true | Température actuelle mesurée sur le chauffe-eau. |
energieJourWh | nombre (Wh) | toujours | Énergie routée vers le chauffe-eau depuis le début de la journée. |
energieMoisWh | nombre (Wh) | toujours | Énergie routée depuis le début du mois. |
energieTotaleWh | nombre (Wh) | toujours | Énergie routée cumulée depuis la mise en service (compteur total). |
ProdPVAujourdHui | nombre (kWh) | toujours | Production solaire estimée pour la journée en cours (nécessite l'estimation solaire activée en 1.5 ; vaut 0 sinon). |
ProdPVDemain | nombre (kWh) | toujours | Production solaire estimée pour le lendemain. |
relaisCE | booléen | toujours | État du relais chauffe-eau (allumé/éteint), pertinent si un Shelly-relais est configuré. |
relaisCharge2Presente | booléen | toujours | Une deuxième charge (« Charge 2 ») est configurée. |
relaisCharge2 | booléen | si relaisCharge2Presente = true | État du relais de la Charge 2. |
safetyPause | booléen | toujours | Le routeur est actuellement en pause de sécurité. |
safetyPauseRestantMin | nombre (min) | si safetyPause = true | Temps restant avant la fin de la pause de sécurité. |
wifiRSSI | nombre (dBm) | toujours | Intensité du signal Wi-Fi. |
heapLibre | nombre (octets) | toujours | Mémoire RAM libre actuelle sur l'ESP32 (diagnostic technique). |
heapMinHistorique | nombre (octets) | toujours | Plus basse valeur de mémoire libre observée depuis le démarrage (indicateur de fuite mémoire). |
uptimeSec | nombre (s) | toujours | Durée écoulée depuis le dernier démarrage de l'ESP32. |
majDisponible | booléen | toujours | Une mise à jour du firmware est disponible en ligne. |
versionDisponible | texte | si majDisponible = true | Numéro de la version disponible en ligne. |
versionActuelle | texte | toujours | Numéro de version du firmware actuellement installé. |
Cas type : sonde présente, Charge 2 absente, pas de mise à jour disponible.
{
"dimmerCE": 62,
"powerCE": 1364,
"puissanceMaison": -850,
"etatMaison": "INJECTION",
"ModeRouteur": "AUTO",
"sondeTempPresente": true,
"sondeTempValide": true,
"tempCE": 54.3,
"energieJourWh": 3240,
"energieMoisWh": 48210,
"energieTotaleWh": 512430,
"ProdPVAujourdHui": 12.4,
"ProdPVDemain": 9.8,
"relaisCE": true,
"relaisCharge2Presente": false,
"safetyPause": false,
"wifiRSSI": -58,
"heapLibre": 148320,
"heapMinHistorique": 121004,
"uptimeSec": 386420,
"majDisponible": false,
"versionActuelle": "5.76"
}
1.9 Configuration Wi-Fi Optionnel
Dans cet onglet, vous retrouvez l'ensemble des informations liées à la configuration Wi-Fi du routeur : réseau utilisé, paramètres de connexion et état de la liaison.
Rappelle les paramètres réseau actuellement utilisés par le routeur, à titre informatif.
Par défaut, le routeur obtient automatiquement son adresse IP (DHCP) auprès de la box internet. Il est également possible de définir une adresse IP fixe (statique) pour le routeur. Cette option peut être utile dans certains cas : accès simplifié à l'interface web (l'adresse ne change jamais), règles réseau spécifiques (redirection de port, filtrage…), etc.
Si cette case est cochée, quatre champs deviennent disponibles : adresse IP, masque, passerelle et DNS.
1.10 Mises à jour, journaux et commandes rapides
Les commandes qui agissent immédiatement sur le routeur, sans étape « Appliquer / Sauvegarder », sont désormais réparties entre plusieurs pages accessibles depuis les boutons du bandeau supérieur : la page d'accueil (marche forcée, redémarrage), la page « Mises à Jour » (tout ce qui concerne les mises à jour logicielles et le système de fichiers), la page « Journaux » (diagnostic), et le bandeau de la page « Configuration » (export/import de la configuration, accès à l'assistant).
Depuis l'onglet « 01 - Chauffe eau » de la page Configuration (voir 1.4), les boutons « Allumer » et « Éteindre » forcent immédiatement l'état du relais Shelly du chauffe-eau, si un tel relais est configuré (voir 1.5 — Monitoring Chauffe-Eau).
Repasse le routeur en mode entièrement automatique (AUTO) : la régulation du surplus solaire décrite en introduction reprend la main.
Passe le routeur en mode Manuel : plus aucune régulation automatique n'a lieu, le dimmer reste figé sur la dernière valeur imposée (la sécurité puissance, voir 1.5, reste néanmoins active).
Démarre ou annule une marche forcée manuelle, à la durée et à la puissance définies dans la Configuration Chauffe-Eau (voir 1.4 — Marche forcée manuelle). C'est l'équivalent, depuis l'interface web, de la marche forcée déclenchable sur la page 2 de l'écran tactile.
Ouvre une page qui affiche les journaux (logs) du routeur en direct, en continu. Utile pour observer ce qu'il se passe en temps réel en cas de comportement inattendu.
Affiche le journal du dernier démarrage de l'appareil : connexion Wi-Fi, initialisation des différents modules (Shelly, sonde, MQTT…). Utile pour diagnostiquer un problème survenu au démarrage.
Télécharge le journal détaillé de la dernière marche forcée journalière : il détaille pourquoi elle s'est déclenchée ou non (température de l'eau, production solaire estimée…), selon la logique décrite en 1.4 — Marche forcée journalière.
Ouvre le journal des modifications (changelog) des différentes versions du logiciel du routeur, consultable en ligne.
Il suffit de cliquer sur ce lien dans le menu pour ouvrir la page de téléchargement, où sont mis à disposition les fichiers nécessaires à la mise à jour du routeur. Cette page est protégée par un mot de passe, fourni à la commande : il figure dans l'e-mail d'expédition ainsi que sur le feuillet inclus dans le colis.
La page « Mises à Jour » (bouton dans le bandeau de toutes les pages) indique la version actuellement installée et si une mise à jour est disponible, avec une case à cocher « Recevoir les mises à jour bêta » pour les tester avant leur diffusion générale.
Installation automatique Recommandé
- Cliquer sur « Vérifier maintenant ».
- Si une mise à jour est disponible, confirmer l'installation.
- Le firmware puis les pages web sont téléchargés et installés automatiquement ; l'avancement s'affiche à l'écran.
- Le routeur redémarre tout seul une fois l'installation terminée. Inutile de recharger la page manuellement.
La même page permet aussi d'installer une version précise déjà publiée (menu déroulant « Installer une version précise » — utile pour tester ou revenir en arrière), de réinstaller le firmware actuellement installé à l'identique (en cas de comportement anormal), ou de ne resynchroniser que les pages web sans toucher au firmware (voir ci-dessous).
Portail de mise à jour manuelle Dépannage
Si l'installation automatique échoue (coupure réseau en cours de transfert, par exemple), un portail de secours reste disponible via le bouton « Ouvrir le portail /update » de la page « Mises à Jour », avec les fichiers téléchargés depuis la page « Téléchargements » (bouton « Page téléchargements Firmware ») — à réaliser depuis un ordinateur, pas depuis un smartphone.
- Sur le portail, choisir le fichier firmware (
.bin) et/ou le fichier système de fichiers LittleFS (.bin) — au moins l'un des deux, les deux peuvent être envoyés ensemble. - Cliquer sur « Envoyer et installer » : une barre de progression affiche l'avancement de l'envoi.
- Une fois l'envoi terminé, le routeur redémarre automatiquement pour appliquer la mise à jour.
Deux boutons complémentaires permettent de garder le système de fichiers du routeur propre dans la durée : « Lister les fichiers » affiche le contenu et l'espace libre du système de fichiers, et « Nettoyer les fichiers obsolètes » purge les fichiers d'une ancienne interface qui seraient restés d'une mise à jour OTA précédente (une synchronisation incrémentale ne supprime jamais un fichier devenu inutile de lui-même).
Retélécharge et réécrit uniquement les pages web (HTML/JS/CSS) depuis le serveur, sans toucher au firmware et sans redémarrage. Utile pour réparer une synchronisation incomplète ou corrompue après une mise à jour, ou pour recevoir un correctif de page sans attendre une nouvelle version de firmware.
Cette page regroupe les trois outils de diagnostic détaillés plus haut (Live Debug, log de démarrage, journal de la marche programmée), chacun avec ses propres boutons Rafraîchir / Copier, et Télécharger pour le journal de la marche programmée.
Le premier graphique superpose, pour le jour choisi, le pourcentage de dimmer, la température de la sonde (si présente) et la puissance de la maison, sur trois échelles indépendantes, avec un bouton de rafraîchissement manuel. Le second affiche, par semaine ou par mois, la répartition de l'énergie routée vers le chauffe-eau entre surplus solaire, marche forcée et marche programmée.
Génère un fichier .zip contenant l'ensemble des fichiers nécessaires à la restauration complète de la configuration du routeur, y compris les données d'historique énergétique.
Permet de restaurer une configuration précédemment exportée. Il faut d'abord décompresser l'archive .zip téléchargée, puis sélectionner tous les fichiers extraits en une seule fois (sélection multiple) lors de l'import. Le routeur redémarre automatiquement une fois l'import terminé.
1.11 Routes techniques (API) Avancé
Au-delà des pages et commandes accessibles depuis le menu, le routeur expose un ensemble de routes techniques directement accessibles depuis un navigateur, en saisissant http://[adresse IP du routeur]/route. Elles sont utiles pour l'automatisation (scripts, domotique), le diagnostic avancé, ou pour déclencher une action sans passer par l'interface graphique.
| Route | Méthode | Fonction |
|---|---|---|
/health | GET | Vérification rapide de la disponibilité du serveur web. |
/debug | GET | Affiche le contenu du buffer de log en mémoire (RAM). |
/debug/clear | GET | Vide le buffer de log en RAM. |
/live-debug | GET | Page avec flux WebSocket pour suivre les journaux en direct (équivalent de « Live Debug », voir 1.10). |
/log.txt | GET | Télécharge le journal complet enregistré en mémoire flash. |
/logboot.txt | GET | Télécharge le journal du dernier démarrage (équivalent de « Afficher le Log de démarrage », voir 1.10). |
/log_prog_jour.txt | GET | Journal brut de la dernière marche forcée journalière (404 si aucune n'a encore eu lieu). |
/log_prog_jour.html | GET | Page de visualisation de ce journal (équivalent de « Télécharger log programmation », voir 1.10). |
/log_recup_prod_solaire.txt | GET | Journal brut des tentatives de récupération de la production solaire estimée. |
/log_recup_prod_solaire.html | GET | Page de visualisation de ce même journal. |
/etat-secours | GET | Vue de diagnostic rapide : état actif/désactivé de MQTT, du relais Shelly2, de la mesure de consommation CE, de la sonde Dallas et de l'enregistrement des fichiers d'énergie. |
Désactivent ou réactivent une brique fonctionnelle sans reflasher le routeur, utile si celle-ci bloque le serveur web. Ces routes modifient la configuration et l'enregistrent aussitôt (effet persistant après redémarrage).
| Route | Méthode | Fonction |
|---|---|---|
/mqtt/enable | GET | Réactive MQTT. |
/mqtt/disable | GET | Désactive MQTT. |
/shelly2/enable | GET | Réactive le module Shelly2 (mesure et/ou relais chauffe-eau). |
/shelly2/disable | GET | Désactive complètement le Shelly2. |
/dallas/enable | GET | Réactive la sonde de température Dallas. |
/dallas/disable | GET | Désactive la sonde Dallas. |
/energie/enable | GET | Réactive l'enregistrement des fichiers d'historique d'énergie. |
/energie/disable | GET | Désactive cet enregistrement. |
/test/relais-sans-conso | GET | Route de test technique (pas une route de secours) : force en RAM une combinaison normalement interdite par le formulaire (relais Shelly2 actif sans mesure de conso CE) ; non enregistrée, un redémarrage revient à l'état normal. |
| Route | Méthode | Fonction |
|---|---|---|
/downloadAll | GET | Liste, au format texte, les fichiers de configuration et de données présents ; utilisée par l'export ZIP côté navigateur (voir 1.10 — Sauvegarde). |
/upload | POST | Reçoit un ou plusieurs fichiers et les écrit en mémoire flash, en écrasant les fichiers existants de même nom ; déclenche un redémarrage automatique. |
/import-secours | GET | Page de secours autonome, générée entièrement par le routeur, avec un bouton d'import de configuration ; accessible même si le menu principal est inaccessible. |
/export-secours | GET | Page de secours équivalente pour l'export (nécessite une connexion Internet du navigateur pour charger les bibliothèques de compression). |
/energiedat | GET | Télécharge directement le fichier brut energie.dat. |
| Route | Méthode | Fonction |
|---|---|---|
/ConfigWIFI.html | GET | Sert la page de configuration Wi-Fi (voir 1.9). |
/ConfigWIFI.json | GET | Fichier de configuration brut, au format JSON. |
/RecupConfigWIFI | GET | Renvoie l'IP courante, le masque, la passerelle, le DNS, la configuration IP fixe enregistrée et le SSID courant. |
/SaveConfigWIFI | POST | Sauvegarde la configuration Wi-Fi en mémoire flash. |
/ApplyConfigWIFI | POST | Applique la configuration en mémoire vive, sans sauvegarde ni redémarrage. |
/resetwifi | POST | Efface les identifiants Wi-Fi et redémarre le routeur, qui repasse en point d'accès de configuration (restreinte au POST pour éviter un déclenchement accidentel par un simple lien). |
| Route | Méthode | Fonction |
|---|---|---|
/ConfigMQTT.html | GET | Sert la page de configuration MQTT (voir 1.8). |
/ConfigMQTT.json | GET | Fichier de configuration brut. |
/RecupConfigMQTT | GET | Renvoie la configuration MQTT courante. |
/SaveConfigMQTT | POST | Sauvegarde la configuration en mémoire flash. |
/ApplyConfigMQTT | POST | Applique les champs du formulaire ; si MQTT vient d'être activé ou que la connexion n'est pas active, relance immédiatement une tentative de connexion. |
| Route | Méthode | Fonction |
|---|---|---|
/ConfigCE.html | GET | Sert la page de configuration du chauffe-eau (voir 1.4). |
/ConfigCE.json | GET | Fichier de configuration brut. |
/RecupConfigCE | GET | Renvoie tous les réglages de régulation du chauffe-eau. |
/ApplyConfigCE | POST | Applique en mémoire vive, avec recadrage automatique des valeurs incohérentes (jamais de rejet silencieux). |
/SaveConfigCE | POST | Sauvegarde en mémoire flash. |
| Route | Méthode | Fonction |
|---|---|---|
/ConfigCharge2.html | GET | Sert la page de configuration de la deuxième charge (voir 1.7). |
/RecupConfigCharge2 | GET | Renvoie la configuration et l'état on/off courant. |
/ApplyConfigCharge2 | POST | Applique en mémoire vive. |
/SaveConfigCharge2 | POST | Sauvegarde en mémoire flash. |
| Route | Méthode | Fonction |
|---|---|---|
/ConfigSYS.html | GET | Sert la page de configuration système (voir 1.5). |
/ConfigSYS.json | GET | Fichier de configuration brut. |
/RecupConfigSYS | GET | Renvoie l'intégralité des réglages système. |
/ApplyConfigSYS | POST | Applique en mémoire vive, avec règles de cohérence automatiques (ex. le relais Shelly2 ne peut pas être actif sans mesure de conso CE ; port MQTT invalide → 1883 par défaut) et recalcule les horaires de fonctionnement journaliers. |
/SaveConfigSYS | POST | Sauvegarde en mémoire flash. |
| Route | Méthode | Fonction |
|---|---|---|
/ConfigESP.html | GET | Sert la page de configuration écran/système (voir 1.6). |
/ConfigESP.json | GET | Fichier de configuration brut. |
/RecupConfigESP | GET | Renvoie les réglages écran et système. |
/ApplyConfigESP | POST | Applique en mémoire vive (bornes de sécurité), recalcule le prochain redémarrage programmé et applique immédiatement la rotation d'écran et la luminosité. |
/SaveConfigESP | POST | Sauvegarde en mémoire flash. |
| Route | Méthode | Fonction |
|---|---|---|
/modeautomatique | GET | Repasse le routeur en mode entièrement automatique (équivalent de « Mode Autonome », voir 1.10). |
/modemanuel | GET | Passe le routeur en mode manuel (équivalent de « Mode Manuel », voir 1.10). |
/marcheforcee | GET | Démarre une marche forcée, à la durée et à la puissance définies dans la Configuration Chauffe-Eau (équivalent de « Chauffe forcée », voir 1.10). |
/marcheforceecancel | GET | Annule la marche forcée en cours (équivalent de « Annuler chauffe forcée », voir 1.10). |
/relaisCEon | GET | Force l'allumage immédiat du relais chauffe-eau (100 %), bascule en mode manuel (équivalent de « Allumer le relais », voir 1.10). |
/relaisCEoff | GET | Force l'extinction du relais, bascule en mode manuel (équivalent de « Éteindre le relais », voir 1.10). |
/inputpower?power=0-100 | GET | Pilotage manuel de la puissance envoyée au chauffe-eau ; power=0 repasse en mode AUTO, toute autre valeur passe en mode MANUEL à la puissance demandée (et allume le relais si nécessaire). Conçue pour être appelée par des scripts ou automatismes externes. |
/inversecouleurs | GET / POST | Inverse le thème de couleur de l'écran tactile et redémarre l'écran. |
| Route | Méthode | Fonction |
|---|---|---|
/recupinfo | GET | Instantané complet de l'état courant, au format JSON ; interrogée périodiquement par la page d'accueil. |
/api/histo | GET | Historique complet (par mois/jour) de l'énergie routée en régulation normale, en marche forcée et en programmation journalière ; alimente les graphiques de la page « Historique Dimmer ». |
/prod | GET | Estimation de la production solaire du lendemain (kWh), en texte brut. |
/energie | GET | Résumé de l'énergie routée du jour, du mois et de l'année (Wh), en texte brut. |
/energie.dat | GET | Fichier brut d'historique d'énergie. |
/energie_marche_forcee.dat | GET | Fichier brut d'historique d'énergie en marche forcée. |
/energie_programmee.dat | GET | Fichier brut d'historique d'énergie en programmation journalière. |
/data_day1.txt à /data_day7.txt | GET | Données journalières détaillées (courbe dimmer/température) de chacun des 7 derniers jours. |
/resetenergie | GET | Affiche une page de confirmation avant réinitialisation (n'efface rien par elle-même). |
/resetenergie | POST | Remet à zéro tout l'historique d'énergie — action irréversible, déclenchée uniquement après confirmation. |
/forceSun | GET | Force un recalcul immédiat des heures de lever et de coucher du soleil. |
/dateheure?set=AAAA-MM-JJ_HH:MM | GET | Sans paramètre, affiche l'usage de la commande ; avec le paramètre, force manuellement la date et l'heure système (utile si la synchronisation NTP échoue). |
/enphase_last.json | GET | Dernière relève de la passerelle Enphase, au format JSON. |
| Route | Méthode | Fonction |
|---|---|---|
/reset | GET | Redémarre l'ESP32 (page de confirmation avec redirection automatique). |
/recupNewFirm | GET | Vérifie en ligne si une nouvelle version du firmware est disponible ; renvoie son numéro en texte brut (vide si aucune mise à jour ou pas de connexion Internet). |
1.12 Écran tactile — pages principales
En complément de l'interface web, le routeur dispose d'un écran tactile intégré, qui sert avant tout au monitoring au quotidien (et permet la connexion Wi-Fi initiale, voir 1.1). Il propose plusieurs pages consultables en faisant défiler l'écran ; les principales sont présentées ci-dessous.
Affiche l'état courant du routeur : puissance échangée avec le réseau (injection en vert ou consommation réseau en rouge), mode de fonctionnement (ici AUTO), pourcentage du dimmer, état du relais chauffe-eau (« Relais CE », visible si un Shelly-relais est configuré, voir 1.5), température du chauffe-eau et puissance qu'il consomme.
Récapitule l'énergie routée vers le chauffe-eau — jour, mois et année — répartie par origine : routage normal (surplus solaire), programmation journalière et marche forcée, avec un total. Équivalent, sur l'écran, des statistiques d'énergie consultables depuis l'interface web (voir 1.10).
Permet de démarrer ou d'arrêter directement depuis l'écran une marche forcée manuelle, à la durée et à la puissance définies dans la Configuration Chauffe-Eau (voir 1.4) — équivalent tactile de la commande « Chauffe forcée » du menu web (voir 1.10). Une confirmation est demandée avant chaque action.
Affiche l'historique du jour directement sur l'écran, sans avoir besoin de se connecter à l'interface web : dimmer, température, et la puissance de la maison (courbe verte) — équivalent simplifié du graphique « Historique Dimmer / Température / Maison » de la page web Graphiques.
Affiche la version actuellement installée et, si une mise à jour est disponible, un bouton « Installer » (avec confirmation) permettant de la lancer directement depuis l'écran, sans ordinateur — équivalent tactile du bouton « Installer maintenant » de l'interface web (voir 1.10). Une fois lancée, une barre de progression affiche le téléchargement du firmware, puis la synchronisation des pages web, avec un compteur de fichiers.
02 Installation électrique
Une fois le routeur entièrement paramétré (connexion Wi-Fi et réglages de l'interface web, voir Étape 1), il peut être raccordé physiquement.
2.1 Branchement de la sonde de température Optionnel
La sonde de température Dallas DS18B20 (voir 1.4 — Configuration Chauffe-Eau) est optionnelle : sans elle, le routeur régule uniquement en fonction du surplus solaire, sans connaître la température de l'eau. Son branchement se fait directement sur une petite carte électronique interne au routeur.
Pour réaliser le branchement :
- Ouvrir le boîtier.
Boîtier à vis (modèle antérieur) : dévisser les 4 vis sur le dessus du boîtier pour retirer le capot supérieur du Routeur Solaire.
Boîtier à languettes (modèle actuel) : insérer un tournevis plat sur le côté du boîtier, au niveau d'un des 4 trous latéraux, et faire légèrement levier pour libérer la languette ; répéter l'opération sur les 4 trous latéraux jusqu'à ce que le capot supérieur se détache complètement. - Dégager l'écran pour accéder à la carte électronique de la sonde, située en dessous.
Boîtier à vis : dévisser l'écran.
Boîtier à languettes : pousser les languettes de l'écran vers l'extérieur pour le dégager de son logement, puis le soulever en le faisant légèrement pivoter pour désolidariser le clip situé du côté de l'écran — le même principe de languettes (sans vis) s'applique à la petite carte électronique où se branche la sonde. - Faire passer le câble de la sonde par l'un des deux trous latéraux, en bas du boîtier, à droite ou à gauche sous l'écran.
- Brancher les fils de la sonde sur le connecteur à 3 broches libellé « GND-3V-22 », en respectant la correspondance suivante.
| Fil | Broche |
|---|---|
| Fil jaune | 22 (donnée 1-Wire) |
| Fil rouge | 3V |
| Fil noir | GND |
Côté chauffe-eau, deux méthodes de pose sont possibles :
Si la place le permet, la sonde Dallas peut être insérée dans le doigt de gant déjà utilisé par la sonde du thermostat du chauffe-eau. C'est la solution la plus précise, mais le doigt de gant est bien souvent trop étroit pour accueillir les deux sondes en même temps.
À défaut de place, la sonde peut simplement être scotchée contre la paroi extérieure, en bas du chauffe-eau. La température affichée n'est alors plus celle de l'eau à l'intérieur du ballon, mais celle de la paroi à cet endroit — nettement plus basse.
2.2 Branchement du routeur
Ouvrir le boîtier pour accéder au SSR (relais statique).
Boîtier à vis (modèle antérieur) : dévisser les 4 vis sur le dessus du boîtier pour retirer le capot supérieur.
Boîtier à languettes (modèle actuel) : insérer un tournevis plat sur le côté du boîtier au niveau de chacun des 4 trous latéraux, et faire levier pour libérer la languette correspondante, jusqu'à ce que le capot supérieur se détache complètement.
Le boîtier est conçu pour être fixé au mur à proximité du chauffe-eau, afin de limiter la longueur des câbles et faciliter l'installation. Il dispose de 4 trous de fixation : 2 sont directement accessibles sur le dessus du boîtier ; les 2 autres se trouvent sous l'écran, et nécessitent de dégager celui-ci pour y accéder (en le dévissant sur l'ancien modèle de boîtier, ou en poussant ses languettes vers l'extérieur puis en le faisant légèrement pivoter sur le modèle actuel).
Un presse-étoupe est fourni dans la petite boîte d'accessoires (voir Introduction) : il se visse sur le dessus du boîtier et permet de faire passer les 2 fils de phase (l'un en entrée depuis le disjoncteur, l'autre en sortie vers le chauffe-eau) tout en les maintenant fermement et en toute sécurité.
Si le chauffe-eau est raccordé à un contacteur Jour/Nuit (HP/HC), le routeur ne peut agir que lorsque celui-ci est en position marche. Deux solutions :
La phase et le neutre sont récupérés directement sur le disjoncteur pour alimenter le routeur et le chauffe-eau : le neutre va directement du disjoncteur au chauffe-eau ; la phase passe par le SSR du routeur (une borne en entrée depuis le disjoncteur, l'autre en sortie vers le chauffe-eau).
Un module Shelly Pro EM est intercalé pour piloter automatiquement le contacteur HP/HC, à la place du signal du fournisseur d'électricité. Il dispose de deux pinces ampèremétriques : une pour mesurer la consommation du chauffe-eau, et — à condition que le contacteur du chauffe-eau et l'arrivée générale se trouvent dans le même tableau électrique — une seconde pour mesurer en temps réel la consommation/injection de la maison.
Câblage du Shelly Pro EM : alimentation par phase et neutre en partie basse. La borne supérieure I (Input) est reliée à une phase du tableau. La borne O (Output) est reliée à la borne A1 du contacteur HP/HC (la borne A2 étant reliée au neutre du tableau).