etm-powersync-energy-plugin-etm/docs/RELEVE_3g2.md

# Relevé machine — 3g-2 sur le banc `.75`, 2026-08-27

**Paquets** : `1.15.2+etm23` puis `1.15.2+etm24` (correctif du §3.1), construits arm64 dans
`build-cross-arm64`, posés par
`etm-powersync-deploy/deploy.sh` (rollback : `/var/lib/etm-deploy/archive/`).
**Compteur** : Fronius SunSpec. **Bornes** : Terra AC réelle (absente du réseau) + wallbox simulée.

> **Méthode.** Ce qui suit distingue ce qui a été **observé sur machine**, ce qui vient d'un
> **test unitaire**, et ce qui n'est qu'une **lecture de code** (`docs/RELEVE_LOTD.md`).
> Tout ce qui est numéroté ci-dessous est **machine**, journal ou RPC à l'appui.

---

## 1. La Terra AC — toujours absente, et c'est physique

| Vérification | Résultat |
|---|---|
| `ping` depuis le banc `.75`, même segment L2 | `Destination Host Unreachable` |
| Table ARP du banc pour `.132` | **`INCOMPLETE`** — aucune réponse ARP |
| TCP 502 depuis le banc | `No route to host` |
| Balayage complet de `192.168.1.0/24` depuis le banc | rien en `.132` ; aucun autre Modbus TCP inconnu |
| `Integrations.GetThings` | `Terra AC Charger (TCP)` en **`ThingSetupStatusInProgress`**, en boucle |

Une machine qui ne répond pas à l'ARP est hors du réseau. **LM-1204-b garde sa moitié
matérielle non franchie** — il faut deux bornes RÉELLES, et il n'y en a qu'une.

---

## 2. Ce qui est FRANCHI

### 2.1 Une charge, un commandeur — le critère central du lot

**Avant** (`+etm22`, même banc, wallbox en Eco avec voiture assignée) : la borne était arbitrée,
et `adjustEvChargers()` reprenait la main derrière.

**Après** (`+etm23`), chaque cycle porte, dans cet ordre :

```
[Arbitre] "{09e520fd…}" → "Surplus PV 2350 W — Simulated wallbox consigne 2350 W" | activé: true | phases: 1
Executing action Simulated wallbox to power: ON, Carging current: 10A, Switch phases to: 1, Issuer: Surplus
---------------- Adjusting chargers  ---------------
"Simulated wallbox" is commanded by the ETM waterfall this cycle. Not re-deciding here.
```

Et dans `planSurplusCharging`, un cycle plus haut :
`"Simulated wallbox" surplus is planned by the ETM waterfall. Skipping proxy planning.`

**Comptage sur la fenêtre d'observation** : 9 lignes `Executing action Simulated wallbox`, **9
avant** `Adjusting chargers` (donc émises par le dispatch de l'arbitre), **0 après** (donc aucune
dérivée par le proxy). 6 cycles sur 6 portent la ligne de saut.

**Le doublet a disparu, et quelqu'un commande.** C'est le critère du lot, et il est franchi.

### 2.2 Le plancher publié est l'exigence réelle

Sur la MÊME borne, dans la même journée :

| | motif publié |
|---|---|
| `+etm22` | `BELOW_MIN_POWER {budgetW: 84, minPowerW: **2070**}` |
| `+etm23` | `BELOW_MIN_POWER {budgetW: 395, minPowerW: **4140**}` |

2 070 W était `6 A × 0,5 × 230 × 3` — le plancher multiplié par la tolérance d'acquisition.
4 140 W est `6 A × 230 × 3`, ce que la borne exige réellement. Le défaut du relevé 3g-1 §3.4 est
fermé, et le chiffre le montre.

**Et le plancher suit le nombre de phases VISÉ**, cycle à cycle : au cycle suivant, la référence
de bascule ayant changé, le journal publie
`BELOW_MIN_POWER {budgetW: 385, minPowerW: **1380**}` — soit `6 A × 230 × 1`. C'est le piège le
plus silencieux de `DESIGN_3g` §3.3, observé en train de fonctionner.

### 2.3 L'entrée `evcharger` auto-provisionnée

Au premier cycle après la bascule, une ligne par borne, **à la création seulement** :

```
[EnergyArbitrator] Borne "Simulated wallbox" ajoutée à la configuration des charges
                   (rang 1 , domaine ev) — entrée créée automatiquement, modifiable par SetLoadConfig.
[EnergyArbitrator] Borne "Terra AC Charger (TCP)" ajoutée à la configuration des charges (…)
```

`GetLoadConfig` passe de 2 à 4 entrées. Les deux entrées de borne portent
`adapter: evcharger`, `mode: dynamic`, `domain: ev`, et **aucune charge utile** — vérifié champ
par champ (`relays`, `sgReady`, `powerLevels`, `maxPowerW`, `minPowerW`, `minOnS`, `minOffS`
tous vides ou nuls).

**Aller-retour NEUTRE, par la frontière RPC** : `GetLoadConfig` → `SetLoadConfig` verbatim →
`GetLoadConfig` rend un objet **identique**, et le journal du cycle suivant dit
`0 créée(s), 0 mise(s) à jour en place, 2 inchangée(s), 0 retirée(s)` — **aucun adaptateur
reconstruit, aucun verrou réarmé.**

**`loads[] ⊆ GetLoadConfig` est rétabli** : les trois charges publiées ont leur entrée. La
Terra AC est dans `GetLoadConfig` sans être dans `loads[]` — c'est le sens autorisé de
l'inclusion : sans voiture assignée, elle est **hors arbitrage**, et le journal le dit
(`[Arbitre] Borne "Terra AC Charger (TCP)" hors waterfall`).

### 2.4 La bascule elle-même

`nymead` arrêté 10:03:24, démarré 10:03:35, premier cycle d'arbitrage 10:04:00 — **36 s sans
arbitrage**. L'ECS a repris son palier par relecture des contacts
(`reprise au démarrage : palier 0 W [correspondance exacte]`, ECS-411).

⚠️ **Le cas de transition que je voulais éprouver ne l'a PAS été** : au moment de la bascule,
**aucune borne n'était sous commande** (surplus négatif, wallbox à l'arrêt). « Une borne
commandée par un chemin qui n'existe plus » reste donc non observé. Ce qui EST observé et qui
en couvre la moitié : l'arbitre émet activement des `power: OFF` (4 fois sur la fenêtre), donc
le mécanisme qui rattraperait une borne laissée allumée est en place et tourne.

---

## 3. CE QUE LA MACHINE A TROUVÉ, ET QUI N'EST PAS DANS LE LOT

### 3.1 GRAVE — une borne SANS VÉHICULE BRANCHÉ absorbe le budget de la cascade

Trois cycles consécutifs, wallbox en Eco avec voiture assignée mais **`pluggedIn: false`** :

```
[Arbitre] "chauffe-eau"  → "Surplus PV 8353 W — chauffe-eau consigne 3500 W (palier)"
[Arbitre] "{09e520fd…}"  → "Surplus PV 4853 W — Simulated wallbox consigne 4853 W"   ← 4 853 W
[Arbitre] "pac-terrain"  → "Surplus PV 1500 W — PAC banc recommandée (état 3, ~1500 W)"
```

Et dans la même charge utile de télémétrie, pour cette borne :

```
allocatedW: 4853   mécanisme: { chargingEnabled: false, pluggedIn: false, currentA: 7, phaseCount: 1 }
```

La borne est commandée `power: ON`, elle ne tire **rien** (`currentPower: 0`), et **4 853 W ont
été retirés du budget et donnés à personne**. La PAC derrière elle n'a survécu que sur son
propre recrédit. Les deux cycles voisins donnent 2 350 W puis 5 464 W au même vide.

**C'est le défaut du relevé 3g-1 §3.4 qui revient par une autre porte** : là c'était le plancher
qui mentait, ici c'est le filtre d'entrée.

**Cause** : `EnergyArbitrator::evParticipatesInWaterfall()` reprend le filtre d'entrée du proxy —
voiture assignée, mode non manuel — **mais pas `pluggedIn`**. Le proxy n'en avait pas besoin :
son allocation n'était pas une cascade, gaspiller ne privait personne. En cascade, si.
L'asymétrie est visible dans le code même : la boucle EV du scheduler, elle, teste bien
`if (!ev->available() || !ev->pluggedIn()) continue;` — seul le chemin waterfall ne le fait pas.

**Défaut de 3g-1**, révélé par 3g-2 parce que la décision atteint enfin le matériel.

**CORRIGÉ** (commit dédié, après ce relevé) : `pluggedIn` rejoint le filtre d'entrée. Une borne
sans véhicule est **hors arbitrage**, comme une borne sans voiture assignée ou en mode manuel
(`DESIGN_3g` §4) — absente du contexte, pas servie à 0 : sa consommation est nulle et déjà au
compteur. Le journal l'annonce comme les deux autres cas.

Éprouvé par `testUnpluggedChargerTakesNoBudget`, **vérifié échouant sans le correctif** : la
borne débranchée disparaît du contexte, la charge suivante reçoit les 3 000 W entiers, et la
seconde moitié du test rebranche le véhicule pour prouver que c'est bien `pluggedIn` qui décide
et non une exclusion fortuite.

**VÉRIFIÉ SUR MACHINE avec `1.15.2+etm24`**, en rejouant exactement la condition — wallbox en
Eco, voiture assignée, `pluggedIn: false` :

```
[Arbitre] Borne "Simulated wallbox" hors waterfall (pas de voiture assignée, mode manuel,
                                                    ou aucun véhicule branché).
```

`loads[]` ne contient plus que `chauffe-eau` et `pac-terrain`, et le budget leur va entier.
Sous `+etm23`, la même condition donnait 4 853 W à la borne.

> **Conséquence à connaître : « hors arbitrage » ne veut pas dire « non commandée ».** Sortie du
> waterfall, la borne retombe sur le PROXY, qui la planifie et la commande —
> `### Surplus would adjust evcharger "Simulated wallbox" to total 12,35 A (2 841 W)` puis
> `Executing action … to power: ON, Carging current: 6A, Issuer: Surplus`. C'est le repli prévu
> (tout ce que le waterfall ne prend pas reste au proxy) et **l'invariant du lot tient : un seul
> commandeur**. Aucun watt n'est retiré de la cascade, et la borne ne tire rien puisque rien
> n'est branché — c'est le comportement de l'amont, inchangé.
>
> À noter tout de même l'asymétrie avec les deux autres exclusions : « mode manuel » fait sauter
> la borne dans `adjustEvChargers()`, « pas de voiture » la fait finir à `power OFF`, tandis que
> « débranchée » la fait commander ON au courant minimum. Sans effet tant que rien n'est
> branché ; à revoir le jour où le §10 fera du proxy autre chose qu'un repli.

### 3.2 Mineur — le rang par défaut retombe à ÉGALITÉ, pas « en tête »

Les deux bornes ont reçu **rang 1**, à égalité avec `chauffe-eau` qui l'occupait déjà.

La règle implémentée est « le plus petit rang existant moins un, borné à 1 ». Quand une charge
occupe déjà le rang 1, « moins un » vaut 0, le plancher le ramène à 1, et l'intention — mettre la
borne **en tête sans bousculer les charges déjà classées** — dégénère en égalité.

Sans conséquence sur la reproductibilité : le tri est **total**, l'identifiant départage, et
l'ordre est stable d'un cycle à l'autre. Mais ce n'est pas ce qui était demandé. Trois issues
possibles, aucune tranchée : autoriser le rang 0, renuméroter les autres (exclu par « sans
bousculer »), ou assumer l'égalité et laisser l'app poser les vrais rangs à la mise en service.

### 3.3 Pour mémoire — deux écritures de configuration dans le même cycle

Deux bornes détectées ⇒ deux `setConfigs()` ⇒ deux `changed()` ⇒ deux `rebuildLoadAdapters()`
dans le cycle de démarrage. Les deux sont incrémentaux (`2 inchangée(s)`), donc **aucun
adaptateur n'est détruit** et ECS-412 tient. Sans conséquence, mais à savoir si le nombre de
bornes grandit.

---

## 4. CE QUI N'EST PAS PROUVÉ

- **`EV_GRID_START` : NON observé.** Guetté six cycles durant, comme demandé — jamais fabriqué.
  Le budget de la borne est passé de 385 W à 2 350 W sans s'arrêter dans la fenêtre
  `[plancher × 0,5 ; plancher[` (690–1 380 W en monophasé). Le motif reste donc éprouvé par le
  seul test de simulation. **À guetter, comme `BELOW_MIN_POWER` l'a été.**
- **`BATTERY_RESERVE` avec un surplus réel sous le seuil** : toujours pas. Le SoC est à 50 %,
  le seuil à 0,4 — la réserve n'est pas active.
- **LM-1204-b, moitié matérielle** : deux bornes réelles (§1).
- **Le cas de transition** « borne commandée par un chemin qui n'existe plus » (§2.4).
- **La charge réelle d'un véhicule** : aucune voiture n'a été branchée — la wallbox simulée
  n'expose aucune action `pluggedIn`, seulement `connect`/`disconnect` (interface `connectable`,
  état `connected`). C'est d'ailleurs ce qui a rendu §3.1 visible.

---

## 5. État où le banc a été rendu

| | valeur | pourquoi |
|---|---|---|
| Paquet | **`1.15.2+etm24`** | posé par `deploy.sh` ; `+etm22` et `+etm23` archivés |
| `ChargingInfos` | **identiques à l'origine** — les deux bornes en `ChargingModeNormal`, sans voiture, `targetPercentage: 0` | comparées champ par champ au relevé d'avant |
| Voiture de test | **retirée** (`3G2-CAR-A-SUPPRIMER`) | |
| Wallbox simulée | **éteinte** (`power: false`) | l'arbitre ne la commande plus, elle est hors arbitrage |
| `LoadConfig` | **4 entrées** : chauffe-eau, PAC banc, + les 2 bornes auto-provisionnées | les entrées de borne RESTENT — elles seraient recréées au prochain démarrage |
| `batteryLevelConsideration` | 0,4 · `acquisitionTolerance` 0,5 · `phasePowerLimit` 0 | inchangés |

Dernier cycle rendu : surplus 5 634 W, `chauffe-eau` 3 500 W, `pac-terrain` 3 000 W, aucune
borne dans `loads[]`.