Hvis De allerede Victron GX-enhed såsom en Cerbo GX til at administrere din sol og batteri installation, en stor mængde nyttige real- time data er allerede tilgængelige lokalt: gitter strøm, batteri status, solproduktion, AC belastninger, MPPT produktion og, hvor installeret, data fra AC- koblede sol invertere såsom Fronius.
Den Clevr Victron Panel integration til Home Assistant gør disse data til et rent sæt af Home Assistant sensorer, der kan bruges af CleV GX Panel, dashboards, automatiseringer og andre Home Assistant enheder.
I modsætning til ældre installationer baseret på manuelt oprettede YAML sensorer, finder Clevr integration automatisk det udstyr, der er forbundet til dit GX system, og lader dig gennemgå den fundne konfiguration, før du opretter sensorer.
Der er ingen grund til at ændre configuration.yaml.
Hvad er det, der sker med Clevr Victron Integration?
Integrationen forbinder til dine eksisterende Victron GX MQTT data gennem Home Assistant MQTT integration.
Under installationen opdager det viktron-udstyr, der er tilgængeligt på GX-systemet, herunder understøttet:
| Datakilde | Eksempler |
|---|---|
| Viktronsystem | Grid, AC-belastning og systemeffekt |
| Batteri | Opladning og udledning energi |
| MPPT solopladere | Victron SmartSolar og andre GX- forbundne opladere |
| Vekselstrømsomformere | Fronius og andre invertere eksponeret af GX som PV-invertere |
| Trådmålere | Grid import og eksport energi |
| Home Assistant Recorder | Timeløn, daglige og historiske energidata |
Integrationen skaber også aggregerede solsensorer og specielle historie feeds, der anvendes af Clevr GX- panel.
Home Assistant forbliver ansvarlig for lagring af de historiske oplysninger. Det betyder, at Clevr-displayet kan slukkes eller genstartes uden at miste den energihistorie, der allerede er registreret af Home Assistant.

Før du starter
Du får brug for:
- Home Assistant med MQTT integration konfigureret (se Forbind Home Assistant MQTT til en Victron GX Hvis du ikke har oprettet dette endnu)
- En Victron GX-enhed tilgængelig via MQTT
- GX VRM Portal- id
- Den Clevr Victron integration pakke, downloadet fra Clevr House (du vil finde download i Clevr GX Panelkonfigurator)
Dine Victron MQTT data skal allerede være tilgængelige for MQTT mægler, der anvendes af Home Assistant.
En typisk brolagt installation vil afsløre Viktron emner svarende til:
victron/N/<portal-id>/...
og tillade Home Assistant at sende læse anmodninger tilbage gennem:
victron/R/<portal-id>/...
Den N/ emner bære meddelelser og data fra GX-enheden. Den R/ emner giver integrationen mulighed for at anmode om nye oplysninger og holde GX MQTT datastrømmen aktiv.
Integrationen af Clevr bruger automatisk disse læserapporter. Det sender ikke Victron. W/ skriver kommandoer og ændrer ikke indstillinger på dit GX- system.
Hvis din MQTT mægler bruger et præfiks andet end victron/, gøre en note af det, fordi du får brug for det under opsætning.
Installation af integrationen
- Opret en Home Assistant backup. Før du tilføjer nogen brugerdefineret integration, anbefaler vi at oprette en Home Assistant backup fra Indstillinger → System → Backup.
- Hent og udtræk pakken Clevr. Efter download af integration, udtrække ZIP-fil på din computer. Indenfor vil du finde
config/custom_components/clevr_victron. - Kopier integrationen i Home Assistant. Kopiér hele
clevr_victronmappe ind/config/custom_components/. Den endelige struktur bør se ud som/config/custom_components/clevr_victron/manifest.json.Du kan overføre filerne ved hjælp af den metode, du normalt bruger for at få adgang til din hjemmeassisterende konfiguration, såsom Studio Code Server, Samba eller SSH / SCP. Vær forsigtig med ikke at oprette en ekstra mappe niveau såsom
/config/custom_components/clevr_victron/clevr_victron/. - Genstart Home Assistant. En komplet Home Assistant genstart er nødvendig efter installation af filerne.
- Tilføj den Clevr integration. Åbn Indstillinger → Enheder & Tjenesteydelser, vælg Tilføj integration, søg efter Clevr Victron Panel, og vælg det.
- Indtast dine MQTT indstillinger. Integrationen kræver to værdier: MQTT-bropræfiks og GX Portal- id.
For en fælles installation, hvor Victron GX er forbundet til Home Assistant MQTT mægler nedenfor
victron/, indtastvictron/som MQTT-bropræfikset. Hvis Home Assistant er forbundet direkte til GX MQTT mægler og de emner, der begynder direkte medN/, lad præfikset være tomt.GX Portal-id 'et identificerer entydigt din Victron installation.
- Lad Clevr opdage GX installationen. Når du fortsætter, Clevr anmoder om et nyt datasæt fra GX-enheden og undersøger det tilgængelige udstyr. Scanningen søger efter systemet, VE.Bus udstyr, batteri enheder, gitter målere, Victron solfangere og AC PV invertere.
- Gennemgå det detekterede udstyr omhyggeligt. Den næste skærm er bevidst ikke fuldt automatisk. Solarudstyr kan forsvinde fra GX-data, når det er offline, så Clevr beder dig om at bekræfte, hvad der blev fundet.
Vælg det rigtige Energimåler til gitter, Batterienergimåler, og alle installeret Solvarmekomponenter. Derefter bekræftes, hvilke faser der er til stede for Gitter, Indgangsbelastninger for vekselstrøm, og Strømudgangsbelastninger.
Udfør den første opdagelse om muligt under dagslys, med alle solinvertere og MPPT udstyr online. En inverter, der producerer nul watt, kan stadig være en gyldig installeret enhed, mens en inverter, der er helt offline kan ikke vises på alle.
- Gennemgå energikildens advarsler. Før du opretter sensorer, viser Clevr, hvordan hver energiværdi vil blive opnået. Når GX udsætter en egnet lokal energitæller, bruger Clevr den. Når et passende lokalt gitter eller batteri energi tæller ikke er tilgængelig, integration kan skabe en klart identificeret Anslået energiføler baseret på målt effekt. Gennemgå disse advarsler, før de fortsætter.
- Opret sensorerne. Bekræft den endelige skærm og Home Assistant vil oprette en ny CleV GX enhed sammen med de opdagede sensorer og beregnede data feeds.
- Verificer værdierne. Åbn den nyoprettede Clevr GX-enhed i Home Assistant og sammenlign de viste værdier med din Victron GX-grænseflade. Du bør også tjekke Udvikler værktøjer → Stater og Udvikler værktøjer → Statistik at bekræfte, at energisensorerne registreres korrekt.
Hvilke Sensorer er skabt?
Det nøjagtige sæt afhænger af det udstyr, der er fundet i din installation.
For eksempel kan et system, der indeholder Victron MPPT-opladere og en Fronius inverter, producere separate kildesensorer sammen med flere aggregerede Clevr-sensorer.
Vigtige paneldata omfatter:
| Sensor type | Formål |
|---|---|
| MPPT-effekt | Kombineret øjeblikkelig udgang af de udvalgte Victron MPPT-opladere |
| AC PV Power | Kombineret effekt fra AC-tilsluttede PV-invertere såsom Fronius |
| AC PV Output Power | PV-produktion, der er specifikt forbundet med GX AC-outputsiden |
| Grid Import / Export Energy | Energi importeret fra og eksporteret til nettet |
| Batteriopladning / udladningsenergi | Energi, der strømmer ind og ud af batteriet |
| Energiøjebliksbillede | Kompakt energiinformation, der anvendes af visningen af Clevr |
| Historie Snapshot | Recorder- based time og multi- day historik for Clevr displayet |
Hvor flere solopladere er installeret, kan Clevr kombinere dem automatisk i stedet for at kræve, at skærmen firmware til at kende hver enkelt enhed ID.
Dette er især nyttigt, når et system udvides senere med yderligere MPPT opladere.
Indfødte og estimerede energisensorer
Clevr foretrækker altid energitællere rapporteret direkte af udstyret.
Nogle gange udsætter en GX-installation øjeblikkelig strøm, men giver ikke en passende kumulativ energitæller for en bestemt rolle. I disse situationer kan Clevr udlede en Anslået energitæller fra den målte effekt.
Sensorer, der vurderes, identificeres bevidst som sådanne.
Der er en vigtig forskel: en anslået tæller kan kun akkumulere energi, mens Home Assistant kører og modtager data. Hvis Home Assistant er offline i en time, integrationen ikke opfinde eller interpolere det manglende forbrug for den time.
Indfødte enhedstællere foretrækkes derfor, når de er tilgængelige.
Historiske data og Home Assistant Recorder
Clevr GX Panel behøver ikke at gemme sin egen langsigtede energidatabase.
I stedet bruger Clevr Home Assistant Recorder statistik at forberede timeløn og daglig historie vises på panelet.
Det har flere fordele. Displayet kan genstarte uden at miste historie, flere skærme kan bruge de samme data, og historiske oplysninger forbliver centralt styret af Home Assistant.
Hvis du bruger en brugerdefineret Recorder include konfiguration, sørg for, at de nyoprettede Clevr energisensorer er inkluderet.
Husk også, at installation af integrationen i dag ikke kan genskabe time Home Assistant statistik fra før sensorerne eksisterede. Den første dag efter installationen kan derfor kun indeholde delvis historie.
Hent Clevr Diagnostics-filen
Når installationen fungerer korrekt, skal du downloade integrationens Diagnostik fil fra Home Assistant.
Denne fil er især nyttig, når du konfigurerer et Clevr GX Panel, fordi den indeholder de oplysninger, der kræves for at identificere den opdagede installation, herunder udstyrets beholdning, udvalgte energikilder, fase konfiguration og faktiske Home Assistant entity ID 'er oprettet på dit system.
Den diagnostiske eksport indeholder ikke dit MQTT brugernavn eller password.
Behold denne fil, hvis dit Clevr GX Panel vil blive forberedt specielt til din installation.
Fejlfinding: “Ingen GX data”
Hvis Clevr rapporterer No fresh GX data, integrationen er installeret korrekt, men Home Assistant modtager ikke GX data, der kræves til opdagelse.
Kontroller, at Home Assistant 's MQTT integration er forbundet og kontrollere Portal- id og MQTT- præfiks.
Hvis du bruger en MQTT-bro, skal den virke i begge retninger:
- GX → Home Assistant for
N/data træ - Home Assistant → GX for
R/læse anmodninger
For eksempel, hvis Home Assistant modtager victron/N/<portal-id>/system/0/..., skal det også være muligt at sende victron/R/<portal-id>/keepalive Tilbage til GX-enheden.
Clevr sender automatisk disse anmodninger, mens integrationen kører.
En solinør mangler
Hvis en Fronius eller en anden PV inverter ikke vises under opdagelsen, først kontrollere, om det er i øjeblikket synlig på GX-enheden.
Soludstyr bør fortrinsvis opdages i dagslys med hver inverter drevet og kommunikere.
Antag ikke, at en enhed er fraværende, blot fordi dens magt er i øjeblikket nul. Omvendt, en helt offline inverter kan ikke forekomme i opdagelsesdata overhovedet.
Ret kommunikationsproblemet først og gentag derefter Clevr integration setup.
Energi eller historie er utilgængelig
En utilgængelig energiværdi indikerer ikke nødvendigvis et installationsproblem.
Nogle Victron enheder eller tilslutningsmetoder simpelthen ikke afsløre de indfødte energitællere, der kræves til denne måling.
Clevr undgår bevidst at fremstille historiske oplysninger, når kildedataene er ufuldstændige.
For Recorder-baseret historie, også kontrollere, at de tilsvarende sensorer bliver registreret af Home Assistant og ikke er blevet udelukket af en brugerdefineret Recorder konfiguration.
Lokal efter design
Den datasti, der anvendes af Clevr integration kan forblive helt inde i dit lokale netværk.
Home Assistant kommunikerer med MQTT mægler, der allerede er konfigureret til installationen, og integrationen bruger de lokale GX-data, der er udsat gennem denne mægler.
Integrationen begrænser sig også til at læse de data, der er nødvendige for opdagelse, energi regnskab og Clevr display. Det bruger ikke MQTT skrive kommandoer til at ændre Victron indstillinger.
Fra Home Assistant til Clevr GX Panel
Når integrationen er installeret og de fundne værdier er blevet verificeret, Home Assistant bliver den stabile data lag mellem din Victron installation og Clevr GX- panel.
Panelet kan bruge de Clevr- genererede solaggregater, energiinformation og Recorder- backed historie uden at kræve, at hver kunde installation til at have præcis den samme Victron eller Fronius enhed id 'er.
Det betyder, at et system med en MPPT, flere MPPT-opladere, en AC- koblet Fronius inverter, forskellige gitter målere eller forskellige fase konfigurationer kan alle være repræsenteret gennem den samme Clevr display interface.
Installer integrationen en gang, gennemgå, hvad Clevr opdager, og lad Home Assistant give en konsekvent grænseflade til resten af Clevr økosystem.
Klar til panelet? Den Victron GX Erstatning – 4 tommer bruger netop denne integration. Tryk Indstil, uploade din diagnostiske fil, og din panelkode er bygget til din installation.