From 47521da029cc4806fc438f79ded1b9495780d9be Mon Sep 17 00:00:00 2001
From: naltatis Legt den Soll-Arbeitspunkt der Überschussregelung am Netzübergang (Gridmeter) fest. Der Standardwert ist 0 (Watt).
-Negative Werte verschieben den Sollwert in Richtung Netzeinspeisung, positive Werte in Richtung Netzbezug.
+Positive Werte verschieben den Sollwert in Richtung Netzeinspeisung, negative Werte in Richtung Netzbezug.
Mit diesem Wert wird der durch die Steuerung einzustellende "Ruhezustand" des Regelkreises eingestellt. Insbesondere im Zusammenspiel mit weiteren unabhängigen Überschussausregelungen wie z. B. der eines Batteriespeichers ist es obligatorisch, diesen Wert anzupassen, um ein definiertes Systemverhalten mit klaren Prioritäten zu erzielen. Soll im PV-Modus ein Netzbezugsanteil verbleiben bzw. zugelassen werden, muss hier eine negative Leistung entsprechend des Maximalanteils des Netzbezugs konfiguriert werden. Beispiel "Netzbezugsanteil": Die Ladung soll im PV-Modus mit mindestens 6A (einphasig) auch bereits mit nur 50% PV-Anteil beginnen (Rest Netzbezug)
-Mindestladeleistung: 1 Phase _ 6A _ 230V = 1380 W, davon 50%: 690 Wtitle
",id:"title",level:3},{value:"meters
",id:"meters",level:3},{value:"Optionale Parameter",id:"optionale-parameter",level:2},{value:"meters.grid
",id:"metersgrid",level:3},{value:"meters.pv
",id:"meterspv",level:3},{value:"meters.battery
",id:"metersbattery",level:3},{value:"meters.aux
",id:"metersaux",level:3},{value:"prioritySoc
",id:"prioritysoc",level:3},{value:"bufferSoc
",id:"buffersoc",level:3},{value:"bufferStartSoc
",id:"bufferstartsoc",level:3},{value:"residualPower
",id:"residualpower",level:3},{value:"grid
meter
vorhanden",id:"grid-meter-vorhanden",level:4},{value:"Nur pv
meter
vorhanden",id:"nur-pv-meter-vorhanden",level:4},{value:"smartCostLimit
(ehemals cheap
)",id:"smartcostlimit-ehemals-cheap",level:3},{value:"maxGridSupplyWhileBatteryCharging
",id:"maxgridsupplywhilebatterycharging",level:3}];function o(e){const n={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",h3:"h3",h4:"h4",hr:"hr",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,s.a)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(n.h1,{id:"site",children:(0,i.jsx)(n.code,{children:"site"})}),"\n",(0,i.jsx)(n.p,{children:"Beschreibt den Standort mit den vorhandenen und ben\xf6tigten Ger\xe4ten der Hausinstallation und ist f\xfcr das Regeln der verf\xfcgbaren Leistung zust\xe4ndig."}),"\n",(0,i.jsx)(n.p,{children:"Um das Laden mit PV-\xdcberschuss zu regeln, ist ein auslesbarer Z\xe4hler direkt hinter dem Netzanschlusspunkt notwendig. Zus\xe4tzlich k\xf6nnen auch Ger\xe4te f\xfcr die PV-Leistung und Hausbatterie(n) angegeben werden. Mehrere Ger\xe4te werden dabei in der Leistung intern automatisch addiert. Bei Batteriespeichern wird der Mittelwert des Ladezustands gebildet."}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"site:\n - title: Zuhause # display name for UI\n meters:\n grid: mygridmeter # grid meter reference\n pv: # (pvs = veraltet)\n - mypv1 # first pv meter reference\n - mypv9 # second pv meter reference\n battery: # (batteries = veraltet)\n - mybat5 # battery meter reference\n aux:\n - myaux1\n residualPower: 100\n bufferSoc: 80\n prioritySoc: 66\n"})}),"\n",(0,i.jsx)(n.hr,{}),"\n",(0,i.jsx)(n.h2,{id:"erforderliche-parameter",children:"Erforderliche Parameter"}),"\n",(0,i.jsx)(n.h3,{id:"title",children:(0,i.jsx)(n.code,{children:"title"})}),"\n",(0,i.jsx)(n.p,{children:"Die angezeigte Beschreibung des Ladepunktes, wird in der UI angezeigt."}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"title: Zuhause\n"})}),"\n",(0,i.jsx)(n.hr,{}),"\n",(0,i.jsx)(n.h3,{id:"meters",children:(0,i.jsx)(n.code,{children:"meters"})}),"\n",(0,i.jsxs)(n.p,{children:["Definiert welche konfigurierten ",(0,i.jsx)(n.a,{href:"meters",children:(0,i.jsx)(n.code,{children:"meter"})})," (Strommessger\xe4te) als welche Art Messpunkt verwendet werden sollen.\nHier erfolgt somit die logische Verkn\xfcpfung der Ger\xe4tedefiniton mit dem Verwendungszweck.\nEin zun\xe4chst universeller Z\xe4hler bekommt somit entsprechend seines Einbauortes in der Hausinstallation einen Zweck zugewiesen."]}),"\n",(0,i.jsx)(n.admonition,{type:"note",children:(0,i.jsxs)(n.p,{children:["Es ist mindestens die Konfiguration eines ",(0,i.jsx)(n.code,{children:"grid"})," oder eines ",(0,i.jsx)(n.code,{children:"pv"})," Elementes notwendig!\nOhne mindestens einen der beiden Eintr\xe4ge kann evcc nicht verwendet werden!"]})}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"site:\n meters:\n grid: mygridmeter # grid meter reference\n pv: mypv1 # pv meter reference\n battery: mybat2 # battery meter reference\n aux: myaux1\n"})}),"\n",(0,i.jsx)(n.hr,{}),"\n",(0,i.jsx)(n.h2,{id:"optionale-parameter",children:"Optionale Parameter"}),"\n",(0,i.jsx)(n.h3,{id:"metersgrid",children:(0,i.jsx)(n.code,{children:"meters.grid"})}),"\n",(0,i.jsxs)(n.p,{children:["Definiert das ",(0,i.jsx)(n.a,{href:"meters",children:(0,i.jsx)(n.code,{children:"meter"})})," (Strommessger\xe4t), welches die Messwerte des Netzanschlusspunktes liefert."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"M\xf6gliche Werte"}),": Wert eines ",(0,i.jsx)(n.code,{children:"name"})," Parameters in der ",(0,i.jsx)(n.a,{href:"#meters",children:(0,i.jsx)(n.code,{children:"meters"})})," Konfiguration."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"grid: mygridmeter # grid meter reference\n"})}),"\n",(0,i.jsx)(n.hr,{}),"\n",(0,i.jsx)(n.h3,{id:"meterspv",children:(0,i.jsx)(n.code,{children:"meters.pv"})}),"\n",(0,i.jsxs)(n.p,{children:["Definiert die ",(0,i.jsx)(n.a,{href:"meters",children:(0,i.jsx)(n.code,{children:"meter"})})," (Strommessger\xe4te), welche die PV-Erzeugungswerte liefern.\nEs k\xf6nnen mehrere Ger\xe4te angegeben werden. Die Leistungsdaten werden automatisch addiert."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"M\xf6gliche Werte"}),": Ein Wert oder eine Liste von Werten eines ",(0,i.jsx)(n.code,{children:"name"})," Parameters in der ",(0,i.jsx)(n.a,{href:"#meters",children:(0,i.jsx)(n.code,{children:"meters"})})," Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"pv: myonlypv # single pv meter reference\n"})}),"\n",(0,i.jsx)(n.p,{children:"oder"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"pv: # (pvs = veraltet)\n - myoldpv # first pv meter reference\n - mynewestpv # second pv meter reference\n"})}),"\n",(0,i.jsx)(n.hr,{}),"\n",(0,i.jsx)(n.h3,{id:"metersbattery",children:(0,i.jsx)(n.code,{children:"meters.battery"})}),"\n",(0,i.jsxs)(n.p,{children:["Definiert die ",(0,i.jsx)(n.a,{href:"meters",children:(0,i.jsx)(n.code,{children:"meter"})})," (Strommessger\xe4te), welche die Messdaten des/der Batteriespeicher(s) liefern.\nEs k\xf6nnen mehrere Ger\xe4te angegeben werden. Die Leistungsdaten werden automatisch addiert und aus den Speicherf\xfcllst\xe4nden wird ein Mittelwert gebildet."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"M\xf6gliche Werte"}),": Ein Wert oder eine Liste von Werten eines ",(0,i.jsx)(n.code,{children:"name"})," Parameters in der ",(0,i.jsx)(n.a,{href:"#meters",children:(0,i.jsx)(n.code,{children:"meters"})})," Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"battery: myonlybat # single battery meter reference\n"})}),"\n",(0,i.jsx)(n.p,{children:"oder"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"battery: # (batteries = veraltet)\n - mysmallbat # first battery meter reference\n - myhugebat # second battery meter reference\n"})}),"\n",(0,i.jsx)(n.h3,{id:"metersaux",children:(0,i.jsx)(n.code,{children:"meters.aux"})}),"\n",(0,i.jsx)(n.p,{children:"Definiert die meter (Strommessger\xe4te), welche die Messdaten externer Ger\xe4te liefern, die \xfcber eine eigene \xdcberschussregelung verf\xfcgen, aber nicht direkt durch evcc gesteuert werden. Es k\xf6nnen mehrere Ger\xe4te angegeben werden. Die Leistungsdaten werden automatisch addiert."}),"\n",(0,i.jsx)(n.p,{children:"In evcc flie\xdft diese Leistung in die Berechnung der prinzipiell zur Verf\xfcgung stehenden \xdcberschussleistung zur Fahrzeugladung ein.\nEs wird davon ausgegangen, dass die mittels der Aux-Meter gemessenen Ger\xe4te ihren Leistungsbedarf selbstst\xe4ndig und zeitnah reduzieren bzw. vollst\xe4ndig unterbrechen, wenn die gemessene Aux-Leistung durch evcc der Fahrzeugladung zugeschlagen wird."}),"\n",(0,i.jsx)(n.p,{children:"Positiver Wert: zus\xe4tzliche verf\xfcgbare \xdcberschussleistung (steht der Fahrzeugladung zur Verf\xfcgung)"}),"\n",(0,i.jsx)(n.p,{children:"Negativer Wert: fehlende \xdcberschussleistung (steht der Fahrzeugladung nicht zur Verf\xfcgung)"}),"\n",(0,i.jsx)(n.p,{children:"Beispiele:"}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsxs)(n.li,{children:["Ein Heizstab f\xfcr die Warmwasserbereitung, welcher autark auf Basis des PV-\xdcberschuss am Netz\xfcbergang geregelt wird. Wenn die Leistungsmessung dieses Heizstabes als ",(0,i.jsx)(n.code,{children:"aux"}),"-Meter gemessen und eingerichtet wird, steht die gesamte \xdcberschussleistung (Leistung des Heizstabs plus ggf. verbleibende Netzeinspeisung) jederzeit bevorzugt der Fahrzeugladung zur Verf\xfcgung. Greift die Fahrzeugladung darauf zu, sorgt die autarke Regelung des Heizstabes selbstst\xe4ndig daf\xfcr, dass dessen Leistung entsprechend reduziert wird."]}),"\n"]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"M\xf6gliche Werte"}),": Ein Wert oder eine Liste von Werten eines ",(0,i.jsx)(n.code,{children:"name"})," Parameters in der ",(0,i.jsx)(n.a,{href:"#meters",children:(0,i.jsx)(n.code,{children:"meters"})})," Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"aux: myaux # single aux meter reference\n"})}),"\n",(0,i.jsx)(n.p,{children:"oder"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"aux:\n - myaux1 # first aux meter reference\n - myaux2 # second aux meter reference\n"})}),"\n",(0,i.jsx)(n.h3,{id:"prioritysoc",children:(0,i.jsx)(n.code,{children:"prioritySoc"})}),"\n",(0,i.jsx)(n.admonition,{title:"veraltet in yaml",type:"note",children:(0,i.jsx)(n.p,{children:"Dieser Wert kann und sollte \xfcber den Batterieeinstellungen-Dialog in der UI konfiguriert werden."})}),"\n",(0,i.jsx)("img",{src:t,style:{maxWidth:400}}),"\n",(0,i.jsx)(n.p,{children:"Die Ladung der Hausbatterie hat unterhalb des angegebenen Soc (%) Wertes Priorit\xe4t gegen\xfcber der Fahrzeugladung.\nSteht unterhalb dieses Wertes mehr Erzeugungsleistung zur Verf\xfcgung als der Batteriespeicher aufnimmt, kann dieser \xdcberschuss trotzdem nachrangig zur Fahrzeugladung verwendet werden.\nWenn die Hausbatterie oberhalb des Wertes geladen wird, wird die Batterieladeleistung f\xfcr das Laden des EVs als verf\xfcgbare \xdcberschussleistung betrachtet. Somit hat dann die Fahrzeugladung Priorit\xe4t bei der Verwendung der \xdcberschussleistung.\nIst deaktiviert (entspricht 0%) wenn kein Wert angegeben wird."}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"prioritySoc: 50 # Hausbatterie bekommt bis zum Soc 50% Priorit\xe4t beim laden\n"})}),"\n",(0,i.jsx)(n.h3,{id:"buffersoc",children:(0,i.jsx)(n.code,{children:"bufferSoc"})}),"\n",(0,i.jsx)(n.admonition,{title:"veraltet in yaml",type:"note",children:(0,i.jsx)(n.p,{children:"Dieser Wert kann und sollte \xfcber den Batterieeinstellungen-Dialog in der UI konfiguriert werden."})}),"\n",(0,i.jsx)("img",{src:d,style:{maxWidth:400}}),"\n",(0,i.jsx)(n.p,{children:"Erlaubt das Entladen einer Hausbatterie oberhalb des angegebenen Soc (%) Wertes, wenn zu wenig Solar\xfcberschuss (unterhalb der Mindestladeleistung) zur Verf\xfcgung steht. Somit werden Schwankungen in der Erzeugung oder beim Verbrauch prim\xe4r von der Hausbatterie ausgeglichen. Reicht die Entladeleistung der Hausbatterie nicht aus, um die Mindestladeleistung des Fahrzeugs zu liefern, wird der Rest aus dem Netz bezogen."}),"\n",(0,i.jsxs)(n.p,{children:["Es wird im Modus ",(0,i.jsx)(n.code,{children:"PV"})," automatisch ein Ladevorgang gestartet, sobald genug Solar\xfcberschuss vorhanden ist."]}),"\n",(0,i.jsx)(n.p,{children:"Ist deaktiviert (entspricht >100%) wenn kein Wert angegeben wird."}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"bufferSoc: 80 # Hausbatterie wird oberhalb Soc 80% als Puffer genutzt\n"})}),"\n",(0,i.jsx)(n.h3,{id:"bufferstartsoc",children:(0,i.jsx)(n.code,{children:"bufferStartSoc"})}),"\n",(0,i.jsx)(n.admonition,{title:"veraltet in yaml",type:"note",children:(0,i.jsx)(n.p,{children:"Dieser Wert kann und sollte \xfcber den Batterieeinstellungen-Dialog in der UI konfiguriert werden."})}),"\n",(0,i.jsx)("img",{src:a,style:{maxWidth:400}}),"\n",(0,i.jsxs)(n.p,{children:["Erlaubt im Modus ",(0,i.jsx)(n.code,{children:"PV"})," den Start eines Ladevorgangs oberhalb des angegebenen Soc (%) Wertes, auch wenn nicht genug Solar\xfcberschuss vorhanden ist."]}),"\n",(0,i.jsx)(n.p,{children:"Reicht die Entladeleistung der Hausbatterie nicht aus, um die Mindestladeleistung des Fahrzeugs zu liefern, wird der Rest aus dem Netz bezogen."}),"\n",(0,i.jsxs)(n.p,{children:["Kann im UI nur ge\xe4ndert werden, wenn ",(0,i.jsx)(n.code,{children:"bufferSoc"})," < 100% eingestellt ist"]}),"\n",(0,i.jsx)(n.p,{children:"Ist deaktiviert (entspricht 0%) wenn kein Wert angegeben wird."}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"bufferStartSoc: 90 # hat die Hausbatterie Soc 90& erreicht, startet der Ladevorgang\n"})}),"\n",(0,i.jsx)(n.h3,{id:"residualpower",children:(0,i.jsx)(n.code,{children:"residualPower"})}),"\n",(0,i.jsx)(n.p,{children:'Legt den Soll-Arbeitspunkt der \xdcberschussregelung am Netz\xfcbergang (Gridmeter) fest. Der Standardwert ist 0 (Watt).\nNegative Werte verschieben den Sollwert in Richtung Netzeinspeisung, positive Werte in Richtung Netzbezug.\nMit diesem Wert wird der durch die Steuerung einzustellende "Ruhezustand" des Regelkreises eingestellt.'}),"\n",(0,i.jsx)(n.p,{children:"Insbesondere im Zusammenspiel mit weiteren unabh\xe4ngigen \xdcberschussausregelungen wie z. B. der eines Batteriespeichers ist es obligatorisch, diesen Wert anzupassen, um ein definiertes Systemverhalten mit klaren Priorit\xe4ten zu erzielen."}),"\n",(0,i.jsx)(n.p,{children:"Soll im PV-Modus ein Netzbezugsanteil verbleiben bzw. zugelassen werden, muss hier eine negative Leistung entsprechend des Maximalanteils des Netzbezugs konfiguriert werden."}),"\n",(0,i.jsxs)(n.h4,{id:"grid-meter-vorhanden",children:[(0,i.jsx)(n.code,{children:"grid"})," ",(0,i.jsx)(n.code,{children:"meter"})," vorhanden"]}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:"Positiver Wert: Verbleibende Netzeinspeiseleistung"}),"\n",(0,i.jsx)(n.li,{children:"Negativer Wert: Verbleibende Netzbezugsleistung"}),"\n"]}),"\n",(0,i.jsxs)(n.h4,{id:"nur-pv-meter-vorhanden",children:["Nur ",(0,i.jsx)(n.code,{children:"pv"})," ",(0,i.jsx)(n.code,{children:"meter"})," vorhanden"]}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:"Positiver Wert: Typischer Hausverbrauch, um damit den PV-\xdcberschuss absch\xe4tzen zu k\xf6nnen"}),"\n",(0,i.jsx)(n.li,{children:"Negativer Wert: angegebene Leistung wird zur PV-Leistung addiert und erh\xf6ht die zur Verf\xfcgung stehende Ladeleistung (Achtung: Netzbezug)"}),"\n"]}),"\n",(0,i.jsx)(n.admonition,{type:"info",children:(0,i.jsxs)(n.p,{children:["Bei Existenz eines Batteriespeichers wird dringend empfohlen hier einen kleinen Wert von 100 bis 300 (Watt) einzutragen, um damit eine Speicherladung gem\xe4\xdf der konfigurierten Priorit\xe4ten (siehe ",(0,i.jsx)(n.code,{children:"prioritySoc"}),') zu erm\xf6glichen. Andernfalls "sieht" die unabh\xe4ngige Regelung des Speichers keinen nutzbaren \xdcberschuss.\nEbenso l\xe4sst sich damit bei schnellen Erzeugungs- und Lastwechseln auch ohne Speicher ein kurzzeitiger Netzbezug besser vermeiden.']})}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:'Beispiel "Batteriespeicher"'}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"residualPower: 100\n"})}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:'Beispiel "Netzbezugsanteil"'}),":"]}),"\n",(0,i.jsx)(n.p,{children:"Die Ladung soll im PV-Modus mit mindestens 6A (einphasig) auch bereits mit nur 50% PV-Anteil beginnen (Rest Netzbezug)\nMindestladeleistung: 1 Phase _ 6A _ 230V = 1380 W, davon 50%: 690 W"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"residualPower: -690\n"})}),"\n",(0,i.jsxs)(n.h3,{id:"smartcostlimit-ehemals-cheap",children:[(0,i.jsx)(n.code,{children:"smartCostLimit"})," (ehemals ",(0,i.jsx)(n.code,{children:"cheap"}),")"]}),"\n",(0,i.jsx)(n.p,{children:"Mit diesem Parameter kann eine Preis- oder gCO2equivalent-Grenze festgelegt werden. Im PV-Modus startet die Ladung beim Unterschreiten dieser Grenze."}),"\n",(0,i.jsx)(n.p,{children:"Beispiel Preisobergrenze (bei variablen Tarifen)"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"smartCostLimit: 0.20 # 20 ct\n"})}),"\n",(0,i.jsx)(n.p,{children:"Beispiel gCO2e Obergrenze (bei Nutzung z.B. Gr\xfcnstromindex)"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"smartCostLimit: 550 # 550 gCO2 equivalent\n"})}),"\n",(0,i.jsx)(n.h3,{id:"maxgridsupplywhilebatterycharging",children:(0,i.jsx)(n.code,{children:"maxGridSupplyWhileBatteryCharging"})}),"\n",(0,i.jsx)(n.p,{children:"Dieser Parameter ist (nur) hilfreich bei Hybrid-Wechselrichter-Systemen, bei denen die DC-Erzeugungsleistung in Verbindung mit einem direkt angebundenen Speichersystem gr\xf6\xdfer sein kann als die AC-Ausgabeleistung des Wechselrichters. Hierbei kann es w\xe4hrend der Fahrzeugladung zu Netzbezug kommen, obwohl gleichzeitig die Batterie geladen wird."}),"\n",(0,i.jsx)(n.p,{children:"Beispielszenario:\n10 kW maximale AC-Ausgabeleistung des Hybrid-WR. Aktuelle PV-Erzeugungsleistung 15 kW, dabei gehen 5 kW in die direkt angeschlossene Batterie, da der AC-Pfad des Hybrid-WR bereits mit 10 kW voll ausgelastet ist."}),"\n",(0,i.jsxs)(n.p,{children:["Normalerweise wird die momentane Ladeleistung der Hausbatterie als zus\xe4tzlich verf\xfcgbare Fahrzeugladeleistung betrachtet (falls ",(0,i.jsx)(n.code,{children:"prioritySoc"})," schon erreicht wurde). In dem obigen Beispiel k\xe4me es dann jedoch zu Netzbezug in H\xf6he der momentanen Batterieladeleistung da diese vom Wechselrichter dem Netz (und somit dem Fahrzeug) technisch nicht zur Verf\xfcgung gestellt werden kann. Der ausgelastete AC-Pfad des Hybrid-WR bildet hierbei einen f\xfcr die Standard-Regelung unerwarteten Engpass."]}),"\n",(0,i.jsx)(n.p,{children:"Mit diesem Parameter kann ein Schwellenwert f\xfcr den Netzbezug gesetzt werden, der bewirkt, dass in diesem Fall die Batterieladeleistung nicht als verf\xfcgbare Fahrzeugladeleistung einberechnet wird. Somit bleibt dann die maximale \xdcberschussladeleistung auf die maximale AC-Ausgangsleistung des/der Wechselrichter zuz\xfcgliches dieses Wertes begrenzt."}),"\n",(0,i.jsx)(n.p,{children:"Empfohlen wird ein Wert von mindestens 50 (Watt). Je nach Tr\xe4gheit der beteiligten Regelungssysteme kann er auch h\xf6her gew\xe4hlt werden m\xfcssen."}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"maxGridSupplyWhileBatteryCharging: 50\n"})})]})}function m(e={}){const{wrapper:n}={...(0,s.a)(),...e.components};return n?(0,i.jsx)(n,{...e,children:(0,i.jsx)(o,{...e})}):o(e)}},1151:(e,n,r)=>{r.d(n,{Z:()=>a,a:()=>d});var i=r(7294);const s={},t=i.createContext(s);function d(e){const n=i.useContext(t);return i.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function a(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:d(e.components),i.createElement(t.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
+"use strict";(self.webpackChunkevcc_docs=self.webpackChunkevcc_docs||[]).push([[8715],{4273:(e,n,r)=>{r.r(n),r.d(n,{assets:()=>u,contentTitle:()=>c,default:()=>m,frontMatter:()=>l,metadata:()=>h,toc:()=>g});var i=r(5893),s=r(1151);const t=r.p+"assets/images/prioritysoc-a3ca3690db871f4ab9f0dec062a1d3b9.webp",d=r.p+"assets/images/buffersoc-7de54dc8a40af3bd5a1c403da13d54cc.webp",a=r.p+"assets/images/bufferstartsoc-1ccd7ffc8e59c35b918e4b599f4eb20d.webp",l={sidebar_position:2},c="site",h={id:"reference/configuration/site",title:"site",description:"Beschreibt den Standort mit den vorhandenen und ben\xf6tigten Ger\xe4ten der Hausinstallation und ist f\xfcr das Regeln der verf\xfcgbaren Leistung zust\xe4ndig.",source:"@site/docs/reference/configuration/site.mdx",sourceDirName:"reference/configuration",slug:"/reference/configuration/site",permalink:"/docs/reference/configuration/site",draft:!1,unlisted:!1,editUrl:"https://github.com/evcc-io/docs/tree/main/docs/reference/configuration/site.mdx",tags:[],version:"current",sidebarPosition:2,frontMatter:{sidebar_position:2},sidebar:"tutorialSidebar",previous:{title:"evcc.yaml",permalink:"/docs/reference/configuration/"},next:{title:"loadpoints",permalink:"/docs/reference/configuration/loadpoints"}},u={},g=[{value:"Erforderliche Parameter",id:"erforderliche-parameter",level:2},{value:"title
",id:"title",level:3},{value:"meters
",id:"meters",level:3},{value:"Optionale Parameter",id:"optionale-parameter",level:2},{value:"meters.grid
",id:"metersgrid",level:3},{value:"meters.pv
",id:"meterspv",level:3},{value:"meters.battery
",id:"metersbattery",level:3},{value:"meters.aux
",id:"metersaux",level:3},{value:"prioritySoc
",id:"prioritysoc",level:3},{value:"bufferSoc
",id:"buffersoc",level:3},{value:"bufferStartSoc
",id:"bufferstartsoc",level:3},{value:"residualPower
",id:"residualpower",level:3},{value:"grid
meter
vorhanden",id:"grid-meter-vorhanden",level:4},{value:"Nur pv
meter
vorhanden",id:"nur-pv-meter-vorhanden",level:4},{value:"smartCostLimit
(ehemals cheap
)",id:"smartcostlimit-ehemals-cheap",level:3},{value:"maxGridSupplyWhileBatteryCharging
",id:"maxgridsupplywhilebatterycharging",level:3}];function o(e){const n={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",h3:"h3",h4:"h4",hr:"hr",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,s.a)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(n.h1,{id:"site",children:(0,i.jsx)(n.code,{children:"site"})}),"\n",(0,i.jsx)(n.p,{children:"Beschreibt den Standort mit den vorhandenen und ben\xf6tigten Ger\xe4ten der Hausinstallation und ist f\xfcr das Regeln der verf\xfcgbaren Leistung zust\xe4ndig."}),"\n",(0,i.jsx)(n.p,{children:"Um das Laden mit PV-\xdcberschuss zu regeln, ist ein auslesbarer Z\xe4hler direkt hinter dem Netzanschlusspunkt notwendig. Zus\xe4tzlich k\xf6nnen auch Ger\xe4te f\xfcr die PV-Leistung und Hausbatterie(n) angegeben werden. Mehrere Ger\xe4te werden dabei in der Leistung intern automatisch addiert. Bei Batteriespeichern wird der Mittelwert des Ladezustands gebildet."}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"site:\n - title: Zuhause # display name for UI\n meters:\n grid: mygridmeter # grid meter reference\n pv: # (pvs = veraltet)\n - mypv1 # first pv meter reference\n - mypv9 # second pv meter reference\n battery: # (batteries = veraltet)\n - mybat5 # battery meter reference\n aux:\n - myaux1\n residualPower: 100\n bufferSoc: 80\n prioritySoc: 66\n"})}),"\n",(0,i.jsx)(n.hr,{}),"\n",(0,i.jsx)(n.h2,{id:"erforderliche-parameter",children:"Erforderliche Parameter"}),"\n",(0,i.jsx)(n.h3,{id:"title",children:(0,i.jsx)(n.code,{children:"title"})}),"\n",(0,i.jsx)(n.p,{children:"Die angezeigte Beschreibung des Ladepunktes, wird in der UI angezeigt."}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"title: Zuhause\n"})}),"\n",(0,i.jsx)(n.hr,{}),"\n",(0,i.jsx)(n.h3,{id:"meters",children:(0,i.jsx)(n.code,{children:"meters"})}),"\n",(0,i.jsxs)(n.p,{children:["Definiert welche konfigurierten ",(0,i.jsx)(n.a,{href:"meters",children:(0,i.jsx)(n.code,{children:"meter"})})," (Strommessger\xe4te) als welche Art Messpunkt verwendet werden sollen.\nHier erfolgt somit die logische Verkn\xfcpfung der Ger\xe4tedefiniton mit dem Verwendungszweck.\nEin zun\xe4chst universeller Z\xe4hler bekommt somit entsprechend seines Einbauortes in der Hausinstallation einen Zweck zugewiesen."]}),"\n",(0,i.jsx)(n.admonition,{type:"note",children:(0,i.jsxs)(n.p,{children:["Es ist mindestens die Konfiguration eines ",(0,i.jsx)(n.code,{children:"grid"})," oder eines ",(0,i.jsx)(n.code,{children:"pv"})," Elementes notwendig!\nOhne mindestens einen der beiden Eintr\xe4ge kann evcc nicht verwendet werden!"]})}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"site:\n meters:\n grid: mygridmeter # grid meter reference\n pv: mypv1 # pv meter reference\n battery: mybat2 # battery meter reference\n aux: myaux1\n"})}),"\n",(0,i.jsx)(n.hr,{}),"\n",(0,i.jsx)(n.h2,{id:"optionale-parameter",children:"Optionale Parameter"}),"\n",(0,i.jsx)(n.h3,{id:"metersgrid",children:(0,i.jsx)(n.code,{children:"meters.grid"})}),"\n",(0,i.jsxs)(n.p,{children:["Definiert das ",(0,i.jsx)(n.a,{href:"meters",children:(0,i.jsx)(n.code,{children:"meter"})})," (Strommessger\xe4t), welches die Messwerte des Netzanschlusspunktes liefert."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"M\xf6gliche Werte"}),": Wert eines ",(0,i.jsx)(n.code,{children:"name"})," Parameters in der ",(0,i.jsx)(n.a,{href:"#meters",children:(0,i.jsx)(n.code,{children:"meters"})})," Konfiguration."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"grid: mygridmeter # grid meter reference\n"})}),"\n",(0,i.jsx)(n.hr,{}),"\n",(0,i.jsx)(n.h3,{id:"meterspv",children:(0,i.jsx)(n.code,{children:"meters.pv"})}),"\n",(0,i.jsxs)(n.p,{children:["Definiert die ",(0,i.jsx)(n.a,{href:"meters",children:(0,i.jsx)(n.code,{children:"meter"})})," (Strommessger\xe4te), welche die PV-Erzeugungswerte liefern.\nEs k\xf6nnen mehrere Ger\xe4te angegeben werden. Die Leistungsdaten werden automatisch addiert."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"M\xf6gliche Werte"}),": Ein Wert oder eine Liste von Werten eines ",(0,i.jsx)(n.code,{children:"name"})," Parameters in der ",(0,i.jsx)(n.a,{href:"#meters",children:(0,i.jsx)(n.code,{children:"meters"})})," Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"pv: myonlypv # single pv meter reference\n"})}),"\n",(0,i.jsx)(n.p,{children:"oder"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"pv: # (pvs = veraltet)\n - myoldpv # first pv meter reference\n - mynewestpv # second pv meter reference\n"})}),"\n",(0,i.jsx)(n.hr,{}),"\n",(0,i.jsx)(n.h3,{id:"metersbattery",children:(0,i.jsx)(n.code,{children:"meters.battery"})}),"\n",(0,i.jsxs)(n.p,{children:["Definiert die ",(0,i.jsx)(n.a,{href:"meters",children:(0,i.jsx)(n.code,{children:"meter"})})," (Strommessger\xe4te), welche die Messdaten des/der Batteriespeicher(s) liefern.\nEs k\xf6nnen mehrere Ger\xe4te angegeben werden. Die Leistungsdaten werden automatisch addiert und aus den Speicherf\xfcllst\xe4nden wird ein Mittelwert gebildet."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"M\xf6gliche Werte"}),": Ein Wert oder eine Liste von Werten eines ",(0,i.jsx)(n.code,{children:"name"})," Parameters in der ",(0,i.jsx)(n.a,{href:"#meters",children:(0,i.jsx)(n.code,{children:"meters"})})," Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"battery: myonlybat # single battery meter reference\n"})}),"\n",(0,i.jsx)(n.p,{children:"oder"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"battery: # (batteries = veraltet)\n - mysmallbat # first battery meter reference\n - myhugebat # second battery meter reference\n"})}),"\n",(0,i.jsx)(n.h3,{id:"metersaux",children:(0,i.jsx)(n.code,{children:"meters.aux"})}),"\n",(0,i.jsx)(n.p,{children:"Definiert die meter (Strommessger\xe4te), welche die Messdaten externer Ger\xe4te liefern, die \xfcber eine eigene \xdcberschussregelung verf\xfcgen, aber nicht direkt durch evcc gesteuert werden. Es k\xf6nnen mehrere Ger\xe4te angegeben werden. Die Leistungsdaten werden automatisch addiert."}),"\n",(0,i.jsx)(n.p,{children:"In evcc flie\xdft diese Leistung in die Berechnung der prinzipiell zur Verf\xfcgung stehenden \xdcberschussleistung zur Fahrzeugladung ein.\nEs wird davon ausgegangen, dass die mittels der Aux-Meter gemessenen Ger\xe4te ihren Leistungsbedarf selbstst\xe4ndig und zeitnah reduzieren bzw. vollst\xe4ndig unterbrechen, wenn die gemessene Aux-Leistung durch evcc der Fahrzeugladung zugeschlagen wird."}),"\n",(0,i.jsx)(n.p,{children:"Positiver Wert: zus\xe4tzliche verf\xfcgbare \xdcberschussleistung (steht der Fahrzeugladung zur Verf\xfcgung)"}),"\n",(0,i.jsx)(n.p,{children:"Negativer Wert: fehlende \xdcberschussleistung (steht der Fahrzeugladung nicht zur Verf\xfcgung)"}),"\n",(0,i.jsx)(n.p,{children:"Beispiele:"}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsxs)(n.li,{children:["Ein Heizstab f\xfcr die Warmwasserbereitung, welcher autark auf Basis des PV-\xdcberschuss am Netz\xfcbergang geregelt wird. Wenn die Leistungsmessung dieses Heizstabes als ",(0,i.jsx)(n.code,{children:"aux"}),"-Meter gemessen und eingerichtet wird, steht die gesamte \xdcberschussleistung (Leistung des Heizstabs plus ggf. verbleibende Netzeinspeisung) jederzeit bevorzugt der Fahrzeugladung zur Verf\xfcgung. Greift die Fahrzeugladung darauf zu, sorgt die autarke Regelung des Heizstabes selbstst\xe4ndig daf\xfcr, dass dessen Leistung entsprechend reduziert wird."]}),"\n"]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"M\xf6gliche Werte"}),": Ein Wert oder eine Liste von Werten eines ",(0,i.jsx)(n.code,{children:"name"})," Parameters in der ",(0,i.jsx)(n.a,{href:"#meters",children:(0,i.jsx)(n.code,{children:"meters"})})," Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"aux: myaux # single aux meter reference\n"})}),"\n",(0,i.jsx)(n.p,{children:"oder"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"aux:\n - myaux1 # first aux meter reference\n - myaux2 # second aux meter reference\n"})}),"\n",(0,i.jsx)(n.h3,{id:"prioritysoc",children:(0,i.jsx)(n.code,{children:"prioritySoc"})}),"\n",(0,i.jsx)(n.admonition,{title:"veraltet in yaml",type:"note",children:(0,i.jsx)(n.p,{children:"Dieser Wert kann und sollte \xfcber den Batterieeinstellungen-Dialog in der UI konfiguriert werden."})}),"\n",(0,i.jsx)("img",{src:t,style:{maxWidth:400}}),"\n",(0,i.jsx)(n.p,{children:"Die Ladung der Hausbatterie hat unterhalb des angegebenen Soc (%) Wertes Priorit\xe4t gegen\xfcber der Fahrzeugladung.\nSteht unterhalb dieses Wertes mehr Erzeugungsleistung zur Verf\xfcgung als der Batteriespeicher aufnimmt, kann dieser \xdcberschuss trotzdem nachrangig zur Fahrzeugladung verwendet werden.\nWenn die Hausbatterie oberhalb des Wertes geladen wird, wird die Batterieladeleistung f\xfcr das Laden des EVs als verf\xfcgbare \xdcberschussleistung betrachtet. Somit hat dann die Fahrzeugladung Priorit\xe4t bei der Verwendung der \xdcberschussleistung.\nIst deaktiviert (entspricht 0%) wenn kein Wert angegeben wird."}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"prioritySoc: 50 # Hausbatterie bekommt bis zum Soc 50% Priorit\xe4t beim laden\n"})}),"\n",(0,i.jsx)(n.h3,{id:"buffersoc",children:(0,i.jsx)(n.code,{children:"bufferSoc"})}),"\n",(0,i.jsx)(n.admonition,{title:"veraltet in yaml",type:"note",children:(0,i.jsx)(n.p,{children:"Dieser Wert kann und sollte \xfcber den Batterieeinstellungen-Dialog in der UI konfiguriert werden."})}),"\n",(0,i.jsx)("img",{src:d,style:{maxWidth:400}}),"\n",(0,i.jsx)(n.p,{children:"Erlaubt das Entladen einer Hausbatterie oberhalb des angegebenen Soc (%) Wertes, wenn zu wenig Solar\xfcberschuss (unterhalb der Mindestladeleistung) zur Verf\xfcgung steht. Somit werden Schwankungen in der Erzeugung oder beim Verbrauch prim\xe4r von der Hausbatterie ausgeglichen. Reicht die Entladeleistung der Hausbatterie nicht aus, um die Mindestladeleistung des Fahrzeugs zu liefern, wird der Rest aus dem Netz bezogen."}),"\n",(0,i.jsxs)(n.p,{children:["Es wird im Modus ",(0,i.jsx)(n.code,{children:"PV"})," automatisch ein Ladevorgang gestartet, sobald genug Solar\xfcberschuss vorhanden ist."]}),"\n",(0,i.jsx)(n.p,{children:"Ist deaktiviert (entspricht >100%) wenn kein Wert angegeben wird."}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"bufferSoc: 80 # Hausbatterie wird oberhalb Soc 80% als Puffer genutzt\n"})}),"\n",(0,i.jsx)(n.h3,{id:"bufferstartsoc",children:(0,i.jsx)(n.code,{children:"bufferStartSoc"})}),"\n",(0,i.jsx)(n.admonition,{title:"veraltet in yaml",type:"note",children:(0,i.jsx)(n.p,{children:"Dieser Wert kann und sollte \xfcber den Batterieeinstellungen-Dialog in der UI konfiguriert werden."})}),"\n",(0,i.jsx)("img",{src:a,style:{maxWidth:400}}),"\n",(0,i.jsxs)(n.p,{children:["Erlaubt im Modus ",(0,i.jsx)(n.code,{children:"PV"})," den Start eines Ladevorgangs oberhalb des angegebenen Soc (%) Wertes, auch wenn nicht genug Solar\xfcberschuss vorhanden ist."]}),"\n",(0,i.jsx)(n.p,{children:"Reicht die Entladeleistung der Hausbatterie nicht aus, um die Mindestladeleistung des Fahrzeugs zu liefern, wird der Rest aus dem Netz bezogen."}),"\n",(0,i.jsxs)(n.p,{children:["Kann im UI nur ge\xe4ndert werden, wenn ",(0,i.jsx)(n.code,{children:"bufferSoc"})," < 100% eingestellt ist"]}),"\n",(0,i.jsx)(n.p,{children:"Ist deaktiviert (entspricht 0%) wenn kein Wert angegeben wird."}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Beispiel"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"bufferStartSoc: 90 # hat die Hausbatterie Soc 90& erreicht, startet der Ladevorgang\n"})}),"\n",(0,i.jsx)(n.h3,{id:"residualpower",children:(0,i.jsx)(n.code,{children:"residualPower"})}),"\n",(0,i.jsx)(n.p,{children:'Legt den Soll-Arbeitspunkt der \xdcberschussregelung am Netz\xfcbergang (Gridmeter) fest. Der Standardwert ist 0 (Watt).\nPositive Werte verschieben den Sollwert in Richtung Netzeinspeisung, negative Werte in Richtung Netzbezug.\nMit diesem Wert wird der durch die Steuerung einzustellende "Ruhezustand" des Regelkreises eingestellt.'}),"\n",(0,i.jsx)(n.p,{children:"Insbesondere im Zusammenspiel mit weiteren unabh\xe4ngigen \xdcberschussausregelungen wie z. B. der eines Batteriespeichers ist es obligatorisch, diesen Wert anzupassen, um ein definiertes Systemverhalten mit klaren Priorit\xe4ten zu erzielen."}),"\n",(0,i.jsx)(n.p,{children:"Soll im PV-Modus ein Netzbezugsanteil verbleiben bzw. zugelassen werden, muss hier eine negative Leistung entsprechend des Maximalanteils des Netzbezugs konfiguriert werden."}),"\n",(0,i.jsxs)(n.h4,{id:"grid-meter-vorhanden",children:[(0,i.jsx)(n.code,{children:"grid"})," ",(0,i.jsx)(n.code,{children:"meter"})," vorhanden"]}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:"Positiver Wert: Verbleibende Netzeinspeiseleistung"}),"\n",(0,i.jsx)(n.li,{children:"Negativer Wert: Verbleibende Netzbezugsleistung"}),"\n"]}),"\n",(0,i.jsxs)(n.h4,{id:"nur-pv-meter-vorhanden",children:["Nur ",(0,i.jsx)(n.code,{children:"pv"})," ",(0,i.jsx)(n.code,{children:"meter"})," vorhanden"]}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:"Positiver Wert: Typischer Hausverbrauch, um damit den PV-\xdcberschuss absch\xe4tzen zu k\xf6nnen"}),"\n",(0,i.jsx)(n.li,{children:"Negativer Wert: angegebene Leistung wird zur PV-Leistung addiert und erh\xf6ht die zur Verf\xfcgung stehende Ladeleistung (Achtung: Netzbezug)"}),"\n"]}),"\n",(0,i.jsx)(n.admonition,{type:"info",children:(0,i.jsxs)(n.p,{children:["Bei Existenz eines Batteriespeichers wird dringend empfohlen hier einen kleinen Wert von 100 bis 300 (Watt) einzutragen, um damit eine Speicherladung gem\xe4\xdf der konfigurierten Priorit\xe4ten (siehe ",(0,i.jsx)(n.code,{children:"prioritySoc"}),') zu erm\xf6glichen. Andernfalls "sieht" die unabh\xe4ngige Regelung des Speichers keinen nutzbaren \xdcberschuss.\nEbenso l\xe4sst sich damit bei schnellen Erzeugungs- und Lastwechseln auch ohne Speicher ein kurzzeitiger Netzbezug besser vermeiden.']})}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:'Beispiel "Batteriespeicher"'}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"residualPower: 100\n"})}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:'Beispiel "Netzbezugsanteil"'}),":"]}),"\n",(0,i.jsxs)(n.p,{children:["Die Ladung soll im PV-Modus mit mindestens 6A (einphasig) auch bereits mit nur 50% PV-Anteil beginnen (Rest Netzbezug)\nMindestladeleistung: 1 Phase _ 6A _ 230V = 1380 W, davon 50%: 690 W. Siehe auch die ",(0,i.jsx)(n.a,{href:"/docs/guides/charging/#pv-erzeugung-im-winter-nutzen",children:"Alternative mittels enable/disable um anteilig PV und Netzbezug zu erlauben"}),"."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"residualPower: -690\n"})}),"\n",(0,i.jsxs)(n.h3,{id:"smartcostlimit-ehemals-cheap",children:[(0,i.jsx)(n.code,{children:"smartCostLimit"})," (ehemals ",(0,i.jsx)(n.code,{children:"cheap"}),")"]}),"\n",(0,i.jsx)(n.p,{children:"Mit diesem Parameter kann eine Preis- oder gCO2equivalent-Grenze festgelegt werden. Im PV-Modus startet die Ladung beim Unterschreiten dieser Grenze."}),"\n",(0,i.jsx)(n.p,{children:"Beispiel Preisobergrenze (bei variablen Tarifen)"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"smartCostLimit: 0.20 # 20 ct\n"})}),"\n",(0,i.jsx)(n.p,{children:"Beispiel gCO2e Obergrenze (bei Nutzung z.B. Gr\xfcnstromindex)"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"smartCostLimit: 550 # 550 gCO2 equivalent\n"})}),"\n",(0,i.jsx)(n.h3,{id:"maxgridsupplywhilebatterycharging",children:(0,i.jsx)(n.code,{children:"maxGridSupplyWhileBatteryCharging"})}),"\n",(0,i.jsx)(n.p,{children:"Dieser Parameter ist (nur) hilfreich bei Hybrid-Wechselrichter-Systemen, bei denen die DC-Erzeugungsleistung in Verbindung mit einem direkt angebundenen Speichersystem gr\xf6\xdfer sein kann als die AC-Ausgabeleistung des Wechselrichters. Hierbei kann es w\xe4hrend der Fahrzeugladung zu Netzbezug kommen, obwohl gleichzeitig die Batterie geladen wird."}),"\n",(0,i.jsx)(n.p,{children:"Beispielszenario:\n10 kW maximale AC-Ausgabeleistung des Hybrid-WR. Aktuelle PV-Erzeugungsleistung 15 kW, dabei gehen 5 kW in die direkt angeschlossene Batterie, da der AC-Pfad des Hybrid-WR bereits mit 10 kW voll ausgelastet ist."}),"\n",(0,i.jsxs)(n.p,{children:["Normalerweise wird die momentane Ladeleistung der Hausbatterie als zus\xe4tzlich verf\xfcgbare Fahrzeugladeleistung betrachtet (falls ",(0,i.jsx)(n.code,{children:"prioritySoc"})," schon erreicht wurde). In dem obigen Beispiel k\xe4me es dann jedoch zu Netzbezug in H\xf6he der momentanen Batterieladeleistung da diese vom Wechselrichter dem Netz (und somit dem Fahrzeug) technisch nicht zur Verf\xfcgung gestellt werden kann. Der ausgelastete AC-Pfad des Hybrid-WR bildet hierbei einen f\xfcr die Standard-Regelung unerwarteten Engpass."]}),"\n",(0,i.jsx)(n.p,{children:"Mit diesem Parameter kann ein Schwellenwert f\xfcr den Netzbezug gesetzt werden, der bewirkt, dass in diesem Fall die Batterieladeleistung nicht als verf\xfcgbare Fahrzeugladeleistung einberechnet wird. Somit bleibt dann die maximale \xdcberschussladeleistung auf die maximale AC-Ausgangsleistung des/der Wechselrichter zuz\xfcgliches dieses Wertes begrenzt."}),"\n",(0,i.jsx)(n.p,{children:"Empfohlen wird ein Wert von mindestens 50 (Watt). Je nach Tr\xe4gheit der beteiligten Regelungssysteme kann er auch h\xf6her gew\xe4hlt werden m\xfcssen."}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-yaml",children:"maxGridSupplyWhileBatteryCharging: 50\n"})})]})}function m(e={}){const{wrapper:n}={...(0,s.a)(),...e.components};return n?(0,i.jsx)(n,{...e,children:(0,i.jsx)(o,{...e})}):o(e)}},1151:(e,n,r)=>{r.d(n,{Z:()=>a,a:()=>d});var i=r(7294);const s={},t=i.createContext(s);function d(e){const n=i.useContext(t);return i.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function a(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:d(e.components),i.createElement(t.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/runtime~main.5d6ccf07.js b/assets/js/runtime~main.2fb2df49.js
similarity index 98%
rename from assets/js/runtime~main.5d6ccf07.js
rename to assets/js/runtime~main.2fb2df49.js
index 7ebe6059b5..e275f0030c 100644
--- a/assets/js/runtime~main.5d6ccf07.js
+++ b/assets/js/runtime~main.2fb2df49.js
@@ -1 +1 @@
-(()=>{"use strict";var e,b,c,a,d,f={},t={};function r(e){var b=t[e];if(void 0!==b)return b.exports;var c=t[e]={id:e,loaded:!1,exports:{}};return f[e].call(c.exports,c,c.exports,r),c.loaded=!0,c.exports}r.m=f,r.c=t,e=[],r.O=(b,c,a,d)=>{if(!c){var f=1/0;for(i=0;ibufferS
bufferStartSoc: 90 # hat die Hausbatterie Soc 90& erreicht, startet der Ladevorgang
residualPower
Nur <
residualPower: 100
residualPower: -690
smartCostLimit
(ehemals cheap
)Mit diesem Parameter kann eine Preis- oder gCO2equivalent-Grenze festgelegt werden. Im PV-Modus startet die Ladung beim Unterschreiten dieser Grenze.
diff --git a/docs/reference/configuration/sponsortoken/index.html b/docs/reference/configuration/sponsortoken/index.html index 4b31210e63..e44a3e2101 100644 --- a/docs/reference/configuration/sponsortoken/index.html +++ b/docs/reference/configuration/sponsortoken/index.html @@ -10,7 +10,7 @@ - + diff --git a/docs/reference/configuration/tariffs/index.html b/docs/reference/configuration/tariffs/index.html index 41b2496c4a..eb0dd78538 100644 --- a/docs/reference/configuration/tariffs/index.html +++ b/docs/reference/configuration/tariffs/index.html @@ -10,7 +10,7 @@ - + diff --git a/docs/reference/configuration/telemetry/index.html b/docs/reference/configuration/telemetry/index.html index b36c65779c..6790423489 100644 --- a/docs/reference/configuration/telemetry/index.html +++ b/docs/reference/configuration/telemetry/index.html @@ -10,7 +10,7 @@ - + diff --git a/docs/reference/configuration/uri/index.html b/docs/reference/configuration/uri/index.html index bfb41e99da..eef1b0763c 100644 --- a/docs/reference/configuration/uri/index.html +++ b/docs/reference/configuration/uri/index.html @@ -10,7 +10,7 @@ - + diff --git a/docs/reference/configuration/vehicles/index.html b/docs/reference/configuration/vehicles/index.html index 195ed59a2b..e5d684b8fc 100644 --- a/docs/reference/configuration/vehicles/index.html +++ b/docs/reference/configuration/vehicles/index.html @@ -10,7 +10,7 @@ - + diff --git a/docs/reference/index.html b/docs/reference/index.html index b0aa9653af..97540cfb69 100644 --- a/docs/reference/index.html +++ b/docs/reference/index.html @@ -10,7 +10,7 @@ - + diff --git a/docs/reference/modbus/index.html b/docs/reference/modbus/index.html index 865211673f..c3b01ccde7 100644 --- a/docs/reference/modbus/index.html +++ b/docs/reference/modbus/index.html @@ -10,7 +10,7 @@ - + diff --git a/docs/reference/plugins/index.html b/docs/reference/plugins/index.html index 01223021a5..6b0d79a2f2 100644 --- a/docs/reference/plugins/index.html +++ b/docs/reference/plugins/index.html @@ -10,7 +10,7 @@ - + diff --git a/docs/sponsorship/index.html b/docs/sponsorship/index.html index e9f104e76f..5399dbb04e 100644 --- a/docs/sponsorship/index.html +++ b/docs/sponsorship/index.html @@ -10,7 +10,7 @@ - + diff --git a/en/404.html b/en/404.html index 4fb294dddd..dda93c48f1 100644 --- a/en/404.html +++ b/en/404.html @@ -10,7 +10,7 @@ - + diff --git a/en/assets/js/bf99a23a.281976a5.js b/en/assets/js/bf99a23a.282d7f0d.js similarity index 82% rename from en/assets/js/bf99a23a.281976a5.js rename to en/assets/js/bf99a23a.282d7f0d.js index 4d3571ddf1..8e24e4d18f 100644 --- a/en/assets/js/bf99a23a.281976a5.js +++ b/en/assets/js/bf99a23a.282d7f0d.js @@ -1 +1 @@ -"use strict";(self.webpackChunkevcc_docs=self.webpackChunkevcc_docs||[]).push([[2380],{617:(e,r,i)=>{i.r(r),i.d(r,{assets:()=>h,contentTitle:()=>c,default:()=>m,frontMatter:()=>l,metadata:()=>d,toc:()=>u});var n=i(5893),t=i(1151);const s=i.p+"assets/images/prioritysoc-5e12ff2baefee6c49d7e8a6088a3ce1c.webp",a=i.p+"assets/images/buffersoc-220fabbb55f28789a16e1d98516748c5.webp",o=i.p+"assets/images/bufferstartsoc-20da1606f6dc57fe6e8e591edfe88f90.webp",l={sidebar_position:2},c="site",d={id:"reference/configuration/site",title:"site",description:"Describes the location with the existing and required devices of the home installation and is responsible for regulating the available power.",source:"@site/i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/site.mdx",sourceDirName:"reference/configuration",slug:"/reference/configuration/site",permalink:"/en/docs/reference/configuration/site",draft:!1,unlisted:!1,editUrl:"https://github.com/evcc-io/docs/tree/main/i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/site.mdx",tags:[],version:"current",sidebarPosition:2,frontMatter:{sidebar_position:2},sidebar:"tutorialSidebar",previous:{title:"evcc.yaml",permalink:"/en/docs/reference/configuration/"},next:{title:"loadpoints",permalink:"/en/docs/reference/configuration/loadpoints"}},h={},u=[{value:"Required Parameters",id:"required-parameters",level:2},{value:"title
",id:"title",level:3},{value:"meters
",id:"meters",level:3},{value:"Optional Parameters",id:"optional-parameters",level:2},{value:"meters.grid
",id:"metersgrid",level:3},{value:"meters.pv
",id:"meterspv",level:3},{value:"meters.battery
",id:"metersbattery",level:3},{value:"meters.aux
",id:"metersaux",level:3},{value:"prioritySoc
",id:"prioritysoc",level:3},{value:"bufferSoc
",id:"buffersoc",level:3},{value:"bufferStartSoc
",id:"bufferstartsoc",level:3},{value:"residualPower
",id:"residualpower",level:3},{value:"grid
meter
present",id:"grid-meter-present",level:4},{value:"Only pv
meter
present",id:"only-pv-meter-present",level:4},{value:"smartCostLimit
(formerly cheap
)",id:"smartcostlimit-formerly-cheap",level:3},{value:"maxGridSupplyWhileBatteryCharging
",id:"maxgridsupplywhilebatterycharging",level:3}];function p(e){const r={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",h3:"h3",h4:"h4",hr:"hr",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,t.a)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(r.h1,{id:"site",children:(0,n.jsx)(r.code,{children:"site"})}),"\n",(0,n.jsx)(r.p,{children:"Describes the location with the existing and required devices of the home installation and is responsible for regulating the available power."}),"\n",(0,n.jsx)(r.p,{children:"To regulate charging with PV surplus, a readable meter directly behind the grid connection point is necessary. In addition, devices for PV power and house battery(ies) can also be specified. Several devices are automatically added in terms of power or, in the case of battery storage, the average state of charge is calculated."}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"site:\n - title: Home # display name for UI\n meters:\n grid: mygridmeter # grid meter reference\n pv: # (pvs = deprecated)\n - mypv1 # first pv meter reference\n - mypv9 # second pv meter reference\n battery: # (batteries = deprecated)\n - mybat5 # battery meter reference\n aux:\n - myaux1\n residualPower: 100\n bufferSoc: 80\n prioritySoc: 66\n"})}),"\n",(0,n.jsx)(r.hr,{}),"\n",(0,n.jsx)(r.h2,{id:"required-parameters",children:"Required Parameters"}),"\n",(0,n.jsx)(r.h3,{id:"title",children:(0,n.jsx)(r.code,{children:"title"})}),"\n",(0,n.jsx)(r.p,{children:"The description of the charging point is also displayed in the UI."}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"title: Home\n"})}),"\n",(0,n.jsx)(r.hr,{}),"\n",(0,n.jsx)(r.h3,{id:"meters",children:(0,n.jsx)(r.code,{children:"meters"})}),"\n",(0,n.jsx)(r.p,{children:"Defines which configured meter (current measurement devices) are to be used as what type of measurement point. This logically links the device definition with its intended use. A initially universal meter is thus assigned a purpose based on its location within the home installation."}),"\n",(0,n.jsx)(r.admonition,{type:"note",children:(0,n.jsxs)(r.p,{children:["At least the configuration of one ",(0,n.jsx)(r.code,{children:"grid"})," or at least one ",(0,n.jsx)(r.code,{children:"pv"})," element is necessary!\nevcc cannot be used without at least one of these entries!"]})}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"site:\n meters:\n grid: mygridmeter # grid meter reference\n pv: mypv1 # pv meter reference\n battery: mybat2 # battery meter reference\n aux: myaux1\n"})}),"\n",(0,n.jsx)(r.hr,{}),"\n",(0,n.jsx)(r.h2,{id:"optional-parameters",children:"Optional Parameters"}),"\n",(0,n.jsx)(r.h3,{id:"metersgrid",children:(0,n.jsx)(r.code,{children:"meters.grid"})}),"\n",(0,n.jsxs)(r.p,{children:["Defines the ",(0,n.jsx)(r.a,{href:"meters",children:(0,n.jsx)(r.code,{children:"meter"})})," (current measurement device) that provides the measurements of the grid connection point."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"Possible values"}),": Value of a ",(0,n.jsx)(r.code,{children:"name"})," parameter in the ",(0,n.jsx)(r.a,{href:"#meters",children:(0,n.jsx)(r.code,{children:"meters"})})," configuration."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"grid: mygridmeter # grid meter reference\n"})}),"\n",(0,n.jsx)(r.hr,{}),"\n",(0,n.jsx)(r.h3,{id:"meterspv",children:(0,n.jsx)(r.code,{children:"meters.pv"})}),"\n",(0,n.jsxs)(r.p,{children:["Defines ",(0,n.jsx)(r.a,{href:"meters",children:(0,n.jsx)(r.code,{children:"meter"})})," (current measurement devices), from which evcc fetches PV generation measurements.\nMultiple devices can be specified. Power data is automatically added."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"Possible values"}),": A single value or a list of values of a name parameter in the ",(0,n.jsx)(r.a,{href:"#meters",children:(0,n.jsx)(r.code,{children:"meters"})})," configuration. The list version can also be used with single values."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"pv: myonlypv # single pv meter reference\n"})}),"\n",(0,n.jsx)(r.p,{children:"or"}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"pv: # (pvs = deprecated)\n - myoldpv # first pv meter reference\n - mynewestpv # second pv meter reference\n"})}),"\n",(0,n.jsx)(r.hr,{}),"\n",(0,n.jsx)(r.h3,{id:"metersbattery",children:(0,n.jsx)(r.code,{children:"meters.battery"})}),"\n",(0,n.jsxs)(r.p,{children:["Defines the ",(0,n.jsx)(r.a,{href:"meters",children:(0,n.jsx)(r.code,{children:"meter"})})," (current measurement devices) that provide measurement data from the battery(ies).\nMultiple devices can be specified. Power data is automatically added, and an average is calculated from the battery state of charge."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"Possible values"}),": A single value or a list of values of a ",(0,n.jsx)(r.code,{children:"name"})," parameter in the ",(0,n.jsx)(r.a,{href:"#meters",children:(0,n.jsx)(r.code,{children:"meters"})})," configuration. The list version can also be used with single values."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"battery: myonlybat # single battery meter reference\n"})}),"\n",(0,n.jsx)(r.p,{children:"or"}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"battery: # (batteries = deprecated)\n - mysmallbat # first battery meter reference\n - myhugebat # second battery meter reference\n"})}),"\n",(0,n.jsx)(r.h3,{id:"metersaux",children:(0,n.jsx)(r.code,{children:"meters.aux"})}),"\n",(0,n.jsx)(r.p,{children:"Defines the meters (current measurement devices) that provide measurement data from external devices that have their own surplus control but are not directly controlled by evcc. Multiple devices can be specified. Power data is automatically added."}),"\n",(0,n.jsx)(r.p,{children:"In evcc, this power contributes to the calculation of the available surplus power for vehicle charging. It is assumed that devices measured using auxiliary meters will autonomously and promptly reduce or completely interrupt their power consumption when the measured auxiliary power is allocated to vehicle charging by evcc."}),"\n",(0,n.jsx)(r.p,{children:"Positive value: additional available surplus power (allocated to vehicle charging)"}),"\n",(0,n.jsx)(r.p,{children:"Negative value: insufficient surplus power (not available for vehicle charging)"}),"\n",(0,n.jsx)(r.p,{children:"Examples:"}),"\n",(0,n.jsx)(r.p,{children:"An immersion heater for hot water production that is autonomously regulated based on PV surplus at the grid connection point. When the power consumption of this immersion heater is measured and configured as an aux meter, the entire surplus power (power of the immersion heater plus any remaining grid feed-in) is always preferentially allocated to vehicle charging. If the vehicle charging accesses it, the autonomous regulation of the immersion heater ensures that its power is reduced accordingly."}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"Possible values"}),": A single value or a list of values of a ",(0,n.jsx)(r.code,{children:"name"})," parameter in the ",(0,n.jsx)(r.a,{href:"#meters",children:(0,n.jsx)(r.code,{children:"meters"})})," configuration. The list version can also be used with single values."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"Example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"aux: myaux # single aux meter reference\n"})}),"\n",(0,n.jsx)(r.p,{children:"or"}),"\n",(0,n.jsx)(r.p,{children:"yaml"}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"aux:\n - myaux1 # first aux meter reference\n - myaux2 # second aux meter reference\n"})}),"\n",(0,n.jsx)(r.h3,{id:"prioritysoc",children:(0,n.jsx)(r.code,{children:"prioritySoc"})}),"\n",(0,n.jsx)(r.admonition,{title:"deprecated in yaml",type:"note",children:(0,n.jsx)(r.p,{children:"This value can and should be configured via the battery settings dialog in the UI."})}),"\n",(0,n.jsx)("img",{src:s,style:{maxWidth:400}}),"\n",(0,n.jsx)(r.p,{children:"Charging the house battery is prioritized over vehicle charging below the specified state of charge (SoC) (%) value. If there is more generation capacity available below this value than the battery can absorb, this surplus can still be used for vehicle charging, but as a lower priority. When the house battery is charged above this value, the battery charging power is considered as available surplus power for vehicle charging. Thus, vehicle charging takes priority in using the surplus power when it is above this SoC value.\nIt is disabled (equivalent to 0%) if no value is provided."}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"prioritySoc: 50 # House battery has priority for charging up to 50% SoC\n"})}),"\n",(0,n.jsx)(r.h3,{id:"buffersoc",children:(0,n.jsx)(r.code,{children:"bufferSoc"})}),"\n",(0,n.jsx)(r.admonition,{title:"deprecated in yaml",type:"note",children:(0,n.jsx)(r.p,{children:"This value can and should be configured via the battery settings dialog in the UI."})}),"\n",(0,n.jsx)("img",{src:a,style:{maxWidth:400}}),"\n",(0,n.jsx)(r.p,{children:"Allows the discharging of a house battery above the specified state of charge (SoC) (%) value when there is insufficient solar surplus (below the minimum charging power). This helps balance fluctuations in generation or consumption primarily using the house battery. If the discharge power of the house battery is not enough to provide the minimum charging power for the vehicle, the remainder will be sourced from the grid."}),"\n",(0,n.jsxs)(r.p,{children:["In ",(0,n.jsx)(r.code,{children:"PV"})," mode, a charging process is automatically initiated when enough solar surplus is available."]}),"\n",(0,n.jsx)(r.p,{children:"It is disabled (equivalent to >100%) if no value is provided."}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"bufferSoc: 80 # House battery is used as a buffer above 80% SoC\n"})}),"\n",(0,n.jsx)(r.h3,{id:"bufferstartsoc",children:(0,n.jsx)(r.code,{children:"bufferStartSoc"})}),"\n",(0,n.jsx)(r.admonition,{title:"deprecated in yaml",type:"note",children:(0,n.jsx)(r.p,{children:"This value can and should be configured via the battery settings dialog in the UI."})}),"\n",(0,n.jsx)("img",{src:o,style:{maxWidth:400}}),"\n",(0,n.jsxs)(r.p,{children:["In ",(0,n.jsx)(r.code,{children:"PV"})," mode, allows the start of a charging process above the specified state of charge (SoC) (%) value, even if there is insufficient solar surplus."]}),"\n",(0,n.jsx)(r.p,{children:"If the discharge power of the house battery is not enough to provide the minimum charging power for the vehicle, the remainder will be sourced from the grid."}),"\n",(0,n.jsx)(r.p,{children:"It is disabled (equivalent to 0%) if no value is provided."}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"bufferStartSoc: 90 # Charging process starts when the house battery reaches 90% SoC\n"})}),"\n",(0,n.jsx)(r.h3,{id:"residualpower",children:(0,n.jsx)(r.code,{children:"residualPower"})}),"\n",(0,n.jsx)(r.p,{children:'Sets the target operating point of the surplus regulation at the grid connection (grid meter). The default value is 0 W.\nNegative values shift the target value towards grid feed-in, while positive values shift it towards grid consumption.\nUltimately, this value sets the "idle state" of the control loop that needs to be adjusted by the controller.'}),"\n",(0,n.jsx)(r.p,{children:"Especially in combination with other independent surplus regulation systems like a battery storage, this value must be adjusted to achieve a defined system behaviour with clear priorities."}),"\n",(0,n.jsx)(r.p,{children:"If a certain proportion of grid consumption should remain or be allowed in PV mode, a negative value corresponding to the maximum proportion of grid consumption can be configured."}),"\n",(0,n.jsxs)(r.h4,{id:"grid-meter-present",children:[(0,n.jsx)(r.code,{children:"grid"})," ",(0,n.jsx)(r.code,{children:"meter"})," present"]}),"\n",(0,n.jsxs)(r.ul,{children:["\n",(0,n.jsx)(r.li,{children:"Positive value: Remaining grid feed-in power"}),"\n",(0,n.jsx)(r.li,{children:"Negative value: Remaining grid consumption power"}),"\n"]}),"\n",(0,n.jsxs)(r.h4,{id:"only-pv-meter-present",children:["Only ",(0,n.jsx)(r.code,{children:"pv"})," ",(0,n.jsx)(r.code,{children:"meter"})," present"]}),"\n",(0,n.jsxs)(r.ul,{children:["\n",(0,n.jsx)(r.li,{children:"Positive value: Typical household consumption, used to estimate PV surplus."}),"\n",(0,n.jsx)(r.li,{children:"Negative value: The specified power is added to PV power and increases available charging power (Attention: grid consumption)"}),"\n"]}),"\n",(0,n.jsx)(r.admonition,{type:"info",children:(0,n.jsxs)(r.p,{children:["When a battery storage is present, it is strongly recommended to enter a small value, e.g. between 100 to 300 W here, allowing battery charging according to configured priorities (see ",(0,n.jsx)(r.code,{children:"prioritySoc"}),"). Otherwise, the independent regulation of the storage will not see usable surplus. Likewise, this prevents temporary grid consumption even without a battery during rapid generation and load changes."]})}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:'Example "Battery Storage"'}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"residualPower: 100\n"})}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:'For example "Grid Consumption Proportion"'}),":"]}),"\n",(0,n.jsx)(r.p,{children:"Charging should start in PV mode with at least 6A (single-phase) even with only 50% PV surplus (rest from grid).\nMinimum charging power: 1 phase _ 6A _ 230V = 1380 W, 50% of it: 690 W"}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"residualPower: -690\n"})}),"\n",(0,n.jsxs)(r.h3,{id:"smartcostlimit-formerly-cheap",children:[(0,n.jsx)(r.code,{children:"smartCostLimit"})," (formerly ",(0,n.jsx)(r.code,{children:"cheap"}),")"]}),"\n",(0,n.jsx)(r.p,{children:"This parameter can set a price or gCO2-equivalent limit. In PV mode, charging starts when this limit is undercut."}),"\n",(0,n.jsx)(r.p,{children:"Example price limit (for variable tariffs):"}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"smartCostLimit: 0.20 # 20 cents (or pence)\n"})}),"\n",(0,n.jsx)(r.p,{children:"For example gCO2e limit (when using e.g. green energy index):"}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"smartCostLimit: 550 # 550 gCO2 equivalent\n"})}),"\n",(0,n.jsx)(r.h3,{id:"maxgridsupplywhilebatterycharging",children:(0,n.jsx)(r.code,{children:"maxGridSupplyWhileBatteryCharging"})}),"\n",(0,n.jsx)(r.p,{children:"This parameter is only helpful for hybrid inverter systems where the DC power generated in combination with a directly connected storage system can be greater than the AC output power of the inverter. This can result in grid consumption during vehicle charging, even when the battery is being charged simultaneously."}),"\n",(0,n.jsx)(r.p,{children:"Scenario:\nMaximum 10 kW AC output power of the hybrid inverter. Current PV generation is 15 kW, with 5 kW going into the directly connected battery since the AC path of the hybrid inverter is fully utilized at 10 kW."}),"\n",(0,n.jsxs)(r.p,{children:["Normally, the current battery charging power is considered as additional available vehicle charging power (once ",(0,n.jsx)(r.code,{children:"prioritySoc"})," is reached). In the above example, grid consumption could occur equal to the current battery charging power since the inverter cannot provide this power to the grid (and thus the vehicle). The fully utilized AC path of the hybrid inverter creates an unexpected bottleneck for the standard regulation."]}),"\n",(0,n.jsx)(r.p,{children:"With this parameter, a threshold value for grid consumption can be set. If this threshold is reached, the battery charging power is not considered as available vehicle charging power in this scenario. This way, the maximum surplus charging power remains limited to the maximum AC output power of the inverter, plus this value."}),"\n",(0,n.jsx)(r.p,{children:"A recommended value is at least 50 Watts. Depending on the responsiveness of the control systems involved, it might need to be higher."}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"maxGridSupplyWhileBatteryCharging: 50\n"})})]})}function m(e={}){const{wrapper:r}={...(0,t.a)(),...e.components};return r?(0,n.jsx)(r,{...e,children:(0,n.jsx)(p,{...e})}):p(e)}},1151:(e,r,i)=>{i.d(r,{Z:()=>o,a:()=>a});var n=i(7294);const t={},s=n.createContext(t);function a(e){const r=n.useContext(s);return n.useMemo((function(){return"function"==typeof e?e(r):{...r,...e}}),[r,e])}function o(e){let r;return r=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:a(e.components),n.createElement(s.Provider,{value:r},e.children)}}}]);
\ No newline at end of file
+"use strict";(self.webpackChunkevcc_docs=self.webpackChunkevcc_docs||[]).push([[2380],{617:(e,r,i)=>{i.r(r),i.d(r,{assets:()=>h,contentTitle:()=>c,default:()=>m,frontMatter:()=>l,metadata:()=>d,toc:()=>u});var n=i(5893),t=i(1151);const s=i.p+"assets/images/prioritysoc-5e12ff2baefee6c49d7e8a6088a3ce1c.webp",a=i.p+"assets/images/buffersoc-220fabbb55f28789a16e1d98516748c5.webp",o=i.p+"assets/images/bufferstartsoc-20da1606f6dc57fe6e8e591edfe88f90.webp",l={sidebar_position:2},c="site",d={id:"reference/configuration/site",title:"site",description:"Describes the location with the existing and required devices of the home installation and is responsible for regulating the available power.",source:"@site/i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/site.mdx",sourceDirName:"reference/configuration",slug:"/reference/configuration/site",permalink:"/en/docs/reference/configuration/site",draft:!1,unlisted:!1,editUrl:"https://github.com/evcc-io/docs/tree/main/i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/site.mdx",tags:[],version:"current",sidebarPosition:2,frontMatter:{sidebar_position:2},sidebar:"tutorialSidebar",previous:{title:"evcc.yaml",permalink:"/en/docs/reference/configuration/"},next:{title:"loadpoints",permalink:"/en/docs/reference/configuration/loadpoints"}},h={},u=[{value:"Required Parameters",id:"required-parameters",level:2},{value:"title
",id:"title",level:3},{value:"meters
",id:"meters",level:3},{value:"Optional Parameters",id:"optional-parameters",level:2},{value:"meters.grid
",id:"metersgrid",level:3},{value:"meters.pv
",id:"meterspv",level:3},{value:"meters.battery
",id:"metersbattery",level:3},{value:"meters.aux
",id:"metersaux",level:3},{value:"prioritySoc
",id:"prioritysoc",level:3},{value:"bufferSoc
",id:"buffersoc",level:3},{value:"bufferStartSoc
",id:"bufferstartsoc",level:3},{value:"residualPower
",id:"residualpower",level:3},{value:"grid
meter
present",id:"grid-meter-present",level:4},{value:"Only pv
meter
present",id:"only-pv-meter-present",level:4},{value:"smartCostLimit
(formerly cheap
)",id:"smartcostlimit-formerly-cheap",level:3},{value:"maxGridSupplyWhileBatteryCharging
",id:"maxgridsupplywhilebatterycharging",level:3}];function p(e){const r={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",h3:"h3",h4:"h4",hr:"hr",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,t.a)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(r.h1,{id:"site",children:(0,n.jsx)(r.code,{children:"site"})}),"\n",(0,n.jsx)(r.p,{children:"Describes the location with the existing and required devices of the home installation and is responsible for regulating the available power."}),"\n",(0,n.jsx)(r.p,{children:"To regulate charging with PV surplus, a readable meter directly behind the grid connection point is necessary. In addition, devices for PV power and house battery(ies) can also be specified. Several devices are automatically added in terms of power or, in the case of battery storage, the average state of charge is calculated."}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"site:\n - title: Home # display name for UI\n meters:\n grid: mygridmeter # grid meter reference\n pv: # (pvs = deprecated)\n - mypv1 # first pv meter reference\n - mypv9 # second pv meter reference\n battery: # (batteries = deprecated)\n - mybat5 # battery meter reference\n aux:\n - myaux1\n residualPower: 100\n bufferSoc: 80\n prioritySoc: 66\n"})}),"\n",(0,n.jsx)(r.hr,{}),"\n",(0,n.jsx)(r.h2,{id:"required-parameters",children:"Required Parameters"}),"\n",(0,n.jsx)(r.h3,{id:"title",children:(0,n.jsx)(r.code,{children:"title"})}),"\n",(0,n.jsx)(r.p,{children:"The description of the charging point is also displayed in the UI."}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"title: Home\n"})}),"\n",(0,n.jsx)(r.hr,{}),"\n",(0,n.jsx)(r.h3,{id:"meters",children:(0,n.jsx)(r.code,{children:"meters"})}),"\n",(0,n.jsx)(r.p,{children:"Defines which configured meter (current measurement devices) are to be used as what type of measurement point. This logically links the device definition with its intended use. A initially universal meter is thus assigned a purpose based on its location within the home installation."}),"\n",(0,n.jsx)(r.admonition,{type:"note",children:(0,n.jsxs)(r.p,{children:["At least the configuration of one ",(0,n.jsx)(r.code,{children:"grid"})," or at least one ",(0,n.jsx)(r.code,{children:"pv"})," element is necessary!\nevcc cannot be used without at least one of these entries!"]})}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"site:\n meters:\n grid: mygridmeter # grid meter reference\n pv: mypv1 # pv meter reference\n battery: mybat2 # battery meter reference\n aux: myaux1\n"})}),"\n",(0,n.jsx)(r.hr,{}),"\n",(0,n.jsx)(r.h2,{id:"optional-parameters",children:"Optional Parameters"}),"\n",(0,n.jsx)(r.h3,{id:"metersgrid",children:(0,n.jsx)(r.code,{children:"meters.grid"})}),"\n",(0,n.jsxs)(r.p,{children:["Defines the ",(0,n.jsx)(r.a,{href:"meters",children:(0,n.jsx)(r.code,{children:"meter"})})," (current measurement device) that provides the measurements of the grid connection point."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"Possible values"}),": Value of a ",(0,n.jsx)(r.code,{children:"name"})," parameter in the ",(0,n.jsx)(r.a,{href:"#meters",children:(0,n.jsx)(r.code,{children:"meters"})})," configuration."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"grid: mygridmeter # grid meter reference\n"})}),"\n",(0,n.jsx)(r.hr,{}),"\n",(0,n.jsx)(r.h3,{id:"meterspv",children:(0,n.jsx)(r.code,{children:"meters.pv"})}),"\n",(0,n.jsxs)(r.p,{children:["Defines ",(0,n.jsx)(r.a,{href:"meters",children:(0,n.jsx)(r.code,{children:"meter"})})," (current measurement devices), from which evcc fetches PV generation measurements.\nMultiple devices can be specified. Power data is automatically added."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"Possible values"}),": A single value or a list of values of a name parameter in the ",(0,n.jsx)(r.a,{href:"#meters",children:(0,n.jsx)(r.code,{children:"meters"})})," configuration. The list version can also be used with single values."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"pv: myonlypv # single pv meter reference\n"})}),"\n",(0,n.jsx)(r.p,{children:"or"}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"pv: # (pvs = deprecated)\n - myoldpv # first pv meter reference\n - mynewestpv # second pv meter reference\n"})}),"\n",(0,n.jsx)(r.hr,{}),"\n",(0,n.jsx)(r.h3,{id:"metersbattery",children:(0,n.jsx)(r.code,{children:"meters.battery"})}),"\n",(0,n.jsxs)(r.p,{children:["Defines the ",(0,n.jsx)(r.a,{href:"meters",children:(0,n.jsx)(r.code,{children:"meter"})})," (current measurement devices) that provide measurement data from the battery(ies).\nMultiple devices can be specified. Power data is automatically added, and an average is calculated from the battery state of charge."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"Possible values"}),": A single value or a list of values of a ",(0,n.jsx)(r.code,{children:"name"})," parameter in the ",(0,n.jsx)(r.a,{href:"#meters",children:(0,n.jsx)(r.code,{children:"meters"})})," configuration. The list version can also be used with single values."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"battery: myonlybat # single battery meter reference\n"})}),"\n",(0,n.jsx)(r.p,{children:"or"}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"battery: # (batteries = deprecated)\n - mysmallbat # first battery meter reference\n - myhugebat # second battery meter reference\n"})}),"\n",(0,n.jsx)(r.h3,{id:"metersaux",children:(0,n.jsx)(r.code,{children:"meters.aux"})}),"\n",(0,n.jsx)(r.p,{children:"Defines the meters (current measurement devices) that provide measurement data from external devices that have their own surplus control but are not directly controlled by evcc. Multiple devices can be specified. Power data is automatically added."}),"\n",(0,n.jsx)(r.p,{children:"In evcc, this power contributes to the calculation of the available surplus power for vehicle charging. It is assumed that devices measured using auxiliary meters will autonomously and promptly reduce or completely interrupt their power consumption when the measured auxiliary power is allocated to vehicle charging by evcc."}),"\n",(0,n.jsx)(r.p,{children:"Positive value: additional available surplus power (allocated to vehicle charging)"}),"\n",(0,n.jsx)(r.p,{children:"Negative value: insufficient surplus power (not available for vehicle charging)"}),"\n",(0,n.jsx)(r.p,{children:"Examples:"}),"\n",(0,n.jsx)(r.p,{children:"An immersion heater for hot water production that is autonomously regulated based on PV surplus at the grid connection point. When the power consumption of this immersion heater is measured and configured as an aux meter, the entire surplus power (power of the immersion heater plus any remaining grid feed-in) is always preferentially allocated to vehicle charging. If the vehicle charging accesses it, the autonomous regulation of the immersion heater ensures that its power is reduced accordingly."}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"Possible values"}),": A single value or a list of values of a ",(0,n.jsx)(r.code,{children:"name"})," parameter in the ",(0,n.jsx)(r.a,{href:"#meters",children:(0,n.jsx)(r.code,{children:"meters"})})," configuration. The list version can also be used with single values."]}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"Example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"aux: myaux # single aux meter reference\n"})}),"\n",(0,n.jsx)(r.p,{children:"or"}),"\n",(0,n.jsx)(r.p,{children:"yaml"}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"aux:\n - myaux1 # first aux meter reference\n - myaux2 # second aux meter reference\n"})}),"\n",(0,n.jsx)(r.h3,{id:"prioritysoc",children:(0,n.jsx)(r.code,{children:"prioritySoc"})}),"\n",(0,n.jsx)(r.admonition,{title:"deprecated in yaml",type:"note",children:(0,n.jsx)(r.p,{children:"This value can and should be configured via the battery settings dialog in the UI."})}),"\n",(0,n.jsx)("img",{src:s,style:{maxWidth:400}}),"\n",(0,n.jsx)(r.p,{children:"Charging the house battery is prioritized over vehicle charging below the specified state of charge (SoC) (%) value. If there is more generation capacity available below this value than the battery can absorb, this surplus can still be used for vehicle charging, but as a lower priority. When the house battery is charged above this value, the battery charging power is considered as available surplus power for vehicle charging. Thus, vehicle charging takes priority in using the surplus power when it is above this SoC value.\nIt is disabled (equivalent to 0%) if no value is provided."}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"prioritySoc: 50 # House battery has priority for charging up to 50% SoC\n"})}),"\n",(0,n.jsx)(r.h3,{id:"buffersoc",children:(0,n.jsx)(r.code,{children:"bufferSoc"})}),"\n",(0,n.jsx)(r.admonition,{title:"deprecated in yaml",type:"note",children:(0,n.jsx)(r.p,{children:"This value can and should be configured via the battery settings dialog in the UI."})}),"\n",(0,n.jsx)("img",{src:a,style:{maxWidth:400}}),"\n",(0,n.jsx)(r.p,{children:"Allows the discharging of a house battery above the specified state of charge (SoC) (%) value when there is insufficient solar surplus (below the minimum charging power). This helps balance fluctuations in generation or consumption primarily using the house battery. If the discharge power of the house battery is not enough to provide the minimum charging power for the vehicle, the remainder will be sourced from the grid."}),"\n",(0,n.jsxs)(r.p,{children:["In ",(0,n.jsx)(r.code,{children:"PV"})," mode, a charging process is automatically initiated when enough solar surplus is available."]}),"\n",(0,n.jsx)(r.p,{children:"It is disabled (equivalent to >100%) if no value is provided."}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"bufferSoc: 80 # House battery is used as a buffer above 80% SoC\n"})}),"\n",(0,n.jsx)(r.h3,{id:"bufferstartsoc",children:(0,n.jsx)(r.code,{children:"bufferStartSoc"})}),"\n",(0,n.jsx)(r.admonition,{title:"deprecated in yaml",type:"note",children:(0,n.jsx)(r.p,{children:"This value can and should be configured via the battery settings dialog in the UI."})}),"\n",(0,n.jsx)("img",{src:o,style:{maxWidth:400}}),"\n",(0,n.jsxs)(r.p,{children:["In ",(0,n.jsx)(r.code,{children:"PV"})," mode, allows the start of a charging process above the specified state of charge (SoC) (%) value, even if there is insufficient solar surplus."]}),"\n",(0,n.jsx)(r.p,{children:"If the discharge power of the house battery is not enough to provide the minimum charging power for the vehicle, the remainder will be sourced from the grid."}),"\n",(0,n.jsx)(r.p,{children:"It is disabled (equivalent to 0%) if no value is provided."}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:"For example"}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"bufferStartSoc: 90 # Charging process starts when the house battery reaches 90% SoC\n"})}),"\n",(0,n.jsx)(r.h3,{id:"residualpower",children:(0,n.jsx)(r.code,{children:"residualPower"})}),"\n",(0,n.jsx)(r.p,{children:'Sets the target operating point of the surplus regulation at the grid connection (grid meter). The default value is 0 W.\nPositive values shift the target value towards grid feed-in, while negative values shift it towards grid consumption.\nUltimately, this value sets the "idle state" of the control loop that needs to be adjusted by the controller.'}),"\n",(0,n.jsx)(r.p,{children:"Especially in combination with other independent surplus regulation systems like a battery storage, this value must be adjusted to achieve a defined system behaviour with clear priorities."}),"\n",(0,n.jsx)(r.p,{children:"If a certain proportion of grid consumption should remain or be allowed in PV mode, a negative value corresponding to the maximum proportion of grid consumption can be configured."}),"\n",(0,n.jsxs)(r.h4,{id:"grid-meter-present",children:[(0,n.jsx)(r.code,{children:"grid"})," ",(0,n.jsx)(r.code,{children:"meter"})," present"]}),"\n",(0,n.jsxs)(r.ul,{children:["\n",(0,n.jsx)(r.li,{children:"Positive value: Remaining grid feed-in power"}),"\n",(0,n.jsx)(r.li,{children:"Negative value: Remaining grid consumption power"}),"\n"]}),"\n",(0,n.jsxs)(r.h4,{id:"only-pv-meter-present",children:["Only ",(0,n.jsx)(r.code,{children:"pv"})," ",(0,n.jsx)(r.code,{children:"meter"})," present"]}),"\n",(0,n.jsxs)(r.ul,{children:["\n",(0,n.jsx)(r.li,{children:"Positive value: Typical household consumption, used to estimate PV surplus."}),"\n",(0,n.jsx)(r.li,{children:"Negative value: The specified power is added to PV power and increases available charging power (Attention: grid consumption)"}),"\n"]}),"\n",(0,n.jsx)(r.admonition,{type:"info",children:(0,n.jsxs)(r.p,{children:["When a battery storage is present, it is strongly recommended to enter a small value, e.g. between 100 to 300 W here, allowing battery charging according to configured priorities (see ",(0,n.jsx)(r.code,{children:"prioritySoc"}),"). Otherwise, the independent regulation of the storage will not see usable surplus. Likewise, this prevents temporary grid consumption even without a battery during rapid generation and load changes."]})}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:'Example "Battery Storage"'}),":"]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"residualPower: 100\n"})}),"\n",(0,n.jsxs)(r.p,{children:[(0,n.jsx)(r.strong,{children:'For example "Grid Consumption Proportion"'}),":"]}),"\n",(0,n.jsx)(r.p,{children:"Charging should start in PV mode with at least 6A (single-phase) even with only 50% PV surplus (rest from grid).\nMinimum charging power: 1 phase _ 6A _ 230V = 1380 W, 50% of it: 690 W"}),"\n",(0,n.jsxs)(r.p,{children:["See also the ",(0,n.jsx)(r.a,{href:"/docs/guides/charging#solar-production-in-winter",children:"alternative using enable/disable to allow proportional PV and grid consumption"}),"."]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"residualPower: -690\n"})}),"\n",(0,n.jsxs)(r.h3,{id:"smartcostlimit-formerly-cheap",children:[(0,n.jsx)(r.code,{children:"smartCostLimit"})," (formerly ",(0,n.jsx)(r.code,{children:"cheap"}),")"]}),"\n",(0,n.jsx)(r.p,{children:"This parameter can set a price or gCO2-equivalent limit. In PV mode, charging starts when this limit is undercut."}),"\n",(0,n.jsx)(r.p,{children:"Example price limit (for variable tariffs):"}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"smartCostLimit: 0.20 # 20 cents (or pence)\n"})}),"\n",(0,n.jsx)(r.p,{children:"For example gCO2e limit (when using e.g. green energy index):"}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"smartCostLimit: 550 # 550 gCO2 equivalent\n"})}),"\n",(0,n.jsx)(r.h3,{id:"maxgridsupplywhilebatterycharging",children:(0,n.jsx)(r.code,{children:"maxGridSupplyWhileBatteryCharging"})}),"\n",(0,n.jsx)(r.p,{children:"This parameter is only helpful for hybrid inverter systems where the DC power generated in combination with a directly connected storage system can be greater than the AC output power of the inverter. This can result in grid consumption during vehicle charging, even when the battery is being charged simultaneously."}),"\n",(0,n.jsx)(r.p,{children:"Scenario:\nMaximum 10 kW AC output power of the hybrid inverter. Current PV generation is 15 kW, with 5 kW going into the directly connected battery since the AC path of the hybrid inverter is fully utilized at 10 kW."}),"\n",(0,n.jsxs)(r.p,{children:["Normally, the current battery charging power is considered as additional available vehicle charging power (once ",(0,n.jsx)(r.code,{children:"prioritySoc"})," is reached). In the above example, grid consumption could occur equal to the current battery charging power since the inverter cannot provide this power to the grid (and thus the vehicle). The fully utilized AC path of the hybrid inverter creates an unexpected bottleneck for the standard regulation."]}),"\n",(0,n.jsx)(r.p,{children:"With this parameter, a threshold value for grid consumption can be set. If this threshold is reached, the battery charging power is not considered as available vehicle charging power in this scenario. This way, the maximum surplus charging power remains limited to the maximum AC output power of the inverter, plus this value."}),"\n",(0,n.jsx)(r.p,{children:"A recommended value is at least 50 Watts. Depending on the responsiveness of the control systems involved, it might need to be higher."}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-yaml",children:"maxGridSupplyWhileBatteryCharging: 50\n"})})]})}function m(e={}){const{wrapper:r}={...(0,t.a)(),...e.components};return r?(0,n.jsx)(r,{...e,children:(0,n.jsx)(p,{...e})}):p(e)}},1151:(e,r,i)=>{i.d(r,{Z:()=>o,a:()=>a});var n=i(7294);const t={},s=n.createContext(t);function a(e){const r=n.useContext(s);return n.useMemo((function(){return"function"==typeof e?e(r):{...r,...e}}),[r,e])}function o(e){let r;return r=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:a(e.components),n.createElement(s.Provider,{value:r},e.children)}}}]);
\ No newline at end of file
diff --git a/en/assets/js/runtime~main.5682326e.js b/en/assets/js/runtime~main.9552671e.js
similarity index 99%
rename from en/assets/js/runtime~main.5682326e.js
rename to en/assets/js/runtime~main.9552671e.js
index 2804efa1b0..5469468841 100644
--- a/en/assets/js/runtime~main.5682326e.js
+++ b/en/assets/js/runtime~main.9552671e.js
@@ -1 +1 @@
-(()=>{"use strict";var e,c,f,a,b,d={},t={};function r(e){var c=t[e];if(void 0!==c)return c.exports;var f=t[e]={id:e,loaded:!1,exports:{}};return d[e].call(f.exports,f,f.exports,r),f.loaded=!0,f.exports}r.m=d,r.c=t,e=[],r.O=(c,f,a,b)=>{if(!f){var d=1/0;for(i=0;ibufferS
bufferStartSoc: 90 # Charging process starts when the house battery reaches 90% SoC
residualPower
Sets the target operating point of the surplus regulation at the grid connection (grid meter). The default value is 0 W.
-Negative values shift the target value towards grid feed-in, while positive values shift it towards grid consumption.
+Positive values shift the target value towards grid feed-in, while negative values shift it towards grid consumption.
Ultimately, this value sets the "idle state" of the control loop that needs to be adjusted by the controller.
Especially in combination with other independent surplus regulation systems like a battery storage, this value must be adjusted to achieve a defined system behaviour with clear priorities.
If a certain proportion of grid consumption should remain or be allowed in PV mode, a negative value corresponding to the maximum proportion of grid consumption can be configured.
@@ -115,6 +115,7 @@ Only <
For example "Grid Consumption Proportion":
Charging should start in PV mode with at least 6A (single-phase) even with only 50% PV surplus (rest from grid).
Minimum charging power: 1 phase _ 6A _ 230V = 1380 W, 50% of it: 690 W
+See also the alternative using enable/disable to allow proportional PV and grid consumption.
residualPower: -690
smartCostLimit
(formerly cheap
)
This parameter can set a price or gCO2-equivalent limit. In PV mode, charging starts when this limit is undercut.
diff --git a/en/docs/reference/configuration/sponsortoken/index.html b/en/docs/reference/configuration/sponsortoken/index.html
index d2794ecc34..fc3e4b4fe4 100644
--- a/en/docs/reference/configuration/sponsortoken/index.html
+++ b/en/docs/reference/configuration/sponsortoken/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/en/docs/reference/configuration/tariffs/index.html b/en/docs/reference/configuration/tariffs/index.html
index 84eaa8da7f..73174ba274 100644
--- a/en/docs/reference/configuration/tariffs/index.html
+++ b/en/docs/reference/configuration/tariffs/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/en/docs/reference/configuration/telemetry/index.html b/en/docs/reference/configuration/telemetry/index.html
index ab21611185..837f545c0f 100644
--- a/en/docs/reference/configuration/telemetry/index.html
+++ b/en/docs/reference/configuration/telemetry/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/en/docs/reference/configuration/uri/index.html b/en/docs/reference/configuration/uri/index.html
index 56c009786a..fdf8b36718 100644
--- a/en/docs/reference/configuration/uri/index.html
+++ b/en/docs/reference/configuration/uri/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/en/docs/reference/configuration/vehicles/index.html b/en/docs/reference/configuration/vehicles/index.html
index bea03e9bf8..80101c6e6b 100644
--- a/en/docs/reference/configuration/vehicles/index.html
+++ b/en/docs/reference/configuration/vehicles/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/en/docs/reference/index.html b/en/docs/reference/index.html
index 9cd7ed1de7..02fe855995 100644
--- a/en/docs/reference/index.html
+++ b/en/docs/reference/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/en/docs/reference/modbus/index.html b/en/docs/reference/modbus/index.html
index 5737eafb4d..4cf8cfb3b2 100644
--- a/en/docs/reference/modbus/index.html
+++ b/en/docs/reference/modbus/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/en/docs/reference/plugins/index.html b/en/docs/reference/plugins/index.html
index 862f9b169e..67cad24ef4 100644
--- a/en/docs/reference/plugins/index.html
+++ b/en/docs/reference/plugins/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/en/docs/sponsorship/index.html b/en/docs/sponsorship/index.html
index 654c08dac2..fee973e4b1 100644
--- a/en/docs/sponsorship/index.html
+++ b/en/docs/sponsorship/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/en/index.html b/en/index.html
index 43f1cb5e19..ad5876fda0 100644
--- a/en/index.html
+++ b/en/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/en/markdown-page/index.html b/en/markdown-page/index.html
index 688f2ffed9..f843fd4022 100644
--- a/en/markdown-page/index.html
+++ b/en/markdown-page/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/en/search/index.html b/en/search/index.html
index 937bb9cfd7..984366dd01 100644
--- a/en/search/index.html
+++ b/en/search/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/index.html b/index.html
index c8a097e9fe..79ae42e33a 100644
--- a/index.html
+++ b/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/markdown-page/index.html b/markdown-page/index.html
index 07450c9695..9c3e0ef5f8 100644
--- a/markdown-page/index.html
+++ b/markdown-page/index.html
@@ -10,7 +10,7 @@
-
+
diff --git a/search/index.html b/search/index.html
index d6dedcaeae..f521ccf98a 100644
--- a/search/index.html
+++ b/search/index.html
@@ -10,7 +10,7 @@
-
+