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 Configuration Chauffe-Eau
- 1.4 Configuration Système
- 1.5 Configuration Écran / ESP
- 1.6 Configuration Charge 2
- 1.7 Configuration MQTT
- 1.8 Configuration Wi-Fi
- 1.9 Commandes rapides du menu
- 1.10 Routes techniques (API)
- 1.11 É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 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 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.
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).
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.4).
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.4).
| 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. |
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.4 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 |
| 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.3 — 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.5 Configuration Écran / Système ESP Optionnel
Cette page 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.6 Configuration Charge 2 Optionnel
Cette page 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.
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.7 Configuration MQTT Optionnel
Cette page 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.4 ; 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.8 Configuration Wi-Fi Optionnel
Sur cette page, 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.9 Commandes rapides du menu
Le menu latéral (icône hamburger, accessible depuis n'importe quelle page de l'interface web) donne accès à une série de commandes rapides. Contrairement aux pages de configuration, elles agissent immédiatement sur le routeur, sans étape « Appliquer / Sauvegarder ».
Force immédiatement l'allumage ou l'extinction du relais Shelly du chauffe-eau, si un tel relais est configuré (voir 1.4 — Monitoring Chauffe-Eau). Ces deux commandes basculent automatiquement le routeur en mode Manuel.
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.4, 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.3 — 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.3 — 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.
Le bandeau supérieur de l'interface web indique la version actuellement installée sur le routeur ; il s'affiche en rouge lorsqu'une mise à jour est disponible.
afficheur-tempo.fr. La procédure de mise à jour doit être effectuée depuis un ordinateur, pas depuis un smartphone.
Une fois les fichiers téléchargés, cliquer sur « Mise à jour logicielle » dans le menu latéral : la page de mise à jour s'affiche (le champ « Hardware ID » dépend de l'appareil et ne nécessite aucune action).
Étape 1 — Mise à jour du firmware
- Dans « OTA Mode », sélectionner « Firmware ».
- Cliquer dans la zone de dépôt (« Drag and drop ») et sélectionner le fichier
firmware_….bin. - La mise à jour démarre automatiquement.
- À la fin de l'opération, le routeur redémarre.
- Se reconnecter à l'interface web, puis retourner dans « Mise à jour logicielle ».
Étape 2 — Mise à jour du système de fichiers (LittleFS)
- Dans « OTA Mode », sélectionner « Filesystem ».
- Sélectionner le fichier
LittleFS_….bin. - La mise à jour s'effectue, puis le routeur redémarre à nouveau.
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.10 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.9). |
/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.9). |
/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.9). |
/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.9 — 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.8). |
/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.7). |
/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.3). |
/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.6). |
/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.4). |
/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.5). |
/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.9). |
/modemanuel | GET | Passe le routeur en mode manuel (équivalent de « Mode Manuel », voir 1.9). |
/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.9). |
/marcheforceecancel | GET | Annule la marche forcée en cours (équivalent de « Annuler chauffe forcée », voir 1.9). |
/relaisCEon | GET | Force l'allumage immédiat du relais chauffe-eau (100 %), bascule en mode manuel (équivalent de « Allumer le relais », voir 1.9). |
/relaisCEoff | GET | Force l'extinction du relais, bascule en mode manuel (équivalent de « Éteindre le relais », voir 1.9). |
/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.11 É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.4), 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.9).
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.3) — équivalent tactile de la commande « Chauffe forcée » du menu web (voir 1.9). Une confirmation est demandée avant chaque action.
Affiche l'historique du dimmer et de la température du jour, directement sur l'écran, sans avoir besoin de se connecter à l'interface web (équivalent simplifié du graphique « Historique Dimmer », voir 1.9).
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.3 — 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 :
- Dévisser le capot supérieur du Routeur Solaire.
- 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
Dévisser le capot supérieur du routeur pour accéder au SSR (relais statique). 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.
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).
Pour toute question, vous pouvez envoyer une demande à l'adresse mail suivante
En cas de problème, pensez à joindre à votre message le Log de démarrage et l'export de votre configuration (voir 1.9 — Commandes rapides du menu) : cela facilite grandement le diagnostic.