# meters

> Définissez dans evcc.yaml les compteurs du réseau, du solaire, de la batterie domestique et des consommateurs, avec la convention de signe et les types disponibles.

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`](/fr/reference/configuration/loadpoints#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](/fr/reference/plugins) avec `scale: -1`.

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

**Exemple** :

```yaml
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](/fr/meters).

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](/fr/reference/configuration/site) ou du [point de charge](/fr/reference/configuration/loadpoints#meter).

**Exemple** :

```yaml
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](/fr/meters).

**Exemple** :

```yaml
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** :

```yaml
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)](https://github.com/volkszaehler/mbmd#supported-devices).

**Exemple** :

```yaml
  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](/fr/reference/modbus).

##### `power`

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

**Exemple** :

```yaml
power: Power
```

***

##### `energy`

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

**Exemple** :

```yaml
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** :

```yaml
soc: ChargeState
```

***

### `lgess`

Appareils LG ESS Home 8/10.

**Exemple** :

```yaml
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** :

```yaml
uri: https://192.0.2.2/
```

***

##### `password`

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

**Exemple** :

```yaml
password: "DE200..."
```

***

### `openwb`

Pour utiliser les mesures d’un chargeur OpenWB.

**Exemple** :

```yaml
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** :

```yaml
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** :

```yaml
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** :

```yaml
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** :

```yaml
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** :

```yaml
interface: eth0
```

***

### `tesla`

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

**Exemple** :

```yaml
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** :

```yaml
uri: 192.0.2.2
```

***

##### `password`

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

**Exemple** :

```yaml
password: "ThePassword"
```

***

### `custom`

Implémentation générique dans laquelle chaque valeur est fournie par des [plugins](/fr/user-defined-devices#meter).

**Exemple** :

```yaml
  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** :

```yaml
  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** :

```yaml
  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** :

```yaml
  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** :

```yaml
  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** :

```yaml
  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** :

```yaml
  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** :

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