Consigner la nuit LVHUB, les correctifs swap rapide et la re-mesure du parc assaini (HANDOFF §74 + MANUEL §0)

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

HANDOFF.md

@@ -7256,3 +7256,98 @@ l'etat des cellules cote Home Assistant, et le bouton lui-meme.
 
 ---
 *Document mis a jour le : 18/09/2026 (~03:15) — releve par cellule avec le courant, conception de la charge HC manuelle arretee et non ecrite*
+
+## 74. Session du 20/09/2026 — Nuit LVHUB, correctifs swap rapide, et re-mesure du parc assaini
+
+### La nuit LVHUB (18-19/09) : le detail batterie est mort depuis le 15/09, pas a cause des packs
+Detail complet dans `docs/PROTOCOLE_LVHUB_CERBO.md`. En resume : le proprietaire
+a voulu passer le pack US2000C en maitre a la place du pack US5000. **Six
+leviers essayes, aucun ne ramene les trames etendues** du Cerbo (nombre de
+modules, capacite, tensions de cellule, firmware) : rescan, redemarrage Cerbo,
+MAJ firmware Cerbo, inversion du maitre, reset hub, sequence complete rejouee.
+Les trames de BASE passent (SOC, limites 250/250 A, alarmes → le BMS protege) ;
+seules les ETENDUES sont `null`, et ce **depuis le redemarrage HA du 15/09
+05:09** (§69), donc AVANT toute manip de packs. Cause = la couche logicielle
+Venus `can-bus-bms v0.71`, pas le materiel ni l'ordre des packs. **Ne plus
+toucher au materiel batterie pour ce symptome — demontre inutile.** A instruire
+a froid : firmware du LV-Hub, ou effet de la MAJ Venus, sur doc constructeur.
+Config a garder : US5000 maitre → cable bleu → hub → Cerbo, cable gris entre
+packs (seule combinaison qui donne les 3 bips). Le chainage inter-groupes ne
+marche que dans le sens US5000-tete.
+
+### Incident du swap rapide (19/09) et les correctifs — P11-bis, bouton reset, alerte
+VW debranchee ~14:50, JEEP branchee, mais le swap n'a dure que **14 s** → la
+borne a GELE son etat (charging_time reste a 1h25, jamais reinitialise). P11
+(base uniquement sur charging_time ≤ 90s) restait aveugle → le collant
+"vehicule plein" de la VW a bloque la JEEP, qui n'a pas charge de l'apres-midi.
+Un debranchement FRANC de 30s a tout debloque.
+
+Correctifs deployes (golden 113 → 116) :
+- **P11-bis** : `sessionFresh` gagne un SECOND signal, l'age du dernier
+  (re)branchement (`as_timestamp` du last_changed de vehicle_connected),
+  independant du charging_time de la borne. Le swap de 14s avait bien fait
+  bouger ce last_changed. Meme fenetre 90s. Gabarit + INPUT_PARSE
+  (`evcsVehicleConnectedAgeSec`) + WINDOWS.
+- **Bouton reset borne** (`input_boolean.evcs_reset_borne`, carte EVCS Master) :
+  echappatoire manuelle, force une session fraiche un cycle, momentane (le
+  controleur le rebascule off).
+- **Detection anomalie "branchee mais ne charge pas"** (historiseur) : helper
+  `input_text.evcs_alerte_charge` (SPARK/OpenClaw envoie le WhatsApp), toggle
+  maitre `input_boolean.evcs_alerte_charge_enabled` (OFF, opt-in, seuils
+  500W/10min A CALIBRER). Critere robuste par la censure sans injection.
+- Cote OpenClaw (SPARK) : le concierge ecrit desormais AUSSI le selecteur
+  `input_select.victron_evcs_vehicle` sur confirmation WhatsApp (plus besoin de
+  le regler a la main), + message spontane utilisable (une reponse VW/JEEP sans
+  question posee est appliquee) + menage gateway (la saturation qui avalait les
+  messages).
+
+### ⚠️ RE-MESURE DE LA COURBE BATTERIE SUR LE PARC ASSAINI (le point majeur)
+Le parc compte maintenant **13 equivalents US2000 sains** : 4 US5000 (pack 1,
+neufs 03/2026) + 5 US2000C (pack 2, dont l'ancien module sain `…0323`). Les
+modules abimes (cellules 12 et 15 mortes) sont sortis. Cellules du pack 2
+mesurees a **3-6 mV d'ecart** (contre 168 mV sur l'ancien parc), SOH 99.
+
+`node tools/mesure-courbe-batterie.mjs 8` sur ce parc donne une courbe
+**PLATE a 0,30 kWh/point de 25 a 97 %, PLUS DE GENOU**. Le genou a 33 % (§41)
+etait la signature de la cellule 12 morte : il a disparu avec elle. La reserve
+utile a quasiment **double : 12,4 → ~23 kWh** (100 → 22 %).
+
+Recalage deploye (rec 1) :
+- `src/energy-balance/BALANCE.js` : `kneePct` 33 → 0, pentes 0,169/0,097 →
+  **0,1615 plat** (× echelleParc 13/7 = 0,30 au parc actuel).
+- `src/nodes/INPUT_PARSE.js` : `batteryUsableCapacityKwh` 2,414 → **2,308
+  kWh/module** (0,30/13 × 100).
+- helper `evcs_balance_usable_capacity_kwh` 15 → 23 (inerte mais coherent).
+- Tests bilan 50/50 (10 attendus re-figes, verifies a la main), golden 116/116,
+  golden-acm 20/20. Mutation deux sens sur la courbe.
+
+⚠️ **La courbe est un RESULTAT DE MESURE, a remesurer apres toute evolution du
+parc.** Les constantes 0,1615 et 2,308 valent pour 13 modules ; le scaling
+`modules/7` (helper `evcs_balance_modules_en_service` = 13) adapte au nombre.
+
+### Rec 2 : top-off ACM 52,4 → 52,8 V
+Le 52,4 V avait ete pose le 06/09 pour menager la cellule 12 faible du pack
+ancien. Ce pack est sorti ; on releve le top-off pour atteindre une charge plus
+pleine et **recalibrer la jauge SOC Pylontech** (qui derive tant qu'on n'atteint
+jamais 100 %). 52,8 V = 3,52 V/cellule, sous les 53,2 V autorises par le BMS, et
+la cellule haute du pack 2 est a 3356 mV. patch rejouable
+`tools/patch-20260920-topoff-52v8.mjs`.
+
+### ⚠️ ANGLE MORT A LEVER : cellules du pack 1 (US5000) hors surveillance
+Le releve serie continu est sur le pack 2 (US2000C) ; les trames etendues du
+Cerbo sont mortes (voir ci-dessus). Les cellules du **pack 1 (US5000) ne sont
+donc PAS surveillees en continu**. Lues saines le 19/09 (`pwr` : Vlow 3330 /
+Vhigh 3331, ~1-2 mV), et les US5000 sont neufs. Le proprietaire a commande un
+**2e cable console** pour surveiller les deux packs. La re-mesure de courbe et
+la capacite, elles, couvrent BIEN le parc entier (agregat SOC/puissance du
+Cerbo). Seule la sante CELLULE du pack 1 manque — d'ou la prudence sur le
+top-off, applique sur autorisation explicite du proprietaire.
+
+### Production vs consommation (7 jours, 13-19/09)
+Maison a ~40 kWh/jour, conso qui DEPASSE souvent la production (15/09 : 29 vs
+39 ; 17/09 : 27 vs 42). Deja tendu en septembre ; l'hiver sera nettement
+deficitaire. (PV mesuree = censuree sans injection, ressource reelle plus haute
+les jours ou la batterie s'est remplie tot.)
+
+---
+*Document mis a jour le : 20/09/2026 — nuit LVHUB (trames etendues mortes cote Venus), P11-bis + bouton reset + alerte, courbe batterie remesuree (plate 0,30, ~23 kWh utiles), top-off 52,8 V*

docs/MANUEL_COMPLET.md

@@ -75,17 +75,29 @@ défaut de configuration était réel, son ampleur a été surestimée.
 et `inverter_size` porté de 8 000 à **16 000 W**.
 
 ### Batterie
-**8 × Pylontech US2000C** (`AIRTRIA 8 US2000C`, Battery Monitor, instance VRM
-512, fabricant PYLON, interface CAN-bus), organisés en **deux packs de 4 reliés
-par un hub**. Le premier pack a deux ans de plus que le second et a vécu avant
-la climatisation du garage.
-**État au 24/08/2026 : un module en panne et isolé → 7 modules actifs**, un
-huitième commence à faiblir. Mélanger des packs d'âges différents est
-déconseillé (contrainte de budget, pas un choix technique).
-⚠️ `batteryUsableCapacityKwh: 17.5` est codé en dur dans `INPUT_PARSE.js` et
-utilisé trois fois dans `WINDOWS_SOURCEV2.js` : avec 7 modules, cette valeur
-surestime la réserve réelle de 15 à 20 %. Aucun capteur de capacité ou de santé
-batterie n'est publié côté HA — à corriger.
+**État au 20/09/2026 : parc assaini à 13 équivalents US2000, deux packs reliés
+par un LV-Hub.**
+- **Pack 1** : 4 × **US5000** (48V/100AH, 8 équivalents US2000), neufs
+  (fabriqués 03/2026), maître de la chaîne.
+- **Pack 2** : 5 × **US2000C** (48V/50AH) — les 4 `Y230202C…` plus l'ancien
+  module sain `K220803C30160323`.
+- Retirés le 12/09 : les trois US2000C abîmés (cellules 12 et 15 descendues sous
+  3,0 V, mortes). Le genou de la courbe SOC à 33 % (§41) était leur signature ;
+  il a disparu avec elles.
+
+Cellules du pack 2 mesurées à **3-6 mV d'écart**, SOH 99, limites BMS 250 A
+charge / 250 A décharge, 53,2 V. ⚠️ Les cellules du **pack 1 (US5000) ne sont
+pas sous surveillance continue** : le relevé série est sur le pack 2 et les
+trames étendues du Cerbo sont mortes depuis le 15/09 (HANDOFF §69/§74). 2e câble
+console en commande.
+
+**Capacité RE-MESURÉE le 20/09** (`tools/mesure-courbe-batterie.mjs`, HANDOFF
+§74) : courbe **plate à 0,30 kWh/point, sans genou**, réserve utile **~23 kWh**
+de 100 à 22 % (l'ancien parc abîmé n'en donnait que 12,4). Constantes recalées :
+`batteryUsableCapacityKwh` = **2,308 kWh/module** (INPUT_PARSE), courbe du bilan
+`0,1615 × modules/7` plate (BALANCE.js), helper
+`evcs_balance_modules_en_service` = 13. ⚠️ **À remesurer après toute évolution
+du parc** — ce sont des résultats de mesure, pas des réglages.
 
 **Accès diagnostic au BMS** (05/09/2026). Le câble console Pylontech est branché
 sur une machine **Windows en 10.10.10.93**, qui fait tourner **BatteryView**.