meters

Les meters (compteurs) sont une liste d’appareils de la maison capables de mesurer la puissance et la consommation d’énergie, la production solaire ou l’utilisation de la batterie domestique. Un meter définit un point de mesure de l’énergie et peut être un appareil physique (p. ex. un compteur au point de raccordement au réseau), un onduleur solaire (AC ou DC dans le cas des onduleurs hybrides) ou un onduleur de batterie.

Les chargeurs peuvent disposer d’un compteur intégré, ou un compteur externe peut y être raccordé. Si un chargeur dispose d’un compteur intégré, il n’est pas nécessaire de créer une entrée pour lui dans meters. Si le chargeur ne dispose pas d’un tel compteur, evcc utilise le compteur configuré ici et attribué au chargeur sous meter dans la configuration du point de charge, ou suppose que la puissance de charge réglée est effectivement utilisée.

evcc applique une convention de signe cohérente pour les valeurs de puissance et de courant (power, powers, currents) :

• Positif (+) pour l’énergie entrante : import du réseau, production solaire, décharge de la batterie domestique
• Négatif (-) pour l’énergie sortante : export vers le réseau, consommation en veille de l’onduleur solaire, charge de la batterie domestique
• Les consommateurs (chargeur, compteurs auxiliaires) sont toujours positifs (+)

Si l’appareil renvoie des valeurs avec le signe inverse, vous pouvez le corriger dans la configuration du plugin avec scale: -1.

La configuration meters est une liste des différents appareils disponibles.

Exemple :

meters:
  - name: grid
    type: ...
  - name: pv
    type: ...
  - name: battery
    type: ...
  - name: charge
    type: ...
  - name: aux
    type: ...

Vous trouverez les configurations des appareils connus sous Appareils → Installation domestique.

Les différents paramètres sont expliqués ci-dessous.

---

Paramètres obligatoires

name

Une désignation courte du compteur. Cette valeur sert à référencer l’appareil dans la configuration du site ou du point de charge.

Exemple :

name: charger1

---

type

Il s’agit du type de compteur propre à evcc qui permet de communiquer avec l’appareil. Vous trouverez le type adapté aux appareils connus sous Appareils → Installation domestique.

Exemple :

type: modbus

Les différents types possibles et leurs paramètres supplémentaires sont documentés ci-dessous :

---

Remarque

Les champs supplémentaires title et icon des compteurs ne sont pas pris en charge dans le fichier evcc.yaml pour des raisons techniques. Les titres et les icônes (selon l’utilisation) ne peuvent être définis que pour les compteurs créés via l’interface de configuration.

Types pris en charge

movingaverage

Ce type de compteur permet de lisser des valeurs de mesure fluctuantes. Il fonctionne avec toutes les utilisations de compteur (usage). Le paramètre decay indique le pourcentage de la nouvelle valeur pris en compte dans le calcul.

Exemple :

meters:
- name: grid
  type: movingaverage
  decay: 0.1
  meter:
    type: template
    template: solarlog
    usage: grid
    host: 192.0.2.2
    ...

Dans cet exemple, 10 % de la nouvelle valeur est prise en compte. Après 10 cycles, la valeur la plus ancienne sort du calcul. Cette durée dépend du paramètre interval.

---

modbus

Appareils raccordés via l’interface Modbus et pris en charge par le projet MBMD (ModBus Measurement Daemon).

Exemple :

  type: modbus
  power: Power
  energy: Sum
  soc: ChargeState
  ...

Paramètres obligatoires

En plus des paramètres définis ici, d’autres paramètres sont nécessaires. Ils sont décrits dans la documentation Modbus.

power

Définit la grandeur MBMD qui fournit la puissance, généralement Power.

Exemple :

power: Power

---

energy

Définit la grandeur MBMD qui fournit l’énergie, généralement Sum.

Exemple :

energy: Sum

---

Paramètres facultatifs

soc

Définit la grandeur MBMD qui fournit le niveau de charge de la batterie, généralement ChargeState.

Exemple :

soc: ChargeState

---

lgess

Appareils LG ESS Home 8/10.

Exemple :

type: lgess
usage: grid
uri: https://192.0.2.2/
password: "DE200..."

Note

Les paramètres uri et password ne sont nécessaires pour un appareil meter que si plusieurs appareils sont configurés.

Paramètres obligatoires

usage

Indique quelles mesures l’appareil doit fournir.

Valeurs possibles :

• grid : pour les mesures au point de raccordement au réseau
• pv : pour les mesures de la production solaire
• battery : pour les mesures de la batterie domestique

---

uri

Définit l’URL de l’appareil LG ESS dans le réseau domestique.

Exemple :

uri: https://192.0.2.2/

---

password

Le numéro d’enregistrement de l’onduleur LG ESS HOME doit être saisi ici.

Exemple :

password: "DE200..."

---

openwb

Pour utiliser les mesures d’un chargeur OpenWB.

Exemple :

type: openwb
usage: grid
broker: 192.0.2.2

Paramètres obligatoires

usage

Indique quelles mesures l’appareil doit fournir.

Valeurs possibles :

• grid : pour les mesures au point de raccordement au réseau
• pv : pour les mesures de la production solaire
• battery : pour les mesures de la batterie domestique

---

broker

Définit le nom d’hôte ou l’adresse IP ainsi que le port de l’OpenWB dans le réseau domestique.

Exemple :

broker: 192.0.2.2:1883

---

sma

Pour utiliser le SMA Home Manager 2.0, le SMA Energy Meter ou un onduleur SMA. Les appareils doivent prendre en charge le protocole Speedwire.

Exemple :

type: sma
uri: 192.0.2.2
serial: 12345678
interface: eth0

---

Paramètres obligatoires

Note

Il suffit de définir soit uri, soit serial.

uri

Définit le nom d’hôte ou l’adresse IP de l’appareil dans le réseau domestique.

Exemple :

uri: 192.0.2.2

serial

Définit le numéro de série de l’appareil dont les mesures doivent être reçues.

Exemple :

serial: 12345678

Paramètres facultatifs

interface

Les messages multicast ne peuvent être reçus que sur une interface réseau donnée. Il s’agit généralement de la première interface du système. Si le compteur est joignable par une autre interface, indiquez-la explicitement.

Exemple :

interface: eth0

---

tesla

tesla : pour utiliser les mesures d’une Tesla Powerwall.

Exemple :

type: tesla
usage: grid
uri: https://192.0.2.2/
password: "***"

---

Paramètres obligatoires

usage

Indique quelles mesures l’appareil doit fournir.

Valeurs possibles :

• grid : pour les mesures au point de raccordement au réseau
• pv : pour les mesures de la production solaire
• battery : pour les mesures de la batterie domestique

---

uri

Définit le nom d’hôte ou l’adresse IP de l’appareil dans le réseau domestique.

Exemple :

uri: 192.0.2.2

---

password

Le mot de passe de l’utilisateur customer doit être saisi ici.

Exemple :

password: "ThePassword"

---

custom

Implémentation générique dans laquelle chaque valeur est fournie par des plugins.

Exemple :

  type: custom
  power: # Puissance (W)
    source: # Type de plugin
    ...
  energy: # Énergie (kWh)
    source: # Type de plugin
    ...
  returnenergy: # Énergie dans le sens inverse (kWh)
    source: # Type de plugin
    ...
  soc: # Niveau de charge de la batterie (%)
    source: # Type de plugin
    ...
  capacity: # Capacité de la batterie, facultative (kWh)
  currents: # Courant (A) par phase
    - source: # Type de plugin phase 1
      ...
    - source: # Type de plugin phase 2
      ...
    - source: # Type de plugin phase 3
      ...
  powers: # Puissance (W) par phase
    - source: # Type de plugin phase 1
      ...
    - source: # Type de plugin phase 2
      ...
    - source: # Type de plugin phase 3
      ...
  voltages: # Tension (V) par phase
    - source: # Type de plugin phase 1
      ...
    - source: # Type de plugin phase 2
      ...
    - source: # Type de plugin phase 3
      ...
  ...

---

Paramètres obligatoires

power

Définition de plugin qui renvoie la puissance en watts (W).

Exemple :

  power: ... # Puissance (W)
    source: # Type de plugin
    ...

---

Paramètres facultatifs

energy

Définition de plugin qui renvoie l’énergie consommée en kilowattheures (kWh).

Exemple :

  energy: ... # Énergie (kWh)
    source: # Type de plugin
    ...

---

returnenergy

Définition de plugin qui renvoie l’énergie dans le sens inverse en kilowattheures (kWh), p. ex. l’export vers le réseau.

Exemple :

  returnenergy: ... # Énergie dans le sens inverse (kWh)
    source: # Type de plugin
    ...

---

soc

Définition de plugin qui renvoie le niveau de charge de la batterie en pourcentage (%).

Exemple :

  soc: ... # Niveau de charge de la batterie (%)
    source: # Type de plugin
    ...

---

capacity

Indique la capacité de la batterie. Elle n’est utile qu’en présence de plusieurs batteries et sert à calculer le niveau de charge global.

---

currents

Une liste de définitions de plugin qui renvoient le courant en ampères (A) par phase.

Exemple :

  currents: # Courant (A) par phase
    - source: # Type de plugin phase 1
      ...
    - source: # Type de plugin phase 2
      ...
    - source: # Type de plugin phase 3
      ...
  ...

---

powers

Une liste de définitions de plugin qui renvoient la puissance en watts (W) par phase.

Exemple :

  powers: # Puissance (W) par phase
    - source: # Type de plugin phase 1
      ...
    - source: # Type de plugin phase 2
      ...
    - source: # Type de plugin phase 3
      ...
  ...

---

voltages

Une liste de définitions de plugin qui renvoient la tension en volts (V) par phase.

Exemple :

  voltages: # Tension (V) par phase
    - source: # Type de plugin phase 1
      ...
    - source: # Type de plugin phase 2
      ...
    - source: # Type de plugin phase 3
      ...
  ...