diff --git a/docs/devices/meters-nightly.mdx b/docs/devices/meters-nightly.mdx new file mode 100644 index 000000000..4b519f80b --- /dev/null +++ b/docs/devices/meters-nightly.mdx @@ -0,0 +1,10399 @@ +--- +sidebar_position: 2 +--- + +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; +import DeviceFeatures from "../../src/components/DeviceFeatures"; +import DeviceFeatureFilter from "../../src/components/DeviceFeatureFilter"; +import DeviceConfig from "../../src/components/DeviceConfig"; +import SponsorshipRequired from "/docs/_sponsorship_required.mdx"; + +# Hausinstallation + +Die aufgelisteten Geräte können als `meter` für verschiedene Zwecke eingebunden werden: + +- `grid`: Netzanschluss +- `pv`: PV Produktion +- `battery`: Hausbatterie +- `charge`: Ladeleistung an der Wallbox +- `aux`: intelligenter Verbraucher mit eigener Überschussregelung + +In der Konfigurationsdatei gibt es hierzu den folgenden Bereich: + +```yaml +meters: + - name: grid1 + type: ... + - name: pv1 + type: ... + - name: battery1 + type: ... +``` + +Auf dieser Seite findest du die Konfigurationen für alle von evcc bekannterweise unterstützte Komponenten die als Energiemesspunkte (Zähler) eingebunden werden kann. +Nachdem du das Code-Beispiel für deine Zähler angepasst und in die `evcc.yaml` übernommen hast, kannst du die Verbindung mit dem Befehl `evcc meter` testen. Dabei werden alle konfigurierten Zähler getestet. Mit dem Befehl `evcc meter --name my_meter` kann man mittels des vergebenen Namens selektiv testen. + +``` +$ ./evcc meter + +grid +----- +Power: -31W +Energy: 5195.5kWh +Current L1..L3: 3.05A 1.07A 1.15A +``` + +:::note +Die meisten modernen PV-Technikkomponenten, insbesondere Wechselrichter und Batteriespeicher aber auch manche Smart Meter sind mit den s.g. SunSpec-Schemata über ein standardisiertes Datenmodell via Modbus/TCP abfragbar, ohne dass man dazu auf spezielle gerätespezifische Datenregister o. ä. zugreifen muss. Sollten hier bekannte Systeme also nicht mit einer eigenen Konfiguration namentlich aufgeführt sein, bedeutet dies in der Regel, dass diese vollständig SunSpec-kompatibel sind und somit keiner gerätespezifischen Sonderkonfiguration bedürfen. +::: + +#### Eigenschaften {#features} + +- **aktive Batteriesteuerung**: Eine passive Batteriesteuerung ist bei allen Hausakkus möglich. Die Ladung des Fahrzeugs wird dabei in abhängigkeit vom Ladestand des Hausakkus dynamisch angepasst. Unterstützt der Hausakku **aktive Steuerung** können weitere Optimierungen vorgenommen werden. Momentan ist eine Hausakku-Entladesperre beim Schnelladen des Fahrzeuges implementiert. + +#### Nach Eigenschaften filtern + + + + + + + +## ABB A43, A44, B23, B24 + + + + + + + + + + + + + + + + + + + + + + +## Acrel ADW300 Wireless Metering Meter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Ads-tec StoraXe + + + + + + + + + +## Alpha ESS Storion SMILE + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Anker Micro inverter + + + + + + + + + +## APsystems EZ1 + + + + + + + + + +## Bernecker Engineering MPM3PM + + + + + + + + + + + + + + + + + + + + + + +## Bosswerk Micro inverter + + + + + + + + + +## Carlo Gavazzi + +### EM110/111/112 + + + + + + + + + + + + + + + + + + + + + + +### EM24 + + + + + + + + + + + + + + + + + + + + + + +### EM330/EM340 + + + + + + + + + + + + + + + + + + + + + + +### EM530/EM540 + + + + + + + + + + + + + + + + + + + + + + +### ET112 + + + + + + + + + + + + + + + + + + + + + + +### ET330/ET340 + + + + + + + + + + + + + + + + + + + + + + +## cFos PowerBrain Meter + + + + + + + + + + + +## Deye + +### 3p hybrid inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### hp3 hybrid inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Micro inverter + + + + + + + + + +### Storage (hybrid) inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### String inverter + + + + + + + + + +## Discovergy + + + + + + + + + + + + + + + + + + + + + + +## DSMR + + + + + + + + + +## DZG DVH4013 + + + + + + + + + +## E3/DC + + + +Benutzername und Passwort sind identisch zum Web-Portal bzw. My E3/DC App. Key (=RSCP-Passwort) muss im Hauskraftwerk unter Personalisieren/Benutzerprofil angelegt werden. + +**Achtung**: Die aktive Batteriesteuerung überschreibt Einstellungen im Smart-Power/Betriebsbereich. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Eastron + +### SDM120-Modbus + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SDM220/230 + + + + + + + + + + + + + + + + + + + + + + +### SDM630-Modbus + + + + + + + + + + + + + + + + + + + + + + +### SDM72D-M + + + + + + + + + + + + + + + + + + + + + + +### SDM72DM-V2 + + + + + + + + + + + + + + + + + + + + + + +## Enphase IQ Envoy + + + +Als Batteriespeicher werden seitens der Enphase-API derzeit nur die Batterien vom Typ "AC Battery" unterstützt. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## ESPHome DSMR + + + + + + + + + +## FENECON + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## FoxESS + +### H1 Series Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + +### H3 Series Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Fronius + +### Ohmpilot + + + + + + + + + +### Primo GEN24 Plus + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Solar API V1 + + + +Benutzername und Passwort werden nur für die aktive Batteriesteuerung benötigt. + +**Achtung**: Die aktive Batteriesteuerung sollte nur verwendet werden, wenn keine weiteren Einstellungen für die zeitabhängige Batteriesteuerung in der Wechselrichter-Konfiguration unter "Energiemanagement" - "Batteriemanagement" getätigt wurden, denn bestehende Einstellungen werden überschrieben. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Symo GEN24 Plus + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Ginlong + +### Solis Hybrid Inverter (RHI series) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Solis Hybrid Inverter (S Series) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Solis Inverter + + + + + + + + + + + + + + + + + + + + + + +## go-e Controller + + + + + + + + + + + + + + + + + + + + + + +## GoodWe + +### ET/EH/BH/BT Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SDT/DT Inverter + + + + + + + + + +## Growatt + +### Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### TL-X(H) Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## HomeWizard Wi-Fi P1 Meter + + + + + + + + + + + + + + + + + + + + + + +## Hoymiles + +### HM & HMS Series (via AhoyDTU) + + + + + + + + + +### HM & HMS Series (via OpenDTU) + + + + + + + + + +## Huawei + +### SmartLogger + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SUN2000 via RS485 Modbus + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SUN2000 with SDongle + + + +Erfordert "Modbus/TCP". Freischaltung via "Errichterzugang" in den Kommunikationseinstellungen des Wechselrichters. +Siehe https://forum.huawei.com/enterprise/en/modbus-tcp-guide/thread/667250677153415168-667213868771979264 + + + + + + + +### SUN2000 with SDongle & Power Sensor + + + +Erfordert "Modbus/TCP". Freischaltung via "Errichterzugang" in den Kommunikationseinstellungen des Wechselrichters. +Siehe https://forum.huawei.com/enterprise/en/modbus-tcp-guide/thread/667250677153415168-667213868771979264 + + + + + + + + + + + + + + + + + + + + + + + + + + + +## IGEN Tech Solarman Logger + + + + + + + + + +## inepro PRO380-MOD + + + + + + + + + + + + + + + + + + + + + + +## Janitza B series, UMG series + + + + + + + + + + + + + + + + + + + + + + +## KEBA KeContact E10 + + + + + + + + + +## Kostal + +### Energy Meter C (KEM-C) + + + + + + + + + + + + + + + + + + + + + + +### Energy Meter P (KEM-P) + + + + + + + + + + + + + + + + + + + + + + +### Piko (legacy) + + + + + + + + + +### Piko Hybrid + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Piko MP Plus + + + + + + + + + +### Piko, Piko BA + + + + + + + + + + + + + + + + + + + + + + +### Plenticore Hybrid + + + +Nur ein System kann und darf auf den Wechselrichter zugreifen! Für die aktive Batteriesteuerung muss die externe Batteriesteuerung über Modbus mit dem Handwerkerzugang aktiviert sein. + + + + + + + + + + + + + + + + + + + + +### Smart Energy Meter + + + + + + + + + +### Smart Energy Meter (über den Wechselrichter) + + + +Der Zähler muss in Sensorposition 2 (Netzanschluss) installiert sein. Sensorposition 1 (Haushaltsverbrauch) wird nicht unterstützt. + + + + + + + +## LG ESS Home 8/10 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Loxone Miniserver + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## M-TEC + +### Energy Butler GEN2 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Energy Butler GEN3 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## my-PV + +### AC ELWA 2 + + + + + + + + + +### AC ELWA-E + + + + + + + + + +### AC•THOR + + + + + + + + + +### WiFi Meter + + + + + + + + + +## OpenEMS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Orno OR-WE-516, OR-WE-517 + + + + + + + + + + + + + + + + + + + + + + +## P1Monitor P1 Monitor + + + + + + + + + +## Plexlog + + + +Die Werte werden ca. alle 15 Sekunden aktualisiert, deshalb sollte das evcc `interval` nicht kleiner als 30 Sekunden gewählt werden. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Powerdog + + + + + + + + + + + + + + + + + + + + + + +## Powerfox Poweropti + + + + + + + + + + + + + + + + + + + + + + +## Qcells Q.HOME ESS HYB-G3 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## RCT Power + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Saia-Burgess Controls ALE3, AWD3 + + + + + + + + + + + + + + + + + + + + + + +## SAJ H2 Series Hybrid Solar Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## SAX Homespeicher + + + + + + + + + + + + + + + + + + + + + + +## Schneider Electric iEM3xxx Modbus + + + + + + + + + + + + + + + + + + + + + + +## SENEC .Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Senergy SE 4/5/6KTL-S1/G2 Inverter + + + + + + + + + +## Shelly + +### 3EM + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Pro 3 EM + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Siemens + +### 7KT1665 + + + + + + + + + + + + + + + + + + + + + + +### PAC 2200 + + + + + + + + + + + + + + + + + + + + + + +## SMA + +### Data Manager + + + +In der Weboberfläche des SMA Data Manager muss im Bereich "Externe Kommunikation" der Schalter "Modbus Server aktivieren" eingeschaltet sein. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Energy Meter + + + + + + + + + + + + + + + + + + + + + + +### Smart Energy Hybrid-Wechselrichter + + + + + + + + + + + + + + + + + + + + + + +### Sunny Boy Storage 1.5/2.0/2.5 (Modbus) + + + + + + + + + +### Sunny Boy Storage 3.7/5.0/6.0 (Modbus) + + + + + + + + + +### Sunny Home Manager 2.0 + + + + + + + + + +### Sunny Island (Modbus) + + + + + + + + + +### WebBox + + + + + + + + + +### Wechselrichter (Modbus) + + + + + + + + + +### Wechselrichter (Speedwire) + + + + + + + + + + + + + + + + + + + + + + +## Smartfox + +### Box, Reg, Reg extended + + + +`aux` kann für die Leistung der Warmwasserbereitung verwendet werden. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Pro, Pro 2, Pro Light, Pro Light 2, Light (EM2 firmware) + + + +`aux` kann für die Leistung der Warmwasserbereitung verwendet werden. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## SofarSolar + +### HYD 3…6K-EP + + + +Es wird empfohlen die Verbindung über einen LSE-3 Logger Stick mittels ModBus TCP herzustellen (LSW-3 WLAN Stick wird nicht unterstützt). Bei seriellem Anschluss via RS485 mit entsprechendem Adapter am COM Port ist zu beachten, dass wechselrichterseitig für eine Terminierung des RS485 Busses zu sorgen ist. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### HYD 5…20K-3PH + + + +Es wird empfohlen die Verbindung über einen LSE-3 Logger Stick mittels ModBus TCP herzustellen (LSW-3 WLAN Stick wird nicht unterstützt). Bei seriellem Anschluss via RS485 mit entsprechendem Adapter am COM Port ist zu beachten, dass wechselrichterseitig für eine Terminierung des RS485 Busses zu sorgen ist. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Inverter, Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SOFAR 5…24KTL-G3 + + + +Es wird empfohlen die Verbindung über einen LSE-3 Logger Stick mittels ModBus TCP herzustellen (LSW-3 WLAN Stick wird nicht unterstützt). Bei seriellem Anschluss via RS485 mit entsprechendem Adapter am COM Port ist zu beachten, dass wechselrichterseitig für eine Terminierung des RS485 Busses zu sorgen ist. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SOFAR 80…136KTL + + + +Es wird empfohlen die Verbindung über einen LSE-3 Logger Stick mittels ModBus TCP herzustellen (LSW-3 WLAN Stick wird nicht unterstützt). Bei seriellem Anschluss via RS485 mit entsprechendem Adapter am COM Port ist zu beachten, dass wechselrichterseitig für eine Terminierung des RS485 Busses zu sorgen ist. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Solaranzeige Solaranzeige + + + + + + + + + + + + + + + + + + + + + + +## SolarEdge + +### Hybrid Inverter + + + +Nur ein System kann und darf zeitgleich eine Modbus TCP-Verbindung zum Wechselrichter haben! +Für die optionale Batteriesteuerung muss StorageConf_CtrlMode (0xE004) auf 4 "Remote" stehen, das funktioniert am einfachsten wenn der Batteriemodus "Nutzungszeit" in der MySolarEdge-App aktiviert wurde. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Wechselrichter + + + +Nur ein System kann und darf auf den Wechselrichter zugreifen! + + + + + + + + + + + + + + + + + + + + +## Solarlog + + + +Wir empfehlen dieses Gerät für den Netzbezug/Einspeisewerte nur zu verwenden, wenn kein anderes Gerät diese Daten liefert. +Falls eine Hausbatterie angeschlossen ist sollte dieses Gerät auf keinen Fall für die erwähnten Werte verwendet werden! + + + + + + + + + + + + + + + + + + + + +## SolarMax + +### MAX.STORAGE / MAX.STORAGE Ultimate + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SolarMax SMT + + + + + + + + + +### SP Series Inverter + + + + + + + + + +## Solarwatt + +### EnergyManager, EnergyManager Pro + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### MyReserve + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### MyReserve Matrix (LAN oder PowerGateway) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Solax + +### Hybrid X1/X3 G3/G4 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Hybrid-Wechselrichter (Cloud) + + + +Der Solax Hybrid-Wechselrichter muss in der SolaxCloud angemeldet sein. + +**Achtung**: Die Werte können nur alle 150s abgerufen werden und dann auch 5 Minuten alt sein. Die Laderegelung nach PV kann hiermit nicht optimal gesteuert werden! Nur als Notfalloption nutzen wenn kein lokaler Zugriff möglich ist. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### PV-Wechselrichter (Cloud) + + + +Der Solax PV-Wechselrichter muss in der SolaxCloud angemeldet sein. + +**Achtung**: Die Werte können nur alle 150s abgerufen werden und dann auch 5 Minuten alt sein. Die Laderegelung nach PV kann hiermit nicht optimal gesteuert werden! Nur als Notfalloption nutzen wenn kein lokaler Zugriff möglich ist. + + + + + + + +## Sonnen + +### comfort, eco 5, eco 6, oem 6.5 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### sonnenBatterie + + + +Für die aktive Batteriesteuerung muss über das Webinterface der sonnenBatterie (unter Software-Integration) das "JSON Write API" aktiviert und das dort generierte API-Token in der Batteriekonfiguration unter `token` eingetragen werden. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Steca coolcept fleX + + + + + + + + + +## Sungrow + +### SG Series Inverter + + + + + + + + + + + + + + + + + + + + + + +### SH Series Hybrid Inverter + + + +Verbindungen über das WiNet-S-Dongle (WiFi oder LAN) funktionieren nur mit aktueller Firmware. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Sunsynk + +### 3p hybrid inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### hp3 hybrid inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Micro inverter + + + + + + + + + +### Storage (hybrid) inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### String inverter + + + + + + + + + +## Tasmota SML IR-Lesekopf für smarte Stromzähler bspw Hichi + + + +Um die Werte des Smartmeters für evcc korrekt auslesen zu können, muss das Lesekopf-Script so geändert werden, dass folgende JSON-Tags erzeugt werden: +- **SML** als Gruppenname der ausgelesenen Parameter +- **Total_in** für den Gesamtverbrauch in KWh (4 Nachkommastellen) +- **Total_out** für den Gesamteinspeisung in KWh mit (4 Nachkommastellen) +- **Power_curr** für den aktuellen Verbrauch bzw. die aktuelle Einspeisung (0 Nachkommastellen) + +Ein entsprechendes Lesekopf-Script sieht wie folgt aus: +``` +>D +>B +=>sensor53 r +>M 1 +// highlight-next-line ++1,3,s,16,9600,SML +// highlight-next-line +1,77070100010800ff@1000,Gesamtverbrauch,KWh,Total_in,4 +// highlight-next-line +1,77070100020800ff@1000,Gesamteinspeisung,KWh,Total_out,4 +// highlight-next-line +1,77070100100700ff@1,Verbrauch,W,Power_curr,0 +1,77070100600100ff@#,Zählernummer,,Meter_Id,0 +# +``` + + + + + + + +## Tesla Powerwall + + + +Um die optionale Entladesteuerung der Battery zu nutzen wird ein `refresh` Token für die Kommunikation mit der Tesla API benötigt. + +Folgende Apps ermöglichen das Erstellen des Tokens: +- [Auth app for Tesla (iOS)](https://apps.apple.com/us/app/auth-app-for-tesla/id1552058613#?platform=iphone) +- [Tesla Tokens (Android)](https://play.google.com/store/apps/details?id=net.leveugle.teslatokens) +- [Tesla Auth (macOS, Linux)](https://github.com/adriankumpf/tesla_auth) + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Tibber Pulse + + + + + + + + + +## TQ + +### Energy Manager EM2xx/EM3xx + + + + + + + + + +### Energy Manager EM420 + + + + Datenendpunkt (optional) + token: ey... # Token des EM420 (Erstellen unter Profil -> Zugangsschlüssel)`} /> + + + + + +## VARTA pulse, pulse neo, element + + + +PV nur verfügbar mit PV-Sensor + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Victron + +### EM24 + + + + + + + + + + + + + + + + + + + + + + +### EM530/EM540 + + + + + + + + + + + + + + + + + + + + + + +### Energy + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### ET340 + + + + + + + + + + + + + + + + + + + + + + +## Weidmüller + +### EM110-RTU-2P + + + + + + + + + + + + + + + + + + + + + + +### EM111-RTU-2P + + + + + + + + + + + + + + + + + + + + + + +### EM120-RTU-2P + + + + + + + + + + + + + + + + + + + + + + +### EM122-RTU-2P + + + + + + + + + + + + + + + + + + + + + + +## Youless Energy Monitor + + + +Zur Erfassung der PV-Produktion wird ein extern angebundenener S0-Erzeugungszähler benötigt. + + + + + + + + + + + + + + + + + + + + +## ZCS Azzurro Inverter, Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Zuidwijk + +### SlimmeLezer(+) + + + + + + + + + +### SlimmeLezer(+) V2 + + + +Neuere Slimmelezer-Geräte verwenden eine andere Konfiguration. Probieren Sie diese Vorlage aus, wenn die andere fehlschlägt. + + + + + + + +## Generische Unterstützung + +### manuell + +```yaml +meters: + - name: my_meter + type: custom + power: # power (W) + source: # plugin type + # ... + energy: # optional energy (kWh) + source: # plugin type + # ... + soc: # optional battery soc (%) + source: # plugin type + # ... + currents: # optional currents (A) + - source: # L1 plugin type + # ... + - source: # L2 plugin type + # ... + - source: # L3 plugin type + # ... +``` + +### SunSpec Batterie (Model 124) + + + + + + + + + +### SunSpec Batterie (Model 802) + + + + + + + + + +### SunSpec Hybridwechselrichter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SunSpec Wechselrichter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Volkszähler + +#### HTTP API + + + + + + + + + +#### HTTP API, Import & Export + + + + + + + + + +#### WebSocket API + + + + + + + + + +### vzlogger + + + + + + + + + +## Schaltbare Steckdosen + +### AVM FritzDECT + + + + + + + + + + + + + + + + + + + + + + +### Homematic IP + + + + + + + + + + + + + + + + + + + + + + +### myStrom Switch + + + + + + + + + + + + + + + + + + + + + + +### Shelly 1PM, EM, Plug S + + + + + + + + + + + + + + + + + + + + + + +### Tasmota (1 Phase Meter) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Tasmota dreiphasig + + + +Kanäle 1,2,3 müssen verwendet werden. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### TP-Link + +#### H-Series Smart Plug + + + + + + + + + +#### Tapo P-Series Smart Plug + + + + + + + diff --git a/docs/devices/vehicles-nightly.mdx b/docs/devices/vehicles-nightly.mdx new file mode 100644 index 000000000..9a7a2e683 --- /dev/null +++ b/docs/devices/vehicles-nightly.mdx @@ -0,0 +1,1508 @@ +--- +sidebar_position: 3 +--- + +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; +import SponsorshipRequired from "/docs/_sponsorship_required.mdx"; +import DeviceConfig from "../../src/components/DeviceConfig"; + +# Fahrzeuge + +Um die Ladung auf einen bestimmten Ladestand (SoC) zu begrenzen, und die meisten Wallboxen diesen nicht kennen, kann evcc direkt mit dem Fahrzeug über den Fahrzeughersteller kommunizieren. + +In der Konfigurationsdatei gibt es hierzu den folgenden Bereich: + +```yaml +vehicles: + - name: ev + type: ... +``` + +Auf dieser Seite findest du die Konfigurationen für alle von evcc unterstützten Fahrzeuge. +Nachdem du das Code-Beispiel für dein Fahrzeug angepasst und in die `evcc.yaml` übernommen hast, kannst du die Verbindung mit dem Befehl `evcc vehicle` testen. Dabei werden alle konfigurierten Fahrzeuge getestet. Mit dem Befehl `evcc vehicle --name my_ev` kann man mittels des vergebenen Namens selektiv testen. + +``` +$ ./evcc vehicle + +SoC: 57% +Charge status: B +Charged: 4.7kWh +Capacity: 77kWh +Range: 280km +Odometer: 4131km +``` + +:::note +Die Qualität und Verfügbarkeit der Fahrzeugschnittstellen variiert von Hersteller zu Hersteller. Solltest du anhaltende Probleme mit dem aktualisieren deiner Fahrzeugdaten haben melde dich bitte in den [GitHub Discussions](https://github.com/evcc-io/evcc/discussions). +::: + + + + + +## Aiways + + + + + + + +## Audi + + + + + + + +## BMW + + + + + + + +## Citroën + +Benötigt `access` und `refresh` Tokens. Diese können über den Befehl `evcc token [name]` generiert werden. + + + + + + + +## Dacia + + + + + + + +## DS + +Benötigt `access` und `refresh` Tokens. Diese können über den Befehl `evcc token [name]` generiert werden. + + + + + + + +## Fiat + + + + + + + +## Ford + + + + + + + +## Hyundai Bluelink + +Manche Modelle (z.B. Kona) schalten bei geringen Ladeströmen (< 8A) intern auf 2 Phasen um. In den Fällen, in denen die Wallbox auch die Phasenströme misst, führt das zu unerwünschten Schwankungen der Ladeleistung. Abhilfe schafft hier, den Mindestladestrom auf 8A zu setzen. + + + + + + + +## Jeep + + + + + + + +## Kia Bluelink + +Manche Modelle (z.B. Niro EV) schalten bei geringen Ladeströmen (< 8A) intern auf 2 Phasen um. In den Fällen, in denen die Wallbox auch die Phasenströme misst, führt das zu unerwünschten Schwankungen der Ladeleistung. Abhilfe schafft hier, den Mindestladestrom auf 8A zu setzen. + + + + + + + +## Mercedes-Benz + +Benötigt `access` und `refresh` Tokens. Diese können über den Befehl `evcc token [name]` generiert werden. + + + + + + + +## MG + + + + + + + +## Mini + + + + + + + +## Nissan + +### Ariya + + + + + + + +### Leaf + + + + + + + +### Leaf (pre 2019) + + + + + + + +## Opel + +Benötigt `access` und `refresh` Tokens. Diese können über den Befehl `evcc token [name]` generiert werden. + + + + + + + +## Peugeot + +Benötigt `access` und `refresh` Tokens. Diese können über den Befehl `evcc token [name]` generiert werden. + + + + + + + +## Polestar + + + + + + + +## Renault + + + + + + + +## Seat + +### CupraConnect Gen3 (Ateca, Leon, Formentor) + + + + + + + +### CupraConnect Gen4 (Born) + + + + + + + +## Skoda + +### Andere + + + + + + + +### Enyaq + + + + + + + +## Smart + +### + + + + + + + +### EQ + + + + + + + +## Tesla + +Benötigt `access` und `refresh` Tokens. Diese können über [tesla.evcc.io](https://tesla.evcc.io) erstellt werden. +Die Steuerung von Fahrzeugen im Zusammenspiel mit einem Tesla Wall Connector erfolgt über einen evcc Proxy-Server und benötigt ein Sponsor Token. Der virtuelle evcc Schlüssel muss auf dem Fahrzeug installiert sein. +Siehe [tesla.evcc.io](https://tesla.evcc.io). + + + + + + + + + +## Volkswagen We Connect ID + +e-Golf, e-Up, ID Familie + + + + + + + +## Volvo + +### aktuell + + + + + + + +### veraltet + + + + + + + +## Zero Motorcycles + + + + + + + +## Generische Unterstützung + +### manuell + +```yaml +vehicles: + - name: my_car + type: custom + title: Mein Auto # display name for UI + capacity: 50 # battery capacity (kWh) + soc: # battery soc (%) + source: # plugin type + # ... + status: # optional charge status (A..F) + source: # plugin type + # ... + range: # optional electric range (km) + source: # plugin type + # ... + odometer: # optional odometer (km) + source: # plugin type + # ... + climater: # optional climate status (true/false) + source: # plugin type + # ... + wakeup: # optional vehicle wake up command + source: # plugin type + # ... + maxcurrent: # set charger max current (A) + source: # plugin type + # ... + limitsoc: # optional in-vehicle limit soc, read-only (%) + source: # plugin type + # ... +``` + +### evNotify + + + + + + + +### ISO15118 + +Nur unterstützt wenn das Fahrzeug den Ladestand (Soc) an die verbundene Wallbox übermitteln kann. +Bei Verwendung von ISO15118 mit bestimmten VW Konzernfahrzeugen, z.B. Porsche Taycan, ist zusätzliche Konfiguration +im Fahrzeug erforderlich. Dafür muss ein aktives Ortsbezogenes Ladeprofil mit der niedrigsten Minimalladung (25%) +angelegt sein und Direktladen deaktiviert. Anderenfalls kann das Fahrzeug nicht in den Schalfmodus übergeben. + + + + + + + +### mg2mqtt + +Voraussetzung ist ein konfigurierter MQTT Broker und ein SAIC/MQTT Gateway (https://github.com/SAIC-iSmart-API/saic-python-mqtt-gateway oder https://github.com/SAIC-iSmart-API/saic-java-client) + + + + + + + +### mz2mqtt + +myMazda zu MQTT. Voraussetzung ist ein konfigurierter MQTT Broker und eine mz2mqtt Installation https://github.com/C64Axel/mz2mqtt. + + + + + + + +### Offline + + + + + + + +### Open Vehicle Monitoring System + +Unterstützung für alle Fahrzeuge via ODB2 Adapter im Fahrzeug. Mehr Infos bei [Open Vehicle Monitoring System](http://api.openvehicles.com/). + + + + + + + +### PSA Car Controller + +Remote Control of PSA car https://github.com/flobz/psa_car_controller + + + + + + + +### TeslaLogger + +Open Source Tesla Datenlogger https://github.com/bassmaster187/TeslaLogger + + + + + + + +### TeslaMate + +Open Source Tesla Datenlogger https://github.com/adriankumpf/teslamate. Voraussetzung ist konfigurierter MQTT Broker. + + + + + + + +### Tronity + + + + + + + + + +## Scooter + +### NIU E-Scooter + + + + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/devices/meters-nightly.mdx b/i18n/en/docusaurus-plugin-content-docs/current/devices/meters-nightly.mdx new file mode 100644 index 000000000..2ba801d57 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/devices/meters-nightly.mdx @@ -0,0 +1,10400 @@ +--- +sidebar_position: 2 +--- + +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; +import DeviceConfig from "../../../../../src/components/DeviceConfig"; +import DeviceFeatures from "../../../../../src/components/DeviceFeatures"; +import DeviceFeatureFilter from "../../../../../src/components/DeviceFeatureFilter"; +import SponsorshipRequired from "../_sponsorship_required.mdx"; + +# Meters / Site + +The devices on this page can all be used as energy measuring points (`meter`) for various purposes: + +- `grid`: Grid supply +- `pv`: Solar power +- `battery`: House battery +- `charge`: Charging power at the wallbox +- `aux`: Smart consumer with its own surplus regulation + +The configuration is formatted as follows: + +```yaml +meters: + - name: grid1 + type: ... + - name: pv1 + type: ... + - name: battery1 + type: ... +``` + +Once you have adapted the code samples to suit your meters in `evcc.yaml`, you can test the connection using the `evcc meter` command, which returns the current status of all connected meters. +If you just want to test one meter at a time, use `evcc meter --name my_meter`. + +``` +$ ./evcc meter + +grid +----- +Power: -31W +Energy: 5195.5kWh +Current L1..L3: 3.05A 1.07A 1.15A +``` + +:::note +Most components used in modern Solar / Battery installations, especially inverters and battery storage (but also some metering devices!) have support for the relatively standardised "SunSpec" data model, which can be queried via Modbus/TCP without requiring device-specific data registers. +If your system isn't listed here, that might mean that it is 100% SunSpec-compatible, so try that as your first port of call. (You may need to enable network support on your device - check the manual) +::: + +#### Features {#features} + +- **active battery control**: Passive battery control is possible with all home batteries. The charging of the vehicle is dynamically adjusted depending on the charge level of the house battery. If the house battery supports **active control**, further optimizations can be made. Currently, a home battery discharge lock is implemented when fast charging a vehicle. + +#### Filter by feature + + + + + + + +## ABB A43, A44, B23, B24 + + + + + + + + + + + + + + + + + + + + + + +## Acrel ADW300 Wireless Metering Meter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Ads-tec StoraXe + + + + + + + + + +## Alpha ESS Storion SMILE + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Anker Micro inverter + + + + + + + + + +## APsystems EZ1 + + + + + + + + + +## Bernecker Engineering MPM3PM + + + + + + + + + + + + + + + + + + + + + + +## Bosswerk Micro inverter + + + + + + + + + +## Carlo Gavazzi + +### EM110/111/112 + + + + + + + + + + + + + + + + + + + + + + +### EM24 + + + + + + + + + + + + + + + + + + + + + + +### EM330/EM340 + + + + + + + + + + + + + + + + + + + + + + +### EM530/EM540 + + + + + + + + + + + + + + + + + + + + + + +### ET112 + + + + + + + + + + + + + + + + + + + + + + +### ET330/ET340 + + + + + + + + + + + + + + + + + + + + + + +## cFos PowerBrain Meter + + + + + + + + + + + +## Deye + +### 3p hybrid inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### hp3 hybrid inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Micro inverter + + + + + + + + + +### Storage (hybrid) inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### String inverter + + + + + + + + + +## Discovergy + + + + + + + + + + + + + + + + + + + + + + +## DSMR + + + + + + + + + +## DZG DVH4013 + + + + + + + + + +## E3/DC + + + +Username and password are identical to Web Portal or My E3/DC App access. Key (=RSCP-Password) must be set in the E3/DC System at Personalize/User Profile. + +**Note**: Active battery control will override Smart-Power/Operating Range settings. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Eastron + +### SDM120-Modbus + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SDM220/230 + + + + + + + + + + + + + + + + + + + + + + +### SDM630-Modbus + + + + + + + + + + + + + + + + + + + + + + +### SDM72D-M + + + + + + + + + + + + + + + + + + + + + + +### SDM72DM-V2 + + + + + + + + + + + + + + + + + + + + + + +## Enphase IQ Envoy + + + +Only batteries of type "AC Battery" are currently supported by Enphase-API. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## ESPHome DSMR + + + + + + + + + +## FENECON + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## FoxESS + +### H1 Series Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + +### H3 Series Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Fronius + +### Ohmpilot + + + + + + + + + +### Primo GEN24 Plus + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Solar API V1 + + + +Username and password are only required for active battery control. + +**Attention**: Active battery control should only be used if no other settings for time-dependent battery control were made in the inverter configuration under "Energy Management" - "Battery Management", as existing settings will be overwritten. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Symo GEN24 Plus + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Ginlong + +### Solis Hybrid Inverter (RHI series) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Solis Hybrid Inverter (S Series) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Solis Inverter + + + + + + + + + + + + + + + + + + + + + + +## go-e Controller + + + + + + + + + + + + + + + + + + + + + + +## GoodWe + +### ET/EH/BH/BT Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SDT/DT Inverter + + + + + + + + + +## Growatt + +### Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### TL-X(H) Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## HomeWizard Wi-Fi P1 Meter + + + + + + + + + + + + + + + + + + + + + + +## Hoymiles + +### HM & HMS Series (via AhoyDTU) + + + + + + + + + +### HM & HMS Series (via OpenDTU) + + + + + + + + + +## Huawei + +### SmartLogger + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SUN2000 via RS485 Modbus + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SUN2000 with SDongle + + + +Needs "Modbus/TCP". Activation using "maintenance access" within the communication settings of the inverter. +See https://forum.huawei.com/enterprise/en/modbus-tcp-guide/thread/667250677153415168-667213868771979264 + + + + + + + +### SUN2000 with SDongle & Power Sensor + + + +Needs "Modbus/TCP". Activation using "maintenance access" within the communication settings of the inverter. +See https://forum.huawei.com/enterprise/en/modbus-tcp-guide/thread/667250677153415168-667213868771979264 + + + + + + + + + + + + + + + + + + + + + + + + + + + +## IGEN Tech Solarman Logger + + + + + + + + + +## inepro PRO380-MOD + + + + + + + + + + + + + + + + + + + + + + +## Janitza B series, UMG series + + + + + + + + + + + + + + + + + + + + + + +## KEBA KeContact E10 + + + + + + + + + +## Kostal + +### Energy Meter C (KEM-C) + + + + + + + + + + + + + + + + + + + + + + +### Energy Meter P (KEM-P) + + + + + + + + + + + + + + + + + + + + + + +### Piko (legacy) + + + + + + + + + +### Piko Hybrid + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Piko MP Plus + + + + + + + + + +### Piko, Piko BA + + + + + + + + + + + + + + + + + + + + + + +### Plenticore Hybrid + + + +Only a single system may access the inverter! For active battery control, the external battery control via Modbus must be activated using installer access. + + + + + + + + + + + + + + + + + + + + +### Smart Energy Meter + + + + + + + + + +### Smart Energy Meter (via inverter) + + + +The energy meter must be installed in sensor position 2 (grid connection). Sensor position 1 (House consumption) is not supported. + + + + + + + +## LG ESS Home 8/10 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Loxone Miniserver + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## M-TEC + +### Energy Butler GEN2 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Energy Butler GEN3 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## my-PV + +### AC ELWA 2 + + + + + + + + + +### AC ELWA-E + + + + + + + + + +### AC•THOR + + + + + + + + + +### WiFi Meter + + + + + + + + + +## OpenEMS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Orno OR-WE-516, OR-WE-517 + + + + + + + + + + + + + + + + + + + + + + +## P1Monitor P1 Monitor + + + + + + + + + +## Plexlog + + + +The values are updated approximately every 15 seconds, hence the evcc `interval` should not be less than 30 seconds. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Powerdog + + + + + + + + + + + + + + + + + + + + + + +## Powerfox Poweropti + + + + + + + + + + + + + + + + + + + + + + +## Qcells Q.HOME ESS HYB-G3 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## RCT Power + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Saia-Burgess Controls ALE3, AWD3 + + + + + + + + + + + + + + + + + + + + + + +## SAJ H2 Series Hybrid Solar Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## SAX Homespeicher + + + + + + + + + + + + + + + + + + + + + + +## Schneider Electric iEM3xxx Modbus + + + + + + + + + + + + + + + + + + + + + + +## SENEC .Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Senergy SE 4/5/6KTL-S1/G2 Inverter + + + + + + + + + +## Shelly + +### 3EM + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Pro 3 EM + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Siemens + +### 7KT1665 + + + + + + + + + + + + + + + + + + + + + + +### PAC 2200 + + + + + + + + + + + + + + + + + + + + + + +## SMA + +### Data Manager + + + +In the web interface of the SMA Data Manager you need to activate "Modbus Server activated" in the section "External communication". + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Energy Meter + + + + + + + + + + + + + + + + + + + + + + +### Inverter (Speedwire) + + + + + + + + + + + + + + + + + + + + + + +### Smart Energy Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + +### Sunny Boy Storage 1.5/2.0/2.5 (Modbus) + + + + + + + + + +### Sunny Boy Storage 3.7/5.0/6.0 (Modbus) + + + + + + + + + +### Sunny Home Manager 2.0 + + + + + + + + + +### Sunny Island (Modbus) + + + + + + + + + +### WebBox + + + + + + + + + +### Wechselrichter (Modbus) + + + + + + + + + +## Smartfox + +### Box, Reg, Reg extended + + + +`aux` can be used for water heating power. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Pro, Pro 2, Pro Light, Pro Light 2, Light (EM2 firmware) + + + +`aux` can be used for water heating power. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## SofarSolar + +### HYD 3…6K-EP + + + +It is recommended to establish the connection via a LSE-3 logger stick using ModBus TCP (LSW-3 WiFi stick is not supported). If you are connecting via serial RS485 using the inverter's COM port and a proper adapter note that on the inverter's side you have to take care of a proper termination of the RS485 bus. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### HYD 5…20K-3PH + + + +It is recommended to establish the connection via a LSE-3 logger stick using ModBus TCP (LSW-3 WiFi stick is not supported). If you are connecting via serial RS485 using the inverter's COM port and a proper adapter note that on the inverter's side you have to take care of a proper termination of the RS485 bus. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Inverter, Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SOFAR 5…24KTL-G3 + + + +It is recommended to establish the connection via a LSE-3 logger stick using ModBus TCP (LSW-3 WiFi stick is not supported). If you are connecting via serial RS485 using the inverter's COM port and a proper adapter note that on the inverter's side you have to take care of a proper termination of the RS485 bus. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SOFAR 80…136KTL + + + +It is recommended to establish the connection via a LSE-3 logger stick using ModBus TCP (LSW-3 WiFi stick is not supported). If you are connecting via serial RS485 using the inverter's COM port and a proper adapter note that on the inverter's side you have to take care of a proper termination of the RS485 bus. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Solaranzeige Solaranzeige + + + + + + + + + + + + + + + + + + + + + + +## SolarEdge + +### Hybrid Inverter + + + +Only one system can and may have a Modbus TCP connection to the inverter at the same time! +For optional battery control, StorageConf_CtrlMode (0xE004) must be set to 4 "Remote" that is most easily achieved by setting the battery mode to "Time of Use" e.g. in the MySolarEdge-App. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Inverter + + + +Only one system may access the inverter! + + + + + + + + + + + + + + + + + + + + +## Solarlog + + + +We recommend to use this device for grid power values only, if no other device is available providing this data. +If you have a home battery installed, please do not use this device at all for grid power values. + + + + + + + + + + + + + + + + + + + + +## SolarMax + +### MAX.STORAGE / MAX.STORAGE Ultimate + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SolarMax SMT + + + + + + + + + +### SP Series Inverter + + + + + + + + + +## Solarwatt + +### EnergyManager, EnergyManager Pro + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### MyReserve + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### MyReserve Matrix (LAN oder PowerGateway) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Solax + +### Hybrid X1/X3 G3/G4 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Hybrid-Inverter (Cloud) + + + +The Solax hybrid inverter has to be registered in the SolaxCloud. + +**Attention**: Values can only be fetched every 150s and then also can be 5 minutes old. Charging by PV will not be optimal because of this! Only use as fallback if no local access is available. + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Inverter (Cloud) + + + +The Solax inverter has to be registered in the SolaxCloud. + +**Attention**: Values can only be fetched every 150s and then also can be 5 minutes old. Charging by PV will not be optimal because of this! Only use as fallback if no local access is available. + + + + + + + +## Sonnen + +### comfort, eco 5, eco 6, oem 6.5 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### sonnenBatterie + + + +For active battery control, the "JSON Write API" must be activated via the sonnenBatterie web interface (under Software-Integration) and the API token generated there must be entered in the battery configuration under `token`. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Steca coolcept fleX + + + + + + + + + +## Sungrow + +### SG Series Inverter + + + + + + + + + + + + + + + + + + + + + + +### SH Series Hybrid Inverter + + + +Connections via the WiNet-S dongle (WiFi or LAN) only work with the latest firmware. + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Sunsynk + +### 3p hybrid inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### hp3 hybrid inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Micro inverter + + + + + + + + + +### Storage (hybrid) inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### String inverter + + + + + + + + + +## Tasmota SML IR-reader for smartmeters e.g. Hichi + + + +To be able to read the values of the smart meter for evcc correctly, the IR reader script must be changed so that the following JSON tags are generated: +- **SML** as the group name of the read parameters +- **Total_in** for the total consumption in KWh (4 decimal places) +- **Total_out** for the total feed-in in KWh (4 decimal places) +- **Power_curr** for the current consumption or the current feed-in in W (0 decimal places) + +A corresponding IR reader script looks like this: +``` +>D +>B +=>sensor53 r +>M 1 +// highlight-next-line ++1,3,s,16,9600,SML +// highlight-next-line +1,77070100010800ff@1000,Gesamtverbrauch,KWh,Total_in,4 +// highlight-next-line +1,77070100020800ff@1000,Gesamteinspeisung,KWh,Total_out,4 +// highlight-next-line +1,77070100100700ff@1,Verbrauch,W,Power_curr,0 +1,77070100600100ff@#,Zählernummer,,Meter_Id,0 +# +``` + + + + + + + +## Tesla Powerwall + + + +To use the optional battery control you need to generate a `refresh` token for communicating with the Tesla API. + +The following apps allow to create the token: +- [Auth app for Tesla (iOS)](https://apps.apple.com/us/app/auth-app-for-tesla/id1552058613#?platform=iphone) +- [Tesla Tokens (Android)](https://play.google.com/store/apps/details?id=net.leveugle.teslatokens) +- [Tesla Auth (macOS, Linux)](https://github.com/adriankumpf/tesla_auth) + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Tibber Pulse + + + + + + + + + +## TQ + +### Energy Manager EM2xx/EM3xx + + + + + + + + + +### Energy Manager EM420 + + + + Data Endpoint (optional) + token: ey... # Access token for EM420 (Create in Profile -> Access tokens)`} /> + + + + + +## VARTA pulse, pulse neo, element + + + +PV only available with PV sensor + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Victron + +### EM24 + + + + + + + + + + + + + + + + + + + + + + +### EM530/EM540 + + + + + + + + + + + + + + + + + + + + + + +### Energy + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### ET340 + + + + + + + + + + + + + + + + + + + + + + +## Weidmüller + +### EM110-RTU-2P + + + + + + + + + + + + + + + + + + + + + + +### EM111-RTU-2P + + + + + + + + + + + + + + + + + + + + + + +### EM120-RTU-2P + + + + + + + + + + + + + + + + + + + + + + +### EM122-RTU-2P + + + + + + + + + + + + + + + + + + + + + + +## Youless Energy Monitor + + + +An externally connected S0 generation meter is required to record the solar production. + + + + + + + + + + + + + + + + + + + + +## ZCS Azzurro Inverter, Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Zuidwijk + +### SlimmeLezer(+) + + + + + + + + + +### SlimmeLezer(+) V2 + + + +More recent slimmelezer devices use a different configuration. Try this template if the other one fails. + + + + + + + +## Generic support + +### Custom + +```yaml +meters: + - name: my_meter + type: custom + power: # power (W) + source: # plugin type + # ... + energy: # optional energy (kWh) + source: # plugin type + # ... + soc: # optional battery soc (%) + source: # plugin type + # ... + currents: # optional currents (A) + - source: # L1 plugin type + # ... + - source: # L2 plugin type + # ... + - source: # L3 plugin type + # ... +``` + +### SunSpec Battery (Model 124) + + + + + + + + + +### SunSpec Battery (Model 802) + + + + + + + + + +### SunSpec Hybrid Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### SunSpec Inverter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Volkszähler + +#### HTTP API + + + + + + + + + +#### HTTP API, Import & Export + + + + + + + + + +#### WebSocket API + + + + + + + + + +### vzlogger + + + + + + + + + +## Switchable sockets + +### AVM FritzDECT + + + + + + + + + + + + + + + + + + + + + + +### Homematic IP + + + + + + + + + + + + + + + + + + + + + + +### myStrom Switch + + + + + + + + + + + + + + + + + + + + + + +### Shelly 1PM, EM, Plug S + + + + + + + + + + + + + + + + + + + + + + +### Tasmota (1 Phase Meter) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### Tasmota three phase + + + +Meter channels 1,2,3 must be used. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +### TP-Link + +#### H-Series Smart Plug + + + + + + + + + +#### Tapo P-Series Smart Plug + + + + + + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/devices/vehicles-nightly.mdx b/i18n/en/docusaurus-plugin-content-docs/current/devices/vehicles-nightly.mdx new file mode 100644 index 000000000..70e9623c7 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/devices/vehicles-nightly.mdx @@ -0,0 +1,1510 @@ +--- +sidebar_position: 3 +--- + +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; +import SponsorshipRequired from "../_sponsorship_required.mdx"; +import DeviceConfig from "../../../../../src/components/DeviceConfig"; + + +# Vehicles + +To limit vehicle charging to a given State of Charge (SoC), which most Chargers do not have the capability to read, +evcc can directly communicate with the Vehicle, usually via its manufacturer. + +The configuration is formatted as follows: + +```yaml +vehicles: + - name: ev + type: ... +``` + +All of the Vehicles listed on this page are supported by evcc. +Once you have adapted the code samples to suit your Vehicle(s) in `evcc.yaml`, you can test the connection using the `evcc vehicle` command, which returns the current status of all connected vehicles. +If you just want to test one meter at a time, use `evcc vehicle --name my_swanky_ev`. + +``` +$ ./evcc vehicle + +SoC: 57% +Charge status: B +Charged: 4.7kWh +Capacity: 77kWh +Range: 280km +Odometer: 4131km +``` + +:::note +The availability and general quality of Vehicle data can vary greatly by manufacturer. If you have persistent issues updating your Vehicle data, please open a [GitHub discussion](https://github.com/evcc-io/evcc/discussions). +::: + + + + + +## Aiways + + + + + + + +## Audi + + + + + + + +## BMW + + + + + + + +## Citroën + +Requires `access` and `refresh` tokens. These can be generated with command `evcc token [name]`. + + + + + + + +## Dacia + + + + + + + +## DS + +Requires `access` and `refresh` tokens. These can be generated with command `evcc token [name]`. + + + + + + + +## Fiat + + + + + + + +## Ford + + + + + + + +## Hyundai Bluelink + +Some models (e.g. Kona) switch internally to 2 phases at low charging currents (< 8A). In cases where the wallbox also measures the phase currents, this leads to undesirable fluctuations in the charging power. The remedy here is to set the minimum charging current to 8A. + + + + + + + +## Jeep + + + + + + + +## Kia Bluelink + +Some models (e.g. Niro EV) switch internally to 2 phases at low charging currents (< 8A). In cases where the wallbox also measures the phase currents, this leads to undesirable fluctuations in the charging power. The remedy here is to set the minimum charging current to 8A. + + + + + + + +## Mercedes-Benz + +Requires `access` and `refresh` tokens. These can be generated with command `evcc token [name]`. + + + + + + + +## MG + + + + + + + +## Mini + + + + + + + +## Nissan + +### Ariya + + + + + + + +### Leaf + + + + + + + +### Leaf (pre 2019) + + + + + + + +## Opel + +Requires `access` and `refresh` tokens. These can be generated with command `evcc token [name]`. + + + + + + + +## Peugeot + +Requires `access` and `refresh` tokens. These can be generated with command `evcc token [name]`. + + + + + + + +## Polestar + + + + + + + +## Renault + + + + + + + +## Seat + +### CupraConnect Gen3 (Ateca, Leon, Formentor) + + + + + + + +### CupraConnect Gen4 (Born) + + + + + + + +## Skoda + +### Enyaq + + + + + + + +### Others + + + + + + + +## Smart + +### + + + + + + + +### EQ + + + + + + + +## Tesla + +Tesla `access` and `refresh` tokens are required. These can be generated through [tesla.evcc.io](https://tesla.evcc.io). +Controlling vehicles in conjunction with a Tesla Wall Connector is done via an evcc proxy server and requires a sponsor token. The evcc virtual key must be installed on the vehicle. +See [tesla.evcc.io](https://tesla.evcc.io). + + + + + + + + + +## Volkswagen We Connect ID + +e-Golf, e-Up, ID family + + + + + + + +## Volvo + +### latest + + + + + + + +### legacy + + + + + + + +## Zero Motorcycles + + + + + + + +## Generic support + +### Custom + +```yaml +vehicles: + - name: my_car + type: custom + title: My Car # display name for UI + capacity: 50 # battery capacity (kWh) + soc: # battery soc (%) + source: # plugin type + # ... + status: # optional charge status (A..F) + source: # plugin type + # ... + range: # optional electric range (km) + source: # plugin type + # ... + odometer: # optional odometer (km) + source: # plugin type + # ... + climater: # optional climate status (true/false) + source: # plugin type + # ... + wakeup: # optional vehicle wake up command + source: # plugin type + # ... + maxcurrent: # set charger max current (A) + source: # plugin type + # ... + limitsoc: # optional in-vehicle limit soc, read-only (%) + source: # plugin type + # ...``` + +### evNotify + + + + + + + +### ISO15118 + +Only supported if the vehicle can provide the state of charge (Soc) to the connected charger. +Using ISO15118 with some VW group vehicles, e.g. Porsche Taycan, requires additional configuration in the vehicle. +This requires an active location-based charging profile with the lowest minimum charge (25%) and direct charging disabled. +Otherwise the vehicle cannot be put into sleep mode. + + + + + + + +### mg2mqtt + +Required MQTT broker configuration and a SAIC/MQTT Gateway (https://github.com/SAIC-iSmart-API/saic-python-mqtt-gateway or https://github.com/SAIC-iSmart-API/saic-java-client) + + + + + + + +### mz2mqtt + +myMazda to MQTT. Required MQTT broker configuration and a mz2mqtt installation https://github.com/C64Axel/mz2mqtt. + + + + + + + +### Offline + + + + + + + +### Open Vehicle Monitoring System + +Support for all vehicles via ODB2 adapter in the vehicle. More info at [Open Vehicle Monitoring System](http://api.openvehicles.com/). + + + + + + + +### PSA Car Controller + +Remote Control of PSA car https://github.com/flobz/psa_car_controller + + + + + + + +### TeslaLogger + +Open source Tesla data logger https://github.com/bassmaster187/TeslaLogger + + + + + + + +### TeslaMate + +Open source Tesla data logger https://github.com/adriankumpf/teslamate. MQTT broker required. + + + + + + + +### Tronity + + + + + + + + + +## Scooter + +### NIU E-Scooter + + + + + diff --git a/src/generateFromTemplate.js b/src/generateFromTemplate.js index c2b017775..8b2629066 100644 --- a/src/generateFromTemplate.js +++ b/src/generateFromTemplate.js @@ -118,10 +118,10 @@ ${block.code} return deviceFeatures + description + code + sponsor; } -function additionalContent(name, target) { +function additionalContent(name, source) { const filename = name.toLowerCase().replaceAll(" ", "_"); try { - const path = target.replace(/\.mdx$/, `/_${filename}.mdx`); + const path = source.replace(/\.mdx$/, `/_${filename}.mdx`); const content = fs.readFileSync(path, "utf-8"); console.log("integrated additional content from ", path); return content + "\n"; @@ -129,7 +129,7 @@ function additionalContent(name, target) { return ""; } -function generateMarkdown(data, type, target) { +function generateMarkdown(data, type, source, target) { let brandCounter = 0; let productCounter = 0; @@ -163,7 +163,7 @@ function generateMarkdown(data, type, target) { if (group !== lastGroup) { generated += `## ${group}\n\n`; - generated += additionalContent(group, target); + generated += additionalContent(group, source); } if (brand && brand !== lastBrand) { @@ -190,7 +190,7 @@ function generateMarkdown(data, type, target) { } const content = fs - .readFileSync(target, "utf-8") + .readFileSync(source, "utf-8") .replace( new RegExp(`${escapeRegExp(AUTOGEN_MARKER)}(.|\n)*`, "gm"), `${AUTOGEN_MARKER}\n\n${generated}`, @@ -199,16 +199,21 @@ function generateMarkdown(data, type, target) { fs.writeFileSync(target, content, "utf-8"); } -["vehicle", "meter", "charger", "tariff"].forEach((type) => { - // German - const templatesDe = readTemplates(`./templates/release/de/${type}`); - generateMarkdown(templatesDe, type, `./docs/devices/${type}s.mdx`); - - // English - const templatesEn = readTemplates(`./templates/release/en/${type}`); - generateMarkdown( - templatesEn, - type, - `./i18n/en/docusaurus-plugin-content-docs/current/devices/${type}s.mdx`, - ); +["release", "nightly"].forEach((version) => { + ["vehicle", "meter", "charger", "tariff"].forEach((type) => { + ["de", "en"].forEach((lang) => { + const templates = readTemplates(`./templates/${version}/${lang}/${type}`); + const base = + lang === "de" + ? "./docs" + : `./i18n/en/docusaurus-plugin-content-docs/current`; + const postfix = version === "release" ? "" : "-nightly"; + generateMarkdown( + templates, + type, + `${base}/devices/${type}s.mdx`, + `${base}/devices/${type}s${postfix}.mdx`, + ); + }); + }); });