Procedure de remplacement du parc batterie

Les trois modules en panne ont GONFLE. Cela annule le plan d essai a
l alimentation stabilisee propose le 05/09 : un module gonfle a produit
du gaz, il ne se charge pas, ne s ouvre pas, ne se met pas sous tension.

Cible : 5 US2000C (les 4 recents plus K220803C30160323, le module ancien
sain) et 4 US5000, accouples par le LV Hub — soit 13 equivalents.

⚠️ Point le plus important de la procedure : sans batterie, le MultiPlus
s arrete et il n y a plus rien sur AC-out, meme contacteur ferme. La
maison sera hors tension pendant l intervention s il n existe pas de
bypass manuel — et Home Assistant comme n8n tournent sur le .17, alimente
par la maison.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GwpFpy2aQ2rJok6tNQSbVj

docs/PROCEDURE_REMPLACEMENT_PACK.md

@@ -0,0 +1,278 @@
+# 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.