Home Assistant og GridZeno.

• Home Assistant 2025.10 eller nyere på dit hjemmenetværk.
• HACS installeret i Home Assistant.
• Din GridZeno Dongle på det samme netværk, med den firmware, der har Home Assistant med. Donglen opdaterer sig selv fra GridZeno.
• En Growatt-inverter, som donglen er forbundet til.
• Din GridZeno-konto i browseren eller appen, så du kan godkende forbindelsen.
• Smart eller Pro, hvis du vil have dine priser og solprognosen med. Resten virker også på Light.

1. Åbn HACS i Home Assistant.
2. Find GridZeno. Står GridZeno ikke i HACS' egen liste, så tilføj github.com/GridZeno/gridzeno-home-assistant under Custom repositories med typen Integration. Du kan også åbne den direkte i din Home Assistant.
3. Hent integrationen med Download.
4. Genstart Home Assistant.

Det tager et par minutter, og du skal kun gøre det én gang.

1. Find donglen. Home Assistant finder den selv på dit netværk. Under Indstillinger, Enheder og tjenester står den som fundet: tryk Tilføj, og svar ja til Connect GridZeno GZ-…?
2. Eller skriv adressen. Finder Home Assistant den ikke, så tilføj integrationen GridZeno, og skriv donglens adresse. Den står under Adresse på dit netværk på siden Dongle i GridZeno. Porten er 80.
3. Se koden. Home Assistant viser en kode på 6 cifre og venter på dig.
4. Godkend i GridZeno. Åbn Integrationer, Home Assistant i browseren eller appen. Står den samme kode der, så vælg Kun læse eller Læse og styre, og tryk Godkend. Står der en anden kode, så tryk Afvis: så er det ikke din dongle, du taler med.
5. Færdig. Home Assistant går selv videre, når donglen har fået besked, og målingerne kommer med det samme.

Anmodningen udløber efter 10 minutter. Der kan være op til fire Home Assistants på en dongle. Donglens egen side kan også godkende en Home Assistant, men kun til at læse.

Du vælger, når du godkender. Kun læse giver alle målinger, tællere, planen og, med Smart og Pro, priserne og solprognosen. Læse og styre giver desuden Command, de fem tal til den og knappen Give the inverter its own settings back, og Home Assistant kan bruge GridZenos handlinger.

Vil du skifte senere, så fjern adgangen under Integrationer, Home Assistant i GridZeno. Home Assistant beder dig så forbinde igen, og du godkender med det nye valg. Selv med lov til at styre styrer Home Assistant kun, når du selv styrer anlægget.

Donglen bliver én enhed i Home Assistant, GridZeno GZ-A1B2C3, med enheder som i tabellen. Navnene er på engelsk, uanset hvilket sprog din Home Assistant har. Id'erne begynder med gridzeno_gz_ og donglens nummer med små bogstaver: GZ-A1B2C3 giver sensor.gridzeno_gz_a1b2c3_battery. Du kan altid se dem og give dem andre navne under enheden.

Uden Smart eller Pro står priserne og solprognosen som utilgængelige. Er den seneste måling over et minut gammel, fordi donglen ikke kan læse inverteren, står målingerne også som utilgængelige, så en automatisering aldrig arbejder på gamle tal.

Tællerne ligger i donglen og går aldrig baglæns. De begynder ved 0, når donglen får den nye firmware, og efter et strømsvigt kan de mangle højst de sidste 10 minutter. Din historik fra før ligger stadig i GridZeno, og du kan hente den under Profil, Hent dine data.

Under Indstillinger, Dashboards, Energi i Home Assistant vælger du:

• Forbrug fra nettet: Energy bought. Som pris vælger du at bruge en enhed med den aktuelle pris, og Buy price.
• Retur til nettet: Energy sold, med Sell price som pris.
• Solpaneler: Solar energy. Sæt flueben ved GridZeno under solprognose.
• Batteri: Energy into the battery som energi ind og Energy out of the battery som energi ud.

Husets forbrug regner Home Assistant selv ud af de fire, så House energy skal ikke med. Den er til dine egne grafer. Med Light er der ingen priser og ingen solprognose fra GridZeno: vælg en fast pris, eller lad prisen være.

Alle enheder kan bruges på dine dashboards. To kort at starte med: indsæt dem som YAML i et nyt kort, og skift a1b2c3 ud med dit eget dongle-nummer.

type: entities
title: GridZeno
entities:
  - sensor.gridzeno_gz_a1b2c3_plan_now
  - sensor.gridzeno_gz_a1b2c3_plan_now_until
  - sensor.gridzeno_gz_a1b2c3_control
  - sensor.gridzeno_gz_a1b2c3_battery
  - sensor.gridzeno_gz_a1b2c3_buy_price
  - sensor.gridzeno_gz_a1b2c3_sell_price
  - select.gridzeno_gz_a1b2c3_command
  - number.gridzeno_gz_a1b2c3_command_duration
  - button.gridzeno_gz_a1b2c3_give_the_inverter_its_own_settings_back

type: history-graph
title: Strømmen i dag
hours_to_show: 24
entities:
  - sensor.gridzeno_gz_a1b2c3_solar_power
  - sensor.gridzeno_gz_a1b2c3_house_consumption
  - sensor.gridzeno_gz_a1b2c3_grid_import
  - sensor.gridzeno_gz_a1b2c3_grid_export

Har din Home Assistant kun lov til at læse, så tag de tre sidste linjer i det første kort ud: kommandoen findes ikke for den.

Kun for en Home Assistant, du har givet lov til at styre, og kun når du selv styrer anlægget under Automatik.

1. Styr selv. Vælg Du selv under Automatik i GridZeno. Så skriver GridZeno ikke længere til inverteren.
2. Sæt tallene. Under enheden sætter du, hvad den næste kommando beder om: Command: charge target, Command: sell power, Command: sell floor, Command: duration og Command: export limit. Home Assistant husker dem, også efter en genstart.
3. Vælg kommandoen. Vælg Charge from the grid, Hold the battery, Sell from the battery eller Limit selling to the grid under Command. Den sendes med tallene, som de står, og Command viser derefter det, der kører.
4. Stop den, når du vil. Vælg The inverter's own settings, eller tryk Give the inverter its own settings back.

At ændre et tal ændrer ikke en kommando, der kører. Vælg kommandoen igen, så erstatter den nye den gamle.

Charge from the grid

Lader batteriet fra nettet til målet. Ved målet står batteriet stille, og huset køber fra nettet, til tiden er gået.

Hold the battery

Holder batteriet, som det er: huset bruger solen og nettet.

Sell from the battery

Aflader batteriet med den effekt, du har valgt, og stopper ved gulvet. Det, huset ikke selv bruger, sælges.

Limit selling to the grid

Sætter inverterens salgsgrænse i en del af dens effekt. 0 % stopper salget.

Reglerne

• Varigheden er en sikkerhed: fra et kvarter til 12 timer. Derefter får inverteren sine egne indstillinger tilbage af sig selv.
• Grænserne er dine: et mål eller et gulv uden for batteriets minimum og maksimum fra GridZeno bliver afvist med en forklaring, ikke rettet til. Så tror Home Assistant aldrig, den har bedt om noget, der ikke sker.
• GridZeno vinder: skifter du tilbage til Automatisk, stopper Home Assistants kommando med det samme.
• Én ad gangen: der kører højst én kommando, uanset hvor mange Home Assistants der er forbundet.
• Samme vej som GridZeno: en kommando kører gennem de samme funktioner og sikkerhedsgrænser som GridZenos egen styring, og donglen tjekker bagefter, at inverteren gjorde det. Batteriets grænser i inverteren røres ikke af en kommando.
• En genstart stopper den: donglen starter aldrig med en kommando, der kører. Inverteren får sine egne indstillinger tilbage.
• GridZeno kan se det: mens en kommando kører, viser GridZeno, hvad Home Assistant har sat i gang og til hvornår.

Handlingerne

Det samme kan dine automatiseringer gøre med GridZenos egne handlinger, hvor alt står i ét kald:

Donglen vælger du i handlingens editor. I YAML hedder feltet config_entry_id, og Home Assistant skriver donglens id selv, når du har valgt den.

Eksempler, du kan tage udgangspunkt i. Skift a1b2c3 ud med dit eget dongle-nummer.

De tre første styrer anlægget. De har alle en betingelse, så de kun kører, når du selv styrer: ellers afviser donglen kommandoen. Prisen og det billigste og dyreste kvarter kræver Smart eller Pro.

Lad batteriet i dagens billigste kvarter

Sætter målet og varigheden og vælger så Charge from the grid. Tallene sættes først, fordi kommandoen sendes med dem, som de står.

alias: Lad batteriet i dagens billigste kvarter
triggers:
  - trigger: time
    at: sensor.gridzeno_gz_a1b2c3_cheapest_quarter_today
conditions:
  - condition: state
    entity_id: sensor.gridzeno_gz_a1b2c3_control
    state: manual
actions:
  - action: number.set_value
    target:
      entity_id: number.gridzeno_gz_a1b2c3_command_charge_target
    data:
      value: 80
  - action: number.set_value
    target:
      entity_id: number.gridzeno_gz_a1b2c3_command_duration
    data:
      value: 60
  - action: select.select_option
    target:
      entity_id: select.gridzeno_gz_a1b2c3_command
    data:
      option: charge_grid

Sælg fra batteriet i dagens dyreste kvarter

Samme idé med handlingen Sell from the battery, hvor effekten, gulvet og varigheden står i kaldet. config_entry_id er donglens id i din Home Assistant.

alias: Sælg fra batteriet i dagens dyreste kvarter
triggers:
  - trigger: time
    at: sensor.gridzeno_gz_a1b2c3_dearest_quarter_today
conditions:
  - condition: state
    entity_id: sensor.gridzeno_gz_a1b2c3_control
    state: manual
actions:
  - action: gridzeno.sell_from_battery
    data:
      config_entry_id: 01JA2B3C4D5E6F7G8H9J0KLMNP
      power: 5000
      floor_soc: 40
      duration: 30

Stop salget ved negative priser

Det gør GridZeno selv, når den styrer. Eksemplet er til dig, der styrer selv. Prisen skifter hvert kvarter, så vælg en varighed, der passer, eller tryk Give the inverter its own settings back, når prisen er positiv igen.

alias: Stop salget ved negative priser
triggers:
  - trigger: numeric_state
    entity_id: sensor.gridzeno_gz_a1b2c3_sell_price
    below: 0
conditions:
  - condition: state
    entity_id: sensor.gridzeno_gz_a1b2c3_control
    state: manual
actions:
  - action: gridzeno.limit_export
    data:
      config_entry_id: 01JA2B3C4D5E6F7G8H9J0KLMNP
      export_limit: 0
      duration: 60

Få besked om morgendagens billigste kvarter

Kun læsning, så den virker også, når GridZeno styrer. Skift notify.notify ud med din egen, fx din telefons.

alias: Fortæl mig morgendagens billigste kvarter
triggers:
  - trigger: state
    entity_id: sensor.gridzeno_gz_a1b2c3_cheapest_quarter_tomorrow
    not_to:
      - unknown
      - unavailable
actions:
  - action: notify.notify
    data:
      message: >-
        I morgen er strømmen billigst kl.
        {{ as_timestamp(states('sensor.gridzeno_gz_a1b2c3_cheapest_quarter_tomorrow')) | timestamp_custom('%H:%M') }}
        til {{ state_attr('sensor.gridzeno_gz_a1b2c3_cheapest_quarter_tomorrow', 'price') | round(2) }} kr. pr. kWh.

Gennemsnitsprisen som en skabelon

Købsprisens egenskab prices har hvert kvarter i dag og i morgen. Som en skabelonsensor under Hjælpere giver denne skabelon gennemsnittet af de kendte kvarterer:

{% set priser = (state_attr('sensor.gridzeno_gz_a1b2c3_buy_price', 'prices') or [])
   | map(attribute='buy') | select('number') | list %}
{{ (priser | sum / priser | count) | round(2) if priser else none }}

• Parring: donglen og Home Assistant laver en fælles nøgle med en nøgleudveksling. Nøglen sendes aldrig over nettet, og koden på 6 cifre er regnet ud af begges nøgler, så ingen imellem kan få de to koder til at passe.
• Hver forespørgsel er underskrevet, og det er hvert svar også. En læsning har en tæller, og en kommando et engangstal fra donglen, så intet kan sendes igen af en anden.
• GridZeno kender ikke nøglen. Den ligger kun i donglen og i din Home Assistant, så vores server hverken kan læse fra donglen eller styre den ad den vej.
• Trafikken er ikke krypteret på dit netværk. Andre på netværket kan se målingerne, som de også kan på donglens egen side, men de kan hverken spørge donglen eller styre den.
• Det, GridZeno gemmer: din Home Assistants navn, om den må læse eller også styre, dens adresse på dit netværk, koden, hvornår du godkendte den, og hvornår donglen sidst så den. Det slettes, så snart den ikke længere har adgang. Læs privatlivspolitikken.

• Home Assistant finder ikke donglen: skriv donglens adresse fra siden Dongle i GridZeno. Donglen og Home Assistant skal være på det samme netværk. Kører Home Assistant i en container uden adgang til værtens netværk, eller på et andet netværk end donglen, når opdagelsen ikke frem, men adressen virker.
• Koden er en anden i GridZeno: afvis anmodningen, og prøv igen fra Home Assistant.
• Anmodningen udløb: den gælder i 10 minutter. Start forfra fra Home Assistant.
• Home Assistant beder om at forbinde igen: adgangen er fjernet i GridZeno, eller donglen har fået en ny ejer. Forbind og godkend den igen.
• Donglen har fået ny adresse: Home Assistant finder den selv igen på netværket. Ellers ret adressen under integrationens indstillinger.
• Priserne står som utilgængelige: de kræver Smart eller Pro, og at donglen har hentet dem hos GridZeno.

Når donglen siger nej til en kommando, viser Home Assistant hvorfor:

GridZeno controls the plant. Choose to control it yourself under Automation in GridZeno first.

Vælg Du selv under Automatik i GridZeno, eller giv din automatisering en betingelse, så den kun kører, når du styrer selv.

This Home Assistant may only read.

Fjern adgangen i GridZeno, forbind Home Assistant igen, og vælg Læse og styre.

The target is outside the battery limits you set in GridZeno.

Målet skal ligge over dit minimum og højst på dit maksimum under Automatik. Det samme gælder gulvet ved salg.

The power is outside what the inverter can do.

Sælg med højst inverterens mærkeeffekt.

The duration must be 15 minutes to 12 hours.

Vælg en varighed fra 15 til 720 minutter.

The plant has no battery.

Uden batteri kan Home Assistant kun begrænse salget.

GridZeno may not change the export limit on this inverter.

Inverterens salgsgrænse står i en tilstand, GridZeno ikke rører, fx som din installatør satte den op. Skriv til os, så ser vi på det.

Control from Home Assistant is not switched on on this dongle yet.

Donglen kan læse, men dens firmware er bygget uden styring. Skriv til os, så finder vi den rigtige version.

The dongle did not answer.

Tjek, at donglen har strøm og er på netværket. Siden Dongle i GridZeno siger, om den er på nettet.

The dongle's answer could not be trusted (no valid signature).

Prøv igen. Sker det igen, står noget på netværket måske i vejen. Skriv til os.

• I Home Assistant: slet integrationen under Enheder og tjenester. Den fjerner også sig selv fra donglen.
• I GridZeno: tryk Fjern adgang under Integrationer, Home Assistant. Så kan den ikke længere tale med donglen, og den beder om at blive forbundet igen. Slet den i Home Assistant, hvis du ikke vil have den tilbage.
• Ny ejer: får donglen en ny ejer, eller fjerner du den fra din konto, mister alle Home Assistants deres adgang.

Koster det noget?

Nej. Integrationen hører med til alle abonnementer. Priserne og solprognosen kræver Smart eller Pro.

Virker det uden internet?

Ja. Målingerne og kommandoerne går direkte mellem Home Assistant og donglen. Donglen bruger det, den sidst fik at vide fra GridZeno: om du styrer selv, og dine grænser for batteriet. Priserne og prognosen bliver ikke opdateret, før internettet er tilbage.

Kan jeg bruge det, når jeg ikke er hjemme?

Integrationen taler kun med donglen på dit eget netværk. Din Home Assistant kan du nå udefra, som du plejer.

Kan Home Assistant og GridZeno styre på samme tid?

Nej. Når GridZeno styrer, kan Home Assistant kun læse. Styrer du selv, kan Home Assistant styre, og skifter du tilbage til Automatisk, vinder GridZeno med det samme.

Jeg har flere dongler.

Hver dongle forbindes for sig og bliver sin egen enhed i Home Assistant.

Ser GridZeno, hvad min Home Assistant gør?

Vi ser ikke, hvad Home Assistant spørger donglen om. Vi ser, hvilke Home Assistants der er forbundet, og en kommando, mens den kører.

Er integrationen udgivet?

Ja. Vi opdaterer den løbende og sender nye firmwareversioner ud til donglen og nye opdateringer til Home Assistant.