ETM-Schurig/powersync-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
powersync-docs/docs/appareils/onduleurs/sunspec.en.md
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

358 lines
16 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# SunSpec
<!-- BEGIN GENERATED: __badges_sunspec__ -->
<span class="badge stable">STABLE</span> <span class="badge origin-nymea">NYMEA</span> <span class="badge consumer">CONSUMER</span>
<!-- END GENERATED -->
Connect to SunSpec devices.
_Installation guide coming soon._
## Reference
<!-- BEGIN GENERATED: integrationpluginsunspec.json -->
**Manufacturer:** SunSpec, SolarEdge, Fronius
**Plugin:** `SunSpec`
#### Supported models
| Model | Role | Transport | Pairing | Quantities |
| --- | --- | --- | --- | --- |
| **SunSpec Generic** | gateway | Modbus TCP | Auto-discovery / Manual | 1 |
| **SunSpec single phase inverter** | solarinverter | — | Auto | 13 |
| **SunSpec split phase inverter** | solarinverter | — | Auto | 16 |
| **SunSpec three phase inverter** | solarinverter | — | Auto | 18 |
| **SunSpec single phase meter** | Energy meter | — | Auto | 8 |
| **SunSpec split phase meter** | Energy meter | — | Auto | 18 |
| **SunSpec three phase meter** | Energy meter | — | Auto | 21 |
| **SunSpec Storage** | battery, energystorage | — | Auto | 16 |
| **SolarEdge** | gateway | Modbus TCP | Auto-discovery / Manual | 1 |
| **SolarEdge battery** | energystorage | — | Auto | 14 |
| **Fronius** | gateway | Modbus TCP | Auto-discovery / Manual | 1 |
#### Per-model detail
??? abstract "SunSpec Generic — `sunspecConnection`"
_Discovery parameters:_
| Key | Label | Type | Range | Default |
| --- | --- | --- | --- | --- |
| `slaveId` | Slave ID | int | — | `1` |
_Settings:_
| Key | Label | Type | Range | Default | Read-only |
| --- | --- | --- | --- | --- | --- |
| `address` | Host address | QString | — | — | no |
| `hostName` | Host name | QString | — | — | no |
| `macAddress` | MAC address | QString | — | — | no |
| `port` | Port | int | — | `502` | no |
| `slaveId` | Slave ID | int | — | `1` | no |
| `endianness` | Endianness | QString | — | `Big Endian` | no |
_Measured quantities:_
| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
??? abstract "SunSpec single phase inverter — `sunspecSinglePhaseInverter`"
_Settings:_
| Key | Label | Type | Range | Default | Read-only |
| --- | --- | --- | --- | --- | --- |
| `modelId` | Model | int | — | — | yes |
| `modbusAddress` | Modbus address | uint | — | `0` | yes |
| `manufacturer` | Manufacturer | QString | — | `Unkown` | no |
| `deviceModel` | Device model | QString | — | `Unkown` | no |
| `serialNumber` | Serial number | QString | — | `Unkown` | no |
_Measured quantities:_
| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `totalCurrent` | Total AC current | double | Ampere |
| `phaseVoltage` | Phase voltage | double | Volt |
| `currentPower` | AC power | double | Watt |
| `frequency` | Frequency | double | Hertz |
| `totalEnergyProduced` | AC energy | double | KiloWattHour |
| `voltageDc` | DC voltage | double | Volt |
| `currentDc` | DC current | double | Ampere |
| `currentPowerDc` | DC power | double | Watt |
| `cabinetTemperature` | Cabinet temperature | double | DegreeCelsius |
| `operatingState` | Operating state | QString | — |
| `error` | Error | QString | — |
| `version` | Version | QString | — |
??? abstract "SunSpec split phase inverter — `sunspecSplitPhaseInverter`"
_Settings:_
| Key | Label | Type | Range | Default | Read-only |
| --- | --- | --- | --- | --- | --- |
| `modelId` | Model | int | — | — | yes |
| `modbusAddress` | Modbus address | uint | — | `0` | yes |
| `manufacturer` | Manufacturer | QString | — | `Unkown` | no |
| `deviceModel` | Device model | QString | — | `Unkown` | no |
| `serialNumber` | Serial number | QString | — | `Unkown` | no |
_Measured quantities:_
| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `totalCurrent` | Total AC current | double | Ampere |
| `phaseACurrent` | Phase A current | double | Ampere |
| `phaseBCurrent` | Phase B current | double | Ampere |
| `phaseANVoltage` | Phase AN voltage | double | Volt |
| `phaseBNVoltage` | Phase BN voltage | double | Volt |
| `currentPower` | AC power | double | Watt |
| `frequency` | Line frequency | double | Hertz |
| `totalEnergyProduced` | AC energy | double | KiloWattHour |
| `voltageDc` | DC voltage | double | Volt |
| `currentDc` | DC current | double | Ampere |
| `currentPowerDc` | DC power | double | Watt |
| `cabinetTemperature` | Cabinet temperature | double | DegreeCelsius |
| `operatingState` | Operating state | QString | — |
| `error` | Error | QString | — |
| `version` | Version | QString | — |
??? abstract "SunSpec three phase inverter — `sunspecThreePhaseInverter`"
_Settings:_
| Key | Label | Type | Range | Default | Read-only |
| --- | --- | --- | --- | --- | --- |
| `modelId` | Model | int | — | — | yes |
| `modbusAddress` | Modbus address | uint | — | `0` | yes |
| `manufacturer` | Manufacturer | QString | — | `Unkown` | no |
| `deviceModel` | Device model | QString | — | `Unkown` | no |
| `serialNumber` | Serial number | QString | — | `Unkown` | no |
_Measured quantities:_
| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `totalCurrent` | Total AC current | double | Ampere |
| `phaseACurrent` | Phase A current | double | Ampere |
| `phaseBCurrent` | Phase B current | double | Ampere |
| `phaseCCurrent` | Phase C current | double | Ampere |
| `phaseANVoltage` | Phase AN voltage | double | Volt |
| `phaseBNVoltage` | Phase BN voltage | double | Volt |
| `phaseCNVoltage` | Phase CN voltage | int | Volt |
| `currentPower` | AC power | double | Watt |
| `frequency` | Frequency | double | Hertz |
| `totalEnergyProduced` | AC energy | double | KiloWattHour |
| `voltageDc` | DC voltage | double | Volt |
| `currentDc` | DC current | double | Ampere |
| `currentPowerDc` | DC power | double | Watt |
| `cabinetTemperature` | Cabinet temperature | double | DegreeCelsius |
| `operatingState` | Operating state | QString | — |
| `error` | Error | QString | — |
| `version` | Version | QString | — |
??? abstract "SunSpec single phase meter — `sunspecSinglePhaseMeter`"
_Settings:_
| Key | Label | Type | Range | Default | Read-only |
| --- | --- | --- | --- | --- | --- |
| `modelId` | Model | int | — | `0` | yes |
| `modbusAddress` | Modbus address | uint | — | `0` | yes |
| `manufacturer` | Manufacturer | QString | — | `Unkown` | no |
| `deviceModel` | Device model | QString | — | `Unkown` | no |
| `serialNumber` | Serial number | QString | — | `Unkown` | no |
_Measured quantities:_
| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Total real power | double | Watt |
| `totalEnergyProduced` | Total real energy exported | double | KiloWattHour |
| `totalEnergyConsumed` | Total real energy imported | double | KiloWattHour |
| `currentPhaseA` | Phase A current | double | Ampere |
| `voltagePhaseA` | Phase A voltage | double | Volt |
| `frequency` | Frequency | double | Hertz |
| `version` | Version | QString | — |
??? abstract "SunSpec split phase meter — `sunspecSplitPhaseMeter`"
_Settings:_
| Key | Label | Type | Range | Default | Read-only |
| --- | --- | --- | --- | --- | --- |
| `modelId` | Model | int | — | `0` | yes |
| `modbusAddress` | Modbus address | uint | — | `0` | yes |
| `manufacturer` | Manufacturer | QString | — | `Unkown` | no |
| `deviceModel` | Device model | QString | — | `Unkown` | no |
| `serialNumber` | Serial number | QString | — | `Unkown` | no |
_Measured quantities:_
| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `totalEnergyProduced` | Total real energy exported | double | KiloWattHour |
| `totalEnergyConsumed` | Total real energy imported | double | KiloWattHour |
| `currentPower` | Total real power | double | Watt |
| `energyConsumedPhaseA` | Energy consumed phase A | double | KiloWattHour |
| `energyConsumedPhaseB` | Energy consumed phase B | double | KiloWattHour |
| `energyProducedPhaseA` | Energy produced phase A | double | KiloWattHour |
| `energyProducedPhaseB` | Energy produced phase B | double | KiloWattHour |
| `totalCurrent` | Total AC current | double | Ampere |
| `currentPowerPhaseA` | Current power phase A | double | Watt |
| `currentPowerPhaseB` | Current power phase B | double | Watt |
| `currentPhaseA` | Phase A current | double | Ampere |
| `currentPhaseB` | Phase B current | double | Ampere |
| `lnACVoltage` | Line to Neutral AC Voltage | double | Volt |
| `voltagePhaseA` | Phase A voltage | double | Volt |
| `voltagePhaseB` | Phase B voltage | double | Volt |
| `frequency` | Frequency | double | Hertz |
| `version` | Version | QString | — |
??? abstract "SunSpec three phase meter — `sunspecThreePhaseMeter`"
_Settings:_
| Key | Label | Type | Range | Default | Read-only |
| --- | --- | --- | --- | --- | --- |
| `modelId` | Model | int | — | `0` | yes |
| `modbusAddress` | Modbus address | uint | — | `0` | yes |
| `manufacturer` | Manufacturer | QString | — | `Unkown` | no |
| `deviceModel` | Device model | QString | — | `Unkown` | no |
| `serialNumber` | Serial number | QString | — | `Unkown` | no |
_Measured quantities:_
| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `totalEnergyProduced` | Total real energy exported | double | KiloWattHour |
| `totalEnergyConsumed` | Total real energy imported | double | KiloWattHour |
| `currentPower` | Total real power | double | Watt |
| `energyConsumedPhaseA` | Energy consumed phase A | double | KiloWattHour |
| `energyConsumedPhaseB` | Energy consumed phase B | double | KiloWattHour |
| `energyConsumedPhaseC` | Energy consumed phase C | double | KiloWattHour |
| `energyProducedPhaseA` | Energy produced phase A | double | KiloWattHour |
| `energyProducedPhaseB` | Energy produced phase B | double | KiloWattHour |
| `energyProducedPhaseC` | Energy produced phase C | double | KiloWattHour |
| `currentPowerPhaseA` | Current power phase A | double | Watt |
| `currentPowerPhaseB` | Current power phase B | double | Watt |
| `currentPowerPhaseC` | Current power phase C | double | Watt |
| `currentPhaseA` | Phase A current | double | Ampere |
| `currentPhaseB` | Phase B current | double | Ampere |
| `currentPhaseC` | Phase C current | double | Ampere |
| `voltagePhaseA` | Phase A voltage | double | Volt |
| `voltagePhaseB` | Phase B voltage | double | Volt |
| `voltagePhaseC` | Phase C voltage | double | Volt |
| `frequency` | Frequency | double | Hertz |
| `version` | Version | QString | — |
??? abstract "SunSpec Storage — `sunspecStorage`"
_Settings:_
| Key | Label | Type | Range | Default | Read-only |
| --- | --- | --- | --- | --- | --- |
| `modelId` | Model | int | — | `0` | yes |
| `modbusAddress` | Modbus address | uint | — | `0` | yes |
| `manufacturer` | Manufacturer | QString | — | `Unkown` | no |
| `deviceModel` | Device model | QString | — | `Unkown` | no |
| `serialNumber` | Serial number | QString | — | `Unkown` | no |
| `revertTime` | Setpoint revert time | uint | 0–28800 | `0` | no |
_Measured quantities:_
| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `batteryCritical` | Battery critical | bool | — |
| `batteryLevel` | Battery level | int | Percentage |
| `storageStatus` | Status | QString | — |
| `chargingState` | Charging state | QString | — |
| `gridCharging` | Grid charging | bool | — |
| `enableCharging` | Charging | bool | — |
| `enableDischarging` | Discharging | bool | — |
| `chargingRate` | Charging rate | int | Percentage |
| `dischargingRate` | Discharging rate | int | Percentage |
| `controlHealthy` | Control healthy | bool | — |
| `chargeGradient` | Charging gradient | double | Percentage |
| `dischargeGradient` | Discharging gradient | double | Percentage |
| `currentPower` | Current power | double | Watt |
| `capacity` | Capacity | double | KiloWattHour |
| `version` | Version | QString | — |
??? abstract "SolarEdge — `solarEdgeConnection`"
_Discovery parameters:_
| Key | Label | Type | Range | Default |
| --- | --- | --- | --- | --- |
| `slaveId` | Slave ID | int | — | `1` |
_Settings:_
| Key | Label | Type | Range | Default | Read-only |
| --- | --- | --- | --- | --- | --- |
| `address` | Host address | QString | — | — | no |
| `hostName` | Host name | QString | — | — | no |
| `macAddress` | MAC address | QString | — | — | no |
| `port` | Port | int | — | `502` | no |
| `slaveId` | Slave ID | int | — | `1` | no |
_Measured quantities:_
| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
??? abstract "SolarEdge battery — `solarEdgeBattery`"
_Settings:_
| Key | Label | Type | Range | Default | Read-only |
| --- | --- | --- | --- | --- | --- |
| `modbusAddress` | Modbus address | uint | — | `0` | yes |
| `manufacturer` | Manufacturer | QString | — | `Unkown` | no |
| `deviceModel` | Device model | QString | — | `Unkown` | no |
| `serialNumber` | Serial number | QString | — | — | no |
_Measured quantities:_
| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `batteryCritical` | Battery critical | bool | — |
| `batteryLevel` | Battery level | int | Percentage |
| `chargingState` | Charging state | QString | — |
| `ratedEnergy` | Rated energy | double | KiloWattHour |
| `averageTemperature` | Average temperature | double | DegreeCelsius |
| `instantaneousVoltage` | Instantaneous voltage | double | Volt |
| `instantaneousCurrent` | Instantaneous current | double | Ampere |
| `currentPower` | Instantaneous power | double | Watt |
| `maxEnergy` | Maximum energy | double | KiloWattHour |
| `capacity` | Available energy | double | KiloWattHour |
| `stateOfHealth` | State of health (SOH) | double | Percentage |
| `batteryStatus` | Battery status | QString | — |
| `version` | Version | QString | — |
??? abstract "Fronius — `froniusConnection`"
_Discovery parameters:_
| Key | Label | Type | Range | Default |
| --- | --- | --- | --- | --- |
| `slaveId` | Slave ID | int | — | `1` |
_Settings:_
| Key | Label | Type | Range | Default | Read-only |
| --- | --- | --- | --- | --- | --- |
| `address` | Host address | QString | — | — | no |
| `hostName` | Host name | QString | — | — | no |
| `macAddress` | MAC address | QString | — | — | no |
| `port` | Port | int | — | `502` | no |
| `slaveId` | Slave ID | int | — | `1` | yes |
| `meterSlaveId` | Smart Meter slave ID | int | 0–247 | `200` | no |
_Measured quantities:_
| Key | Quantity | Type | Unit |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
<!-- END GENERATED -->
Reference in New Issue View Git Blame Copy Permalink