4. Entités Fournies par l'Intégration.md - CharlesP44/Beem_Energy GitHub Wiki

L'intégration Beem Energy crée plusieurs appareils et un ensemble d'entités dans Home Assistant pour vous permettre de suivre et de contrôler votre installation. Cette page détaille les entités les plus importantes et leur signification.

Vous pouvez retrouver toutes vos entités dans l'intégration Beem Energy ou dans Outils de développement → États en filtrant par beem_energy.


🔋 Appareil : Batterie Beem

C'est l'appareil principal qui représente votre système de stockage Beem. La plupart des capteurs importants y sont rattachés.

Capteurs de Puissance (en Watts, W)

Ces capteurs mesurent les flux d'énergie en temps réel. Ils sont parfaits pour les cartes de flux d'énergie comme power-flow-card-plus.

Entité Description Exemple de valeur
sensor.batterie_beem_XXXXX_solarpower Puissance totale générée par vos panneaux solaires. 1250 W
sensor.batterie_beem_XXXXX_batterypower Flux de la batterie. Positif = charge, Négatif = décharge. -300 W (décharge)
sensor.batterie_beem_XXXXX_meterpower Flux avec le réseau. Positif = injection, Négatif = consommation. -500 W (conso.)
sensor.batterie_beem_XXXXX_inverterpower Puissance gérée par l'onduleur. 1500 W

Capteurs de Flux Dérivés (toujours positifs)

Pour simplifier la configuration des tableaux de bord, l'intégration crée également des capteurs de flux qui sont toujours positifs.

  • sensor.batterie_beem_XXXXX_solarpower_production: Production solaire (identique à solarpower).
  • sensor.batterie_beem_XXXXX_batterypower_charging: Puissance de charge de la batterie.
  • sensor.batterie_beem_XXXXX_batterypower_discharging: Puissance de décharge de la batterie.
  • sensor.batterie_beem_XXXXX_meterpower_consumption: Puissance tirée du réseau.
  • sensor.batterie_beem_XXXXX_meterpower_injection: Puissance injectée dans le réseau.

Capteurs d'Énergie (en kWh)

Ces capteurs totalisent l'énergie au fil du temps. Ils sont essentiels pour le Tableau de Bord Énergie.

  • sensor.batterie_beem_XXXXX_solarpower_production_kwh: Énergie totale produite.
  • sensor.batterie_beem_XXXXX_batterypower_charging_kwh: Énergie totale chargée dans la batterie.
  • sensor.batterie_beem_XXXXX_batterypower_discharging_kwh: Énergie totale déchargée de la batterie.
  • sensor.batterie_beem_XXXXX_meterpower_consumption_kwh: Énergie totale consommée depuis le réseau.
  • sensor.batterie_beem_XXXXX_meterpower_injection_kwh: Énergie totale injectée dans le réseau.

Capteurs d'État de la Batterie

Ces capteurs fournissent des informations sur l'état et la configuration de votre batterie.

Entité Description
sensor.batterie_beem_XXXXX_soc État de charge (SoC) : Le pourcentage de charge actuel de la batterie.
sensor.batterie_beem_XXXXX_workingmodelabel Le mode de fonctionnement actuel de la batterie (ex: auto, advanced).
sensor.batterie_beem_XXXXX_globalsch État de santé (SoH) : Le pourcentage de santé global de la batterie.
sensor.batterie_beem_XXXXX_numberofcycles Le nombre total de cycles de charge/décharge effectués par la batterie.

Contrôles de la Batterie

Ces entités vous permettent d'interagir avec votre batterie directement depuis Home Assistant. Attention : la plupart de ces contrôles ne sont disponibles que si la batterie est en mode "avancé".

Entité Type Description
select.batterie_beem_XXXXX_mode select Permet de changer le mode de la batterie (auto, pause, advanced).
switch.batterie_beem_XXXXX_allow_charge_from_grid switch (Mode avancé) Autorise ou non la batterie à se charger depuis le réseau.
switch.batterie_beem_XXXXX_prevent_discharge switch (Mode avancé) Empêche ou non la batterie de se décharger.
number.batterie_beem_XXXXX_min_soc number (Mode avancé) Définit le seuil de charge minimum (SoC) de la batterie.
number.batterie_beem_XXXXX_max_soc number (Mode avancé) Définit le seuil de charge maximum (SoC) de la batterie.
select.batterie_beem_XXXXX_charge_power select (Mode avancé) Sélectionne la puissance maximale de charge depuis le réseau.

🔌 Appareil : Beem EnergySwitch

Si votre installation inclut un EnergySwitch, un appareil dédié sera créé avec les entités suivantes pour chaque canal (ex: ch0 et ch1).

Entité Description
sensor.es_YYYYY_ch0_power Puissance instantanée consommée sur le canal 0.
sensor.es_YYYYY_ch0_voltage Tension sur le canal 0.
sensor.es_YYYYY_ch0_current Courant sur le canal 0.
sensor.es_YYYYY_ch0_energy_active_total Énergie totale consommée (en Wh) sur le canal 0.
(et d'autres capteurs de mesure électrique...)

☀️ Appareil : BeemBox / PnP

Si votre installation inclut des BeemBox (kits "plug-and-play"), chaque boîtier apparaîtra comme un appareil distinct.

Entité Description
sensor.beembox_ZZZZZ_power Puissance de production instantanée de la BeemBox.
sensor.beembox_ZZZZZ_today Énergie totale produite aujourd'hui (en Wh).
sensor.beembox_ZZZZZ_month Énergie totale produite ce mois-ci (en Wh).
sensor.beembox_ZZZZZ_wifi Force du signal WiFi de la BeemBox.