Patrick Schurig 9eee067829 feat: docs-as-code — générateur, literate-nav, badges, CI Gitea Actions
- PORTING_STATUS.yaml : source de vérité canal APT + placement nav
- scripts/gen_device_reference.py : génération matrice + fiches + SUMMARY.md
  depuis integrationplugin*.json + meta.json ; nightly sans JSON = invisible
- mkdocs.yml : plugin literate-nav, nav 6 sections, Appareils via SUMMARY.md
- .gitea/workflows/docs.yml : CI complet — fetch JSON (branche auto-détectée),
  génération, build --strict, check idempotence, rsync deploy
- Badges HTML (stable/testing/nightly + consumer/community + ok/part/road)
- Fiches appareils : Eastron, ABB B2x, ABB Terra, Keba, Waveshare
- requirements.txt : mkdocs-material, mkdocs-literate-nav, PyYAML

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-02 08:53:54 +02:00

408 lines
18 KiB
Markdown

# Compteurs Eastron (SDM)
<span class="badge stable">STABLE</span> <span class="badge consumer">CONSUMER</span>
Les compteurs Eastron de la série SDM (SDM72, SDM120, SDM220, SDM230, SDM630)
communiquent en **Modbus RTU** sur le bus RS485 du hub. Selon le modèle, ils
mesurent un raccordement monophasé ou triphasé et peuvent être affectés à trois
rôles : compteur général, compteur de consommation ou compteur de production.
## 1. Matériel requis
- Le compteur Eastron (modèle selon le besoin de mesure)
- Un adaptateur USB↔RS485 côté hub
- Câble bus 2 fils torsadés (A/B) + masse
## 2. Raccordement RS485
Relier A↔A, B↔B entre l'adaptateur et le compteur, masse commune. Placer une
résistance de terminaison **120 Ω** à chaque extrémité du bus.
!!! warning "À valider sur votre banc"
Vitesse (baudrate) et parité par défaut du compteur : à confirmer dans le
menu de l'appareil avant mise en service.
## 3. Adressage Modbus
Chaque appareil du bus doit avoir une **adresse esclave unique** (réglée via le
menu du compteur). L'adresse par défaut est `1`. Si plusieurs Eastron partagent
le bus, attribuez `1`, `2`, `3`, …
## 4. Ajout et configuration dans l'application
L'ajout se fait depuis l'application, en mode installateur — voir
[Ajouter un appareil](../../installation/application.md). Pour l'Eastron :
découverte sur le bus, sélection du modèle, puis choix du **rôle** (compteur
général / consommation / production).
## 5. Vérification
Une fois ajouté, l'état `connected` passe à vrai et les grandeurs (`currentPower`,
etc.) se mettent à jour. En cas d'absence de données : vérifier câblage A/B,
adresse esclave et terminaison.
---
## Référence {#reference}
<!-- BEGIN GENERATED: integrationplugineastron.json -->
**Fabricant :** Eastron
**Plugin :** `eastron`
#### Modèles pris en charge
| Modèle | Rôle | Transport | Ajout | Grandeurs |
| --- | --- | --- | --- | --- |
| **SDM630 — Energy Meter** | Compteur d'énergie | Modbus RTU | Découverte automatique | 20 |
| **SDM630 — Consumer Meter** | Compteur de consommation | Modbus RTU | Découverte automatique | 4 |
| **SDM630 — Producer Meter** | Compteur de production | Modbus RTU | Découverte automatique | 4 |
| **SDM72 — Energy Meter** | Compteur d'énergie | Modbus RTU | Découverte automatique | 14 |
| **SDM72 — Consumer Meter** | Compteur de consommation | Modbus RTU | Découverte automatique | 4 |
| **SDM72 — Producer Meter** | Compteur de production | Modbus RTU | Découverte automatique | 4 |
| **SDM120 — Energy Meter** | Compteur d'énergie | Modbus RTU | Découverte automatique | 7 |
| **SDM120 — Consumer Meter** | Compteur de consommation | Modbus RTU | Découverte automatique | 4 |
| **SDM120 — Producer Meter** | Compteur de production | Modbus RTU | Découverte automatique | 4 |
| **SDM220 — Energy Meter** | Compteur d'énergie | Modbus RTU | Découverte automatique | 7 |
| **SDM220 — Consumer Meter** | Compteur de consommation | Modbus RTU | Découverte automatique | 4 |
| **SDM220 — Producer Meter** | Compteur de production | Modbus RTU | Découverte automatique | 4 |
| **SDM230 — Energy Meter** | Compteur d'énergie | Modbus RTU | Découverte automatique | 7 |
| **SDM230 — Consumer Meter** | Compteur de consommation | Modbus RTU | Découverte automatique | 4 |
| **SDM230 — Producer Meter** | Compteur de production | Modbus RTU | Découverte automatique | 4 |
#### Détail par modèle
??? abstract "SDM630 — Energy Meter — `sdm630`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `voltagePhaseA` | Voltage phase A | double | Volt |
| `voltagePhaseB` | Voltage phase B | double | Volt |
| `voltagePhaseC` | Voltage phase C | double | Volt |
| `currentPhaseA` | Current phase A | double | Ampere |
| `currentPhaseB` | Current phase B | double | Ampere |
| `currentPhaseC` | Current phase C | double | Ampere |
| `currentPower` | Current power | double | Watt |
| `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 |
| `totalEnergyConsumed` | Total energy consumed | double | KiloWattHour |
| `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
| `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 |
??? abstract "SDM630 — Consumer Meter — `sdm630Consumer`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Current power | double | Watt |
| `totalEnergyConsumed` | Total energy consumed | double | KiloWattHour |
| `frequency` | Frequency | double | Hertz |
??? abstract "SDM630 — Producer Meter — `sdm630Producer`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Current power | double | Watt |
| `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
| `frequency` | Frequency | double | Hertz |
??? abstract "SDM72 — Energy Meter — `sdm72`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `voltagePhaseA` | Voltage phase A | double | Volt |
| `voltagePhaseB` | Voltage phase B | double | Volt |
| `voltagePhaseC` | Voltage phase C | double | Volt |
| `currentPhaseA` | Current phase A | double | Ampere |
| `currentPhaseB` | Current phase B | double | Ampere |
| `currentPhaseC` | Current phase C | double | Ampere |
| `currentPower` | Current power | double | Watt |
| `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 |
| `totalEnergyConsumed` | Total energy consumed | double | KiloWattHour |
| `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
??? abstract "SDM72 — Consumer Meter — `sdm72Consumer`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Current power | double | Watt |
| `totalEnergyConsumed` | Total energy consumed | double | KiloWattHour |
| `frequency` | Frequency | double | Hertz |
??? abstract "SDM72 — Producer Meter — `sdm72Producer`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Current power | double | Watt |
| `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
| `frequency` | Frequency | double | Hertz |
??? abstract "SDM120 — Energy Meter — `sdm120`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `voltagePhaseA` | Voltage | double | Volt |
| `currentPhaseA` | Current | double | Ampere |
| `currentPower` | Current power | double | Watt |
| `frequency` | Frequency | double | Hertz |
| `totalEnergyConsumed` | Total energy consumed | double | KiloWattHour |
| `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
??? abstract "SDM120 — Consumer Meter — `sdm120Consumer`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Current power | double | Watt |
| `totalEnergyConsumed` | Total energy consumed | double | KiloWattHour |
| `frequency` | Frequency | double | Hertz |
??? abstract "SDM120 — Producer Meter — `sdm120Producer`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Current power | double | Watt |
| `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
| `frequency` | Frequency | double | Hertz |
??? abstract "SDM220 — Energy Meter — `sdm220`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `voltagePhaseA` | Voltage | double | Volt |
| `currentPhaseA` | Current | double | Ampere |
| `currentPower` | Current power | double | Watt |
| `frequency` | Frequency | double | Hertz |
| `totalEnergyConsumed` | Total energy consumed | double | KiloWattHour |
| `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
??? abstract "SDM220 — Consumer Meter — `sdm220Consumer`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Current power | double | Watt |
| `totalEnergyConsumed` | Total energy consumed | double | KiloWattHour |
| `frequency` | Frequency | double | Hertz |
??? abstract "SDM220 — Producer Meter — `sdm220Producer`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Current power | double | Watt |
| `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
| `frequency` | Frequency | double | Hertz |
??? abstract "SDM230 — Energy Meter — `sdm230`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `voltagePhaseA` | Voltage | double | Volt |
| `currentPhaseA` | Current | double | Ampere |
| `currentPower` | Current power | double | Watt |
| `frequency` | Frequency | double | Hertz |
| `totalEnergyConsumed` | Total energy consumed | double | KiloWattHour |
| `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
??? abstract "SDM230 — Consumer Meter — `sdm230Consumer`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Current power | double | Watt |
| `totalEnergyConsumed` | Total energy consumed | double | KiloWattHour |
| `frequency` | Frequency | double | Hertz |
??? abstract "SDM230 — Producer Meter — `sdm230Producer`"
_Paramètres de découverte :_
| Clé | Libellé | Type | Plage | Défaut |
| --- | --- | --- | --- | --- |
| `slaveAddress` | Slave address | int | — | `1` |
_Réglages :_
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
| --- | --- | --- | --- | --- | --- |
| `slaveAddress` | Modbus slave address | uint | — | `1` | non |
| `modbusMasterUuid` | Modbus RTU master | QUuid | — | — | oui |
_Grandeurs mesurées :_
| Clé | Grandeur | Type | Unité |
| --- | --- | --- | --- |
| `connected` | Connected | bool | — |
| `currentPower` | Current power | double | Watt |
| `totalEnergyProduced` | Total energy produced | double | KiloWattHour |
| `frequency` | Frequency | double | Hertz |
<!-- END GENERATED -->