Intégration domotique Beem Energy, gratuite et open source
Suivez vos kits solaires Beem (BeemBox, Beem On) : production, historique, économies.
Publiée par Terdious
- Appareils
- Version 1.2.2
- Nécessite Gladys >=5.1.0
- ★ 0
Suivez vos kits solaires Beem (BeemBox des kits 300 W, Beem On des kits 500 W) dans Gladys Assistant : puissance produite en direct, production du jour, du mois, de l'année et depuis le début, signal Wi-Fi de chaque box, estimation des économies et de l'amortissement, alertes quand une box produit moins que les autres.
L'intégration lit le cloud Beem, avec le compte de l'application Beem : les box Beem n'offrent aucun accès local.
Prérequis
- Un compte Beem, avec vos box déjà installées et visibles dans l'application Beem.
- Gladys Assistant 5.1 ou plus récent.
Fonctionnalités
Chaque box du compte devient un appareil Gladys, avec :
| Fonctionnalité | Catégorie / type | Unité |
|---|---|---|
| Puissance solaire | energy-production-sensor / power | W |
| Production solaire (index) | energy-production-sensor / index | kWh |
| Production aujourd'hui | energy-production-sensor / daily-production | kWh |
| Signal Wi-Fi | signal / integer | % |
- Toutes les box en une requête : le cloud Beem répond pour toutes les box du compte d'un coup, lues toutes les deux minutes par défaut (une minute au minimum : le cloud rafraîchit une box environ chaque minute).
- Une box en veille la nuit (alimentée par ses panneaux, elle s'éteint au crépuscule) affiche 0 W au lieu de sa dernière puissance, dès que son dernier relevé a plus de 15 minutes.
- L'index de production est la fonctionnalité que le suivi de l'énergie de Gladys transforme en production par demi-heure. Le cloud Beem ne donne que la production du jour et du mois : l'intégration calcule son propre index à partir du total du mois, et récupère le total final du mois précédent au changement de mois. Rien n'est perdu à minuit, ni pendant un arrêt du conteneur : le relevé suivant rattrape la production manquée.
- Historique : au démarrage, l'intégration demande au cloud Beem la production des mois passés (24 par défaut, une requête toutes les quelques secondes, une seule fois par mois : un mois passé ne change plus), puis celle des jours passés (historique horaire, une semaine par requête ; si le cloud tarde à répondre, la récupération reprend d'elle-même une heure plus tard, sans redémarrage ni clic). Les chiffres de l'année, le total, les économies, l'amortissement et la navigation dans les widgets en partent.
- Le badge de transport indique cloud pour une box présente dans le relevé du cloud, injoignable pour une box qui en est absente.
Relier la production au suivi de l'énergie
Dans Intégrations → Suivi de l'énergie, ajoutez la fonctionnalité Production solaire (index) de chaque box : Gladys en déduit la production par demi-heure et l'affiche dans ses tableaux de l'énergie, à côté de votre consommation.
Configuration
| Champ | Rôle |
|---|---|
| E-mail, Mot de passe | Le compte de l'application Beem (le mot de passe n'est jamais journalisé). |
| Intervalle de rafraîchissement | Secondes entre deux lectures du cloud (60 à 3600, 120 par défaut). |
| Mois d'historique | Mois récupérés au démarrage (0 à 120, 24 par défaut, 0 désactive). |
| Langue des noms | Langue des noms de fonctionnalités des nouvelles box (anglais, français). |
| Fuseau horaire | Les jours et mois du cloud Beem, les heures creuses et le bilan du jour. |
| Tarif, prix… | L'estimation des économies (voir plus bas). |
| Seuil de sous-production | Les alertes (voir plus bas). |
Le bouton Tester la connexion se connecte au cloud et liste les box trouvées.
Widgets du tableau de bord
Le titre de la carte est le nom du widget ; donnez un titre dans ses réglages pour en afficher un autre (une box affiche toujours son nom).
Quatre widgets, à ajouter depuis Tableau de bord → Modifier → Ajouter un widget :
- Box Beem : une box. Courbe de puissance du jour (moyennes sur
5 minutes) avec, en regard, la courbe attendue : ce que la box produirait
au même rendement que les autres box (production par kWc), pour repérer d'un
coup d'œil une box en dessous de ses voisines. Jauge de la puissance par
rapport à la puissance crête, puissance en direct, production du jour et du
mois, rendement du jour (kWh par kWc installé, comparable entre un kit
300 W et un kit 500 W). En dessous : heure du dernier relevé (« en veille » la
nuit), signal Wi-Fi (dBm et %), coupures du jour (les moments d'au moins
5 minutes où la box n'a rien produit alors que les autres produisaient, avec
l'heure de la dernière : utile pour une box qui se connecte et se déconnecte),
rendement face aux autres box (en % de la médiane, ou l'alerte de
sous-production), panneaux (nombre, puissance, orientation en clair :
SE -30°= 30° vers l'est depuis le sud, et inclinaison∠30°), hier, l'année, et le total depuis le premier mois connu. - Installation solaire : toute l'installation, en monophasé (les box choisies, ou toutes) ou en triphasé : attribuez les box de chaque phase (L1, L2, L3) dans les réglages du widget. Périodes : 12 heures et jour (courbe de puissance, une courbe par phase en triphasé), semaine et mois (production par jour), année (production par mois). Sur la journée en cours : puissance, jour, mois, année, part de la puissance crête, une ligne par phase (puissance · production du jour), l'équilibre des phases (en alerte au-delà du seuil réglé, 500 W par défaut), les box muettes ou à faible rendement. Sur une autre période : production, puissance max ou moyenne par jour, meilleur jour, rendement par kWc et la part de chaque phase. Les erreurs d'attribution (une box dans deux phases, ou dans aucune) sont toujours signalées.
- Économies solaires : économies par mois (barres par jour), par année (par mois) ou sur toutes les années ; économie et production de la période, jauge et date d'amortissement, total depuis le début, valeur d'un kWh solaire, parts autoconsommée et injectée de la période, CO2 évité.
- Historique de production : production par mois (barres par jour), par année (par mois) ou sur toutes les années ; production, moyenne et meilleur jour / mois / année de la période, comparaison à la même période un an plus tôt (à jours ou mois égaux), classement des box sur la période (avec leur rendement par kWc). Le réglage Période par défaut choisit la période affichée d'abord.
Changer de période et naviguer
Comme sur les graphiques de Gladys, les widgets Installation, Économies et Historique ont leurs boutons :
- Période (le nom de la période affichée) : ouvre un choix des périodes du widget. Revient à la période en cours.
- Précédent / Suivant : recule ou avance d'une période (jour, semaine, mois, année…). Précédent n'apparaît que s'il y a des données avant, Suivant qu'une fois revenu en arrière.
La période est indiquée dans le titre du graphique. Elle est retenue par widget (par réglages) tant que l'intégration tourne : deux tableaux de bord affichant le même widget avec les mêmes réglages partagent la même période, et un redémarrage revient à la période par défaut. Sur un Gladys antérieur à 5.2, le bouton Période passe simplement à la période suivante.
Données : les courbes de puissance sont gardées 14 jours (moyennes sur 5 minutes). La production jour par jour des jours passés est récupérée au démarrage depuis l'historique horaire de l'application Beem (jusqu'à 400 jours, une semaine par requête) ; l'action Diagnostiquer les box indique combien de jours chaque box a. Les mois viennent de l'historique mensuel.
Exemple : 3 phases, 6 box
Pour 3 BeemBox (3 kits 300 W chacune) et 3 Beem On (2 kits 500 W chacune), une BeemBox et une Beem On par phase : ajoutez le widget Installation solaire, choisissez Triphasée, puis mettez dans Box de la phase L1 la BeemBox et la Beem On de L1, et ainsi de suite. Chaque phase affiche 1,9 kWc ; l'installation 5,7 kWc.
Économies (estimation)
Un kit plug-and-play n'a pas de compteur réseau : rien ne dit quelle part de la production le logement a consommée et quelle part est partie sur le réseau. L'estimation repose donc sur vos chiffres :
valeur d'un kWh produit = taux d'autoconsommation × prix solaire
- (1 − taux) × prix de revente (0 sans contrat de revente : le surplus d'un kit sans contrat est injecté gratuitement)
- Tarif : Base (un prix) ou Heures pleines / creuses (deux prix et les
plages des heures creuses, ex.
22:00-06:00ou02:00-07:00,13:00-16:00). En heures pleines / creuses, le prix solaire est pondéré par le moment où les panneaux produisent : la courbe mesurée des deux derniers jours, ou une courbe de jour standard au début. Des heures creuses la nuit donnent un prix solaire proche du prix des heures pleines ; des heures creuses en début d'après-midi le font baisser. - Taux d'autoconsommation : 100 % par défaut, réaliste pour un kit dimensionné sur la consommation de fond du logement. Baissez-le si votre compteur indique souvent de l'injection.
- Revente : si vous avez un contrat de revente du surplus, cochez la case et donnez le prix.
- Coût de l'installation : ce que vous avez payé les kits (et leur pose). Le widget affiche alors la part amortie et la date d'amortissement, au rythme des 12 derniers mois complets.
- CO2 évité : l'intensité carbone de l'électricité du réseau que votre production remplace (50 g par kWh par défaut, ordre de grandeur du mix français ; 0 masque le chiffre).
Les économies sont recalculées à partir de l'énergie et du tarif actuel : un changement de prix s'applique aussi au passé. C'est une estimation, pas une facture.
Alertes et scènes
Box en sous-production
Les box sont comparées entre elles, à taille égale (production par kWc installé) :
- Muette : une box qui ne produit rien pendant 30 minutes alors que les autres produisent (micro-onduleur éteint, Wi-Fi perdu, disjoncteur…).
- Rendement faible : à partir de 14 h, une box dont le rendement du jour est sous le seuil de sous-production (60 % par défaut) du rendement médian des box, un jour assez ensoleillé pour comparer (0,5 kWh/kWc au moins). Si vos box ont des orientations très différentes, baissez le seuil ; 0 désactive la détection.
L'alerte apparaît sur les widgets et déclenche le déclencheur de scène Box en
sous-production (filtres : la box, la raison), une fois par box et par jour.
Variables : device_name, reason (silent ou low_yield), ratio (% du
rendement des autres), today_kwh.
Bilan de production du jour
Le déclencheur Bilan de production du jour se déclenche une fois par jour,
quand la journée solaire est finie (toutes les box à 0 W depuis 30 minutes après
16 h, ou à 22 h au plus tard). Variables : today_kwh, month_kwh,
yield_kwh_per_kwp, savings, co2_kg, best_box, best_box_kwh. Par exemple,
un message : « ☀️ Production du jour : {{triggerEvent.data.today_kwh}} kWh,
{{triggerEvent.data.savings}} € économisés ».
Lire la production solaire
L'action de scène Lire la production solaire renvoie les chiffres actuels
d'une box, ou de toute l'installation si aucune box n'est choisie :
power_w, today_kwh, month_kwh, year_kwh, load_percent (part de la
puissance crête), savings_today, savings_month. Par exemple, une condition
« si power_w > 1500 » pour lancer le lave-vaisselle quand le soleil brille.
Mettre à jour l'intégration
Installée depuis le catalogue (le cas habituel) : quand une nouvelle version
sort, l'intégration affiche un badge « Mise à jour disponible » et son onglet
Supervision propose la version, avec un lien vers ses notes. Cliquez sur
Mettre à jour : Gladys récupère la nouvelle image et le nouveau manifest.
Votre configuration, vos appareils et l'historique (dans /data) sont
conservés.
Installée en mode développeur (manifest collé à la main) : « Forcer la mise à jour » ne fait que récupérer à nouveau l'image ; recollez le manifest à jour pour récupérer les nouveaux champs.
Dépannage
- « Le cloud Beem a refusé l'e-mail ou le mot de passe » : utilisez les identifiants de l'application Beem (pas ceux du site de commande).
- « Limite de l'API Beem atteinte » : le cloud Beem bloque un compte qui se connecte trop souvent. L'intégration garde son jeton une heure et, après un refus, attend 20 minutes avant de réessayer. Évitez de connecter le même compte à plusieurs outils en même temps (Home Assistant, scripts…), ou augmentez l'intervalle de rafraîchissement.
- Une box est injoignable : elle est absente du relevé du cloud. Vérifiez qu'elle apparaît dans l'application Beem.
- Pas d'historique : lancez l'action Recharger l'historique (par exemple après avoir ajouté une box au compte).
Diagnostic
L'action Diagnostiquer les box affiche, pour chaque box, ce que le cloud remonte maintenant (puissance, jour, mois, signal, dernier relevé) et ce que l'intégration conserve (index, mois d'historique). Joignez-la à un ticket : elle ne contient ni e-mail, ni mot de passe, ni jeton.
Remerciements
Le cloud Beem n'a pas d'API publique : les adresses et les champs utilisés ont été documentés par la communauté, notamment l'intégration Home Assistant CharlesP44/Beem_Energy (licence MIT). Le code de cette intégration est original.
Paramètres de configuration
Voici les paramètres demandés par Beem Energy dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Compte Beem | section | Non | Connectez-vous avec l'e-mail et le mot de passe de l'application Beem. L'intégration lit toutes les box solaires du compte via le cloud Beem (il n'existe pas d'accès local). |
string | Oui | ||
| Mot de passe | secret | Oui | |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture du cloud Beem, en secondes (une minute minimum : le cloud rafraîchit une box environ chaque minute et limite les comptes trop insistants). |
| Mois d'historique | number | Non | Production mensuelle récupérée du cloud Beem au démarrage (année, total, économies et amortissement). 0 la désactive. |
| Langue des noms de fonctionnalités | select | Non | Appliquée aux box découvertes à partir de maintenant. |
| Fuseau horaire | string | Non | Nom IANA : les jours et mois du cloud Beem, les heures creuses et le bilan du jour le suivent. |
| Estimation des économies | section | Non | Sans compteur réseau, les économies sont une estimation : la production multipliée par le prix de l'électricité qu'elle vous évite d'acheter, plus la revente du surplus si vous avez un contrat. Laissez le mode sur Aucun pour les masquer. |
| Tarif d'électricité | select | Non | |
| Prix base (par kWh) | number | Non | |
| Prix heures pleines (par kWh) | number | Non | |
| Prix heures creuses (par kWh) | number | Non | |
| Heures creuses | string | Non | Plages HH:MM-HH:MM séparées par des virgules, dans le fuseau ci-dessus. |
| Taux d'autoconsommation (%) | number | Non | Part de la production consommée sur le moment par le logement. Un kit dimensionné sur le talon est proche de 100 % ; baissez-le si le compteur indique souvent de l'injection. |
| Je revends mon surplus | boolean | Non | Désactivé : le surplus est injecté gratuitement (cas habituel d'un kit plug-and-play). |
| Prix de revente (par kWh) | number | Non | |
| Coût de l'installation | number | Non | Ce que vous avez payé les kits (et leur pose) : le widget des économies en affiche l'amortissement. |
| CO2 évité (g par kWh) | number | Non | Intensité carbone de l'électricité du réseau que votre production remplace. 0 masque le chiffre. |
| Alertes | section | Non | Les box de l'installation sont comparées entre elles (production par kWc installé) : une box muette pendant que les autres produisent, ou très en dessous d'elles, est signalée sur le tableau de bord et déclenche le déclencheur de scène « Box en sous-production ». |
| Seuil de sous-production (%) | number | Non | Une box est signalée sous cette part du rendement médian des box. 0 désactive la détection. |
Comment installer Beem Energy dans Gladys
- Dans Gladys, ouvrez Intégrations : Beem Energy apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/terdious/gladys-beem-energy:1.2.2), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/Terdious/gladys-beem-energy.
Beem Energy nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Beem Energy est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par Terdious, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation