Als u al een Victron GX apparaat zoals een Cerbo GX voor het beheer van uw zonne- en batterijinstallatie is er al een grote hoeveelheid nuttige real-time gegevens beschikbaar: netstroom, batterijstatus, zonne-energieproductie, AC-belasting, MPPT-productie en, waar geïnstalleerd, gegevens van AC-gekoppelde zonne-energie Inverters zoals Fronius.
De Clevr Victron Panel integratie voor Home Assistant verandert die data in een schone set Home Assistant sensoren die gebruikt kunnen worden door het Clevr GX Panel, dashboards, automatiseringen en andere Home Assistant apparaten.
In tegenstelling tot oudere installaties op basis van handmatig aangemaakte YAML-sensoren ontdekt de Clevr-integratie automatisch de apparatuur die op uw GX-systeem is aangesloten en laat u de gedetecteerde configuratie zien voordat u de sensoren aanmaakt.
Er is hoeft niet te worden gewijzigd configuration.yaml.
Wat doet de Clevr Victron Integratie
De integratie verbindt met uw bestaande Victron GX MQTT data door de MQTT integratie van Home Assistant.
Tijdens de installatie ontdekt het de Victron apparatuur beschikbaar op het GX systeem, inclusief ondersteund:
| Gegevensbron | Voorbeelden |
|---|---|
| Victron systeem | Raster, wisselstroom en systeemvermogen |
| Batterij | Energie voor lading en lozing |
| MPPT zonneladers | Victron SmartSolar en andere GX-geconnecteerde laders |
| wisselstroom-zonneomvormers | Fronius en andere door GX als PV-omvormers blootgestelde omvormers |
| Rastermeters | In- en uitvoer van energie uit het net |
| Home Assistant Recorder | Uurgegevens, dagelijkse en historische energiegegevens |
De integratie creëert ook geaggregeerde zonnesensoren en speciale geschiedenis feeds gebruikt door de Clevr GX-paneel.
Home Assistant blijft verantwoordelijk voor het opslaan van de historische informatie. Dit betekent dat de Clevr display kan worden uitgeschakeld of herstart zonder verlies van de energie geschiedenis die al door Home Assistant.
Voordat u begint
U heeft:
- Home Assistant met de MQTT-integratie geconfigureerd (zie Home Assistant MQTT verbinden met een Victron GX als u dit nog niet hebt ingesteld)
- Een Victron GX apparaat toegankelijk via MQTT
- De GX VRM-portaal-ID
- Het Clevr Victron integratie pakket, gedownload van Clevr House (u vindt de download in de Configurator van het Clevr GX-paneel)
Uw Victron MQTT-gegevens moeten al beschikbaar zijn voor de MQTT-makelaar die door Home Assistant wordt gebruikt.
Een typische gebrugde installatie zal Victron onderwerpen onthullen die vergelijkbaar zijn met:
victron/N/<portal-id>/...
en laat Home Assistant om leesverzoeken terug te sturen via:
victron/R/<portal-id>/...
De N/ onderwerpen bevatten meldingen en gegevens van het GX-apparaat. De R/ onderwerpen kunnen de integratie om nieuwe informatie te vragen en de GX MQTT datastream actief te houden.
De Clevr integratie gebruikt deze leesverzoeken automatisch. Het stuurt Victron niet W/ schrijf commando's en verandert de instellingen op uw GX-systeem niet.
Als uw MQTT-makelaar een ander voorvoegsel dan victron/, maak een notitie van het omdat je het nodig hebt tijdens de setup.
De integratie installeren
- Maak een Home Assistant back-up. Alvorens een aangepaste integratie toe te voegen, raden wij het maken van een Home Assistant backup van Instellingen → Systeem → Reservekopieën.
- Download en haal het Clevr pakket. Na het downloaden van de integratie, haalt u het ZIP-bestand op uw computer. Binnen vindt u
config/custom_components/clevr_victron. - Kopieer de integratie in Home Assistant. Kopieer het volledige
clevr_victronmap naar/config/custom_components/. De uiteindelijke structuur moet eruit zien als/config/custom_components/clevr_victron/manifest.json.U kunt de bestanden overdragen met de methode die u normaal gebruikt om toegang te krijgen tot uw Home Assistant configuratie, zoals Studio Code Server, Samba of SSH/SCP. Wees voorzichtig om geen extra mapniveau aan te maken zoals
/config/custom_components/clevr_victron/clevr_victron/. - Herstart de assistente. Een complete Home Assistant herstart is vereist na het installeren van de bestanden.
- Voeg de Clevr integratie toe. Open Instellingen → Apparaten & diensten, selecteren Integratie toevoegen, zoeken Clevr Victron-paneel, en selecteer het.
- Voer uw MQTT-instellingen in. De integratie vraagt om twee waarden: MQTT bridge prefix en de GX-portaal-ID.
Voor een gemeenschappelijke installatie waar de Victron GX wordt overbrugd in de Home Assistant MQTT makelaar hieronder
victron/, entervictron/als het MQTT-brugvoorvoegsel. Als Home Assistant direct verbonden is met de GX MQTT makelaar en de onderwerpen direct beginnen metN/, laat het voorvoegsel leeg.De GX Portal ID identificeert uw Victron installatie uniek.
- Laat Clevr de GX installatie ontdekken. Zodra u verder gaat, vraagt Clevr een nieuwe dataset van het GX-apparaat en onderzoekt de beschikbare apparatuur. De scan zoekt naar het systeem, VE.Bus apparatuur, batterij apparaten, rastermeters, Victron zonneladers en AC PV omvormers.
- Bekijk de gedetecteerde apparatuur zorgvuldig. Het volgende scherm is opzettelijk niet volledig automatisch. Zonne-energie-apparatuur kan verdwijnen uit de GX-gegevens wanneer het offline is, dus Clevr vraagt je om te bevestigen wat gevonden is.
Selecteer de juiste Rasterenergiemeter, Energiemeter voor batterijen, en alles geïnstalleerd Zonne-energie-installaties. Bevestig dan welke fasen er daadwerkelijk aanwezig zijn voor Raster, AC-inputbelasting, en Uitlaatbelasting wisselstroom.
De eerste ontdekking uitvoeren tijdens daglicht waar mogelijk, met alle zonneomvormers en MPPT apparatuur online. Een omvormer die nul watt produceert kan nog steeds een geldig geïnstalleerd apparaat zijn, terwijl een omvormer die volledig offline is misschien helemaal niet verschijnt.
- Bekijk de waarschuwingen over de energiebron. Voordat de sensoren worden gemaakt, laat Clevr zien hoe elke energiewaarde wordt verkregen. Wanneer de GX een geschikte inheemse energieteller blootlegt, gebruikt Clevr het. Wanneer er geen geschikt native net of batterij energieteller beschikbaar is, kan de integratie een duidelijk geïdentificeerde geraamde energiesensor gebaseerd op gemeten vermogen. Bekijk deze waarschuwingen alvorens verder te gaan.
- Maak de sensoren. Bevestig het laatste scherm en Home Assistant zal een nieuw Clevr GX-apparaat maken samen met de ontdekte sensoren en berekende data feeds.
- Controleer de waarden. Open het nieuw aangemaakte Clevr GX-apparaat in Home Assistant en vergelijk de weergegeven waarden met uw Victron GX-interface. U moet ook controleren Ontwikkelaarsgereedschappen → Staten en Ontwikkelaarsgereedschappen → Statistieken om te bevestigen dat de energiesensoren correct worden geregistreerd.
Welke sensors worden gemaakt?
De exacte set is afhankelijk van de apparatuur die in uw installatie is ontdekt.
Zo kan een systeem dat Victron MPPT-laders en een Fronius-omvormer bevat, samen met verschillende geaggregeerde Clevr-sensoren afzonderlijke bronsensoren produceren.
Belangrijke paneelgegevens omvatten:
| Sensortype | Betreft |
|---|---|
| MPPT-vermogen | Gecombineerde directe uitgang van de geselecteerde Victron MPPT-laders |
| AC PV-vermogen | Gecombineerde stroom van wisselstroomgekoppelde PV-omvormers zoals Fronius |
| AC PV-outputvermogen | PV-opwekking die specifiek op de uitgang van de GX AC is aangesloten |
| Raster Import / Export Energy | Energie ingevoerd uit en uitgevoerd naar het net |
| Batterijlading/ontladingsenergie | Energie stroomt in en uit de batterij |
| Energie-snapshot | Compacte energie-informatie gebruikt door het Clevr-display |
| Geschiedenis Snapshot | Op de recorder gebaseerde uur- en meerdaagse geschiedenis voor het Clevr-scherm |
Waar meerdere zonneladers zijn geïnstalleerd, kan Clevr ze automatisch combineren in plaats van de firmware van het display nodig te hebben om elk apparaat ID te kennen.
Dit is vooral handig wanneer een systeem later wordt uitgebreid met extra MPPT-laders.
Inheemse en geschatte energiesensoren
Clevr geeft altijd de voorkeur aan energietellers die direct door de apparatuur worden gerapporteerd.
Soms echter, een GX-installatie bloot onmiddellijk vermogen, maar biedt geen geschikte cumulatieve energieteller voor een bepaalde rol. In deze situaties kan Clevr een geraamde energieteller van het gemeten vermogen.
Geschatte sensoren worden bewust als zodanig geïdentificeerd.
Er is één belangrijk verschil: een geschatte teller kan alleen energie ophopen terwijl Home Assistant data draait en ontvangt. Als Home Assistant is offline voor een uur, de integratie niet uitvinden of interpoleren de ontbrekende consumptie voor dat uur.
Native apparaattellers hebben daarom de voorkeur wanneer ze beschikbaar zijn.
Historische gegevens en Home Assistant Recorder
Het Clevr GX Panel hoeft zijn eigen langetermijnenergiedatabase niet op te slaan.
In plaats daarvan gebruikt Clevr Home Assistant Recorder statistieken om de uur- en daggeschiedenis op het paneel voor te bereiden.
Dit heeft verschillende voordelen. Het display kan opnieuw opstarten zonder geschiedenis te verliezen, meerdere displays kunnen dezelfde gegevens gebruiken, en historische informatie blijft centraal beheerd door Home Assistant.
Als u een aangepaste recorder gebruikt include configuratie, zorg ervoor dat de nieuw gecreëerde energiesensoren van Clevr zijn opgenomen.
Onthoud ook dat het installeren van de integratie vandaag kan niet opnieuw per uur Home Assistant statistieken van voordat de sensoren bestonden. De eerste dag na de installatie mag daarom slechts gedeeltelijke geschiedenis bevatten.
Download het Clevr Diagnostics bestand
Zodra de installatie correct werkt, download de integratie's Diagnostica bestand van Home Assistant.
Dit bestand is vooral nuttig bij het configureren van een Clevr GX-paneel omdat het de informatie bevat die nodig is om de ontdekte installatie te identificeren, inclusief de inventaris van de apparatuur, geselecteerde energiebronnen, faseconfiguratie en de werkelijke Home Assistant entiteit ID's gemaakt op uw systeem.
De uitvoer van diagnostiek bevat uw MQTT gebruikersnaam of wachtwoord niet.
Bewaar dit bestand als uw Clevr GX Panel speciaal voor uw installatie wordt voorbereid.
Problemen oplossen: “Geen verse GX-data”
Als Clevr No fresh GX data, de integratie is correct geïnstalleerd, maar Home Assistant ontvangt niet de GX gegevens die nodig zijn voor ontdekking.
Controleer of de MQTT-integratie van Home Assistant is aangesloten en verifieer de Poort-ID en MQTT-voorvoegsel.
Als u een MQTT-brug gebruikt, moet deze in beide richtingen werken:
- GX → Home Assistant voor de
N/databoom - Home Assistant → GX voor
R/lees verzoeken
Bijvoorbeeld, als Home Assistant ontvangt victron/N/<portal-id>/system/0/..., moet het ook mogelijk zijn om victron/R/<portal-id>/keepalive Terug naar het GX apparaat.
Clevr stuurt automatisch deze keepalive verzoeken terwijl de integratie loopt.
Een zonne-inverter ontbreekt
Als een Fronius of een andere PV inverter niet verschijnt tijdens de ontdekking, controleer dan eerst of het momenteel zichtbaar is op het GX apparaat.
Zonne-energie-apparatuur moet bij voorkeur tijdens daglicht worden ontdekt met elke omvormer aangedreven en communicerend.
Ga er niet van uit dat een apparaat afwezig is omdat het vermogen momenteel nul is. Omgekeerd kan een volledig offline inverter helemaal niet in de ontdekkingsgegevens verschijnen.
Corrigeer eerst het communicatieprobleem en herhaal dan de Clevr integratie setup.
Energie of geschiedenis is niet beschikbaar
Een niet-beschikbare energiewaarde geeft niet noodzakelijkerwijs een installatieprobleem aan.
Sommige Victron-apparaten of verbindingsmethoden stellen eenvoudigweg niet de inheemse energietellers bloot die voor die meting nodig zijn.
Clevr vermijdt bewust historische informatie te fabriceren wanneer de brongegevens onvolledig zijn.
Controleer voor Recorder-gebaseerde geschiedenis ook of de bijbehorende sensoren worden opgenomen door Home Assistant en niet zijn uitgesloten door een aangepaste Recorder configuratie.
Lokaal op ontwerp
Het datapad dat gebruikt wordt door de Clevr integratie kan volledig binnen uw lokale netwerk blijven.
Home Assistant communiceert met de MQTT-makelaar die al is geconfigureerd voor de installatie, en de integratie maakt gebruik van de lokale GX-gegevens die via die makelaar worden blootgesteld.
De integratie beperkt zich ook tot het lezen van de gegevens die nodig zijn voor ontdekking, energie boekhouding en het Clevr display. Het gebruikt geen MQTT schrijfopdrachten om Victron instellingen te wijzigen.
Van Home Assistant naar het Clevr GX Panel
Zodra de integratie is geïnstalleerd en de gedetecteerde waarden zijn geverifieerd, wordt Home Assistant de stabiele datalaag tussen uw Victron installatie en de Clevr GX-paneel.
Het paneel kan gebruik maken van de door Clevr gegenereerde zonne aggregaten, energie-informatie en Recorder-backed geschiedenis zonder dat elke installatie van de klant exact dezelfde Victron of Fronius apparaat ID's hoeft te hebben.
Dat betekent dat een systeem met één MPPT, meerdere MPPT-laders, een AC-gekoppelde Fronius omvormer, verschillende rastermeters of verschillende faseconfiguraties kunnen worden weergegeven via dezelfde Clevr display interface.
Installeer de integratie eenmaal, bekijk wat Clevr ontdekt, en laat Home Assistant een consistente interface bieden naar de rest van het ecosysteem van Clevr.
Klaar voor het panel? De Victron GX-vervanging – 4 inch gebruikt precies deze integratie. Drukken Instellen, upload uw diagnostics bestand, en uw paneel code is gebouwd voor uw installatie.