EVCS/docs/PROCEDURE_REMPLACEMENT_PACK.md

Remplacement du parc batterie — arrêt, câblage, redémarrage

Rédigé le 12/09/2026. Cible : retirer les trois modules gonflés, constituer un groupe de 5 US2000C et un groupe de 4 US5000, les accoupler par le LV Hub. État de départ relevé à 15:26 : SOC 97 %, 50,5 V, contacteur EDF ouvert.

---

0. AVANT DE TOUCHER À QUOI QUE CE SOIT

⚠️ Les modules gonflés ne se testent pas, ne se chargent pas

Un module LiFePO4 qui gonfle a produit du gaz. C'est irréversible et c'est un risque d'incendie. Cela annule le plan d'essai à l'alimentation stabilisée que j'avais proposé le 5 septembre sur BAT3 (K220803C30160324) : si elle fait partie des trois gonflées, elle ne doit ni être chargée, ni être ouverte, ni être mise sous tension.

Manipulation des trois modules retirés :

• ne pas les percer, ne pas les empiler, ne pas les poser sur du combustible ;
• isoler les bornes (capuchon ou ruban) ;
• les stocker hors du local de vie, ventilé, à l'écart du reste du parc ;
• photographier le gonflement avec le numéro de série visible — c'est la pièce du dossier Pylontech ;
• garder les relevés console du 05/09 (docs/mesures/batteries/) : ils documentent 498 et 416 surtensions, et des cellules descendues à 2953 mV.

⚠️ LA MAISON VA PERDRE LE COURANT — à vérifier d'abord

Le MultiPlus tire son alimentation interne du bus continu. Sans batterie, il s'arrête, et il n'y a plus rien sur AC-out, même contacteur EDF fermé : le passthrough exige que l'onduleur fonctionne.

Donc, avant de commencer, répondre à ceci :

Existe-t-il un bypass manuel qui relie le réseau directement aux circuits de la maison, en contournant les MultiPlus ?

• Oui → le basculer avant de couper, la maison reste alimentée.
• Non → la maison sera hors tension pendant toute l'intervention. Prévenir tout le monde, arrêter congélateurs/ordinateurs proprement, et vérifier que la box internet a une batterie, sinon vous perdez aussi l'accès à Home Assistant, à n8n et à mes outils pendant l'opération.

⚠️ Home Assistant et n8n tournent sur le Synology 10.10.10.17, qui est alimenté par la maison. Sans bypass, ils s'arrêtent avec elle. PostgreSQL, InfluxDB, Grafana et le chien de garde sont sur le 10.10.10.22 — autre machine, qui peut rester debout si elle est sur un autre circuit. À vérifier.

Choisir le moment

Fin de matinée par beau temps : la production couvre la maison au redémarrage et la batterie neuve trouve tout de suite de quoi se charger. Pas le soir, pas avant une nuit, et pas pendant les heures creuses.

---

1. ARRÊT

1.1 Neutraliser les automates AVANT tout geste physique

Sinon ils continueront d'écrire pendant que le système est dans un état transitoire, et rechercheront la panne qu'ils croient voir.

1. Stratégie EVCS → stop (carte EVCS Master, ou EDF Urgence).
2. Hystérésis → OFF : input_boolean.victron_grid_hysteresis_enabled. Bouton « EDF FORCE ON » si vous voulez en plus tenir le contacteur.
3. Automatisations Home Assistant : désactiver les deux qui commandent le contacteur sur un seuil de SOC — Victron - Grid ON si SoC < 22% et Sécurité: check SoC < 22% toutes les 5 min. (Victron - Grid OFF si SoC > 35% est déjà désactivée depuis ce matin.) Sans ça, elles réagiront à un SOC qui n'a plus de sens.
4. Débrancher le véhicule s'il y en a un.

1.2 Fermer EDF

Même sans bypass, fermer le contacteur avant de couper limite la casse et permet un redémarrage plus simple.

Bouton « EDF ON manuel » du dashboard Urgence — il coupe l'hystérésis, efface le latch et ferme le contacteur ; plus aucun automate n'y touchera.

1.3 Arrêter la production solaire

Ouvrir les disjoncteurs / sectionneurs DC des MPPT. Sans batterie, un MPPT qui produit dans un bus vide n'a nulle part où envoyer son énergie.

1.4 Arrêter les MultiPlus

Mettre les deux unités sur OFF (interrupteur en façade). Attendre l'arrêt complet des ventilateurs et l'extinction des LED.

1.5 Ouvrir le disjoncteur DC de la batterie

C'est lui qui isole le parc du bus continu. Après cette étape uniquement, le parc n'alimente plus rien.

1.6 Éteindre les modules Pylontech, dans l'ordre

Pour chaque groupe :

1. maintenir le bouton SW rouge du module maître jusqu'à extinction de tous les modules du groupe ;
2. basculer l'interrupteur d'alimentation de chaque module sur OFF ;
3. vérifier que plus aucune LED n'est allumée.

Puis éteindre le LV Hub.

1.7 Attendre, puis débrancher

Compter une minute : les condensateurs du bus continu se déchargent. Ensuite seulement, débrancher les câbles de puissance et les câbles de communication RJ45.

---

2. CÂBLAGE DU NOUVEAU PARC

Composition visée

groupe	contenu	équivalents US2000C
1	5 × US2000C — les 4 de Y230202C… plus K220803C30160323	5
2	4 × US5000	8
	total	13

K220803C30160323 est le module ancien sain : zéro cellule marquée, zéro surtension, tampon d'événements vide au relevé du 05/09. Il rejoint le service sans réparation.

Retirés : K220803C30160322, K220803C30160319, K220803C30160324.

⚠️ Le maître doit être un US5000

Règle de priorité Pylontech : le modèle le plus récent porte le firmware le plus récent et doit être maître. Le maître de chaque groupe est le module dont le port de liaison 0 reste vide.

• Groupe 2 : un US5000 en maître.
• Groupe 1 : le plus récent des US2000C, donc un Y230202C… — pas K220803C30160323, qui est le plus ancien du lot.

Adressage

Seul le maître de chaque groupe reçoit le réglage d'adresse par DIP switches ; tous les autres restent en position basse. Les modules d'un même groupe se chaînent entre eux par les câbles RJ45 courts fournis.

Liaison au hub

Un câble RJ45 long par groupe, du port CAN du maître vers le port numéroté correspondant du LV Hub. Le hub va vers le GX par le câble Victron dédié — ASS030720018, VE.Can vers CAN-bus type A. Ce câble-là n'est pas interchangeable avec un RJ45 ordinaire.

⚠️ Équilibrer les SOC avant d'accoupler

Les 5 US2000C sortiront du service à ~97 %. Les US5000 neufs arrivent typiquement entre 40 et 50 %. Accoupler deux groupes très écartés provoque un courant d'égalisation important entre eux.

La consigne d'installation : les modules doivent être à un clignotement de SOC d'écart avant accouplement, sinon attendre trente minutes ou plus. En pratique : démarrer le groupe 2 seul, le laisser se stabiliser, et ne relier le groupe 1 qu'ensuite — voir la séquence de redémarrage.

⚠️ Ne rebranchez pas de console sur le LV Hub : ça le fait redémarrer.

---

3. REDÉMARRAGE

3.1 Groupe par groupe

1. Fermer le disjoncteur DC de la batterie — non, pas encore. Les modules d'abord.
2. Groupe 2 (US5000) : allumer chaque module, puis maintenir le SW du maître jusqu'à ce que tous affichent RUN. Vérifier aucune alarme.
3. Groupe 1 (US2000C) : idem.
4. Comparer les SOC des deux groupes. S'ils s'écartent de plus d'un clignotement, attendre.
5. Allumer le LV Hub. La LED du groupe connecté doit clignoter vert. Rouge → éteindre, revérifier les câbles, rallumer.

3.2 Remettre la puissance

6. Fermer le disjoncteur DC de la batterie.
7. MultiPlus sur ON. Attendre qu'ils prennent la main sur AC-out.
8. Refermer les sectionneurs DC des MPPT.

3.3 Vérifications avant de rendre la main aux automates

À faire dans cet ordre, et ne pas passer à la suite tant que ça ne colle pas :

vérification	où	attendu
le parc est vu en entier	sensor.airtria_8_us2000c_maximum_allowed_discharge_current	nettement au-dessus de 100 A (il valait 100 avec 4 modules)
courant de charge autorisé	…_maximum_allowed_charge_current	au-dessus de 40 A
aucune alarme	…_tension_de_cellule_elevee, …_low_voltage, …_high_discharge_current	no_alarm
tension cohérente	sensor.victron_battery_voltage	48–53 V
pas d'erreur VE.Bus	alarmes MultiPlus	toutes à no_alarm

⚠️ Si la limite de décharge reste à 100 A, le hub ne voit qu'un seul groupe. Cause la plus probable : le LV Hub date de 2021 (Soft V1.7, release 21-03-25) et rien ne garantit qu'il énumère des US5000B. C'est l'inconnue identifiée le 9 septembre. Vérifier d'abord les câbles et les DIP switches, puis suspecter le firmware du hub.

3.4 Déclarer le nouveau parc au logiciel

Une seule valeur à changer, et c'est la seule.

Dashboard Bilan énergétique → onglet Profils & réglages → carte Réglages → Parc batterie (équivalents US2000C) :

4 → 13

⚠️ Treize, pas neuf. Un US5000 compte pour deux : 5 + (4 × 2) = 13. Cette valeur alimente trois calculs à la fois — la capacité utile du contrôleur, la conversion énergie/SOC du bilan, et l'échelle des limites de courant batterie. Une erreur ici se propage aux trois.

Capacité utile attendue après changement : ~22 kWh livrés à la maison entre 100 % et le plancher de 22 %, contre 6,8 kWh aujourd'hui.

3.5 Rendre la main aux automates

Dans l'ordre inverse de l'arrêt :

1. Bouton « EDF rendre la main » (dashboard Urgence) — réactive l'hystérésis.
2. Réactiver les deux automatisations Home Assistant désactivées en 1.1. Laisser désactivée Victron - Grid OFF si SoC > 35%.
3. Stratégie → auto_solar_plus.
4. Vérifier que le contrôleur EVCS reprend : une exécution en succès toutes les 30 s, et un état cohérent dans input_text.victron_evcs_surplus_state.

---

4. APRÈS — ce qui doit être remesuré

La courbe énergie/SOC actuelle (0,169 kWh par point au-dessus de 33 %, genou à 33 %) a été mesurée sur l'ancien parc. Le genou était attribué aux cellules faibles des modules retirés : il devrait disparaître.

Après quelques jours de fonctionnement :

node tools/mesure-courbe-batterie.mjs 8

et mettre à jour les trois nombres dans src/energy-balance/BALANCE.js ainsi que batteryUsableCapacityKwh dans src/nodes/INPUT_PARSE.js. Ce sont des résultats de mesure, pas des réglages.

Regénérer aussi la carte des décisions, qui horodate les évolutions :

node tools/carte-decisions.mjs --injecte

---

5. DOSSIER PYLONTECH

À joindre pour les trois modules :

module	ce que disent les relevés du 05/09
K220803C30160322	cellules 6, 7, 12 — la 12 oscille de 2953 à 3644 mV ; 498 surtensions, 86 dépassements
K220803C30160319	cellules 2, 6, 10, 12, 15 ; 416 surtensions, 179 dépassements
K220803C30160324	cellule 15 — 43 mΩ de résistance excédentaire, s'effondre à 84 % de charge sous 6,5 A

Plus : photos du gonflement avec numéro de série visible, la facture du 27/04/2023 (La Boutique Solaire, 190002543), et les exports console dans docs/mesures/batteries/.

Pour mémoire, un module sain du même parc affiche 2 mV d'écart entre cellules et zéro compteur — c'est l'étalon qui rend les chiffres ci-dessus parlants.

---

ANNEXE — SÉQUENCE DE MISE EN SERVICE À DEUX GROUPES, VALIDÉE LE 12/09/2026

Trouvée par le propriétaire après une soirée de fausses pistes. Le détail qui débloque tout est au point 7, et il n'est écrit nulle part dans la documentation Pylontech.

Le câblage exact

LV-HUB port 1   ──[câble BLEU]──▶  A/CAN   du maître groupe 1 (US5000)
maître groupe 1 RS485 ──[câble 8 broches]──▶ A/CAN du maître groupe 2 (US2000C)
maître groupe 2 RS485 ──▶  VIDE   (dernier groupe)
LV-HUB port 0   ──[câble court 8 broches]──▶  LV-HUB CAN IN
LV-HUB CAN OUT  ──[câble Victron]──▶  Cerbo GX

⚠️ LES DEUX CÂBLES NE SONT PAS INTERCHANGEABLES.

liaison	câble	étiquette relevée
hub → maître groupe 1	3 premières broches NON connectées	5WRPY01-00132 · 1~3 NA · 4~8 PIN-PIN
entre maîtres, entre modules, port 0 → CAN IN	8 broches droit	BAT / BAT

Un câble ordinaire à la place du premier et le hub ne voit rien — sans aucun message d'erreur autre que le status rouge.

⚠️⚠️ LE CÂBLE BLEU A UN SENS, ET LUI SEUL

étiquette « BATTERY »           ──▶  A/CAN du maître groupe 1
étiquette « Inverter »  (porte    ──▶  port 1 du LV-HUB
aussi une étiquette « 30V »
sur l'exemplaire installé)

Tous les autres câbles de communication Pylontech sont réversibles — ils sont 8 broches droit, les deux extrémités sont identiques. Celui-ci ne l'est pas, et rien sur le connecteur ne le signale : il faut lire les étiquettes.

La raison est dans l'annotation du schéma constructeur :

« The first 3 pins on the port of battery side should be NULL. »

Les trois broches ne sont coupées qu'à une extrémité, celle qui va sur la batterie. Le câble est donc asymétrique par construction. Inversé, il présente un 8-broches complet au maître et un câble amputé au hub : les deux erreurs à la fois.

Ce câble a par ailleurs été fabriqué pour relier une batterie à un onduleur — d'où l'étiquette « Inverter » — et se trouve ici employé vers le hub. Ne pas se laisser dérouter par ce libellé : c'est bien l'extrémité « Inverter » qui va au LV-HUB.

La séquence qui fonctionne

1.  TOUT éteindre : LV-HUB et les 9 modules
2.  DIP du maître groupe 1 sur 0000
3.  Allumer les 4 US5000 (interrupteurs), puis les 5 US2000C
4.  Appuyer sur le bouton SW ROUGE du maître groupe 1
       → les 9 modules s'allument
5.  ÉCOUTER : le maître émet TROIS BIPS
       = tous les groupes sont en ligne. C'est le seul signal fiable.
6.  Passer le DIP du maître groupe 1 sur 0100
7.  ⚠️⚠️  LE CÂBLE MAÎTRE 1 → LV-HUB DOIT ÊTRE DÉBRANCHÉ
           PENDANT TOUTE LA SÉQUENCE 1 À 6
8.  Brancher alors le câble bleu entre le maître 1 et le port 1 du hub
9.  Allumer le LV-HUB
       → LED STATUS verte, LED de comptage des groupes verte

Le point 7 est ce qui manquait. La documentation dit « puis connectez le câble » sans préciser qu'il doit être ABSENT auparavant. Avec le câble en place, l'initialisation ne va jamais à son terme, les trois bips ne se produisent pas, et le hub reste au status rouge quoi qu'on fasse — DIP, resets, cycles d'alimentation compris.

Comment lire les LED du hub (doc Pylontech §2.3)

LED STATUS	signification
bleue, une fois	le hub est allumé, rien de plus
ROUGE	aucune batterie, OU au moins un groupe hors ligne

« When battery group is REDUCED it will alarm (in red), but when battery group is added in it will no alarm. »

⚠️ Le rouge n'est donc pas une panne. Passer de deux groupes à un le déclenche, et il persiste tant que la séquence complète n'a pas été rejouée. Une soirée entière a été perdue à chercher un défaut qui n'existait pas.

Les LED 1 à 4 comptent les groupes en vert : 1 groupe → LED 1 · 2 groupes → LED 2 · 3 groupes → LED 1+2 · 4 groupes → LED 3 · 5 → LED 1+3 · 6 → LED 2+3 · 7 → LED 1+2+3.

Résultat mesuré, 12/09/2026 22:00

9 modules en service   ·   SOC 81 %   ·   49,73 V
charge autorisée 130 A ·   décharge 250 A   ·   aucune alarme
parc déclaré : 13 équivalents US2000C

Contre 6,8 kWh utiles le matin même : la réserve a triplé dans la journée.

Fausses pistes suivies ce soir, à ne pas refaire

1. Le mode console du hub — la console ne bloque rien : tout débranché, le status restait rouge.
2. Un firmware trop ancien pour les US5000 — les deux annoncent Comm version V2.0, et les US2000C donnaient le même symptôme.
3. Une configuration corrompue — les valeurs aberrantes lues en console (16 cellules, coupure à 396,8 V, 0 mA) n'ont jamais été confirmées comme étant l'état réel du hub.
4. Chaîner les deux modèles dans une seule chaîne — la documentation décrit un seul modèle par groupe. Proposition retirée.

Deux corrections à la procédure principale

• Le câble Victron pour des US2000C / US5000 est le type A, ASS030710018 (le type B ASS030720018 est pour les US2000/US3000/UP2500).
• 6 modules maximum par groupe pour les US2000C, pas 16.