# Smappee

> Appareils pris en charge : Smappee Genius Flex

Source: https://voltmasters.io/fr/docs/device-integrations/energy-meters/smappee/

Notre EMS lit les mesures d’un **Smappee Genius Flex** via l’interface MQTT locale de la passerelle.

Le Genius Flex mesure une installation complète : le raccordement, les circuits de production, les circuits de stockage et les éventuels circuits sous-comptés. Chacun de ces points de mesure peut être ajouté à notre EMS comme compteur d’énergie à part entière, de sorte qu’une seule passerelle peut fournir le compteur de raccordement du projet et les sous-compteurs situés derrière.

### Appareils pris en charge

-   **Genius Flex** : la passerelle Smappee Genius Flex avec son interface MQTT locale, un appareil par point de mesure

### Points de mesure

Le Genius Flex publie chaque point de mesure sous un type de charge et un identifiant de charge. La combinaison des deux identifie le point de mesure quand vous ajoutez le compteur.

| Type de charge | Ce qu’il mesure | Usage habituel dans l’EMS |
| --- | --- | --- |
| Grid | le raccordement du site | le compteur de raccordement sur lequel reposent les stratégies de pilotage |
| Production | un circuit de production, en général le PV | le suivi de la production |
| Storage | un circuit de stockage, en général une batterie | le suivi du stockage |
| Submeter | un circuit sous-compté | la consommation d’un bâtiment, d’une machine, d’un circuit de recharge |

Quand vous ajoutez le compteur, notre EMS demande à la passerelle quelles charges elle mesure et propose les circuits sous-comptés, ainsi qu’un éventuel second raccordement, comme compteurs supplémentaires à créer d’un coup. Les charges de production et de stockage ne sont pas proposées : elles mesurent le PV et la batterie, qui s’ajoutent comme appareils à part entière, et un compteur sur l’un ou l’autre compterait cette énergie deux fois.

Les identifiants de charge sont numérotés par type (`grid-1`, `production-1`, `production-2`, `submeter-1`) et restent identiques après un redémarrage de la passerelle. Ajouter ou retirer des circuits dans l’environnement Smappee peut les renuméroter : contrôlez donc les compteurs dans la plateforme après une modification de la configuration des circuits.

### Ce que le compteur rapporte

-   La puissance active totale et la puissance active par phase
-   Le courant par phase
-   La tension par phase, pour le raccordement
-   L’énergie cumulée prélevée et injectée
-   Pour le raccordement : la puissance de pointe contractuelle, la limite de courant et la configuration des phases

La passerelle publie de nouvelles mesures toutes les 5 secondes.

> **Avertissement**
>
> **Pas de puissance réactive ni de facteur de puissance**
> 
> L’interface Smappee n’expose ni puissance réactive, ni puissance apparente, ni facteur de puissance. Un compteur d’énergie Smappee affiche donc 0,00 kVAr et un facteur de puissance de 0,00 dans notre EMS, et ces chiffres ne sont pas des mesures : c’est la valeur de remplacement que notre EMS enregistre pour une grandeur que l’appareil ne mesure pas. Si l’installation a besoin de la puissance réactive, par exemple pour suivre le facteur de puissance du raccordement ou pour un pilotage qui agit sur le réactif, ajoutez à ce point de mesure un compteur qui la mesure, comme un Acrel ADL400 ou un Schneider PM5000.

> **Remarque**
>
> **Compteurs d’énergie**
> 
> Les compteurs d’énergie prélevée et injectée de la passerelle repartent de zéro quand la passerelle redémarre : ce sont donc des valeurs de référence plutôt que des index. Notre EMS tient ses propres totaux d’énergie en intégrant la puissance mesurée, ce qu’un redémarrage n’affecte pas.

### Fonctionnalités de l’EMS

Avec l’intégration actuelle, notre EMS permet :

-   La mesure du raccordement comme point de référence pour l’écrêtage des pointes, la gestion de la puissance et la protection du réseau
-   Le suivi des circuits de production, de stockage et sous-comptés comme points de mesure distincts
-   L’équilibrage de charge et le suivi de la consommation par circuit sous-compté
-   L’usage de la même passerelle pour le comptage à côté de la batterie et des bornes de recharge situées derrière

D’autres fonctions pourront s’ajouter au fil du temps, à mesure que l’intégration évolue.

## Configurer la passerelle

1. **Installez l’intégration MQTT dans l’application Smappee**
   
   Dans l’application Smappee, allez dans **Control > Smappee Store**, ouvrez l’application **MQTT** et appuyez sur **Install Integration**. La dernière étape affiche un nom d’utilisateur et un mot de passe : copiez les deux avec le bouton de copie de l’application.
   
   Les identifiants sont délimités par partie de l’interface. La paire de l’application MQTT donne accès aux données de comptage et aux bornes de recharge. Une batterie derrière la même passerelle exige sa propre paire, issue de l’intégration **Generic MQTT battery**.
2. **Placez la passerelle sur le réseau local**
   
   -   Raccordez le Genius Flex au même réseau filaire (LAN) que le contrôleur Voltmasters, sur le même sous-réseau.
   -   Donnez à la passerelle une adresse IP fixe et notez-la.
   -   Vérifiez que le contrôleur peut atteindre cette adresse IP sur le port 443.
3. **Notez les points de mesure que vous voulez ajouter**
   
   Consultez la configuration des circuits de l’installation dans l’environnement Smappee et notez, pour chaque point de mesure que vous voulez dans l’EMS, son type de charge et son identifiant de charge. Les noms viennent de la configuration Smappee : un sous-compteur appelé « Entrepôt » là-bas est le même point de mesure dans notre EMS.
4. **Ajoutez la passerelle comme compteur d’énergie**
   
   Ajoutez un compteur d’énergie en choisissant la marque **Smappee** et le modèle **Genius Flex**, et complétez l’adresse IP de la passerelle avec le nom d’utilisateur et le mot de passe de l’application MQTT. Ce compteur mesure le raccordement : marquez-le donc comme compteur de raccordement du projet.
   
   Notre EMS demande ensuite à la passerelle ce qu’elle mesure d’autre et propose ces points de mesure comme compteurs supplémentaires. Cochez ceux que vous voulez et ils sont créés avec le bon point de mesure déjà réglé : rien ne doit être cherché à la main.

La passerelle est maintenant configurée et prête à être utilisée avec l’EMS.
