neoom
Inbetriebnahme neoom Ai

neoom BEAAM Daten über lokale BEAAM API in Home Assistant abbilden

Aktualisiert am 10.11.2026

Inhaltsübersicht

Möglichkeit 1: Local BEAAM API only: Konfiguriere die einzelnen Entitäten in der configuration.yaml Datei von Home Assistant selbst.

🆕Möglichkeit 2: Für eine einfachere Integration in Home Assistant, einer Nutzung der BEAAM API und der neoom CLOUD API sowie einer Integration in das Home Assistant Energy Dashboard nutze das Community Projekt "neoom Ai für Home Assistant"

Möglichkeit 1: Konfiguriere die einzelnen Entitäten in der configuration.yaml Datei von Home Assistant selbst. Es wird vorausgesetzt, dass es bereits eine existierende und funktionierende Home Assistant Installation gibt und du die grundlegende Funktionsweise von Home Assistant kennst.

Du solltest auch wissen, wie du die Home Assistant Konfiguration über configuration.yaml editierst.

neoom übernimmt keine Verantwortung, wenn du an deiner Home Assistant Installation etwas zerstörst.

Dieser Artikel beschreibt, wie du die folgenden "Entitäten" in Home Assistant bekommst. Es obliegt dir selbst, wie du diese Entitäten in Home Assistant zur Visualisierung oder Automatisierung nutzt. Bitte habe Verständnis, dass wir zu den Home Assistant Funktionen keinen Support leisten können.

Mit der folgenden Anleitung bekommst du folgende Entitäten in Home Assistant:

Datenpunkt

Name der Entität in Home Assistant

Aktuelle Verbrauchsleistung (in Watt)

neoom_power_consumption_calc

Aktuelle Bezugsleistung aus dem Netz (in Watt)

neoom_power_grid_input

Aktuelle Einspeiseleistung in das Netz (in Watt)

neoom_power_grid_output

Aktuelle Entladeleistung Batterie (in Watt)

neoom_storage_output

Aktuelle Beladeleistung Batterie (in Watt)

neoom_storage_input

Aktueller Ladezustand Batterie (in %)

neoom_state_of_charge

Aktuelle PV Leistung (in Watt)

neoom_power_production

Aktueller Autarkiegrad (in %)

neoom_self_sufficiency

Energie in der Speicher geladen (in Wh)

neoom_energy_charged

Energie von PV produziert (in Wh)

neoom_energy_produced

Energie aus dem Netz bezogen (in Wh)

neoom_energy_imported

Energie ins Netz gespeist (in Wh)

neoom_energy_exported

Energieverbrauch (in Wh)

neoom_energy_consumed_calc

Dazu kopiere bitte folgenden Teil in die configuration.yaml deiner Home Assistant Installation:

Setze bei "resource: http://xxx.xxx.xxx.xxx/api/v1/site/state" die IP Adresse deines neoom BEAAM ein. Die IP Adresse des BEAAM findest Du unter connect.neoom.com --> BEAAM Kachel ganz unten links klicken --> Im Bereich "Netzwerk" --> "WAN"

Setze bei "Authorization: "Bearer sk_beaam_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"" den Token für die lokale BEAAM API ein. Den Token findest du unter connect.neoom.com --> API Schlüssel --> Schlüssel für BEAAM API

```
rest:

    • resource: http://xxx.xxx.xxx.xxx/api/v1/site/state # BEAAM API URL

headers:

Authorization: "Bearer sk_beaam_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" #Put your bearer token here, but do not delete Bearer at the beginning

Content-Type: "application/json"

method: GET

scan_interval: 10 # Intervall für API-Aufrufe in Sekunden

sensor:

# Errechneter Verbrauch (Leistung in Watt)

        • name: "neoom_power_consumption_calc"

unique_id: "power_consumption_calc"

value_template: "{{ (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_CONSUMPTION_CALC') | map(attribute='value') | first * -1) if (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_CONSUMPTION_CALC') | map(attribute='value') | first) < 0 else (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_CONSUMPTION_CALC') | map(attribute='value') | first) }}"

unit_of_measurement: "W"

device_class: power

state_class: measurement

icon: "mdi:SolarPanel"

# Stromnetz (aktueller Netzbezug in Watt)

        • name: "neoom_power_grid_input"

unique_id: "power_grid_input"

value_template: "{{ (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_GRID') | map(attribute='value') | first) * -1 if (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_GRID') | map(attribute='value') | first) < 0 else (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_GRID') | map(attribute='value') | first) }}"

unit_of_measurement: "W"

device_class: power

state_class: total

icon: "mdi:TransmissionTower"

# Stromnetz (aktuelle Einspeisung in Watt)

        • name: "neoom_power_grid_output"

unique_id: "power_grid_output"

value_template: "{{ (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_GRID') | map(attribute='value') | first * -1) if (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_GRID') | map(attribute='value') | first) < 0 else 0 }}"

unit_of_measurement: "W"

device_class: power

state_class: total

icon: "mdi:TransmissionTower"

# Batteriespeicher Output (aktuelle Leistung in Watt)

        • name: "neoom_storage_output"

unique_id: "storage_output"

value_template: "{{ 0 if (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_STORAGE') | map(attribute='value') | first) < 0 else (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_STORAGE') | map(attribute='value') | first) }}"

unit_of_measurement: "W"

device_class: power

state_class: total

icon: "mdi:BatteryArrowDownOutline"

# Batteriespeicher Input (aktuelle Leistung in Watt)

        • name: "neoom_storage_input"

unique_id: "storage_input"

value_template: "{{ (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_STORAGE') | map(attribute='value') | first * -1) if (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_STORAGE') | map(attribute='value') | first) < 0 else 0 }}"

unit_of_measurement: "W"

device_class: power

state_class: total

icon: "mdi:BatteryArrowUpOutline"

# Ladezustand des Speichers in %

        • name: "neoom_state_of_charge"

unique_id: "state_of_charge"

value_template: "{{ value_json['energyFlow']['states'] | selectattr('key', 'eq', 'STATE_OF_CHARGE') | map(attribute='value') | first }}"

unit_of_measurement: "%"

device_class: battery

state_class: measurement

icon: "mdi:BatteryHeartVariant"

# PV Leistung aktuell (Leistung in Watt)

        • name: "neoom_power_production"

unique_id: "power_production"

value_template: "{{ (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_PRODUCTION') | map(attribute='value') | first) if (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'POWER_PRODUCTION') | map(attribute='value') | first) > 0 else 0 }}"

unit_of_measurement: "W"

device_class: energy

state_class: total

icon: "mdi:SolarPanel"

# Autarkiegrad (Autarkiegrad in %)

        • name: "neoom_self_sufficiency"

unique_id: "self_sufficiency"

value_template: "{{ value_json['energyFlow']['states'] | selectattr('key', 'eq', 'SELF_SUFFICIENCY') | map(attribute='value') | first }}"

unit_of_measurement: "%"

device_class: power

state_class: measurement

icon: "mdi:LightningBoltCircle"

# Energie entladen (Entnahme aus dem Speicher in Wh)

        • name: "neoom_energy_discharged"

unique_id: "energy_discharged"

value_template: "{{ value_json['energyFlow']['states'] | selectattr('key', 'eq', 'ENERGY_DISCHARGED') | map(attribute='value') | first }}"

unit_of_measurement: "Wh"

device_class: energy

state_class: total_increasing

icon: "mdi:BatteryArrowDownOutline"

# Energie geladen (gespeicherte Energie in Wh)

        • name: "neoom_energy_charged"

unique_id: "energy_charged"

value_template: "{{ value_json['energyFlow']['states'] | selectattr('key', 'eq', 'ENERGY_CHARGED') | map(attribute='value') | first }}"

unit_of_measurement: "Wh"

device_class: energy

state_class: total_increasing

icon: "mdi:BatteryArrowUpOutline"

# Energie produziert (gesamte erzeugte Energie in Wh)

        • name: "neoom_energy_produced"

unique_id: "energy_produced"

value_template: "{{ value_json['energyFlow']['states'] | selectattr('key', 'eq', 'ENERGY_PRODUCED') | map(attribute='value') | first }}"

unit_of_measurement: "Wh"

device_class: energy

state_class: total_increasing

icon: "mdi:SolarPowerVariant"

# Energie importiert (gesamter Import aus dem Netz in Wh)

        • name: "neoom_energy_imported"

unique_id: "energy_imported"

value_template: "{{ (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'ENERGY_IMPORTED') | map(attribute='value') | first * -1) if (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'ENERGY_IMPORTED') | map(attribute='value') | first) < 0 else (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'ENERGY_IMPORTED') | map(attribute='value') | first) | round(2) }}"

unit_of_measurement: "kWh"

device_class: energy

state_class: total_increasing

icon: "mdi:TransmissionTowerImport"

# Energie exportiert (gesamte Einspeisung ins Netz in Wh)

        • name: "neoom_energy_exported"

unique_id: "energy_exported"

value_template: "{{ (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'ENERGY_EXPORTED') | map(attribute='value') | first * -1) if (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'ENERGY_EXPORTED') | map(attribute='value') | first) < 0 else (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'ENERGY_EXPORTED') | map(attribute='value') | first) }}"

unit_of_measurement: "Wh"

device_class: energy

state_class: total_increasing

icon: "mdi:TransmissionTowerExport"

# Errechneter Energieverbrauch (gesamter Verbrauch in Wh)

        • name: "neoom_energy_consumed_cal"

unique_id: "energy_consumed_calc"

value_template: "{{ (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'ENERGY_CONSUMED_CALC') | map(attribute='value') | first * -1) if (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'ENERGY_CONSUMED_CALC') | map(attribute='value') | first) < 0 else (value_json['energyFlow']['states'] | selectattr('key', 'eq', 'ENERGY_CONSUMED_CALC') | map(attribute='value') | first) }}"

unit_of_measurement: "Wh"

device_class: energy

state_class: measurement

icon: "mdi:HomeLightningBoltOutline"
```

Möglichkeit 2: Community Projekt "neoom Ai für Home Assistant"

⚠️ Disclaimer: Dies ist ein Community-Projekt – es ist nicht Teil der offiziellen neoom Produktlinie. Die Integration wird von Community-Mitgliedern unabhängig entwickelt und gepflegt. neoom leistet hierfür keinen Support und garantiert keine Funktionen.

Die inoffizielle Home Assistant Integration für neoom-Systeme verbindet:

  • Lokales BEAAM Gateway – Echtzeit-Daten (Leistung, Energie, Spannungen) im Sekundentakt
  • neoom AI Cloud – Stromtarife, Wettervorhersagen, Tarif-Informationen

Was kann die Integration?

  • Automatische Erkennung von Wechselrichtern, Batterien, Ladestationen und Zählern
  • Steuerung von Ladeleistung und Betriebsmodi über Home Assistant
  • Natürliche Integration ins Home Assistant Energy Dashboard
  • Intelligente Namensgebung von Geräten aus der neoom Konfiguration

Voraussetzungen

  • neoom AI Bearer Token
  • BEAAM Gateway IP-Adresse (lokal)
  • BEAAM API Key

Installation

Vollständige Installations- und Konfigurationsanleitung findest du im GitHub Repository.

Support

Mehr zu Energiemanagement (neoom Ai)