À propos
Atmoce Battery est une intégration pour la surveillance et le contrôle en local des systèmes solaires et de batteries Atmoce via Modbus TCP. Elle ajoute des capteurs pour les valeurs du réseau, du solaire et de la batterie, un indicateur de problème de batterie et un bouton pour réinitialiser la passerelle. Le contrôle de la batterie via Modbus peut forcer la charge ou la décharge avec un niveau de charge cible, une durée, ou les deux, sans aucun compte. Avec une connexion facultative à atmocecloud.com, elle expose aussi les limites de la batterie et des règles permanentes comme la charge depuis le réseau et l'export, via des nombres, des sélecteurs et des interrupteurs. Un mode de secours facultatif de surveillance via le cloud couvre les pannes de la passerelle et nécessite des clés d'API partenaire délivrées par Atmoce. La configuration se fait dans l'interface, où le nombre de batteries détermine la capacité et les limites de puissance.
Résumé automatique du README et du code de pacorola/Atmoce_battery_HA, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
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.
Passerelle Atmoce - Connexion
- Hôte
- Port
- ID esclave Modbus (1-247)Ne le modifiez que si votre passerelle a été configurée avec un ID esclave différent de la valeur par défaut. Laissez 1 si vous n'êtes pas sûr.
Batteries
- Nombre de batteriesChaque unité ajoute 7 kWh, 3,75 kW de charge et 4,5 kW de décharge.
- Saisir les spécifications manuellementCochez cette case pour un autre matériel, ou si votre onduleur plafonne la puissance totale en dessous de la somme des unités.
Spécifications manuelles de la batterie
- Capacité utile (kWh)
- Puissance maximale de charge continue (kW)
- Puissance maximale de décharge continue (kW)
Compte atmocecloud.com (optionnel)
- Email atmocecloud.comL'email avec lequel vous vous connectez à atmocecloud.com ou à l'application ATMOZEN.
- Mot de passe atmocecloud.comLe mot de passe de ce même compte. Il est stocké dans votre Home Assistant et n'apparaît jamais dans les diagnostics.
Fallback de supervision Cloud (avancé)
- Activer le fallback de supervision CloudNe l'activez que si le support Atmoce vous a fourni app_key et app_secret ; sans elles, le formulaire ne vous laissera pas continuer.
- API app_key (Open API)Fournie par le support Atmoce. Ce n'est pas votre mot de passe et elle ne se génère pas depuis le portail.
- API app_secret (Open API)Fourni en même temps que l'app_key.
- Échecs Modbus avant bascule vers CloudNombre d'échecs Modbus consécutifs avant de basculer vers le Cloud.
Réauthentification - IP de la passerelle modifiée
- Hôte
- Port
Batteries installées
- Nombre de batteriesChaque unité MS-7K-U ajoute 7 kWh, 3,75 kW de charge et 4,5 kW de décharge. Une MS-14K-U compte pour deux unités.
Après la mise en place
- Échecs Modbus avant bascule vers CloudNombre d'échecs Modbus consécutifs avant de basculer vers le Cloud.
- Activer le fallback de supervision CloudNe l'activez que si vous disposez d'app_key et app_secret.
- API app_key (Open API, optionnel)À demander au support Atmoce. Laissez vide si vous ne l'avez pas.
- API app_secret (Open API, optionnel)Fourni en même temps que l'app_key. Laissez vide si vous ne l'avez pas.
- Email atmocecloud.com (pour les limites de batterie)L'email avec lequel vous vous connectez à atmocecloud.com ou à l'application ATMOZEN.
- Mot de passe atmocecloud.comLe mot de passe de ce même compte. Il est pré-rempli avec celui enregistré : si vous l'effacez, il sera également effacé de la configuration.
Textes issus du code de pacorola/Atmoce_battery_HA. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesProblème de batterie
- BoutonsRedémarrer la passerelle
- NombresCharge cible forcée, Durée forcée, Puissance forcée, Puissance de consigne, Limite de charge, Limite de décharge, Réserve de sécurité, Puissance de recharge réseau, Limite de recharge réseau, Puissance d'export, Exporter au-dessus de
- SélecteursCommande de la batterie, Type de mode forcé, Mode autogéré
- CapteursTension du réseau, Courant du réseau, Puissance du réseau, Énergie réseau aujourd'hui, Énergie réseau totale, Électricité vendue aujourd'hui, Électricité vendue au total, Puissance solaire, Énergie solaire aujourd'hui, Énergie solaire totale, Autoconsommation solaire, Charge de la batterie et 12 autres
- InterrupteursContrôle à distance, Recharge depuis le réseau, Export vers le réseau
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Extrait du README
Full local control and monitoring of Atmoce solar + battery systems over Modbus TCP, plus the settings that only exist in the Atmoce portal.
Fully tested and working with the Atmoce MS-7K-U (7 kWh LFP battery). Should be compatible with MC100, MC100-T and MG100 gateways. Try it on your installation and please report back so anything broken can be fixed.
- 24 sensors and a problem binary sensor — grid, solar, battery, plus computed autonomy and self-consumption
- Battery control over Modbus — force charge or discharge with a target SOC, a duration, or both. Entirely local; no account needed
- Battery limits — end-of-charge, end-of-discharge and backup reserve, which Modbus does not expose. Needs your ordinary atmocecloud.com login
- Standing policy — self-powered or time-of-use, grid charging and export, each with its own power cap and SOC bound. Also from the portal
- Battery count in setup — say how many units you have and capacity and power limits follow, changeable later via Reconfigure without reinstalling
- Cloud monitoring fallback (optional, rarely needed) if the gateway stops answering over Modbus. Requires partner API keys that Atmoce issues to installers
- Diagnostics — full state export with credentials and site identity redacted
- Trilingual — English, Spanish and French, entity names and select options included
S’affiche dans Vulpo :
carte Bascule rapide, carte Bouton, carte Sélection, carte Graphique, Apple Watch, centre de contrôle.Informations
- Installations
- 68 partagent leurs statistiques
- Étoiles GitHub
- 16
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v1.5.5,
- Type
- Intégration de la Marketplace
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
atmoce- Problèmes
- Signaler un problème
