Captures d’écran Extraites du README de Veldkornet/ha-hyxi-cloud.
À propos
HYXI est une intégration Home Assistant pour les onduleurs solaires, les batteries et les compteurs HYXiPower. Les données arrivent soit par le HYXI Cloud avec un compte, soit par une liaison directe RS485 Modbus vers un seul onduleur, via une passerelle TCP ou un port série. Elle ajoute des capteurs pour la charge de la batterie, la puissance solaire, la consommation de la maison et le flux du réseau, ainsi que des capteurs binaires, des boutons, des nombres et des interrupteurs, et elle prend en charge le tableau de bord Énergie. Les entités de contrôle des modes de batterie, des objectifs de puissance et des seuils de protection restent masquées tant que Device Control & Protection n'est pas activé dans les options. Les fonctions facultatives comprennent l'envoi par webhook des données en direct et des alarmes, une fréquence d'interrogation réglable et un Energy Manager en version bêta qui gère la charge et la décharge de la batterie à partir d'un compteur P1 et des prévisions solaires. Une action de définition du mode de batterie est disponible pour les automatisations, et la configuration se fait dans l'interface.
Résumé automatique du README et du code de Veldkornet/ha-hyxi-cloud, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
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
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Comment Home Assistant doit-il accéder à votre système HYXI ?
- Méthode de connexion
Connexion à HYXI Cloud
- Clé d'accès (AK)
- Clé secrète (SK)
- Région du serveur
- Activer le push webhook en temps réelLorsqu'il est activé, HYXI envoie les données en temps réel et les alarmes à Home Assistant dès qu'elles surviennent. Cela nécessite une URL HTTPS publique accessible par le cloud HYXI ; la page suivante demande laquelle. Désactivé par défaut ; la fréquence d'envoi peut être définie plus tard dans les options.
URL de rappel du push
- URL de rappel personnalisée (optionnel, valeur par défaut dynamique)Facultatif. Une adresse HTTPS publique vers laquelle le cloud HYXI enverra les données push, si ce n'est ni Home Assistant Cloud ni l'URL externe de Home Assistant. Saisissez uniquement l'URL de base ; le chemin du webhook est ajouté automatiquement.
Comment le bus RS485 est-il connecté ?
- Type de connexion
Également demandé lors d’une modification de la connexion.
Passerelle Modbus TCP
- Hôte ou adresse IP de la passerelle
- Port
- Adresse esclave
Port série
- Périphérique série
- Débit en bauds
- Adresse esclave
Réauthentification HYXI Cloud
- Clé d'accès (AK)
- Clé secrète (SK)
- Région du serveur
Après la mise en place
- Intervalle de mise à jour (1-60 minutes, Défaut : 5)
- Intervalle de mise à jour (1-60 secondes, Défaut : 15)
- Activer la découverte via les alarmes (Avancé)
- Activer le contrôle et la protection de l'appareilActivez avec prudence si votre onduleur est déjà géré par votre fournisseur d'énergie ou inscrit à un programme de centrale électrique virtuelle (VPP). L'envoi de commandes pendant que votre fournisseur a le contrôle peut entrer en conflit avec son calendrier de répartition.
- Activer le Gestionnaire d'énergie autonome (Bêta)
- Activer le push webhook en temps réel
- Fréquence de mise à jour Push (millisecondes, plage : 5000-3600000)
- URL de rappel personnalisée (optionnel, valeur par défaut dynamique)
- Compteur intelligent P1 (capteur de puissance)
- Prévision solaire restante aujourd'hui (optionnel)
- Prévision solaire puissance actuelle (optionnel)
- Onduleur à contrôler
- Remplacer la capacité de la batterie
- Capacité de la batterie (Wh)
- Intervalle de la boucle de décision (secondes)
- Mode simulation (aucun appel API)
Textes issus du code de Veldkornet/ha-hyxi-cloud. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesÉtat de la Connexion, Problèmes Actifs, Mode nuit, Charge élevée détectée, Mode de fonctionnement
- BoutonsRedémarrer l'appareil, Mode : Inactif, Mode : Charge, Mode : Décharge, Mode : Autoconsommation, Mode de fonctionnement : Autoconsommation, Mode de fonctionnement : Secours réseau, Mode de fonctionnement : Heures tarifaires (TOU), Écrêtement des pics : Désactiver, Écrêtement des pics : Forcer la charge, Écrêtement des pics : Forcer la décharge, Écrêtement des pics : Arrêter et 7 autres
- NombresPuissance de charge cible, Puissance de décharge cible, Limite de puissance, Limite de puissance d'injection, SOC Minimum VPP, SOC de Début de Charge Forcée, SOC de Fin de Charge Forcée, SOC Minimum Hors Réseau, SOC de Réserve d'Autoconsommation, SOC Minimum de Décharge, SOC de Réserve de Secours, SOC de Charge Forcée et 23 autres
- CapteursNiveau de charge de la batterie, Puissance de la batterie, Puissance solaire, Consommation du foyer, Importation réseau, Exportation réseau, Batterie en charge, Batterie en décharge, Rendement énergétique total, Rendement énergétique total B, Rendement énergétique total C, Charge totale de la batterie et 137 autres
- InterrupteursContrôle de fréquence, Alimentation, Protection contre la décharge profonde, Charge Réseau Autorisée, Gestionnaire d'énergie, Assistance Batterie Charge Élevée, Mode Nuit, Limitation d'Export, Pilotage de la batterie
Actions
- Annuler l'abonnementAnnuler manuellement un abonnement push/alarme actif ou orphelin sur le serveur HYXI Cloud.Champs : Code d'abonnement, Entry
- Définir le mode de la batterieEnvoie une commande de mode de fonctionnement de la batterie à un onduleur HYXI. Nécessite que "Contrôle et protection de l'appareil" soit activé pour cette entrée, et est refusée tant que le Gestionnaire d'énergie pilote l'onduleur ciblé, sauf si Forcer est défini.Champs : Mode, Puissance, Forcer
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 :Le contrôle de la batterie n'est pas disponible via le HYXI Cloud, Energy Manager en pause : aucune donnée récente
Extrait du README
Monitor your HYXIPower solar production, battery, and grid flow in real-time.
Bring your HYXIPower inverter, battery, and meter data into Home Assistant — over the HYXI Cloud (your account, any supported device) or a direct Local Modbus (RS485) connection to one inverter (no account, no internet dependency).
- ☁️ Cloud or 📟 local — pull data through the HYXI Cloud API, or talk straight to one inverter over RS485 Modbus for faster polling and no internet dependency (Local Modbus).
- ⚡ Energy Dashboard ready — native support for Home Assistant's Energy Dashboard (setup).
- 🔄 Real-time push — optional webhook subscriptions for instant telemetry and alarm updates, bypassing the poll interval (details).
- 🔧 Device control — opt-in inverter mode buttons, charge/discharge power, peak shaving, battery protection, and microinverter controls (reference).
- 🔋 Energy Manager (Beta) — an automated battery engine that manages charge/discharge from your P1 meter, solar, SOC, and forecast (guide).
- 📊 Diagnostics — dedicated sensors for cloud connectivity, data freshness, and sync latency.
- 🛡️ Resilient — 100% test coverage, and glitch-filtering that rejects impossible energy spikes and dips from cloud reporting delays.
- 🕥 Adjustable polling — 1 to 60 minutes.
- 🌍 20+ languages — English, German, French, Dutch, Afrikaans, Portuguese, Spanish, Italian, and more.
S’affiche dans Vulpo :
carte Bascule rapide, carte Bouton, carte Graphique, Apple Watch, centre de contrôle.Informations
- Installations
- 53 partagent leurs statistiques
- Étoiles GitHub
- 15
- Connexion
- Utilise le cloud du fournisseur
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v1.7.0,
- Type
- Intégration de la Marketplace
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
hyxi_cloud- Problèmes
- Signaler un problème











