Dacă utilizaţi deja Dispozitiv Victron GX, cum ar fi un Cerbo GX pentru a gestiona instalaţia dumneavoastră solară şi de baterii, o cantitate mare de date utile în timp real sunt deja disponibile la nivel local: energie de reţea, starea bateriei, producţia solară, încărcăturile de curent alternativ, producţia de MPPT şi, acolo unde sunt instalate, date obţinute de la invertoare solare, cum ar fi Fronius.
ă Clevr Victron Panel Integrare pentru Home Assistant transforma datele intr-un set curat de Home Assistant senzori care pot fi folosite de Clevr GX Panel, borduri, automatizari si alte dispozitive Home Assistant.
Spre deosebire de instalațiile vechi bazate pe senzori YAML creați manual, integrarea Clevr descoperă automat echipamentul conectat la sistemul GX și vă permite să revizuiți configurația detectată înainte de a crea senzorii.
Există nu este necesară modificarea configuration.yaml.
Ce face integrarea Victron Clevr
Integrarea se conectează la datele existente ale Victron GX MQTT prin integrarea MQTT Home Assistant.
În timpul instalării descoperă echipamentul Victron disponibil pe sistemul GX, inclusiv:
| Sursa datelor | Exemple |
|---|---|
| Sistemul Victron | Încărcături de rețea, AC și puterea sistemului |
| Baterie | Energie de încărcare și descărcare |
| Încărcătoare solare MPPT | Victron SmartSolar și alte încărcătoare conectate la GX |
| Invertoare solare AC | Fronius și alți invertori expuși de GX sub formă de invertoare fotovoltaice |
| Contoare de rețea | Energie de import și export în rețea |
| Home Assistant de înregistrare | Date privind energia orare, zilnice și istorice |
Integrarea creează, de asemenea, senzori solari agregate și fluxuri de istorie speciale utilizate de Panou GX Clevr.
Home Assistant rămâne responsabil pentru stocarea informațiilor istorice. Acest lucru înseamnă că afișarea Clevr poate fi oprită sau reluată fără a pierde istoricul energetic deja înregistrat de Home Assistant.

Înainte de a începe
Veţi avea nevoie de:
- Asistent la domiciliu cu Integrarea MQTT configurată (vezi Conectați Home Assistant MQTT la un GX Victron dacă nu ați stabilit încă acest lucru)
- Un dispozitiv Victron GX accesibil prin MQTT
- GX ID-ul portalului VRM
- Pachetul de integrare Clevr Victron, descărcat de la Clevr House (vei găsi descărcarea în Configurator panou Clevr GX)
Datele dvs. Victron MQTT trebuie să fie deja disponibile brokerului MQTT utilizat de Home Assistant.
O instalație tipică pod va expune subiecte Victron similare cu:
victron/N/<portal-id>/...
și permite Home Assistant să trimită cereri de citire înapoi prin:
victron/R/<portal-id>/...
ă N/ subiectele poartă notificări și date de la dispozitivul GX. ă R/ subiectele permit integrării să solicite informații noi și să mențină fluxul de date GX MQTT activ.
Integrarea Clevr utilizează automat aceste cereri de citire. Ea nu trimite Victron W/ scrie comenzi și nu schimbă setările pe sistemul GX.
Dacă brokerul MQTT utilizează un alt prefix decât victron/Notează asta pentru că vei avea nevoie de ea în timpul configuraţiei.
Instalarea integrării
- Creează un asistent de rezervă. Înainte de a adăuga orice integrare personalizată, recomandăm crearea unui ajutor Home Assistant de la Configurări → Sistem → Întăriri.
- Descărcaţi şi extrageţi pachetul Clevr. După descărcarea integrării, extrageți fișierul ZIP de pe computer. Înăuntru vei găsi
config/custom_components/clevr_victron. - Copiază integrarea în Home Assistant. Copiază complet
clevr_victrondosar în/config/custom_components/. Structura finală ar trebui să arate ca/config/custom_components/clevr_victron/manifest.json.Puteţi transfera fişierele folosind oricare metodă utilizaţi în mod normal pentru a accesa configuraţia Home Assistant, cum ar fi Studio Code Server, Samba sau SSH/SCP. Ai grijă să nu creezi un nivel suplimentar de director, cum ar fi
/config/custom_components/clevr_victron/clevr_victron/. - Restart Home Assistant. O repornire completă Home Assistant este necesară după instalarea fișierelor.
- Adăugați integrarea Clevr. Deschide Configurări → Dispozitive & servicii, selectați Adaugă integrare, caută Panou Victron ClevrŞi alege-l.
- Introduceți setările MQTT. Integrarea cere două valori: Prefix pod MQTT şi ID-ul portalului GX.
Pentru o instalare comună în care Victron GX este conectat la Home Assistant MQTT broker de mai jos
victron/, intravictron/ca prefix al podului MQTT. Dacă Home Assistant este conectat direct la brokerul GX MQTT și subiectele încep direct cuN/Lasă prefixul gol.ID-ul portalului GX identifică unic instalarea Victron.
- Lasă-l pe Clevr să descopere instalaţia GX. Odată continuat, Clevr solicită un set nou de date de la dispozitivul GX și examinează echipamentul disponibil. Scanarea caută sistemul, VE. Echipament de autobuz, dispozitive de baterie, contoare de grilă, încărcătoare solare Victron și invertoare fotovoltaice AC.
- Revizuiţi cu atenţie echipamentul detectat. Următorul ecran nu este complet automat. Echipamentul solar poate dispărea din datele GX atunci când este offline, astfel încât Clevr vă cere să confirmați ce a fost găsit.
Selectează corect Contor de energie în rețea, Contor de energie al bateriei, și toate instalate Dispozitive solare. Apoi confirma care faze sunt de fapt prezente pentru Grilă, Încărcături de intrare în curent alternativ, și Încărcături de ieșire AC.
Efectuați descoperirea inițială în timpul zilei ori de câte ori este posibil, cu toate invertoare solare și echipamente MPPT on-line. Un invertor care produce zero wați poate fi încă un dispozitiv instalat valabil, în timp ce un invertor care este complet offline nu poate apărea deloc.
- Revizuirea avertismentelor privind sursele de energie. Înainte de crearea senzorilor, Clevr arată cum va fi obținută fiecare valoare energetică. Ori de câte ori GX expune un contor de energie nativ adecvat, Clevr îl folosește. Atunci când nu este disponibilă o rețea nativă adecvată sau un contor de energie al bateriei, integrarea poate crea o identificare clară senzor de energie estimat pe baza puterii măsurate. Examinaţi aceste avertismente înainte de a continua.
- Creează senzorii. Confirmați ecranul final și Home Assistant va crea un nou dispozitiv Clevr GX împreună cu senzorii descoperiți și fluxurile de date calculate.
- Verifică valorile. Deschideți noul dispozitiv Clevr GX creat în Home Assistant și comparați valorile afișate cu interfața Victron GX. Ar trebui să verifici şi tu. Instrumente dezvoltator → State şi Instrumente dezvoltator → Statistici să confirme că senzorii de energie sunt înregistraţi corect.
Ce senzori sunt creaţi?
Setul exact depinde de echipamentul descoperit în instalația dumneavoastră.
De exemplu, un sistem care conține încărcătoare MPPT Victron și un invertor Fronius poate produce senzori de sursă separați împreună cu mai mulți senzori Clevr agregati.
Datele importante cu vedere spre panou includ:
| Tip de senzor | Scop |
|---|---|
| Putere MPPT | Ieșire instantanee combinată a încărcătoarelor MPPT Victron selectate |
| Putere PV AC | Puterea combinată a invertoarelor fotovoltaice racordate la AC, cum ar fi Fronius |
| Putere de ieșire PV AC | Generarea de PV conectată în mod specific la partea de ieșire GX AC |
| Import grilă / Export energie | Energie importată și exportată în rețea |
| Încărcătură baterie / Energie de descărcare | Energia curge în și din baterie |
| Snapshot de energie | Informații compacte privind energia utilizate de ecranul Clevr |
| Snapshot istoric | Istoric orar și multi-zile pentru afișarea Clevr |
În cazul în care sunt instalate mai multe încărcătoare solare, Clevr le poate combina automat în loc să solicite firmware-ului de afișare să cunoască fiecare dispozitiv individual de identificare.
Acest lucru este deosebit de util atunci când un sistem este extins mai târziu cu încărcătoare MPPT suplimentare.
Senzori de energie nativi și estimați
Clevr preferă contoarele de energie raportate direct de echipament.
Cu toate acestea, uneori, o instalație GX expune energie instantanee, dar nu oferă un contor de energie cumulativ adecvat pentru un anumit rol. În aceste situaţii, Clevr poate obţine contor de energie estimat de la puterea măsurată.
Senzorii estimați sunt identificați în mod deliberat ca atare.
Există o diferență importantă: un contor estimat poate acumula energie doar în timp ce Home Assistant rulează și primește date. Dacă Home Assistant este offline pentru o oră, integrarea nu inventează sau interpolează consumul lipsă pentru acea oră.
Prin urmare, contoarele de dispozitive native sunt preferate ori de câte ori sunt disponibile.
Date istorice și înregistrare Home Assistant
Grupul Clevr GX nu trebuie să stocheze propria bază de date energetică pe termen lung.
În schimb, Clevr folosește Acasă Statistici asistent Recorder pentru a pregăti istoricul orar și zilnic afișat pe panou.
Acest lucru are mai multe avantaje. Afisajul poate reporni fara sa piarda istoria, mai multe afise pot folosi aceleasi date, iar informatiile istorice raman gestionate central de Home Assistant.
Dacă utilizați un recorder personalizat include configurare, asigurați-vă că senzorii de energie Clevr nou create sunt incluse.
De asemenea, amintiți-vă că instalarea integrării astăzi nu poate recrea statistici pe oră Home Assistant înainte ca senzorii să existe. Prin urmare, prima zi după instalare poate conține doar istoricul parțial.
Descărcați fișierul Clevr Diagnostics
Odată ce instalația funcționează corect, descărcați integrarea Diagnostice dosar de la Home Assistant.
Acest fișier este deosebit de util atunci când se configurează un panou Clevr GX deoarece conține informațiile necesare pentru identificarea instalației descoperite, inclusiv inventarul echipamentelor, sursele de energie selectate, configurația fazei și ID-urile reale Home Assistant entity create pe sistemul dumneavoastră.
Diagnosticul exportă nu conține numele de utilizator sau parola MQTT.
Păstrați acest fișier dacă Clevr GX Panel va fi pregătit special pentru instalarea dumneavoastră.
Depanare: “Fără date GX proaspete”
Dacă Clevr raportează No fresh GX data, integrarea este instalată corect, dar Home Assistant nu primește datele GX necesare pentru descoperire.
Verificați dacă integrarea MQTT Home Assistant este conectată și verificați ID portal şi Prefix MQTT.
Dacă utilizați un pod MQTT, acesta trebuie să funcționeze în ambele direcții necesare:
- GX → Asistent la domiciliu pentru
N/arbore de date - Home Assistant → GX pentru
R/a citi cererile
De exemplu, în cazul în care Home Assistant primește victron/N/<portal-id>/system/0/..., trebuie să fie, de asemenea, posibil pentru a trimite victron/R/<portal-id>/keepalive înapoi la dispozitivul GX.
Clevr trimite automat aceste cereri în timp ce integrarea se execută.
Lipseşte un Invertor Solar
Dacă un Fronius sau un alt invertor PV nu apare în timpul descoperirii, verificați mai întâi dacă este vizibil în prezent pe dispozitivul GX.
Echipamentele solare ar trebui să fie de preferat descoperite în timpul zilei cu fiecare invertor alimentat și comunicativ.
Nu presupuneți că un dispozitiv este absent doar pentru că puterea sa este în prezent zero. Invers, un invertor complet offline nu poate apărea în datele de descoperire, la toate.
Corectați problema comunicării mai întâi și apoi repetați configurarea integrării Clevr.
Energia sau istoria nu este disponibilă
O valoare energetică indisponibilă nu indică neapărat o problemă de instalare.
Unele dispozitive Victron sau metode de conectare pur și simplu nu expune contoarele de energie native necesare pentru această măsurare.
Clevr evită în mod deliberat fabricarea informațiilor istorice atunci când datele sursă sunt incomplete.
Pentru istoricul bazat pe Recorder, verificați, de asemenea, dacă senzorii corespunzători sunt înregistrați de Home Assistant și nu au fost excluși printr-o configurație personalizată de înregistrare.
Local de proiectare
Calea de date utilizată de integrarea Clevr poate rămâne în întregime în cadrul rețelei locale.
Home Assistant comunică cu brokerul MQTT deja configurat pentru instalare, iar integrarea utilizează datele locale GX expuse prin intermediul acelui broker.
Integrarea se limitează, de asemenea, la citirea datelor necesare pentru descoperire, contabilitate energetică și afișarea Clevr. Nu folosește comenzi MQTT pentru a modifica setările Victron.
De la Home Assistant la Clevr GX Panel
Odată ce integrarea este instalată și valorile detectate au fost verificate, Home Assistant devine stratul de date stabil între instalarea Victron și Panou GX Clevr.
Panoul poate utiliza agregatele solare generate de Clevr, informaţiile despre energie şi istoria recorder-backed fără a solicita fiecărei instalaţii client să aibă exact aceleaşi identităţi ale dispozitivului Victron sau Fronius.
Aceasta înseamnă că un sistem cu un singur MPPT, mai multe încărcătoare MPPT, un invertor Fronius cuplat cu AC, diferite contoare de rețea sau diferite configurații de fază pot fi reprezentate prin aceeași interfață de afișare Clevr.
Instalați integrarea o dată, revizuiți ceea ce Clevr descoperă, și lăsați Home Assistant să ofere o interfață consecventă pentru restul ecosistemului Clevr.
Gata pentru panou? ă Înlocuirea Victron GX – 4 inch folosește exact această integrare. Apăsați Configurează, încărcați fișierul diagnostic, și codul panoul este construit pentru instalarea dumneavoastră.