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

18 KiB

Compteurs Eastron (SDM)

STABLE CONSUMER

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. 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

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 |