Captures d’écran Extraites du README de nicois/foxess-control.
À propos
FoxESS Control est une intégration de la Marketplace pour Home Assistant.
Prise en charge
Utilise le cloud du fournisseur Nécessite une connexion internet et un compte chez le fournisseur.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
FoxESS Control
- Clé API
- Numéro de série de l'appareil
FoxESS Control — mode entité
- Entité de mode de fonctionnement (select)
- Entité de limite de puissance de charge (number)
- Entité de limite de puissance de décharge (number)
- Entité de SoC minimum (number)
- Entité de SoC de la batterie (sensor)
- Entité de puissance de consommation de la maison (sensor)
- Entité de puissance de production solaire (sensor)
- Entité d'énergie d'injection cumulée (sensor)
- Entité de puissance de charge de la batterie (sensor)
- Entité de puissance de décharge de la batterie (sensor)
- Entité de puissance de consommation réseau (sensor)
- Entité de puissance d'injection réseau (sensor)
- Entité de limite maximale d'injection réseau (number, facultatif — active l'atténuation par actionneur matériel)
- Puissance nominale de l'onduleur (W)
FoxESS Control — batterie
- SoC minimum sur le réseau (%)
- Capacité de la batterie (kWh)
- Changement de puissance minimum pour la charge intelligente (W)
Données en temps réel (facultatif)
- Web Username
- Mot de passe web (ou hachage MD5)
Après la mise en place
- SoC minimum sur le réseau (%)
- Capacité de la batterie (kWh)
- Changement de puissance minimum pour la charge intelligente (W)
- fdSoc API minimum (%) — ⚠️ Les valeurs inférieures à 11 peuvent ne pas fonctionner avec toutes les versions de firmware
- Intervalle d'interrogation API (secondes)
- Intervalle d’interrogation de la température BMS (secondes)
- Marge intelligente (%)
- Limite d’export réseau (W) : plafond réglé sur l’onduleur (0 = aucune limite)
- Mode de données en temps réel WebSocket
- Variable de puissance solaire supplémentaireOptionnel. Pour les systèmes couplés en CA où la production d'un second onduleur est rapportée dans une variable FoxESS distincte (par ex. meterPower2). Sa valeur est ajoutée à la lecture solaire. Laisser vide sinon.
- Entité du mode de fonctionnement (sélecteur)
- Entité de la limite de puissance de charge (nombre)
- Entité de la limite de puissance de décharge (nombre)
- Entité du SoC minimal (nombre)
- Entité du SoC de la batterie (capteur)
- Entité de la puissance de consommation de la maison (capteur)
- Entité de la puissance de production solaire (capteur)
- Entité de l’énergie cumulée injectée dans le réseau (capteur)
- Entité de la puissance de charge de la batterie (capteur)
- Entité de la puissance de décharge de la batterie (capteur)
- Entité de la puissance de consommation du réseau (capteur)
- Entité de la puissance d’injection dans le réseau (capteur)
- Entité de limite d’export réseau max. (nombre, facultatif : active la réduction progressive matérielle)
- Puissance nominale de l’onduleur (W)
Textes issus du code de nicois/foxess-control. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesCharge intelligente active, Décharge intelligente active
- CapteursSoC batterie, Puissance de charge, Puissance de décharge, Consommation maison, Puissance solaire, Température batterie, BMS Battery Temperature, Consommation réseau, Injection réseau, Production, Tension batterie, Courant batterie et 31 autres
Actions
- Effacer les forçagesRemettre l'onduleur en mode autoconsommation en effaçant tous les forçages ou ceux sélectionnés.Champs : Mode
- Injection réseauInjecter l'excédent solaire dans le réseau pendant une durée définie, éventuellement à une heure et une limite de puissance spécifiques.Champs : Durée, Limite de puissance, Heure de début, Supprimer les forçages en conflit au lieu d'abandonner
- Charge forcéeCharger la batterie pendant une durée définie, éventuellement à une heure et une limite de puissance spécifiques.Champs : Durée, Limite de puissance, Heure de début, Supprimer les forçages en conflit au lieu d'abandonner
- Décharge forcéeDécharger la batterie pendant une durée définie, éventuellement à une heure et une limite de puissance spécifiques.Champs : Durée, Limite de puissance, Heure de début, Supprimer les forçages en conflit au lieu d'abandonner
- Charge intelligenteCharger la batterie dans une fenêtre horaire, en régulant la puissance de charge pour atteindre un SoC cible à la fin de l'intervalle. La charge peut démarrer en retard si l'objectif peut être atteint en moins de temps.Champs : Heure de début, Heure de fin, SoC cible, Puissance maximale, Supprimer les forçages en conflit au lieu d'abandonner
- Décharge intelligenteDécharge la batterie dans une fenêtre temporelle. Reste en autoconsommation le plus longtemps possible, puis passe en décharge forcée à pleine puissance lorsque nécessaire pour atteindre l'objectif avant la fin de la fenêtre. Revient en autoconsommation lorsque le SoC minimum ou la limite d'énergie d'injection est atteint.Champs : Heure de début, Heure de fin, Limite de puissance, SoC minimum pour arrêter la décharge, Limite d’énergie injectée, Supprimer les forçages en conflit au lieu d'abandonner
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 :Mode de fonctionnement non géré détecté, La charge intelligente ne peut pas atteindre le SoC cible
Extrait du README
A Home Assistant custom integration for monitoring and controlling FoxESS inverter battery modes.
FoxESS Control polls real-time inverter data (battery SoC, charge/discharge power, solar generation, house load, temperature) and provides actions for force charge, force discharge, smart charge/discharge with SoC targets, and feed-in management. It supports two backends: the FoxESS Cloud API and local entity mode via foxess_modbus. It includes comprehensive polled sensors and can fully replace the foxess-ha integration — see Migrating from foxess-ha.
S’affiche dans Vulpo :
carte Graphique, Apple Watch.Informations
- Installations
- 121 partagent leurs statistiques
- Étoiles GitHub
- 21
- Connexion
- Utilise le cloud du fournisseur
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v1.0.21,
- Catégorie
- Énergie, Solaire et batteries
- Type
- Intégration de la Marketplace
- Marque
- FoxESS
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
foxess_control- Problèmes
- Signaler un problème
