846c0c7525
Signalé sur /de/appareils/bornes/goecharger/ : la page était allemande sur deux
lignes et anglaise sur tout le reste. Le diagnostic a séparé deux choses que
j'avais mises dans le même sac le 2026-10-12.
LA LIGNE DE PARTAGE, écrite en tête du générateur :
• les LIBELLÉS QUE NOUS ÉCRIVONS (en-têtes de colonnes, titres de section,
oui/non, « Documentation fabricant ») → TRADUITS. Ils ne désignent rien à
l'écran, l'anglais n'y était qu'une friction. REF devient REF_I18N, trois
jeux de 20 libellés.
• le CONTENU VENANT DE NYMEA (noms de modèles, clés de registres, libellés de
champs comme « MAC address », unités) → VERBATIM, en anglais. Ce sont
exactement les chaînes que l'installateur lit DANS L'APP, qui tourne en
en_US. Les traduire rendrait la doc inutilisable pour retrouver un champ à
l'écran.
Et la pièce qui change l'expérience plus que la traduction elle-même : une note
`verbatim`, générée dans la langue de la page, en tête du bloc de référence.
Sans elle le mélange FR/EN passe pour une traduction bâclée ; avec elle c'est
une convention que le lecteur comprend.
L'injection devient sensible à la langue : `locale_of()` déduit la langue du
suffixe du fichier et `process()` rend le bloc en conséquence. Sans ça le même
bloc partait à l'identique dans les trois versions.
TAGLINES ET TITRES — i18n/devices.yaml, 52 entrées
Le tagline vivait en paragraphe libre, écrit UNE SEULE FOIS à la création de la
page : il restait donc en anglais sur les trois versions, y compris la
FRANÇAISE. Il entre dans le bloc badges, donc il est régénéré, donc traduisible
pour toujours. 52 taglines en fr et de ; l'anglais retombe sur l'amont.
Les traductions vivent dans le dépôt de DOC et pas dans les meta.json : trois
des cinq dépôts plugins sont des dépôts nymea amont que l'AGENTS.md interdit de
modifier. Repli sur l'amont pour toute entrée absente.
Deux titres s'affichaient en FRANÇAIS sous /de/ et /en/ — « Compteur ABB B2x »,
« Borne ABB Terra AC » : corrigés, dans la page et dans la nav.
Deux coquilles AMONT corrigées au passage, repérées en relisant les 57 entrées :
meta.json annonçait « Bestel » pour Vestel et « Easeex » pour Easee. Signalées
comme corrections, pas comme traductions, dans i18n/devices.yaml.
48 FICHES FR ÉTAIENT DANS UN ANCIEN FORMAT, ET MENTAIENT
Trouvé en vérifiant : 48 fiches FR n'avaient pas de marqueur `__badges_*__`.
Leurs badges étaient du HTML figé, écrit une fois — goecharger affichait
« NIGHTLY » alors que PORTING_STATUS dit `stable` depuis. Elles sont migrées au
format canonique : badges générés, donc exacts, plus titre localisé, tagline et
intertitre. Reste `hvac/homeconnect.md`, orpheline (plugin hors PORTING_STATUS).
NAV : UN CONSTAT QUI ÉVITE DE REFAIRE L'ESSAI
`literate-nav` ne lit que son `nav_file` : la substitution par suffixe de
mkdocs-static-i18n ne s'y applique PAS. Un `SUMMARY.de.md` généré n'était lu par
personne et la barre latérale allemande gardait les noms français. Testé, puis
retiré — et la raison est écrite dans le générateur pour que personne n'y
revienne. Les libellés de nav passent par `nav_translations` : 31 éléments
traduits par langue au lieu de 29.
RÉFÉRENCE API : LAISSÉE EN ANGLAIS, DÉLIBÉRÉMENT
Les 23 pages de l'API n'ont pas de variante par langue. Leur traduire les
libellés aurait fait voir du FRANÇAIS aux lecteurs /de/ et /en/ par le repli —
une régression. Créer 46 variantes pour traduire dix libellés aurait triplé
28 000 mots de contenu généré pour un gain nul : le reste de la page (noms de
méthodes, de champs, de types, descriptions) est l'API elle-même, et ce sont les
chaînes qu'on écrit dans ses requêtes. À la place, une note explique dans les
trois langues POURQUOI cette référence est en anglais.
Vérifié : build --strict sans avertissement, les deux générateurs rendent « Doc à
jour » en --check, et la fiche goecharger relue dans les trois langues.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
119 lines
4.6 KiB
Markdown
119 lines
4.6 KiB
Markdown
# Borne ABB Terra AC
|
||
|
||
<!-- BEGIN GENERATED: __badges_abbterra__ -->
|
||
<span class="badge testing">TESTING</span> <span class="badge origin-etm">ETM</span> <span class="badge consumer">CONSUMER</span>
|
||
|
||
Raccorder les bornes ABB Terra AC en Modbus TCP ou Modbus RTU.
|
||
|
||
<!-- END GENERATED -->
|
||
|
||
La borne de recharge ABB Terra AC existe en deux variantes de communication :
|
||
**Modbus TCP** (réseau Ethernet/LAN) et **Modbus RTU** (bus RS485).
|
||
|
||
## 1. Choix de la variante
|
||
|
||
- **TCP** : la borne est sur le réseau local, repérée par son adresse IP /
|
||
nom d'hôte. Ajout par découverte réseau.
|
||
- **RTU** : la borne est sur un bus RS485, repérée par son adresse esclave.
|
||
|
||
## 2. Raccordement
|
||
|
||
- TCP : câble Ethernet vers le réseau du hub.
|
||
- RTU : A↔A, B↔B, masse, terminaison 120 Ω.
|
||
|
||
## 3. Ajout dans PowerSync
|
||
|
||
Variante TCP : **découverte automatique** sur le réseau, ou ajout **manuel**
|
||
(IP, port). Variante RTU : ajout via le maître RTU + adresse esclave.
|
||
Voir [Ajouter un appareil](../../installation/application.md).
|
||
|
||
## 4. Vérification
|
||
|
||
`connected`, `pluggedIn` puis `charging` reflètent l'état de la session ;
|
||
`maxChargingCurrent` reflète la consigne de courant.
|
||
|
||
---
|
||
|
||
## Référence
|
||
|
||
<!-- BEGIN GENERATED: integrationpluginabbterra.json -->
|
||
!!! info "Libellés de l'application"
|
||
Les clés et libellés ci-dessous sont ceux affichés par
|
||
l'application, **en anglais**. Ils sont laissés tels quels pour
|
||
que vous les retrouviez à l'identique à l'écran.
|
||
|
||
**Fabricant :** ABB
|
||
**Plugin :** `AbbTerra`
|
||
|
||
#### Modèles pris en charge
|
||
| Modèle | Rôle | Transport | Ajout | Grandeurs |
|
||
| --- | --- | --- | --- | --- |
|
||
| **Terra AC Charger (TCP)** | EV charger | Modbus TCP | Manual | 17 |
|
||
| **Terra AC Charger (RTU)** | EV charger | Modbus RTU | Auto-discovery / Manual | 17 |
|
||
|
||
#### Détail par modèle
|
||
??? abstract "Terra AC Charger (TCP) — `terraAcTcp`"
|
||
_Réglages :_
|
||
|
||
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| `macAddress` | MAC address | QString | — | — | oui |
|
||
| `address` | Host address | QString | — | — | non |
|
||
| `hostName` | Host name | QString | — | — | non |
|
||
| `port` | Port | uint | — | `502` | non |
|
||
| `slaveId` | Slave ID | uint | 1–255 | `1` | non |
|
||
|
||
_Grandeurs mesurées :_
|
||
|
||
| Clé | Grandeur | Type | Unité |
|
||
| --- | --- | --- | --- |
|
||
| `connected` | Connected | bool | — |
|
||
| `pluggedIn` | Plugged in | bool | — |
|
||
| `charging` | Charging | bool | — |
|
||
| `power` | Charging enabled | bool | — |
|
||
| `maxChargingCurrent` | Maximum charging current | double | Ampere |
|
||
| `phaseCount` | Phase count | uint | — |
|
||
| `currentPower` | Active power | double | Watt |
|
||
| `currentPhase1` | Current phase 1 | double | Ampere |
|
||
| `currentPhase2` | Current phase 2 | double | Ampere |
|
||
| `currentPhase3` | Current phase 3 | double | Ampere |
|
||
| `voltagePhase1` | Voltage phase 1 | double | Volt |
|
||
| `voltagePhase2` | Voltage phase 2 | double | Volt |
|
||
| `voltagePhase3` | Voltage phase 3 | double | Volt |
|
||
| `sessionEnergy` | Session energy | double | KiloWattHour |
|
||
| `firmwareVersion` | Firmware version | QString | — |
|
||
| `serialNumber` | Serial number | QString | — |
|
||
| `errorCode` | Error code | uint | — |
|
||
|
||
??? abstract "Terra AC Charger (RTU) — `terraAcRtu`"
|
||
_Réglages :_
|
||
|
||
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| `rtuMaster` | Modbus RTU master | QString | — | — | non |
|
||
| `slaveId` | Modbus slave ID | uint | 1–247 | `1` | non |
|
||
|
||
_Grandeurs mesurées :_
|
||
|
||
| Clé | Grandeur | Type | Unité |
|
||
| --- | --- | --- | --- |
|
||
| `connected` | Connected | bool | — |
|
||
| `pluggedIn` | Plugged in | bool | — |
|
||
| `charging` | Charging | bool | — |
|
||
| `power` | Charging enabled | bool | — |
|
||
| `maxChargingCurrent` | Maximum charging current | double | Ampere |
|
||
| `phaseCount` | Phase count | uint | — |
|
||
| `currentPower` | Active power | double | Watt |
|
||
| `currentPhase1` | Current phase 1 | double | Ampere |
|
||
| `currentPhase2` | Current phase 2 | double | Ampere |
|
||
| `currentPhase3` | Current phase 3 | double | Ampere |
|
||
| `voltagePhase1` | Voltage phase 1 | double | Volt |
|
||
| `voltagePhase2` | Voltage phase 2 | double | Volt |
|
||
| `voltagePhase3` | Voltage phase 3 | double | Volt |
|
||
| `sessionEnergy` | Session energy | double | KiloWattHour |
|
||
| `firmwareVersion` | Firmware version | QString | — |
|
||
| `serialNumber` | Serial number | QString | — |
|
||
| `errorCode` | Error code | uint | — |
|
||
|
||
<!-- END GENERATED -->
|