Captures d’écran Extraites du README de windsurf/hassio-zendure-restapi.
À propos
Zendure RestAPI est une intégration locale pour les batteries Zendure SolarFlow qui maintient la connexion au réseau proche de zéro. Elle communique directement avec la batterie, sans compte cloud ni broker MQTT, et s'ajoute dans l'interface avec l'adresse IP de la batterie et son port HTTP. Une boucle de régulation lit le compteur du réseau chaque seconde, charge la batterie avec le surplus solaire et la décharge pour couvrir la consommation de la maison. Le compteur peut être un appareil HomeWizard, YouLess ou Shelly P1 lu via IP, ou n'importe quel capteur de puissance de Home Assistant. Le contrôle des prix planifie la charge et la décharge à partir d'un capteur de prix pour les tarifs dynamiques, et un mode à prix fixe stocke le surplus solaire sans capteur de prix. Elle ajoute des capteurs, des nombres, des sélecteurs, des interrupteurs, des boutons et des capteurs binaires, ainsi qu'un tableau de bord généré avec les vues Price Control et History.
Résumé automatique du README et du code de windsurf/hassio-zendure-restapi, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
S’affiche dans Vulpo :
carte Bascule rapide, carte Bouton, carte Sélection, carte Graphique, Apple Watch, centre de contrôle.Prise en charge
- Fonctionne en localCommunique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
- Détection automatiqueHome Assistant la repère sur le réseau et propose de l’ajouter.
- Depuis la MarketplaceS’installe depuis la Marketplace, anciennement HACS.
- Maintenance activeSon auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Interrupteurs
- Capteurs
Mise en place
Installe l’intégration depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Vérifier le compteur
- Le compteur indique l'injection en positif (inverser le signe)
Appareil Zendure
- Adresse IP
- Port HTTP
- Créer le tableau de bord Zendure RestAPI (batterie uniquement)
Appareil Zendure trouvé
- Créer le tableau de bord Zendure RestAPI
Compteur réseau externe via IP
- Type de compteur
- Adresse IP
- Millisecondes entre les interrogations (100-1000 ; sous 1000 uniquement pour YouLess)
Capteur Home Assistant
- Capteur de puissance (soutirage positif)
- Capteur d'injection (facultatif, injection positive)
- Le compteur indique l'injection en positif (inverser le signe)
Pilotage par le prix
- Batterie ou cluster
- Capteur de prix (prix par kWh)Prix fixes : tout capteur donnant le prix actuel. Plan journalier : un capteur avec une liste de prix — Nord Pool (HACS), EPEX Spot (HACS), Zonneplan, ENTSO-e ou Frank Energie.
- Le capteur de prix contientPour le plan journalier. Nord Pool (HACS) avec TVA et sans coûts supplémentaires : prix spot TTC. Sans TVA : prix spot. Avec tout votre tarif dans les coûts supplémentaires : prix d'achat. EPEX Spot : capteur Market price : prix spot ; capteur Total price : prix d'achat. Zonneplan : prix d'achat.
Appareil de mesure
- Appareil
Cluster virtuel (simulé)
- Batterie à copierLes copies reprennent son modèle, ses valeurs maximales, ses limites de SOC et ses réglages ; la première copie démarre avec son niveau de charge.
Après la mise en place
- Secondes entre les interrogations (1-60)
- Puissance solaire hors batterie (facultatif, pour le tableau de bord)Une prise connectée sur un micro-onduleur ou un second onduleur. Les séries PV du tableau de bord l'affichent : à la place du PV de la batterie s'il n'est pas utilisé, à côté sinon. La régulation n'en a pas besoin, le compteur réseau voit déjà cette puissance.
- Énergie solaire hors batterie (facultatif, pour le tableau de bord)Son compteur kWh, pour les totaux journaliers de l'onglet History.
- Réinitialiser les réglages : les réglages de la régulation à leurs valeurs par défautMarges et seuils de démarrage 5 W, Arrêter la charge en dessous de 50 W, Arrêter la décharge en dessous de 50 W, Arrêter après 30 s, Démarrer après 30 s, puissance de charge et de décharge min. 0 W, Seuil du mode 10 W, Seuil de correction 40 W, force de correction 80 %, Délai de changement de sens 10 s. Operation mode, puissance de charge et de décharge max., protection SOC, le compteur et Price Control restent tels quels. Dans un cluster, les réglages du groupe s'appliquent.
- Reconstruire le tableau de bord (vos modifications sont perdues)
- Adresse IP
- Millisecondes entre les interrogations (100-1000 ; sous 1000 uniquement pour YouLess)
- Capteur de puissance (soutirage positif)
- Capteur d'injection (facultatif, injection positive)
- Le compteur indique l'injection en positif (inverser le signe)
- Capteur de prix (prix par kWh)Prix fixes : tout capteur donnant le prix actuel. Plan journalier : un capteur avec une liste de prix — Nord Pool (HACS), EPEX Spot (HACS), Zonneplan, ENTSO-e ou Frank Energie.
- Le capteur de prix contientPour le plan journalier. Nord Pool (HACS) avec TVA et sans coûts supplémentaires : prix spot TTC. Sans TVA : prix spot. Avec tout votre tarif dans les coûts supplémentaires : prix d'achat. EPEX Spot : capteur Market price : prix spot ; capteur Total price : prix d'achat. Zonneplan : prix d'achat.
- Le compteur indique l'injection en positif (inverser le signe)
- Compteur externe
- Reconstruire le tableau de bord (vos modifications sont perdues)
- Réinitialiser les copies : chaque copie s'arrête et redémarre autour de l'état de charge de votre batterieLes copies s'arrêtent, les deux limites passent à 0, et chacune redémarre au niveau de charge de ta batterie plus son décalage de SoC.
- Réinitialiser les réglages : chaque réglage du cluster virtuel et de ses copies revient à sa valeur par défautCopies 3, Load factor 1, écarts de SoC 0 / -20 / 15 %, temps de réponse supplémentaire 0 / 1 / 3 s, Max share 0, Operation mode Follow source, marges et seuils de démarrage 5 W, Arrêter la charge en dessous de 50 W, Arrêter la décharge en dessous de 50 W, Arrêter après 30 s, Démarrer après 30 s, Concentrate below 300 W, Redistribute every 30 s. Les copies continuent de tourner ; cochez aussi Réinitialiser les copies pour les démarrer avec les nouveaux écarts. Votre propre batterie et Price Control ne sont pas modifiés.
- Reconstruire le tableau de bord (vos modifications sont perdues)
Textes issus du code de windsurf/hassio-zendure-restapi. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesDonnées prêtes, Contact sec, Ventilateur, Réseau connecté, Chauffage, Commande batterie HV, Erreur, Lampe, Passage direct, Couplage PV-AC, Flux inverse, Compensation SOC et 1 autre
- BoutonsReset, Reconstruire le tableau de bord
- NombresIntervalle de calibration, Marge de charge, Rendement de charge, Puissance de charge maximale, Prix bas, Délai de changement de sens, Marge de décharge, Rendement de décharge, Consommation attendue de la maison, Prix élevé, Facteur de revente, Supplément de revente et 30 autres
- SélecteursSource du compteur, Mode du convertisseur, Mode secours, Export PV, Mode du ventilateur, Compteur externe, Décision, Mode à prix bas, Mode à prix élevé, Norme réseau, Mode intermédiaire, Mode de fonctionnement et 1 autre
- CapteursPalier du ventilateur, État de la batterie, État AC, État DC, État PV, État de la limite SOC, État de calibration SOC, État du régulateur, État, Plan, Puissance apparente phase A, État du couplage AC et 78 autres
- InterrupteursVentilateur forcé, Compensation nette (injection = prix d'achat), Ne pas écrire en flash, Enregistrement de trace, Participer
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
- Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :A redémarré avec une limite, Signale de nouvelles propriétés
Extrait du README
Your Zendure SolarFlow battery in Home Assistant, 100% local, in three steps. No cloud account, no MQTT broker, no YAML packages to copy. Install it from HACS, add your battery, pick a mode — the battery holds your grid at zero, once a second.
⚖️ Zero export, once a second. The battery holds your grid connection at zero (Dutch: nul op de meter, NOM). A fast loop reads your meter every second and corrects evenly on both sides of zero: what your solar panels would send to the grid goes into the battery, and what the house would take from the grid comes out of it, without swinging from one to the other.
Informations
- Installations
- 74 partagent leurs statistiques
- Étoiles GitHub
- 14
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v1.7.6,
- Catégorie
- Énergie, Solaire et batteries
- Type
- Intégration de la Marketplace
- Marque
- Zendure
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
zendure_restapi- Problèmes
- Signaler un problème
















