Patrick Schurig 325409dd3f feat(i18n): prose traduite DE/EN et référence régénérée en anglais
82 pages .de.md et 82 .en.md. La volumétrie explique la forme : 95 % du volume
est GÉNÉRÉ (74 013 mots contre 3 506 rédigés, mesuré sur 107 pages). On ne
traduisait donc pas 77 500 mots — on traduit la prose, et le vocabulaire des
générateurs fait le reste.

Prose traduite à la main : accueil, installation (4), fonctionnalités (4),
tarifs, référence, dépannage, FAQ, intégrations (2), api/index, et les 6 fiches
appareils qui portent une vraie prose + compatibilite.md. Les blocs générés ne
sont JAMAIS recopiés dans une traduction : le script de pose les reprend
verbatim du fichier français via des placeholders, pour qu'une traduction ne
puisse pas désynchroniser un bloc généré.

Les 49 fiches légères n'ont rien à traduire : leur tagline vient d'amont et est
DÉJÀ en anglais (« Connects nymea to powerfox. »). Constat, pas renoncement.

Localisation ≠ traduction, et tarifs.md en est l'exemple à connaître : la
version FR parle de Tempo et du signal RTE, la DE de §14a EnWG et de SMARD,
l'EN des deux. Ce ne sont pas des traductions l'une de l'autre, et c'est
volontaire — les signaux tarifaires sont nationaux. Aucune des deux n'est
annoncée comme livrée : les deux sont Roadmap, et les pages le disent.

Référence régénérée : en-têtes et libellés en anglais (Field/Type/Notes,
Supported models, Settings, Read-only, Brand / Model…). Conséquence assumée et
signalée : les pages FR en ligne changent aussi.

README.md (il était VIDE) : la règle du 95 % généré en tête, la frontière de
décision du multi-langue avec sa mesure, pourquoi SCAFFOLD existe, et le piège
--strict/navigation.instant.

TODO : multi-langue clos, et trois points ouverts qui en restent — les tagline
vivent dans les meta.json de 5 autres dépôts (forme à ajouter : tagline_de /
tagline_en), les stubs traduits restent des stubs (la dette éditoriale a triplé
en surface, pas en fond), api/types.md n'a pas besoin de variante. Le P1
openmeteo est corrigé sur constat : il EST dans PORTING_STATUS depuis, et une
ligne commentée contradictoire y traîne encore.

Vérifié : mkdocs build --strict vert sur les trois langues, 322 pages HTML,
contenu traduit relu dans le HTML produit, et les deux générateurs rendent
« Doc à jour » en --check.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-10-13 06:39:20 +02:00

3.9 KiB

KOSTAL Solar Electric

STABLE NYMEA CONSUMER

Connect to Kostal Solar Electric inverters.

Installation guide coming soon.

Reference

Manufacturer: KOSTAL Solar Electric
Plugin: Kostal

Supported models

Model Role Transport Pairing Quantities
KOSTAL Inverter solarinverter Modbus TCP Auto-discovery / Manual 13
KOSTAL Meter Energy meter — Automatic 14
KOSTAL Battery energystorage — Automatic 8

Per-model detail

??? abstract "KOSTAL Inverter — kostalInverter" Discovery parameters:

| Key | Label | Type | Range | Default |
| --- | --- | --- | --- | --- |
| `port` | Port | int | — | `1502` |
| `slaveId` | Slave ID | int | — | `71` |

_Settings:_

| Key | Label | Type | Range | Default | Read-only |
| --- | --- | --- | --- | --- | --- |
| `macAddress` | MAC address | QString | — | — | no |
| `hostName` | Host name | QString | — | — | no |
| `address` | IP address | QString | — | — | no |
| `serialNumber` | serialNumber | QString | — | — | no |
| `port` | Port | int | — | `1502` | no |
| `slaveId` | Slave ID | int | — | `71` | no |

_Measured quantities:_

| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Active power | double | Watt |
| `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
| `phaseACurrent` | Phase A current | double | Ampere |
| `phaseBCurrent` | Phase B current | double | Ampere |
| `phaseCCurrent` | Phase C current | double | Ampere |
| `voltagePhaseA` | Voltage phase A | double | Volt |
| `voltagePhaseB` | Voltage phase B | double | Volt |
| `voltagePhaseC` | Voltage phase C | double | Volt |
| `currentPowerPhaseA` | Current power phase A | double | Watt |
| `currentPowerPhaseB` | Current power phase B | double | Watt |
| `currentPowerPhaseC` | Current power phase C | double | Watt |
| `frequency` | Frequency | double | Hertz |

??? abstract "KOSTAL Meter — kostalMeter" Measured quantities:

| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Current power | double | Watt |
| `totalEnergyProduced` | Total returned energy | double | KiloWattHour |
| `totalEnergyConsumed` | Total imported energy | double | KiloWattHour |
| `currentPhaseA` | Phase A current | double | Ampere |
| `currentPhaseB` | Phase B current | double | Ampere |
| `currentPhaseC` | Phase C current | double | Ampere |
| `currentPowerPhaseA` | Current power phase A | double | Watt |
| `currentPowerPhaseB` | Current power phase B | double | Watt |
| `currentPowerPhaseC` | Current power phase C | double | Watt |
| `voltagePhaseA` | Voltage phase A | double | Volt |
| `voltagePhaseB` | Voltage phase B | double | Volt |
| `voltagePhaseC` | Voltage phase C | double | Volt |
| `frequency` | Frequency | double | Hertz |

??? abstract "KOSTAL Battery — kostalBattery" Measured quantities:

| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `batteryCritical` | Battery critical | bool | — |
| `batteryLevel` | Battery level | int | Percentage |
| `currentPower` | Total real power | double | Watt |
| `voltage` | Voltage | double | Volt |
| `temperature` | Temperature | double | DegreeCelsius |
| `capacity` | Capacity | double | KiloWattHour |
| `chargingState` | Charging state | QString | — |