Skip to content

pvergezac/MSunPVIntegration

Repository files navigation

📋 Description

MsunPV Integration est une intégration personnalisée pour Home Assistant qui permet le suivi des mesures du routeur solaire MSunPV de Ard-Tek.

L'intégration permet de suivre des mesures :

  • Production instantanée des panneaux solaire
  • Consommation ou injection instantanée sur le réseau électrique
  • Taux de routage vers le ballon d'eau chaude
  • Température du ballon (si sonde installée)
  • Production Solaire journalière et cumulée
  • Consommation réseau journalière
  • Injection réseau journalière
  • Valeurs complémentaires calculés (Consommation totale, production consommée, etc.)
  • Infos routeur (modèle, version, config, etc.)
  • Installation et mises à jour via HACS, et l'interface graphique de HA

Le choix à été fait de transformer les valeurs du MSunPV en valeur positives (sauf puissance réseau, négative en cas d'injection). Il semble plus logique de voir une courbe montante quand le production PV augmente. C'est également plus simple d'alimenter le Dashboard Energie de Home Assistant avec ces valeurs. (On pourra si nécessaire, doubler certaines entités pour avoir aussi les valeur en négatif comme sur le routeur).

Les développements et tests ont été réalisés sur un routeur MSunPV MS_PV2_2d, V5.0.1, Fw Wifi 104b, Fw Routeur 104b, en configuration d'origine.

Fonctionnalités à venir (TODO List)

  • État et pilotage des commandes Manu/Auto (ballon & radiateur)
  • État et pilotage des commandes TestRouteur (Inject, Zéro, Moyen, Fort)
  • État et pilotage des consignes de température (ballon & radiateur)
  • Automatisations

L'idée est de pouvoir agir sur le routage depuis HA, pour par exemple intégrer les prévisions de production du lendemain, ou prioriser la production d'eau chade par rapport à la filtration d'un piscine, ou encore tenir compte de la couleur du jour de TEMPO.

Le routeur solaire MSunPV

Le routeur solaire MSunPV de Ard-Tek permet d'utiliser l’excédant de production d'energie de panneaux solaires, pour par exemple recharger un ballon d'eau chaude ou alimenter un radiateur, au lieu de l'injecter gratuitement ou a faible prix sur le réseau EDF.

Tous les détails sur le routeur MSunPV sont sur le site de Ard-Tek.

📦 Installation via HACS (recommandé)

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Prérequis

  • Home Assistant version 2025.2.4 ou supérieure
  • HACS installé sur votre instance Home Assistant

Étape 1 — Ajouter le dépôt personnalisé dans HACS

HACS ne référence pas encore ce dépôt par défaut. Ajoutez-le manuellement.

  1. Dans Home Assistant, ouvrez HACS dans la barre latérale
  2. Cliquez sur les (trois points) en haut à droite
  3. Sélectionnez Dépôts personnalisés
  4. Dans le champ Dépôt, saisissez l'URL du dépôt GitHub :
    https://github.com/pvergezac/MSunPVIntegration
    
  5. Dans Catégorie, sélectionnez Intégration
  6. Cliquez sur Ajouter

Étape 2 — Installer l'intégration

  1. Toujours dans HACS, allez dans Intégrations
  2. Cliquez sur + Explorer et télécharger des dépôts
  3. Recherchez MSunPV Intégration
  4. Cliquez sur le résultat puis sur Télécharger
  5. Confirmez en cliquant sur Télécharger dans la fenêtre de confirmation

Étape 3 — Redémarrer Home Assistant

Après l'installation, un redémarrage est nécessaire :

Paramètres → Système → Redémarrer → Redémarrer Home Assistant

Attendez que Home Assistant soit complètement redémarré avant de continuer.


⚙️ Configuration

Étape 1 — Ajouter l'intégration

Paramètres → Appareils et services → Ajouter une intégration → MSunPV Intégration

Saisissez :

  • l'adresse locale de votre routeur.
    • Ex : http://192.168.xxx.xxx (http uniquement)
  • le nom désignant le routeur dans votre installation
  • l'activation ou non des sondes complémentaires 8 à 15


Notice for Developpement

HAVE FUN! 😎

What?

This repository contains multiple files, here is a overview:

File Purpose Documentation
.devcontainer.json Used for development/testing with Visual Studio Code. Documentation
.github/ISSUE_TEMPLATE/*.yml Templates for the issue tracker Documentation
custom_components/msunpv/* Integration files, this is where everything happens. Documentation
CONTRIBUTING.md Guidelines on how to contribute. Documentation
LICENSE The license file for the project. Documentation
README.md The file you are reading now, should contain info about the integration, installation and configuration instructions. Documentation
requirements.txt Python packages used for development/lint/testing this integration. Documentation

How?

  1. Open this repository in Visual Studio Code devcontainer (Preferably with the "Dev Containers: Clone Repository in Named Container Volume..." option).
  2. Run the scripts/develop to start HA and test out this integration.

🤝 Contribution

Les contributions sont les bienvenues ! Pour signaler un bug ou proposer une amélioration, ouvrez une issue sur GitHub.


📄 Licence

Ce projet est distribué sous licence MIT. Voir le fichier LICENSE pour plus de détails.


Fait avec ❤️ pour la communauté Home Assistant francophone

Si vous aimez ce projet, ajouter une ⭐ étoile sur [Github](https://github.com/pvergezac/![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/pvergezac/MSunPVIntegration/total) )

About

Home Assistant MSunPV solar router integration.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors