Beem Energy (intégration externe) — présentation de la v1.0.0
Bonjour à tous 
Je vous présente une nouvelle intégration externe pour Gladys : Beem Energy, pour suivre vos kits solaires Beem (BeemBox des kits 300 W, Beem On des kits 500 W). Ce sujet servira ensuite à annoncer les nouveautés et à recueillir vos retours.
C’est quoi ?
Une intégration externe Gladys qui tourne dans son propre conteneur, s’installe depuis le catalogue d’intégrations (rayon Énergie) et remonte la production de toutes les box de votre compte Beem, via le cloud Beem (les box n’ont pas d’accès local).
Ce qui est pris en charge
- Chaque box devient un appareil Gladys, avec :
- la puissance solaire en direct (W) ;
- un index de production (kWh), à relier au Suivi de l’énergie de Gladys pour voir votre production par demi-heure à côté de votre consommation ;
- la production du jour (kWh) ;
- le signal Wi-Fi (%).
- Toutes les box en une seule requête, toutes les 2 minutes par défaut.
- La nuit, une box en veille affiche 0 W, et non sa dernière puissance.
- Rien n’est perdu à minuit, au changement de mois ou pendant un arrêt de Gladys : l’index est recalculé à partir des totaux mensuels du cloud.
- Historique mensuel récupéré au démarrage (24 mois par défaut), pour l’année, le total et l’amortissement.
- Protection contre la limite de l’API Beem : le jeton est gardé une heure, et après un refus (429), l’intégration attend 20 minutes au lieu d’insister.
4 widgets de tableau de bord
Dans un tableau de bord : Modifier → Ajouter une boîte → Widgets d’intégrations.
- Box Beem : une box, avec sa courbe du jour, la part de sa puissance crête, le jour, le mois, le rendement en kWh/kWc (comparable entre un kit 300 W et un kit 500 W), le Wi-Fi, l’heure du dernier relevé et les panneaux.
Installation solaire : toute l’installation, en monophasé ou en triphasé. En triphasé, vous attribuez les box de chaque phase (L1, L2, L3) et obtenez une courbe par phase, une ligne par phase, l’équilibre des phases et les box en sous-production.
Économies solaires (estimation) : économies du jour, du mois, de l’année et au total. Avec le coût de vos kits, il affiche aussi la jauge et la date d’amortissement, plus le CO₂ évité et les économies des 12 derniers mois.
Historique de production : barres sur 30 jours ou 12/24 mois, records, comparaison avec l’an dernier, classement des box.
Les économies, comment ça marche ?
Un kit plug-and-play n’a pas de compteur réseau : l’estimation repose sur votre tarif, renseigné dans l’onglet Configuration.
- Tarif : Base ou Heures pleines / creuses. En HP/HC, le prix du kWh solaire est pondéré par les heures où vos panneaux produisent réellement.
- Taux d’autoconsommation : 100 % par défaut.
- Revente du surplus : optionnelle, si vous avez un contrat.
- Coût de l’installation : pour l’amortissement.
Scènes
- Déclencheur Box en sous-production : une box est muette 30 min alors que les autres produisent, ou rend bien moins qu’elles. Il se déclenche une fois par box et par jour, pratique pour détecter un micro-onduleur coupé ou un Wi-Fi perdu.
- Déclencheur Bilan de production du jour : se déclenche une fois la journée solaire terminée, avec les kWh du jour, l’économie, le CO₂ et la meilleure box. Idéal pour un message du soir : « 12,3 kWh aujourd’hui, 2,45 € économisés ».
- Action Lire la production solaire : puissance, jour, mois, année, part de la puissance crête et économies, d’une box ou de toute l’installation. Par exemple pour lancer le lave-vaisselle quand le soleil brille.
Installation
- Dans Gladys : Intégrations → cherchez Beem → Installer.
- Onglet Configuration : l’e-mail et le mot de passe de l’application Beem, puis Enregistrer. Le bouton Tester la connexion liste vos box.
- Vos box apparaissent dans l’onglet Découverte : créez-les.
- Optionnel : renseignez votre tarif pour les économies, et reliez l’index de production de chaque box dans Intégrations → Suivi de l’énergie.
La documentation complète est accessible depuis le lien « Documentation » de l’écran de configuration.
Prérequis
- Gladys ≥ 5.1.0.
- Un compte Beem avec vos box visibles dans l’application.
Bon à savoir
- Évitez de connecter le même compte Beem à plusieurs outils en même temps (Home Assistant, scripts…) : le cloud Beem bloque les comptes trop insistants.
- L’historique jour par jour s’accumule à partir de l’installation de l’intégration. Le cloud Beem ne fournit que l’historique mois par mois.
Retours bienvenus
L’API Beem n’est pas publique : merci à l’intégration Home Assistant CharlesP44/Beem_Energy qui a documenté ses échanges. Pour ma part, je la teste sur 6 box : 3 BeemBox (3 × 300 W) et 3 Beem On (2 × 500 W), une de chaque par phase.
- Les valeurs sont-elles cohérentes avec l’application Beem ?
- Si une valeur vous paraît fausse, le bouton Diagnostiquer les box de l’onglet Configuration affiche ce que le cloud remonte (sans e-mail, mot de passe ni jeton) : collez-le ici ou dans une issue.
Dépôt et notes de version : Releases · Terdious/gladys-beem-energy · GitHub
Mise à jour : v1.1.0 — un widget Box plus parlant
Coupures du jour
Face aux autres box
Pour en profiter