diff --git a/docs/Anzeige-Steuerung.md b/docs/Anzeige-Steuerung.md deleted file mode 100644 index 91cb6c853a..0000000000 --- a/docs/Anzeige-Steuerung.md +++ /dev/null @@ -1,9 +0,0 @@ -Die Kontrolle der openWB geschieht über einen Webbrowser. Der Aufruf geschieht über die Eingabe der IP-Adresse der openWB. - -## Startseite - -Die hier angezeigten Leistungen werden direkt aus den Leistungsdaten, welche vom Zähler übertragen werden, übernommen. - -## Auswertungen - Diagramme - -In der Auswertung (und für das Langzeit-Logging) werden 5-Minuten-Intervalle der Zählerstände (kWh-Differenz/5min = kW) verwendet. diff --git a/docs/Cloud-Sicherung.md b/docs/Cloud-Sicherung.md deleted file mode 100644 index 08a7c1d72e..0000000000 --- a/docs/Cloud-Sicherung.md +++ /dev/null @@ -1,12 +0,0 @@ -_Einstellungen -> System -> System -> Sicherung/Wiederherstellung_ - -In den Sicherungseinstellungen kann ein Cloud-Dienst für automatische Sicherungen hinterlegt werden. -Die Konfiguration des Cloud-Dienstes wird in diesem Wiki-Beitrag beschrieben. - -Automatische Sicherungen werden nur ausgeführt, wenn die openWB als **primary** konfiguriert (oder die einzige) ist. -Auf als **secondary** konfigurierten openWBs werden nur manuelle Sicherungen und Sicherungen vor einem Update (falls aktiviert) ausgeführt, da hier keine Arbeitsdaten (Log-Dateien) zu sichern sind. - -Folgende Anbieter werden unterstützt: - -* [Nextcloud](https://github.com/openWB/core/wiki/NextCloud-als-Sicherungs-Cloud-einrichten) -* [Samba](https://github.com/openWB/core/wiki/Samba-als-Sicherung-einrichten) diff --git a/docs/EVU-PV-Speicher-Kit.png b/docs/EVU-PV-Speicher-Kit.png deleted file mode 100644 index 382404d682..0000000000 Binary files a/docs/EVU-PV-Speicher-Kit.png and /dev/null differ diff --git a/docs/EZA-Beispielkonfiguration.png b/docs/EZA-Beispielkonfiguration.png deleted file mode 100644 index 19980e4a5f..0000000000 Binary files a/docs/EZA-Beispielkonfiguration.png and /dev/null differ diff --git a/docs/Fahrzeuge.md b/docs/Fahrzeuge.md deleted file mode 100644 index 5ed1f96e9c..0000000000 --- a/docs/Fahrzeuge.md +++ /dev/null @@ -1,5 +0,0 @@ -_Einstellungen -> Konfiguration -> Fahrzeuge_ - -Die Einstellungen für die Fahrzeuge sind untergliedert in Fahrzeug-spezifische Einstellungen, Fahrzeug- und Ladeprofile. Im Fahrzeugprofil wird u.a. die Akkugröße und die maximale Anzahl der Phasen vorgegeben. Im Ladeprofil z.B. der Lademodus und die Stromstärke. - -Neben dem Standardprofil muss für jedes physische Fahrzeug ein Fahrzeug hinzugefügt werden. Wenn mehrere Fahrzeuge des gleichen Modells vorhanden sind, kann immer dasselbe Fahrzeug-Profil zugeordnet werden. Wenn alle Fahrzeuge nach dem gleichen Schema geladen werden sollen, weise allen Fahrzeugen dasselbe Lade-Profil zu. Andernfalls nach Bedarf ein neues Lade-Profil hinzufügen und zuweisen. diff --git a/docs/Fehlersuche.md b/docs/Fehlersuche.md deleted file mode 100644 index 2f106543f6..0000000000 --- a/docs/Fehlersuche.md +++ /dev/null @@ -1,45 +0,0 @@ -Es kann immer mal passieren, dass etwas nicht wie gedacht funktioniert. Das kann an einem Fehler im Programmcode, an einem Hardwaredefekt oder an einer fehlerhaften oder nicht zu den Gegebenheiten passenden Konfiguration liegen. - -Wenn nun eine Funktion nicht wie erwartet ausgeführt wird oder plötzlich ein Fehler auftritt, ist die erste Frage: -> Habe ich vor Kurzem etwas verändert? - -Dies betrifft ebenso Änderungen der Einstellungen im Fahrzeug, Wechselrichter (z.B. Softwareupdates) oder der Hauselektrik. Unter Umständen kann das Problem so schon gelöst werden. - -## Wo bekomme ich Hilfe? - -### Hardwaresupport - -Mit Problemen bei Inbetriebnahme / Anschluss oder Hardwareproblemen mit openWB-Hardware bitte direkt über die Support-Funktion unter System -> Support an openWB wenden (notfalls auch per Mail an ). -Im Forum kann durchaus mal etwas untergehen. Das führt zu Frust und soll nicht sein. - -### Forum - -Im [Forum](https://forum.openwb.de/index.php) findet man folgende Hilfestellung für Hilfesuchende. Die hier erbetene Herangehensweise dient dazu, den Fehler mit dem für alle niedrigsten Aufwand zu beheben. - -> Bitte keine Mehrfach-Meldung per Mail, Support-Ticket und Forum. -Das spart auf unserer Seite Supportzeit und bringt erfahrungsgemäß keine Beschleunigung des Vorgangs. -Bitte bei Problemen immer einen Logauszug posten: - -> Dazu unter System->Fehlersuche das Debuglevel auf Details stellen und mindestens zwei komplette Durchläufe von ``# *** Start***`` bis ``# ***Start***`` aus dem Main-Log kopieren, während das Problem auftritt. Sensible Daten wie Benutzernamen und Kennwörter unkenntlich machen. -Logauszüge bitte als Codeblock posten (Schaltfläche "" über dem Editor-Fenster). -Bei Problemen mit dem internen Ladepunkt zusätzlich einen Auszug aus dem Log des internen Ladepunkts, bei Problemen mit dem SoC aus dem SoC-Log posten. -Bei Problemen mit dem UI/Darstellung bitte ein Theme verwenden, das von openWB gepflegt wird (wird bei der Themeauswahl angezeigt). - -> Screenshots ersetzen keinen Logauszug! -Für Beiträge wie "Funktion XY geht nicht mehr! Woran kann das liegen?" ohne Logs gibt es von uns keine Hilfestellung. - -Formuliert eure Frage freundlich, beschreibt, was ihr tun wolltet und was stattdessen passiert ist. Weiterhin ist die verwendete Version von openWB wichtig. Diese findet ihr unter _Einstellungen -> System -> System_ im Feld _Versionsinformationen / Aktualisierungen_. -Da es schon Wechselwirkungen mit anderen SmartHome-Systemen gegeben hat, erwähnt ggf. weitere im Heimnetzwerk laufende SmartHome-Systeme. - -### Log-Erstellung - -In der Standard-Einstellung des Logs werden nur Warnungen & Fehler erfasst. Außerdem wird bei einem Neustart der openWB der Fehlerlog gelöscht. - -Um aussagekräftige Logs zu erzeugen, müssen Log-Dateien im Debug-Modus erstellt werden. Hierzu ist folgende Schaltfläche zu aktivieren: - -![Debug-Einstellung](pictures/Fehlersuche_DebugLog.jpg) - -Aufgrund des detaillierten Loggings ist die Dauer der Aufnahme ca. auf die letzten zwei Stunden begrenzt. Beachtet also, dass sich der Fehler innerhalb des aufgezeichneten Abschnitts befindet. -Dann ist in den meisten Fällen das Main.log aufzuklappen und mit der grünen Schaltfläche zu aktualisieren. Der entsprechende Auszug kann nun in eine Textdatei oder direkt in die Nachricht im Forum kopiert werden. - -![Main-Log](pictures/Fehlersuche_Main-Log.jpg) diff --git a/docs/Grundkonzept.md b/docs/Grundkonzept.md deleted file mode 100644 index a309b157d0..0000000000 --- a/docs/Grundkonzept.md +++ /dev/null @@ -1,37 +0,0 @@ -Hier werden die Grundeinstellungen für Anfänger mit einer einfachen Konstellation, welche im privaten Umfeld häufig vorkommt, erklärt. -Üblicherweise sind da ein oder zwei Autos und ein oder zwei Wallboxen, die bei der software2 nur noch openWBs sein dürfen. Hat man nur ein Auto und eine openWB, ist es ganz simpel. Mit zwei Autos muss man sich - wenn man weiterreichende Features nutzen - oder nur ganz einfach die geladenen kWh loggen möchte - damit auseinandersetzen, wie man der openWB mitteilt, welches Auto nun angeschlossen ist: - -- man wählt das zu ladende Auto auf dem Handy oder auf dem Display der openWB aus -- man macht das bei mit RFID-Leser ausgestatteten openWBs per RFID-Karte -- man kauft für jedes Auto eine eigene openWB; das hat den Vorteil, dass die Autos immer eingesteckt bleiben können und so der gesamte PV-Überschuss garantiert in den Autos landet. -- man gibt ein bisschen mehr Geld aus, kauft eine openWB pro und hat auch die richtigen Autos dafür, dass die Wallbox selbst das Auto erkennt. Da geht das automatisch und das ist neu in der Software2; alternativ kann auch ein optionaler RFID-Leser an die Pro angeschlossen werden und zur Identifizierung des Fahrzeugs verwendet werden. - -## Konfiguration - -Die Konfiguration der Wallbox-Funktionalität verteilt sich auf zwei oder drei Menüpunkte im Konfigurations-Menü: Ladepunkte (ggf. Lastmanagement) und Fahrzeuge. - -### Ladepunkte - die Infrastruktur - -Hier werden die vorhandenen Wallboxen als Ladepunkt angelegt und ihnen gemeinsame Eigenschaften in Form von Ladepunkt-Profilen zugewiesen. Im privaten Bereich ist es ja üblicherweise so, dass mit maximal 11 kW geladen wird und die Ladepunkte entweder vor unbefugtem Zugriff geschützt werden wollen oder nicht. Das versteckt sich im Ladepunkt-Profil, weshalb wir uns um eigene Ladepunkt-Profile gar nicht kümmern müssen. Wir nehmen das Standard-Ladepunkt-Profil für alle unsere openWBs und passen das nach unseren Wünschen an. - -Sind mehrere Ladepunkte an einer Unterverteilung angeschlossen, deren Zuleitung weniger verträgt, als die Ladepunkte abgeben können, muss man sich noch über das Loadsharing Gedanken machen. Zum Beispiel ist eine Unterverteilung, an der zwei 22 kW openWBs angeschlossen sind, in den seltensten Fällen mit den dafür notwendigen 63 A abgesichert; häufig z.B. nur 35 A. Hier fügt man noch eine Komponente "virtuellen Zähler" ein, setzt den im [Lastmanagement](https://github.com/openWB/core/wiki/Lastmanagement-und-kaskadierte-Zähler) in der Struktur über die beiden Ladepunkte und trägt dort die 24 kW / 35 A ein. Die maximal zulässige Leistung am EVU-Punkt trägt man dementsprechend in diesem [Zähler](https://github.com/openWB/core/wiki/Zaehler) ein. - -### Fahrzeuge - warum wir das hier alles machen - -Bei den Fahrzeugen zerteilt sich die Konfiguration in die technischen Eigenschaften und die ladungstechnischen Aspekte - das sind die beiden Profile für Fahrzeug und Ladung. Die beiden zusammengefasst ergeben das Fahrzeug. - -#### Fahrzeug-Profile - -Da steht drin, was für einen Fahrzeugtyp mit welchen Eigenschaften wir haben (ID.3, BMW i3, Tesla Model Y, ...) und Angaben zur Ladungssteuerung und -statistiken. Haben wir nur ein Auto oder interessiert Zielladen oder "geladene km" nicht, reicht es, beim Standard-Fahrzeug-Profil zu bleiben. - -#### Ladeprofil - -Da steht drin, wie das Auto geladen werden soll, aber diese Einstellungen sind später im UI der openWB alle änderbar. Bei mehr als einer openWB sollte man je Fahrzeug ein Ladeprofil anlegen, damit man z.B. von der neu hinzugekommenen Priorisierung Gebrauch machen kann. (Das priorisierte Auto fängt zuerst an zu laden, wenn man beide gleich priorisiert, muss der Überschuss wie bei der 1.9 für beide angeschlossenen Autos reichen.) Bei mehr als einem Auto sollte man auch je Auto ein Ladeprofil anlegen, denn da stehen die Zeitpläne und ein SoC-Limit drin. Einfacher ist es bei nur einem Auto - da reicht es wieder, beim Standard-Ladeprofil zu bleiben und das zu ändern. Allerdings wird das Standard-Ladeprofil (im Modus Stop) auch dafür genutzt, Ladepunkte nach Abstecken zu sperren. Möchte man also Ladepunkte vor unbefugtem Zugriff schützen, muss man auch bei einer Wallbox ein eigenes Ladeprofil anlegen. - -#### Fahrzeug - -Hier werden nun die beiden Profile zusammengeführt und ggf. ein SoC-Modul konfiguriert. - -**Kurz zusammengefasst:** Mit einem Auto und einer openWB bleibt man bei den Profilen immer bei den mitgelieferten Standard-Profilen und ändert die Parameter dort. Bei mehreren Autos legt man für jedes Auto ein Fahrzeug-Profil und ein Ladeprofil an und fasst die beiden im Fahrzeug zusammen. - -Danke für das Erstellen dieses Howto an [Gero](https://openwb.de/forum/viewtopic.php?t=8076) diff --git "a/docs/Grunds\303\244tzliches zu Z\303\244hlern.md" "b/docs/Grunds\303\244tzliches zu Z\303\244hlern.md" deleted file mode 100644 index dec39ce83a..0000000000 --- "a/docs/Grunds\303\244tzliches zu Z\303\244hlern.md" +++ /dev/null @@ -1,87 +0,0 @@ -openWB benötigt zum erfolgreichen PV-Überschussladen die entsprechenden Zählerwerte am EVU-Punkt (EVU=Elektrizitätsversorgungsunternehmen), sprich dem Übergang ins öffentliche Netz. An dieser Stelle muss die Gesamtleistung saldierend erfasst werden. Für eine phasenbasierte Leistungsüberwachung sind auch die einzelnen Ströme und/oder Leistungen der drei Phasen notwendig. Bei einem Zähler im Hausverbrauchs-Zweig muss die Konfiguration wie [hier](https://github.com/openWB/core/wiki/Hausverbrauchs-Zähler) beschrieben erfolgen. - -Im einfachsten Fall geschieht dies durch Kauf und Einbau eines [EVU-Kits](#evu-kit). Sollten schon digital auslesbare Zähler vorhanden sein, so besteht die Möglichkeit diese Werte an openWB weiterzuleiten, auch mit Hilfe von Hausautomationsservern. - -Es gibt viele verschiedene Möglichkeiten, Zähler als auch Wechselrichter in das openWB-System einzufügen. Die Struktur der Zähler muss dann im [Lastmanagement](https://github.com/openWB/core/wiki/Lastmanagement-und-kaskadierte-Zähler) dem System bekanntgegeben werden. Hier können auch [virtuelle Zähler](##Virtuelle Zähler) hinzugefügt werden, welche openWB-intern die untergeordneten Zähler verrechnen. - -## EVU-Kit - -Das [EVU-Kit (Link zum Shop)](https://openwb.de/shop/?product=openwb-evu-kit) ist die einfachste Art in der Software einen Zähler an die openWB zu integrieren. Der Zähler muss von einem Elektriker direkt hinter dem Zähler des EVU in den Zählerschrank integriert werden. Es gibt, je nach Kapazität des Hausanschlusses, verschiedene Messvarianten des Zählers, welche sich von der Integration unterscheiden. Dies betrifft aber nur die Arbeit des Elektrikers. -Der Zähler kommuniziert mit der openWB über Ethernet. Die Kits sind so vorkonfiguriert, dass sie von der openWB Software automatisch gefunden werden, wenn ein entsprechendes Gerät mit Zählerkomponente angelegt wird. Es gibt auch für Wechselrichter und Speicher entsprechende Kits. - -![EVU-Kit](pictures/EVU-PV-Speicher-Kit-689x1024.png) - -## MQTT - -openWB hat einen MQTT-Broker integriert, welcher unter Port 1883 (ohne Verschlüsselung) und Port 8883 (mit Verschlüsselung) erreichbar ist. Benutzerauthentifizierung ist deaktiviert und auch nicht aktivierbar. Ein Zähler, welcher die benötigten Daten liefert muss sich mit diesem Broker verbinden und dort die Werte unter den entsprechenden Topics veröffentlichen. - -Folgende Werte können dem MQTT-Zähler übergeben werden. Die ID ist individuell und wird beim Anlegen der MQTT-Komponente angezeigt. -Die folgenden Topics sind für einen reibungslosen Betrieb unbedingt erforderlich: - -- **openWB/set/counter/id/get/power** - - **Beschreibung**: Bezugsleistung in Watt, Zahl mit oder ohne Nachkommastellen (Float, Integer) und einem Punkt als Dezimaltrennzeichen, positiv für Bezug, negativ für Einspeisung. - - **Beispiel**: `-123.45` - -- **openWB/set/counter/id/get/imported** - - **Beschreibung**: Bezogene Energie in Wh, Zahl mit oder ohne Nachkommastellen (Float, Integer) und einem Punkt als Dezimaltrennzeichen, nur positiv. - - **Beispiel**: `123.45` - -- **openWB/set/counter/id/get/exported** - - **Beschreibung**: Eingespeiste Energie in Wh, Zahl mit oder ohne Nachkommastellen (Float, Integer) und einem Punkt als Dezimaltrennzeichen, nur positiv. - - **Beispiel**: `123.45` - -Ströme je Phase sind für phasenbasiertes Lastmanagement unbedingt erforderlich, sonst erfolgt das Lastmanagement ausschließlich auf Basis der Gesamtleistung am EVU-Punkt: - -- **openWB/set/counter/id/get/currents** - - **Beschreibung**: Array mit den Strömen je Phase in Ampere, mit Nachkommastellen (Float), positiv für Bezug, negativ für Einspeisung. - - **Beispiel**: `[1.2,2.3,-2.1]` - -Die Netzfrequenz, Spannungen, Leistungen und Leistungsfaktoren jeder Phase werden ausschließlich zu Anzeigezwecken verwendet: - -- **openWB/set/counter/id/get/frequency** - - **Beschreibung**: Netzfrequenz in Hz, Zahl mit oder ohne Nachkommastellen (Float, Integer) und einem Punkt als Dezimaltrennzeichen. - - **Beispiel**: `50.12` - -- **openWB/set/counter/id/get/voltages** - - **Beschreibung**: Array mit den Spannungen je Phase in Volt, mit Nachkommastellen (Float). - - **Beispiel**: `[222.2,223.3,222.3]` - -- **openWB/set/counter/id/get/powers** - - **Beschreibung**: Array mit den Leistungen je Phase in Watt, mit Nachkommastellen (Float). - - **Beispiel**: `[12.3,23.4,-12.3]` - -- **openWB/set/counter/id/get/power_factors** - - **Beschreibung**: Array mit den Leistungsfaktoren je Phase, mit Nachkommastellen (Float), Wertebereich -1 bis 1. - - **Beispiel**: `[0.95,0.96,-0.95]` - -## Huawei Wechselrichter mit DTSU666-H 250A und SDongle - -Huawei Wechselrichter werden, in der Betriebsart mit Aufzeichnung des Hausverbraucht mit dem _DTSU666-H 250A_ Stromzähler direkt am EVU-Punkt betrieben. Die Kommunikation zwischen Zähler und Wechselrichter findet über RS485 statt. Sofern der Wechselrichter mit dem optionalen SmartDongle FE ausgestattet ist, können über diesen Daten des Wechselrichter ausgelesen werden. -Die Schnittstelle am Dongle ist Modbus-TCP. Dies muss mit Installer-Account am Wechselrichter auf "Unrestricted" gestellt werden, damit die Daten extern abgerufen werden können. - -Der Huawei-Wechselrichter kann direkt über die openWB ausgelesen werden. -Eine weitere Möglichkeit des Datenabrufs wird im [openWB-Forum](https://openwb.de/forum/viewtopic.php?t=7029) entwickelt und ist auf [Github](https://github.com/AlexanderMetzger/huawei_openwb_bridge) sowie der [Homepage des Entwicklers](https://lebensraum-wohnraum.de/openwb-kommunikation-mit-dem-huawei-wechselrichter-sun-2000/) zu finden. Hierbei wird das Image auf die SD-karte eines Raspberry-Zero gespiegelt und der Raspberry mit dem Config-WLAN des Wechselrichters verbunden. Die Skripte ziehen sich die entsprechenden Werte in Echtzeit vom Wechselrichter und veröffentlichen diese auf die [MQTT](#mqtt) Schnittstelle der openWB. Der Zähler in der openWB muss dementsprechend als MQTT-Zähler eingerichtet sein. - -### Solaranzeige - -[Solaranzeige](https://solaranzeige.de) ist ebenfalls ein OpenSource Projekt, welches der Visualisierung, Speicherung und Weiterverarbeitung von PV-Daten dient. -Dieses Projekt unterstützt aktuell (Stand 2024-02) mehr Wechselrichter als openWB. Somit können hier mit etwas Aufwand existierende Wechselrichter eingebunden und die Daten weitergereicht werden, ohne Arbeiten am Zählerschrank durchzuführen zu lassen. -Die Software ist originär dafür vorgesehen auf einen Raspberry per Image installiert zu werden und nach wenigen Konfigurationsschritten lauffähig zu sein. Es gibt auch schon Portierungen für [Docker](https://github.com/DeBaschdi/docker.solaranzeige). -Solaranzeige kann mit vielen Wechselrichtern kommunizieren und auch teilweise die angeschlossenen Zähler auslesen. Eine zeitbasierte Datenbank (InfluxDb), Datenweitergabe über einen MQTT-Client sowie eine Visualisierung mit Grafana sind direkt integriert. Es kann aber auch bereits existierende Infrastruktur verwendet werden. -In dem Projekt wird (mit Stand von 2021) auch die Möglichkeit dokumentiert die Daten direkt an openWB weiterzuleiten. Dann kann jedoch kein weiterer MQTT-Broker bedient werden. -Alternativ können die Zählerwerte an eine Hausautomationsserver weitergegeben, dort ggf. mit korrigiertem Vorzeichen und dann über einen zweiten MQTT-Client zur openWB geschickt werden. - -## Virtuelle Zähler - -Virtuelle Zähler sind, wie der Name schon sagt, nicht physikalisch vorhanden. Diese dienen in der Struktur des [Lastmanagement](https://github.com/openWB/core/wiki/Lastmanagement-und-kaskadierte-Zähler) dazu, Ströme und/oder Leistung zu begrenzen oder Werte aus untergeordneten einzelnen Zählern zu akkumulieren. - -## Timing - -Das zyklische Senden bzw. Bereitstellen der Zählerwerte ist für eine funktionierende Regelung essentiell. Unter ``Einstellungen - Allgemein - Hardware`` kann die Regelgeschwindigkeit ausgewählt werden. Es gibt die Intervalle: - -- Normal -- Langsam (20s) -- Sehr langsam (60s) - -Hier muss eine Regelgeschwindigkeit entsprechend der Aktualisierungsrate der Zählerwerte angegeben werden, da ansonsten die Rückmeldung des Systems zu spät kommt und die openWB weiter versucht nachzuregeln. -Insbesondere bei der Verwendung von [Solaranzeige](### Solaranzeige) ist aufgrund der 20-30s dauerenden Aktualisierungsrate die Regelungsgeschwindigkeit anzupassen. diff --git a/docs/Hausverbrauch.md b/docs/Hausverbrauch.md deleted file mode 100644 index a9b0c9cc78..0000000000 --- a/docs/Hausverbrauch.md +++ /dev/null @@ -1,31 +0,0 @@ -Der Hausverbrauch kann in der openWB auf zwei verschiedenen Wegen ermittelt werden: die openWB berechnet den Hausverbrauch oder du gibst in den Einstellungen einen Zähler an, der den Hausverbrauch misst. -Eine Mischung der beiden Möglichkeiten, also nicht gemessener, berechneter Hausverbrauch und gemessener Hausverbrauch kann in der openWB nicht abgebildet werden. -Es muss in der Anlage einen Zähler geben, der alle Verbräuche erfasst. Dies kann entweder der EVU-Zähler sein (dieser erfasst auch Wechselrichter und Speicher) oder der Hausverbrauchszähler (Wechselrichter und Zähler werden separat erfasst). - -### Möglichkeit 1: Berechnung des Hausverbrauchs durch die openWB - -Der Hausverbrauch entspricht der Summer aller nicht gemessenen Verbraucher. Üblicherweise ist am EVU-Punkt ein Zähler installiert. Außerdem kennt die openWB die Leistungen des Wechselrichters, des Speichers und der Ladepunkte. Aus der Differenz ergibt sich der Hausverbrauch. - -### Möglichkeit 2: Hausverbrauchszähler - -Unter `Einstellungen→Konfiguration→Lastmanagement` kann bei Hausverbrauch ein Zähler ausgewählt werden. Diese Einstellung ist nur dann richtig, wenn in der Anlage ein Zähler verbaut ist, der den Hausverbrauch misst. Dies ist bei manchen Systemherstellern wie Kostal(?) üblich. Der Hausverbrauchszähler kann die Ladepunkte messen oder nicht. Dann müssen diese in der Hierarchie entsprechend hinter oder neben dem Zähler angeordnet werden. -Bezug und Einspeisung ins öffentliche Netz werden dann mit einem virtuellen Zähler aus den Werten des Hausverauchszählers, Wechselrichter und Speicher berechnet. Der virtuelle Zähler addiert die Werte aller in der Struktur dahinter angeordneten Komponenten. - -Zunächst ein Virtuelles Gerät mit einem virtuellen Zähler anlegen. Die Komponenten müssen in der Hierarchie wie in den Abbildungen unten angeordnet werden. In den Einstellungen für das Lastmanagement beim Punkt Hausverbrauch den Hausverbrauchs-Zähler auswählen. - -### Hausverbrauch bei mehreren Zählern - -Wenn es einen Zähler am EVU-Punkt und einen Zähler im Hausverbrauchszweig gibt, dann wie unter `Möglichkeit 2` beschrieben, den Zähler, der den Hausverbrauch misst unter `Einstellungen→Konfiguration→Lastmanagement→Hausverbauch` auswählen. -Wenn der Hausverbrauch die Summer mehrerer Zähler in der Anlage ist, müssen diese in einem virtuellen Zähler zusammengefasst werden und dieser wie unter `Möglichkeit 2` als Hausverbrauchs-Zähler ausgewählt werden. Dieser kann nicht der Zähler an der Spitze (EVU-Zähler) sein, da in diesem Zähler immer auch Speicher und PV mit eingerechnet werden müssen, um den Überschuss für PV-Laden am EVU-Punkt zu kennen. - -Misst der Zähler den Hausverbrauch, ergibt sich folgende Anordnung: - -![Hausverbrauchs-Zähler](Hausverbrauchs-Zaehler.png) - -Misst der Zähler den Hausverbrauchs und ist ein Hybrid-Wechselrichter vorhanden, ergibt sich folgende Struktur: - -![Hausverbrauchs-Zähler Hybrid](Hausverbrauchs-Zaehler_Hybrid.png) - -Ist der Zähler wie üblich am EVU-Punkt installiert und misst den gesamten Verbrauch/Einspeisung, muss die Struktur wie folgt aussehen: - -![Standard Zähler](standard.png) diff --git a/docs/Hausverbrauchs-Zaehler.png b/docs/Hausverbrauchs-Zaehler.png deleted file mode 100644 index d9da625f28..0000000000 Binary files a/docs/Hausverbrauchs-Zaehler.png and /dev/null differ diff --git a/docs/Hausverbrauchs-Zaehler_Hybrid.png b/docs/Hausverbrauchs-Zaehler_Hybrid.png deleted file mode 100644 index 67f32a8072..0000000000 Binary files a/docs/Hausverbrauchs-Zaehler_Hybrid.png and /dev/null differ diff --git a/docs/Home.md b/docs/Home.md index 0d58231955..06d68608d1 100644 --- a/docs/Home.md +++ b/docs/Home.md @@ -1,14 +1,7 @@ -**Herzlich Willkommen im openWB2 Wiki!** +**Herzlich Willkommen im GitHub-Wiki für openWB software2!** -In openWB2 sind Ladepunkte, Module und Fahrzeuge flexibel konfigurierbar. In diesem Wiki wird das zugrundeliegende Konzept und das Zusammenspiel der verschiedenen Einstellungen erläutert. Details zu den einzelnen Einstellungen erhält man durch Klick auf das Fragezeichen neben der Einstellung direkt im User Interface. +Die komplette Anleitung und Nutzerdokumentation für openWB software2 findet Ihr im neuen [openWB-Wiki für Endanwender](https://wiki.openwb.de/). -Die ersten Schritte in openWB 2 sind [hier](https://openwb.de/main/?page_id=1942) erklärt. Eine Anleitung zum Anbinden von Wechselrichtern, Speichern und Zählern findet Ihr [hier](https://openwb.de/main/?page_id=970). +Auch Ihr als Community könnt an den Artikeln im Wiki für Endanwender mitwirken. Sendet dazu einen Artikel-Vorschlag oder einen Textvorschlag (gerne auch mit Bildern) zur Aktualisierung bzw. Korrektur an unseren Support unter [support@openwb.de](mailto:support@openwb.de). -Die Einstellungsseiten und Konfigurationsmöglichkeiten wurden im Vergleich zu 1.9 grundlegend überarbeitet. -Eine Übersicht über die wichtigsten Features findet Ihr [hier](https://openwb.de/forum/viewtopic.php?f=3&t=3170). - -Unterstützung und Infos zu neuen Releases gibt's im Forum [Software 2.x](https://openwb.de/forum/viewforum.php?f=13). - -Die Erstellung von Wiki-Beiträgen ist [hier](https://github.com/openWB/core/wiki/Wiki-Eintrag_erstellen) beschrieben. - -_Das Wiki befindet sich aktuell noch im Aufbau._ +Hier im GitHub-Wiki findet Ihr ausschließlich technische Informationen für Entwickler, wie Ihr mit euren eigenen Pull Requests zur Weiterentwicklung des openWB-Codes beitragen könnt. \ No newline at end of file diff --git a/docs/Huawei-Smartlogger.md b/docs/Huawei-Smartlogger.md deleted file mode 100644 index 63f4a3e356..0000000000 --- a/docs/Huawei-Smartlogger.md +++ /dev/null @@ -1,15 +0,0 @@ -Im Smartlogger3000a müssen folgende Einstellungen festgelegt werden: - -1. Zunächst unter Einstell.-> Bef.-Param. -> Modbus TCP Folgende Einstellungen festlegen: - - Leitungseinstellungen: Akt.(Unbegrenzt) - - Addressmodus: Logische Addresse - - Logger-Addresse: z.B.4 (Muss eine freie ModBus ID sein, logische Addresse 2tes Bild.) - - Schnelle Planung: Aktivieren -![Huawei Smartlogger ModBusTCP](HuaweiSmartloggerModBusTCP.PNG) -2. Unter Wartung->Geräte-Mgmt.-> Geräte Liste kann man jetzt die logische Adresse der einzelnen Geräte ablesen. Diese wird dann in der openWB in der Einstellung ModbusID eingetragen. - ![HuaweiSmartloggerLogischeAdressen](HuaweiSmartloggerLogischeAdressen.PNG) -3. in den Einstellungen der openWB das Modul Huawei Smartlogger auswählen. -4. Jetzt muss man die IP des Smartloggers und den Port 502 eintragen, außer dieser wurde geändert. -5. Jetzt die passenden Komponenten hinzufügen und die jeweilige ModbusID eintragen. -6. Zum Schluss auf Speichern drücken und unter dem Lastmanagement die passende Anordnung wählen. - ![Huawei Smartlogger Komponenten](HuaweiSmartloggerKomponenten.PNG) diff --git a/docs/HuaweiSmartloggerKomponenten.PNG b/docs/HuaweiSmartloggerKomponenten.PNG deleted file mode 100644 index 2acc515423..0000000000 Binary files a/docs/HuaweiSmartloggerKomponenten.PNG and /dev/null differ diff --git a/docs/HuaweiSmartloggerLogischeAdressen.PNG b/docs/HuaweiSmartloggerLogischeAdressen.PNG deleted file mode 100644 index ffb14ef7aa..0000000000 Binary files a/docs/HuaweiSmartloggerLogischeAdressen.PNG and /dev/null differ diff --git a/docs/HuaweiSmartloggerModBusTCP.PNG b/docs/HuaweiSmartloggerModBusTCP.PNG deleted file mode 100644 index ae0b4e61c8..0000000000 Binary files a/docs/HuaweiSmartloggerModBusTCP.PNG and /dev/null differ diff --git a/docs/Hybrid System aus Wechselrichter und Speicher.md b/docs/Hybrid System aus Wechselrichter und Speicher.md deleted file mode 100644 index e93550cc75..0000000000 --- a/docs/Hybrid System aus Wechselrichter und Speicher.md +++ /dev/null @@ -1,16 +0,0 @@ -Bei Hybrid-Systemen ist ein DC- Speicher an den Wechselrichter angeschlossen. Bei den meisten Herstellern wird dann die Wechselrichter-Leistung anstelle der PV-Leistung ausgegeben. Auch die Zählerstände werden miteinander verrechnet. - -Wechselrichter-Leistung: Summe aus PV- und Speicher-Leistung, die der Wechselrichter ins Hausnetz abgibt. -PV-Leistung: Auf dem Dach erzeugte Leistung. - -In openWB wird die PV-Leistung ausgegeben. Wenn in der Struktur der Speicher hinter dem Wechselrichter angeordnet ist, berechnet die openWB aus der Wechselrichter- und Speicher-Leistung den Wert für die PV-Leistung. - -Nicht alle Hersteller geben bei Hybrid-Systemen die Wechselrichter-Leistung aus. Daher können wir keine allgemein gültige Empfehlung zur Konfiguration der Struktur geben. -Die Struktur muss wie in der ersten Abbildung angeordnet werden, wenn die PV-Leistung um die Ladeleistung des Speichers zu niedrig ist. (Achtung: Auch der Hausverbrauch stimmt dann nicht, da dieser aus den gemessenen Größen berechnet wird.) - -Hybrid-System, wenn die Wechselrichter-Leistung ausgegeben wird: - -![Hybrid-System](hybrid.png) - -Hybrid-System, wenn die PV-Leistung ausgegeben wird: -![Hybrid-System](standard.png) diff --git a/docs/Lademodi.md b/docs/Lademodi.md deleted file mode 100644 index 9ffb373f52..0000000000 --- a/docs/Lademodi.md +++ /dev/null @@ -1,19 +0,0 @@ -### PV-Laden - -Beim PV-Laden wird die Ladeleistung anhand des Überschusses am EVU-Punkt geregelt. Um ständiges Starten und Stoppen der Ladung zu verhindern, startet die Ladung, wenn für die Dauer der Einschaltverzögerung die Einschaltschwelle überschritten wurde. Die Ladung wird gestoppt, wenn für die Dauer der Abschaltverzögerung die Abschaltschwelle unterschritten wurde. -Wenn ein Wechselrichter verbaut ist, bei dem die Einspeiseleistung reduziert wird - auch als 70%-Regelung bekannt -, kann dies mit dem Regelpunkt Einspeisegrenze eingestellt werden. - -### Regelmodus - -Die Ladeleistung kann nicht mit absoluter Genauigkeit eingestellt werden, sodass am EVU-Punkt nicht auf exakt 0W geregelt werden kann. Einige Fahrzeuge und ältere openWBs können zudem nur in Schritten von 1A regeln (entspricht 230W bei einphasiger Ladung). Der Regelmodus bestimmt, in welchem Bereich (ca. 200-300W) sich der EVU-Überschuss bewegen soll. Beim Regelmodus „Bezug“ darf ein geringer Netzbezug vorhanden sein, bevor nachgeregelt wird. Das Auto lädt dann etwas schneller, aber es wird mehr Netzstrom verbraucht. Im Regelmodus „Einspeisung“ kann etwas Strom ins Netz eingespeist werden, bevor nachgeregelt wird. Dann lädt das Auto etwas langsamer und es wird weniger Netzstrom verbraucht. -Der Regelbereich wird auf den gesamten Überschuss angewendet, bevor die PV-Regelung durchgeführt wird. D.h. der Regelbereich wird auf alle Einstellungen für das PV-Laden angewendet und nur einmal unabhängig von der Anzahl der angesteckten Fahrzeuge. Liegt der Überschuss am EVU-Punkt im vorgegebenen Regelbereich, wird nicht nachgeregelt. Liegt er außerhalb des Bereichs, wird die Lade-Leistung auf die Mitte des Bereichs angepasst. -Bei Speichervorrang erzeugt die Regelung bei Bedarf unabhängig vom eingestellten Regelmodus Einspeisung, damit der Speicher seine Ladeleistung erhöht. - -Achtung: bei unlogischen Einstellungen kann die Regelung gestört werden! Im Zweifel bitte unsere vordefinierten Modi verwenden. - -#### Speicherbeachtung - -Sofern ein Hausstromspeicher (im Folgenden „Speicher“ genannt) im Energiesystem verbaut ist, kann dieser beim Fahrzeugladen mit berücksichtigt werden. Dies erfolgt passiv über die Berücksichtigung der Speicherleistungswerte und des Speicher-SoC. Eine aktive Speichersteuerung durch openWB ist aktuell mangels Speicherschnittstelle nicht möglich. -Bei Auswahl „Fahrzeuge“ wird der gesamte Überschuss in das EV geladen. Ist die maximale Ladeleistung der Fahrzeuge erreicht und es wird eingespeist, wird dieser Überschuss in den Speicher geladen. -Bei Auswahl „Speicher“ wird der gesamte Überschuss in den Speicher geladen. Ist die maximale Ladeleistung des Speichers erreicht und es wird eingespeist, wird dieser Überschuss unter Beachtung der Einschaltschwelle in die Fahrzeuge geladen. -Bei Auswahl „Mindest-SoC des Speichers“ wird der Überschuss bis zum Mindest-SoC in den Speicher geladen. Ist die maximale Ladeleistung des Speichers erreicht und es wird eingespeist, wird dieser Überschuss in die Fahrzeuge geladen. Wird der Mindest-SoC überschritten, wird der Überschuss ins Fahrzeug geladen. diff --git a/docs/Ladeprofile.md b/docs/Ladeprofile.md deleted file mode 100644 index 99ce834534..0000000000 --- a/docs/Ladeprofile.md +++ /dev/null @@ -1,15 +0,0 @@ -_Einstellungen -> Konfiguration -> Fahrzeuge -> Lade-Profile_ - -Unter den Lade-Profilen werden die Einstellungen für das Ladeprofil verwaltet. Die Einstellungen auf der Hauptseite werden aus diesem Profil geladen und dorthin geschrieben. Ist nur ein Fahrzeug vorhanden, so wird in den meisten Fällen nur das Standard-Ladeprofil benötigt. Ausgenommen hiervon ist, wenn per RFID-Tag Ladevorgaben ausgewählt werden. - -In den fahrzeugspezifischen Einstellungen wird ein Ladeprofil einem Fahrzeug zugeordnet. Werden zwei Fahrzeuge geladen, empfiehlt es sich dazu ein zweites Ladeprofil anzulegen. - -### Temporäre Ladeprofile (ab Version 2.1.8) - -Anpassungen am Ladeprofil, die über die Hauptseite (Web-Themes) oder ein Display (Display-Themes) vorgenommen werden, sind temporär. Die Lade-Profile müssen direkt in den Einstellungen bearbeitet werden. - -Die temporären Einstellungen werden mit dem Ladeprofil aus den Einstellungen überschrieben, wenn ... - -* abgesteckt wird. -* das Fahrzeug gewechselt wird. Das Lade-Profil des neuen Fahrzeugs wird geladen. -* das Ladeprofil in den Einstellungen geändert wird. diff --git a/docs/Ladepunkte.md b/docs/Ladepunkte.md deleted file mode 100644 index 0e6e8a695a..0000000000 --- a/docs/Ladepunkte.md +++ /dev/null @@ -1,10 +0,0 @@ -_Einstellungen -> Konfiguration -> Ladepunkte_ - -Die Einstellungen für Ladepunkte unterteilen sich in die spezifischen Einstellungen je Ladepunkt und Ladepunkt-Profile. - -Beim Hinzufügen eines Ladepunkts muss zunächst dessen Typ ausgewählt werden. Danach wird Ladepunkt-spezifisches, wie z.B. die Anzahl angeschlossener Phasen oder eine verbaute Phasenumschaltung, konfiguriert. - -In dem Ladepunkt-Profil sind die Einstellungen zum Sperren nach Uhrzeit und für die Freigabe von Ladepunkten durch ID-Tags enthalten. Ein Ladepunkt-Profil kann vom Benutzer mehreren Ladepunkte zugewiesen werden, sodass die Einstellungen für jeden Ladepunkte einzeln oder für eine Gruppe zugewiesen werden können. - -Das Erfassen eines RFID-Tags (verbauter RFID-Leser erforderlich) oder die Pin-Eingabe (Display erforderlich, Eingabefeld muss im Steuerungsmodus 'secondary' aktiviert werden) sowie die automatische -Fahrzeugerkennung der openWB Pro (muss in den Einstellungen aktiviert werden) werden gleich verarbeitet. diff --git "a/docs/Lastmanagement und kaskadierte Z\303\244hler.md" "b/docs/Lastmanagement und kaskadierte Z\303\244hler.md" deleted file mode 100644 index 21eb690aeb..0000000000 --- "a/docs/Lastmanagement und kaskadierte Z\303\244hler.md" +++ /dev/null @@ -1,22 +0,0 @@ -Das Lastmanagement steuert die Freigabe des Ladestroms, wenn nicht alle Ladepunkte mit voller Leistung laden könnnen. Begrenzende Faktoren könnnen der Hausanschluss, Sicherungen oder Zuleitungen sein. - -Die Priorisierung der Ladepunkte beschreibt der Hilfetext unter _Einstellungen -> Konfiguration -> Fahrzeuge -> Lade-Profile -> \*beliebiges Profil\* -> Aktiver Lademodus_. -Das Lastmanagement funktioniert dreistufig (ab Version 1.99.101.1): - -1. Zuteilung des Fahrzeug-Mindeststroms unter Berücksichtigung des Lastmanagements: Der Ladepunkt mit der höchsten Priorisierung erhält zuerst eine Stromzuteilung. -2. Zuteilung des Lademodus-Sollstroms unter Berücksichtigung des Lastmanagements: Der verfügbare Strom wird unter allen Ladepunkten mit der gleichen Priorisierung aufgeteilt. -3. Zuteilung des Überschusses (falls vorhanden und Lademodus PV oder Zielladen) unter Berücksichtigung des Lastmanagements: Der verfügbare Strom wird unter allen Ladepunkten mit der gleichen Priorisierung aufgeteilt. - -### Lastmanagement mit kaskadierten Zählern - -![Kaskadierte Zähler](kaskadierte_zaehler.png) - -_Einstellungen -> Konfiguration -> Geräte und Komponenten_ -Unter _Geräte und Komponenten_ müssen zunächst alle Zähler in der Anlage konfiguriert werden (bitte den Hilfetext in der Benutzeroberfläche zum Anlegen von Geräten und Komponenten beachten). Wenn an einer Zuleitung nur Ladepunkte oder Verbraucher mit einer festen Leistung angeschlossen sind und kein physischer Zähler verbaut ist, kann auch ein virtueller Zähler angelegt werden (Loadsharing). Ob ein Zähler als EVU-Zähler oder Zwischenzähler arbeitet, ergibt sich durch die Anordnung in der Struktur. - -_Einstellungen -> Konfiguration -> Lastmanagement -> Struktur_ -Bei der Konfiguration in der Abbildung sorgt das Lastmanagement dafür, dass Ladepunkt 2 und 3 gemeinsam nicht die maximale Stromstärke des Zwischenzählers "Virtueller Zähler" überschreiten. Außerdem berechnet das Lastmanagement die Ladeströme so, dass der virtuelle Zähler, Ladepunkt 1 und die am EVU-Zähler gemessene Stromstärke und Leistung die vorgegebene maximale Leistung und Stromstärke des EVU-Zählers einhalten. - -### Virtuelle Zähler - -Ein virtueller Zähler addiert alle Komponenten, die in der Hierarchie unterhalb dessen angeordnet sind, und die Leistung, die in den Einstellungen unter _zusätzlicher Verbrauch_ angegeben ist. Wenn sich mehrere Ladepunkte eine Zuleitung teilen (Loadsharing), muss ein virtueller Zähler konfiguriert werden und in der Hierarchie über den beiden Ladepunkten angeordnet werden. In der Abbildung sind das Ladepunkt 2 und 3. diff --git a/docs/MQTT.md b/docs/MQTT.md deleted file mode 100644 index a905d54195..0000000000 --- a/docs/MQTT.md +++ /dev/null @@ -1,69 +0,0 @@ -## Grundsätzliches - -MQTT bedeutet: Message Queuing Telemetry Transport. Es handelt sich hierbei um ein M2M (Machine to Machine) Protokoll. -Für eine Kommunikation wird ein Broker (=Verwalter) benötigt, welcher die Nachrichten von den Sendern empfängt und an die Empfänger, welche sich für den Inhalt angemeldet haben, weiterleitet. Man spricht bei MQTT von publish und subscribe. Die Nachrichten werden in topics verschickt. - -openWB hat einen eigenen MQTT-Broker integriert, über den die Kommunikation läuft. Möchte man die Wallbox steuern oder Status-Nachrichten empfangen, sollte man sich als Client an diesem Broker anmelden. Der Broker läuft auf der IP der openWB unter Port 1883 ohne Nutzerauthentifizierung. - -## Zähler - -Als EVU-Zähler können auch Werte über MQTT empfangen werden. Die Integration ist im Abschnitt [Zähler](https://github.com/openWB/core/wiki/Zähler) beschrieben. - -## SmartHome - -## Steuerbefehle - -Auf eigene Gefahr! Die folgenden Einstellungen und Kommunikationsmöglichkeiten sind nicht spezifiziert und nur von kundigen Nutzern mit entpsrechendem Fachwissen über die Konsequenzen durchzuführen. - -Bei den Steuerbefehlen ist # immer durch den entsprechenden Ladepunkt/Zähler/Fahrzeug zu ersetzen. Dies ist zwingend zu beachten, da ansonsten neue Fahrzeuge/Zähler etc. erstellt werden, wenn es nicht die ID eines Konfigurierten Gerätes ist. - -Lademodus auf "Sofortladen" -`openWB/set/vehicle/template/charge_template/#/chargemode/selected -> instant_charging` - -PV-Laden -`openWB/set/vehicle/template/charge_template/#/chargemode/selected -> pv_charging` - -"Minimal Stromstärke" im PV-Laden auf z.B. 6A -`openWB/set/vehicle/template/charge_template/#/chargemode/pv_charging/min_current -> 6` - -SoC-Limit auf z.B. 80% setzen -`openWB/set/vehicle/template/charge_template/#/chargemode/pv_charging/max_soc -> 80` - -Zielladen -`openWB/set/vehicle/template/charge_template/#/chargemode/selected -> scheduled_charging` - -Eco -`openWB/set/vehicle/template/charge_template/#/chargemode/selected -> eco_charging` - -Stop -`openWB/set/vehicle/template/charge_template/#/chargemode/selected -> stop` - -_Work in Progress_ - -## Statusnachrichten - -Wo wird welcher nützliche Inhalt gesendet. - -Ladeprofil Status (verschachteltes JSON, muss entsprechend weiter decodiert werden...): -openWB/vehicle/template/charge_template/1 - -Setzen von min_Current für min+PV nachbauen: -`openWB/set/vehicle/template/charge_template/#/chargemode/pv_charging/min_current` - -Setzen des Lademodus: (Werte die zu senden sind: instant_charging, pv_charging, scheduled_charging, eco_charging, stop) -`openWB/set/vehicle/template/charge_template/#/chargemode/selected` - -Ladepunkt sperren für Priosteuerung der LP: -`openWB/set/chargepoint/#/set/manual_lock` - -SoC Update triggern: -`openWB/set/vehicle/1#/get/force_soc_update` - -SoC im manuellen Modus setzen: -`openWB/set/vehicle/#/soc_module/calculated_soc_state/manual_soc` - -### Lademodus - -Lademodus des angesteckten Auto wird in den LP geschrieben. Solange immer dasselbe Auto dran steckt ist das gleich, aber wenn Du ein anderes Auto ansteckst, bei mir z.b. ein Gastauto und Du nur den Lademodus deines normalen Auto ausliest und damit steuerst, ist der dortige Lademodus halt dann nicht der eigentliche des LP - -_Work in Progress_ diff --git a/docs/Manueller SoC.md b/docs/Manueller SoC.md deleted file mode 100644 index a3cb0aba80..0000000000 --- a/docs/Manueller SoC.md +++ /dev/null @@ -1,17 +0,0 @@ -# SoC-Modul des Fahrzeugs „Manueller SoC“ - -Stehen keine anderen SoC-Module für Dein Fahrzeug zur Verfügung, so kann das Modul „Manueller SoC“ genutzt werden. - -Der Anfangs-SoC des Fahrzeugs muss hierbei manuell angegeben werden, z.B. über ein integriertes Display oder über das Webinterface. Während der Ladung wird anhand der Angaben aus dem Fahrzeugprofil zur Akkukapazität und des Wirkungsgrades der Ladeelektronik der aktuelle SoC berechnet. - -Zunächst müssen also diese Angaben im Fahrzeugprofil (Angaben zur Batterie) erfasst werden: - -![Fahrzeugprofil: Angaben zu Batterie]() - -Dann wird im Fahrzeug das SoC Modul „Manueller SoC“ ausgewählt: - -![Einstellungen Manueller SoC]() - -Nun kann der Anfangs-SoC auf der Hauptseite angegeben werden: - -![Eingabe manueller SoC]() diff --git a/docs/NextCloud als Sicherungs-Cloud einrichten.md b/docs/NextCloud als Sicherungs-Cloud einrichten.md deleted file mode 100644 index d5fed7c2fd..0000000000 --- a/docs/NextCloud als Sicherungs-Cloud einrichten.md +++ /dev/null @@ -1,23 +0,0 @@ -Zunächst einen neuen Ordner erstellen/auswählen, in den die Sicherungen hochgeladen werden sollen. - -1. Freigabe erstellen -2. Hochladen erlauben (oder file drop only) -3. Link kopieren - -![NextCloud Ordner freigeben](NextCloud.png) - -Diesen Link in das Feld Cloud-URL in der openWB unter System -> Datenverwaltung -> Automatische Sicherung in einen Cloud-Dienst eintragen und Benutzername sowie Passwort freilassen (speichern drücken nicht vergessen)! - -Alternativ: -Falls es Probleme gibt kann der Link auch folgendermaßen eingetragen werden: -Freigabelink z.B.: - -Wahl: BackupCloud: NextCloud -Unterpunkt: Einstellungen für Backup-Cloud Modul "NextCloud" -Cloud-URL: z.B.: OHNE /s/ oder / -Benutzername: dein shared token, also z.B.: tUbHHrEdGltSRgx -Passwort: kann leer gelassen oder irgendetwas eingetragen werden, spielt keine Rolle - -Beide Varianten wurden getestet und funktionieren. - -Stand 10. April 2024 diff --git a/docs/NextCloud.png b/docs/NextCloud.png deleted file mode 100644 index 74c4e178c6..0000000000 Binary files a/docs/NextCloud.png and /dev/null differ diff --git a/docs/OCPP.md b/docs/OCPP.md deleted file mode 100644 index 0fe64dfd64..0000000000 --- a/docs/OCPP.md +++ /dev/null @@ -1,4 +0,0 @@ -OCPP ist ein standardisiertes Ladeprotokoll, um die Daten eines Ladevorgangs an einen Abrechnungsdienstleiter zu senden. - -Die Ladepunkte übermitteln den ID-Tag, Heartbeat und den Zählerstand zum Zeitpunkt des Ansteckens, Absteckens und alle 5 Minuten. Eine Steuerung per OCPP ist nicht möglich. Alle Ladepunkte, die ihre Daten an das OCPP-Backend übermitteln sollen, müssen zunächst im OCPP-Backend angelegt werden. Die dort eingetragene Chargebox ID muss in der openWB in den Einstellungen des Ladepunkts eingetragen werden. -An das OCPP-Backend können auch ID-Tags und Fahrzeug-MACs übermittelt werden. Dazu müssen diese allerdings in der openWB hinterlegt sein. \ No newline at end of file diff --git a/docs/PV-Speicher an EVU-Kit.png b/docs/PV-Speicher an EVU-Kit.png deleted file mode 100644 index 3a0e12891a..0000000000 Binary files a/docs/PV-Speicher an EVU-Kit.png and /dev/null differ diff --git a/docs/RSE-Beispielkonfiguration.png b/docs/RSE-Beispielkonfiguration.png deleted file mode 100644 index 5d1e14a646..0000000000 Binary files a/docs/RSE-Beispielkonfiguration.png and /dev/null differ diff --git a/docs/Samba als Sicherung einrichten.md b/docs/Samba als Sicherung einrichten.md deleted file mode 100644 index 810e4618da..0000000000 --- a/docs/Samba als Sicherung einrichten.md +++ /dev/null @@ -1,88 +0,0 @@ -Zunächst einen neuen Ordner erstellen/auswählen, in den die Sicherungen hochgeladen werden sollen. - -Nachfolgende Schritte müssen auf dem Bereitstellenden system gemacht werden - -1. SMB Freigabe erstellen (Auf NAS etc.) -2. User einrichten und berechtigen - R/W - -Nachfolgende Schritte müssen in openWB gemacht werden. - -1. IP Adresse oder Name (Am besten FQDN) im Feld Server hinterlegen - * IP: z.B 192.168.178.1 - * Name z.B. mein-server - * FQDN z.B mein-server.fritz.box -2. Share angeben in dem das Backup gespeichert werden soll -3. Optional können ein bis n Unterordner angegeben werden. Diese müssen immer mit / getrennt werden und auch am Ende muss ein / stehen - * Beispiel: test/ oder aber test1/test2/test/ -4. Benutzer und Passwort in die jeweilegen Felder eintragen - -![Samba nutzen](Samba.png) - -Ergänzungen: -Bei manchen Systemen kann es notwendig sein das Mindest-SMB-Protokoll auf SMB2 zu setzen. - -Anleitung für Samba Server auf einem Raspberry Pi (z.B.: Stand alone) - -1. Installieren von Samba -sudo apt-get update -sudo apt-get install samba samba-common smbclient -2. Prüfen ob Samba läuft -sudo service smbd status -sudo service nmbd status -3. Samba User anlegen -sudo useradd testsmb -Optional: -4. Falls users nicht vorhanden: sudo groupadd users -check mit getent group -5. Hinzufügen des Samba Users zur Gruppe users -sudo usermod -aG users testsmb -6. Ordner anlegen in /home -sudo mkdir smb -sudo mkdir smb/testsmb -sudo mkdir smb/testsmb/test -7. Besitzer ändern -sudo chown testsmb /home/smb/testsmb -sudo chown testsmb /home/smb/testsmb/test -8. Konfigurationsdatei von Samba sichern -sudo cp /etc/samba/smb.conf /etc/samba/smb.conf_backup -Konfigurationsdatei smb.conf anpassen -sudo nano /etc/samba/smb.conf -[global] - workgroup = WORKGROUP - security = user - encrypt passwords = yes - client min protocol = SMB2 - client max protocol = SMB3 - bis zum Ende der Datei scrollen und folgende Eintragungen vornehmen: -[testsmb] - comment = Samba-Test-Share - valid users = testsmb - path = /home/smb/testsmb - read only = no -9. Testen ob die smb.conf noch funktioniert -testparm -10. Benutzer aktivieren -sudo smbpasswd -a testsmb -New SMB password: testSMB -Retype new SMB password: testSMB -Optional -11. Sichergehen, dass Benutzer aktiviert ist -sudo smbpasswd -e testsmb -12. IP-Adresse des Raspberry Pis notieren -ip address -> z.B.: 192.168.43.81 -13. Neustart von Samba nach Änderung der Konfiguration -sudo service smbd restart -sudo service nmbd restart - -Der Samba Dienst ist nun eingerichtet und konfiguriert. Alternativ können auch andere Benutzergruppen mit anderen Berechtigungen konfiguriert werden. - -In openWB unter System -> Datenverwaltung -> Sicherung / Wiederherstellung unter Automatische Sicherung in einen Cloud-Dienst als Backup-Cloud Samba auswählen und folgende Einstellungen für Backup-Cloud Modul "Samba" eintragen: -Server: IP_Adresse des Raspberry Pis z.B.: 192.168.43.81 -Freigabe: testsmb -Unterordner: test/ -Benutzer: testsmb -Kennwort: testSMB - -Speichern drücken und testen durch klicken auf Sicherung erstellen und hochladen - -Stand 08. April 2024 diff --git a/docs/Samba.png b/docs/Samba.png deleted file mode 100644 index 4ea5bc93b8..0000000000 Binary files a/docs/Samba.png and /dev/null differ diff --git a/docs/SoC-BMW-19-settings-1.PNG b/docs/SoC-BMW-19-settings-1.PNG deleted file mode 100755 index 570b17f1d4..0000000000 Binary files a/docs/SoC-BMW-19-settings-1.PNG and /dev/null differ diff --git a/docs/SoC-BMW-19-settings-2.PNG b/docs/SoC-BMW-19-settings-2.PNG deleted file mode 100755 index 544329616e..0000000000 Binary files a/docs/SoC-BMW-19-settings-2.PNG and /dev/null differ diff --git a/docs/SoC-BMW-19-settings-3.PNG b/docs/SoC-BMW-19-settings-3.PNG deleted file mode 100755 index 2c89899efe..0000000000 Binary files a/docs/SoC-BMW-19-settings-3.PNG and /dev/null differ diff --git a/docs/SoC-BMW-19-settings-4.PNG b/docs/SoC-BMW-19-settings-4.PNG deleted file mode 100755 index 25bdca3c50..0000000000 Binary files a/docs/SoC-BMW-19-settings-4.PNG and /dev/null differ diff --git a/docs/SoC-BMW-20-settings-1.PNG b/docs/SoC-BMW-20-settings-1.PNG deleted file mode 100755 index 9cf8d9c3c2..0000000000 Binary files a/docs/SoC-BMW-20-settings-1.PNG and /dev/null differ diff --git a/docs/SoC-BMW-20-settings-2.PNG b/docs/SoC-BMW-20-settings-2.PNG deleted file mode 100755 index a7c373bc50..0000000000 Binary files a/docs/SoC-BMW-20-settings-2.PNG and /dev/null differ diff --git a/docs/SoC-BMW-20-settings-3.PNG b/docs/SoC-BMW-20-settings-3.PNG deleted file mode 100755 index e089d91292..0000000000 Binary files a/docs/SoC-BMW-20-settings-3.PNG and /dev/null differ diff --git a/docs/SoC-BMW-Mini-Settings.png b/docs/SoC-BMW-Mini-Settings.png deleted file mode 100644 index 2257a25e78..0000000000 Binary files a/docs/SoC-BMW-Mini-Settings.png and /dev/null differ diff --git a/docs/SoC-BMW-Mini.md b/docs/SoC-BMW-Mini.md deleted file mode 100644 index 00f96b7c0f..0000000000 --- a/docs/SoC-BMW-Mini.md +++ /dev/null @@ -1,80 +0,0 @@ -# SoC-Modul BMW & Mini - -Das Modul gibt es in openWB 1.x und 2.x; es funktioniert in beiden Systemen ähnlich. - -## Konfiguration in openWB 1.x -Die Konfiguration des SoC-Moduls erfolgt in Einstellungen - Modulkonfiguration - Ladepunkte: -![BMW-Settings 1.9-1](SoC-BMW-19-settings-1.PNG) -![BMW-Settings 1.9-2](SoC-BMW-19-settings-2.PNG) -![BMW-Settings 1.9-3](SoC-BMW-19-settings-3.PNG) -![BMW-Settings 1.9-4](SoC-BMW-19-settings-4.PNG) - -## Konfiguration in openWB 2.x -Die Konfiguration des SoC-Moduls erfolgt in Einstellungen - Konfiguration - Fahrzeuge: -![BMW-Settings 2.x-1](SoC-BMW-20-settings-1.PNG) -![BMW-Settings 2.x-2](SoC-BMW-20-settings-2.PNG) -![BMW-Settings 2.x-3](SoC-BMW-20-settings-3.PNG) - -Die Hilfe zu den Feldern kann in openWB 2.x durch Click auf das (?) angezeigt werden. - -In der Konfiguration des SoC-Moduls BMW & Mini ist Folgendes einzugeben: - -- SoC-Modul: BMW & Mini -- Intervalle zur Aktualisierung der Fahrzeugdaten -- Auswahl: Nur Aktualisieren wenn angesteckt -- Benutzername des Connected-Drive Accounts -- Kennwort des Benutzers -- VIN des Fahrzeuges -- Captcha-Token -- Auswahl: SoC-Berechnung während des Ladens - -Das Captcha-Token muss durch Lösen eines Captcha ermittelt werden. - -Nach Eingabe des Captcha-Token und Sichern der Einstellung muss der SoC für das Fahrzeug sofort abgerufen werden. Dies geschieht mittels des Kreispfeils neben der SoC-Anzeige auf der Hauptseite. - -Falls das nicht auf Anhieb klappt, muss es wiederholt werden. - -### openWB 2.x: Mehrere Fahrzeuge in einem Account -Wenn mehrere Fahrzeuge in einem Connected-Drive-Account vorhanden sind, ist dies in openWB 2.x wie folgt zu konfigurieren: - -Das erste Fahrzeug - mit der niedrigsten ID - wird wie wie oben beschrieben konfiguriert. - -Ab dem 2. Fahrzeug wird als Captcha-Token der Wert SECONDARY (genau so in Grossbuchstaben) eingegeben. - -## Hinweise -Nach Neustart bzw. Änderung der LP-Konfiguration werden im EV-Soc-Log Fehler ausgegeben (permission oder fehlende Datei). - - Diese Fehler sind normal und können ignoriert werden. Leider wird im Debug Mode 0 keine Positiv-Meldung ausgegeben. - Empfehlung: - - In Einstellungen - System - Fehlersuche bzw. Debugging dies einstellen: Debug Mode 1/Regelwerte bzw. Info - - dann einen manuellen SOC-Abruf durchführen (im Dashboard auf Kreispfeil klicken). - - danach sollte im EV-SOC-Log eine Zeile ähnlich dieser kommen: - - `2023-02-12 11:57:14 INFO:soc_bmwbc:Lp1 SOC: 61%@2023-02-12T11:53:20` - - Diese Zeile zeigt folgende Information: - - `2023-02-12 11:57:14 - Timestamp des SOC-Abrufs` - - `INFO - Debug Level INFO` - - `soc_bmwbc - SOC-Modul` - - `Lp1 - Ladepunkt` - - `SOC: 61% - SOC Stand` - - `@2023-02-12T11:53:20 - Timestamp des Updates vom EV zum VW Cloud-Server` - -Falls diese Schritte nicht zum Erfolg führen, das Problem im [Support-Seite im openWB Forum](https://forum.openwb.de/viewtopic.php?t=4870) posten mit Angabe relevanter Daten - - oWB SW Version - - oWB gekauft oder selbst installiert - - wenn selbst installiert: welches OS(Stretch/Buster) - - welches Fahrzeug - - falls vorhanden Angaben über Firewall, VPN, etc., also Appliances, die den Internetzugang limitieren könnten - - relevante Abschnitte der Logs, vor allem Fehlermeldungen, als CODE-blocks (). - -Das SoC-Log mit evtl. Fehlermeldungen kann wie folgt eingesehen werden: - - openWB 1.x (Status - EV SoC Log) - - openWB 2.x (Einstellungen - System - Fehlersuche) - diff --git a/docs/SoC-Cupra-settings-1.png b/docs/SoC-Cupra-settings-1.png deleted file mode 100644 index 5064108227..0000000000 Binary files a/docs/SoC-Cupra-settings-1.png and /dev/null differ diff --git a/docs/SoC-Cupra-settings-2.png b/docs/SoC-Cupra-settings-2.png deleted file mode 100644 index 219e090f75..0000000000 Binary files a/docs/SoC-Cupra-settings-2.png and /dev/null differ diff --git a/docs/SoC-Cupra.md b/docs/SoC-Cupra.md deleted file mode 100644 index fbea412a55..0000000000 --- a/docs/SoC-Cupra.md +++ /dev/null @@ -1,82 +0,0 @@ -# SoC-Modul Cupra - -Das SoC-Modul Cupra gibt es in openWB 2.x. - -## Konfiguration - -Die Konfiguration erfolgt im Bereich Einstellungen - Konfiguration - Fahrzeuge: - -![Allgemeine Konfiguration](SoC-Cupra-settings-1.png) - -![Spezielle Konfiguration](SoC-Cupra-settings-2.png) - -## Hinweise - -Für nicht-Cupra Fahrzeuge (Audi, Skoda, VW, etc.) funktioniert das Modul nicht. - -Erfolgreich getestet u.a. für folgende Fahrzeuge: Cupra Born. - -**Wichtig für alle Fahrzeuge:** -Es muss ein aktives Konto im Seat ID Portal vorhanden sein und die "My SEAT App" muss eingerichtet sein. Es muss explizit die "My SEAT App" eingerichtet werden und nicht die "My CUPRA App". - -**WICHTIG:** -Seat/Cupra ändert gelegentlich die Bedingungen für die Nutzung der Online-Services. - -Diese müssen bestätigt werden. Wenn der SOC-Abruf plötzlich nicht mehr funktioniert, VOR dem Posten bitte Schritt 1 ausführen. - -Bei Problemen zunächst bitte diese Schritte durchführen: - -1. sicherstellen, dass auf dieser Seat-Seite alle Einverständnisse gegeben wurden. - - - - In einigen Fällen wurden die Einverständnisse gegeben und trotzdem funktionierte die Abfrage nicht. - Hier hat folgendes Vorgehen geholfen: Im Seat Konto das Land temporär umstellen, d.h. - - auf ein anderes Land als das eigene ändern - - sichern - - zurück auf das eigene Land ändern - - sichern. - -2. Nach einem manuellen SOC-Abruf (Kreispfeil hinter dem SOC klicken) auf der Status - Seite EV-SOC Log und Debug log auf Fehler kontrollieren - -3. Falls im Ev-Soc Log Fehler 303 (unknown redirect) gemeldet wird: - - Ursache 1: Bestimmte Sonderzeichen im Passwort funktionieren nicht mit dem Modul. Bitte das Passwort auf eines ohne Sonderzeichen ändern und testen. - - Ursache 2: Falsche Email, Passwort oder VIN eingegeben. Alle 3 löschen, speichern, neu eingeben, speichern und testen. - -4. Falls eine Firewall im Spiel ist: Es gab einzelne Probleme beim Internet-Zugriff der openWB auf Python Archive und Fahrzeug-Server wenn IPV6 aktiv ist. - -5. Nach Neustart bzw. Änderung der LP-Konfiguration werden im EV-Soc-Log Fehler ausgegeben (permission oder fehlende Datei). - - Diese Fehler sind normal und können ignoriert werden. Leider wird im Debug Mode 0 keine Positiv-Meldung ausgegeben. - Empfehlung: - - In Einstellungen - System - Fehlersuche dies einstellen: Debug Level/Details - - dann einen manuellen SOC-Abruf durchführen (im Dashboard auf Kreispfeil klicken). - - danach sollte im EV-SOC-Log eine Zeile ähnlich dieser kommen: - - `2023-02-12 11:57:14 INFO:soc_skoda:Lp1 SOC: 61%@2023-02-12T11:53:20` - - Diese Zeile zeigt folgende Information: - - `2023-02-12 11:57:14` *- Timestamp des SOC-Abrufs* - - `INFO` *- Debug Level INFO* - - `soc_skoda` *- SOC-Modul* - - `Lp1` *- Ladepunkt* - - `SOC: 61%` *- SOC Stand* - - `@2025-02-12T11:53:20` *- Timestamp des Updates vom EV zum Seat Cloud-Server* - -6. Falls diese Schritte nicht zum Erfolg führen, das Problem im [Support Thema](https://forum.openwb.de/viewforum.php?f=12) mit Angabe relevanter Daten posten - - oWB SW Version - - oWB gekauft oder selbst installiert - - wenn selbst installiert: welches OS(Stretch/Buster) - - welches Fahrzeug - - falls vorhanden Angaben über Firewall, VPN, etc., also Appliances, die den Internetzugang limitieren könnten - - relevante Abschnitte der Logs, vor allem Fehlermeldungen, als CODE-blocks (). - -Das SoC-Log mit evtl. Fehlermeldungen kann wie folgt eingesehen werden: - -- Einstellungen - System - Fehlersuche diff --git a/docs/SoC-OVMS-19-settings-1.PNG b/docs/SoC-OVMS-19-settings-1.PNG deleted file mode 100755 index 7f453c26c5..0000000000 Binary files a/docs/SoC-OVMS-19-settings-1.PNG and /dev/null differ diff --git a/docs/SoC-OVMS-19-settings-2.PNG b/docs/SoC-OVMS-19-settings-2.PNG deleted file mode 100755 index b4801a594b..0000000000 Binary files a/docs/SoC-OVMS-19-settings-2.PNG and /dev/null differ diff --git a/docs/SoC-OVMS-Settings.png b/docs/SoC-OVMS-Settings.png deleted file mode 100644 index e99dd003c2..0000000000 Binary files a/docs/SoC-OVMS-Settings.png and /dev/null differ diff --git a/docs/SoC-OVMS.md b/docs/SoC-OVMS.md deleted file mode 100644 index ba0cb6ac95..0000000000 --- a/docs/SoC-OVMS.md +++ /dev/null @@ -1,76 +0,0 @@ -# SoC-Modul OVMS - -Das OVMS-Modul im Fahrzeug sendet je nach Ausführung die Daten über Mobilnetz und/oder WLAN an den OVMS-Server (z.B. ovms.dexters-web.de). - -Die OVMS Smartphone-Apps (Android/ios) verbinden sich mit dem gewählten OVMS-Server. - -Das SoC-Modul holt die Daten auch vom OVMS Server. - - -Das OVMS SoC-Modul ist in openWB 1.x und 2.x vefügbar. - -Das SoC-Modul OVMS wird wie folgt im Fahrzeug konfiguriert: - -## Konfiguration in openWB 1.x - -Die Konfiguration des SoC-Moduls erfolgt in Einstellungen - Modulkonfiguration - Ladepunkte: - -![1](SoC-OVMS-19-settings-1.PNG) -![2](SoC-OVMS-19-settings-2.PNG) - -## Konfiguration in openWB 2.x - -Die Konfiguration des SoC-Moduls erfolgt in Einstellungen - Konfiguration - Fahrzeuge: - -![SoC-OVMS-Einstellungen](SoC-OVMS-Settings.png) - -Die Hilfe zu jedem Feld kann in 2.x durch Click auf das (?) angezeigt werden! - -Nach den allgemeinen Einstellungen ist in den speziellen Einstellungen des SoC-Moduls OVMS Folgendes einzutragen: - -- Server URL(incl. Port, z.B. `https://ovms.dexters-web.de:6869`) -- User Id des Accounts im OVMS-Server -- Passwort des Accounts -- VehicleId des Fahrzeuges (wird bei der Einrichtung des OVMS-Moduls vergeben) -- Abfrage-Intervall wenn nicht geladen wird -- Abfrage-Intervall wenn geladen wird. - -## Hinweise - -Nach Neustart bzw. Änderung der LP-Konfiguration werden im EV-Soc-Log Fehler ausgegeben (permission oder fehlende Datei). - -Diese Fehler sind normal und können ignoriert werden. Leider wird im Debug Mode 0 keine Positiv-Meldung ausgegeben. - -Empfehlung: - -- In Einstellungen - System - Fehlersuche bzw. Debugging dies einstellen: Debug Mode 1/Regelwerte bzw. Info -- dann einen manuellen SOC-Abruf durchführen (im Dashboard auf Kreispfeil klicken). -- danach sollte im EV-SOC-Log eine Zeile ähnlich dieser kommen: - - `2023-02-12 11:57:14 INFO:soc_ovms:Lp1 SOC: 61%@2023-02-12T11:53:20` - -Diese Zeile zeigt folgende Information: - -```text -2023-02-12 11:57:14 - Timestamp des SOC-Abrufs -INFO - Debug Level INFO -soc_ovms - SOC-Modul -Lp1 - Ladepunkt -SOC: 61% - SOC Stand -@2023-02-12T11:53:20 - Timestamp des Updates vom EV zum OVMS Cloud-Server -``` - -Falls diese Schritte nicht zum Erfolg führen, das Problem im [Support-Seite im openWB Forum](https://forum.openwb.de/viewtopic.php?t=9278) posten mit Angabe relevanter Daten - -- oWB SW Version -- oWB gekauft oder selbst installiert -- wenn selbst installiert: welches OS(Stretch/Buster) -- welches Fahrzeug -- falls vorhanden Angaben über Firewall, VPN, etc., also Appliances, die den Internetzugang limitieren könnten -- relevante Abschnitte der Logs, vor allem Fehlermeldungen, als CODE-blocks (). - -Das SoC-Log mit evtl. Fehlermeldungen kann wie folgt eingesehen werden: - -- openWB 1.x (Status - EV SoC Log) -- openWB 2.x (Einstellungen - System - Fehlersuche) - diff --git a/docs/SoC-Skoda-settings-1.PNG b/docs/SoC-Skoda-settings-1.PNG deleted file mode 100644 index 892f4d24e6..0000000000 Binary files a/docs/SoC-Skoda-settings-1.PNG and /dev/null differ diff --git a/docs/SoC-Skoda-settings-2.PNG b/docs/SoC-Skoda-settings-2.PNG deleted file mode 100644 index 6805cea332..0000000000 Binary files a/docs/SoC-Skoda-settings-2.PNG and /dev/null differ diff --git a/docs/SoC-Skoda.md b/docs/SoC-Skoda.md deleted file mode 100644 index c4a0f335d3..0000000000 --- a/docs/SoC-Skoda.md +++ /dev/null @@ -1,82 +0,0 @@ -# SoC-Modul Skoda - -Das SoC-Modul Skoda gibt es in openWB 2.x. - -## Konfiguration - -Die Konfiguration erfolgt im Bereich Einstellungen - Konfiguration - Fahrzeuge: - -![Allgemeine Konfiguration](SoC-Skoda-settings-1.PNG) - -![Spezielle Konfiguration](SoC-Skoda-settings-2.PNG) - -## Hinweise - -Für nicht-Skoda Fahrzeuge (Audi, VW, etc.) funktioniert das Modul nicht. - -Erfolgreich getestet u.a. für folgende Fahrzeuge: Enyaq, Elroq. - -**Wichtig für alle Fahrzeuge:** -Es muss ein aktives Konto im Skoda ID Portal vorhanden sein und die "MySkoda App" muss eingerichtet sein. - -**WICHTIG:** -Skoda ändert gelegentlich die Bedingungen für die Nutzung der Online-Services. - -Diese müssen bestätigt werden. Wenn der SOC-Abruf plötzlich nicht mehr funktioniert, VOR dem Posten bitte Schritt 1 ausführen. - -Bei Problemen zunächst bitte diese Schritte durchführen: - -1. sicherstellen, dass auf dieser Skoda-Seite alle Einverständnisse gegeben wurden. - - - - In einigen Fällen wurden die Einverständnisse gegeben und trotzdem funktionierte die Abfrage nicht. - Hier hat folgendes Vorgehen geholfen: Im Skoda Konto das Land temporär umstellen, d.h. - - auf ein anderes Land als das eigene ändern - - sichern - - zurück auf das eigene Land ändern - - sichern. - -2. Nach einem manuellen SOC-Abruf (Kreispfeil hinter dem SOC klicken) auf der Status - Seite EV-SOC Log und Debug log auf Fehler kontrollieren - -3. Falls im Ev-Soc Log Fehler 303 (unknown redirect) gemeldet wird: - - Ursache 1: Bestimmte Sonderzeichen im Passwort funktionieren nicht mit dem Modul. Bitte das Passwort auf eines ohne Sonderzeichen ändern und testen. - - Ursache 2: Falsche Email, Passwort oder VIN eingegeben. Alle 3 löschen, speichern, neu eingeben, speichern und testen. - -4. Falls eine Firewall im Spiel ist: Es gab einzelne Probleme beim Internet-Zugriff der openWB auf Python Archive und Fahrzeug-Server wenn IPV6 aktiv ist. - -5. Nach Neustart bzw. Änderung der LP-Konfiguration werden im EV-Soc-Log Fehler ausgegeben (permission oder fehlende Datei). - - Diese Fehler sind normal und können ignoriert werden. Leider wird im Debug Mode 0 keine Positiv-Meldung ausgegeben. - Empfehlung: - - In Einstellungen - System - Fehlersuche dies einstellen: Debug Level/Details - - dann einen manuellen SOC-Abruf durchführen (im Dashboard auf Kreispfeil klicken). - - danach sollte im EV-SOC-Log eine Zeile ähnlich dieser kommen: - - `2023-02-12 11:57:14 INFO:soc_skoda:Lp1 SOC: 61%@2023-02-12T11:53:20` - - Diese Zeile zeigt folgende Information: - - `2023-02-12 11:57:14` *- Timestamp des SOC-Abrufs* - - `INFO` *- Debug Level INFO* - - `soc_skoda` *- SOC-Modul* - - `Lp1` *- Ladepunkt* - - `SOC: 61%` *- SOC Stand* - - `@2025-02-12T11:53:20` *- Timestamp des Updates vom EV zum VW Cloud-Server* - -6. Falls diese Schritte nicht zum Erfolg führen, das Problem im [Support Thema](https://forum.openwb.de/viewforum.php?f=12) mit Angabe relevanter Daten posten - - oWB SW Version - - oWB gekauft oder selbst installiert - - wenn selbst installiert: welches OS(Stretch/Buster) - - welches Fahrzeug - - falls vorhanden Angaben über Firewall, VPN, etc., also Appliances, die den Internetzugang limitieren könnten - - relevante Abschnitte der Logs, vor allem Fehlermeldungen, als CODE-blocks (). - -Das SoC-Log mit evtl. Fehlermeldungen kann wie folgt eingesehen werden: - -- Einstellungen - System - Fehlersuche diff --git a/docs/SoC-VWId-19-settings-1.PNG b/docs/SoC-VWId-19-settings-1.PNG deleted file mode 100755 index 9ed159043c..0000000000 Binary files a/docs/SoC-VWId-19-settings-1.PNG and /dev/null differ diff --git a/docs/SoC-VWId-19-settings-2.PNG b/docs/SoC-VWId-19-settings-2.PNG deleted file mode 100755 index 1a6346958b..0000000000 Binary files a/docs/SoC-VWId-19-settings-2.PNG and /dev/null differ diff --git a/docs/SoC-VWId-20-settings-1.PNG b/docs/SoC-VWId-20-settings-1.PNG deleted file mode 100755 index 31a03d78de..0000000000 Binary files a/docs/SoC-VWId-20-settings-1.PNG and /dev/null differ diff --git a/docs/SoC-VWId-20-settings-2.PNG b/docs/SoC-VWId-20-settings-2.PNG deleted file mode 100755 index 610e160807..0000000000 Binary files a/docs/SoC-VWId-20-settings-2.PNG and /dev/null differ diff --git a/docs/SoC-VWId.md b/docs/SoC-VWId.md deleted file mode 100644 index 3f3d17a962..0000000000 --- a/docs/SoC-VWId.md +++ /dev/null @@ -1,97 +0,0 @@ -# SoC-Modul VWId - -Das SoC-Modul VWId gibt es in openWB 1.x und 2.x -Die Konfiguration ist in beiden Varianten sehr ähnlich: - -## Konfiguration in openWB 1.x - -Die Konfiguration in openWB 1.x erfolgt im Bereich Einstellungen - Modulkonfiguration - Ladepunkte: - -![Allgemeine Konfiguration-1x](SoC-VWId-19-settings-1.PNG) - -![Spezielle Konfiguration-1x](SoC-VWId-19-settings-2.PNG) - -## Konfiguration in openWB 2.x - -Die Konfiguration in openWB 2.x erfolgt im Bereich Einstellungen - Konfiguration - Fahrzeuge: - -![Allgemeine Konfiguration-2x](SoC-VWId-20-settings-1.PNG) - -![Spezielle Konfiguration-2x](SoC-VWId-20-settings-2.PNG) - -## Hinweise - -Erfolgreich getestet u.a. für folgende Fahrzeuge: ID3, ID4, ID5, ID7, eGolf, Golf 8 GTE, Passat GTE, eUP, T7 Multivan eHybrid. - -Für nicht-VW Fahrzeuge (Audi, Skoda, etc.) funktioniert das Modul nicht. - -**Wichtig für alle Fahrzeuge:** -Es muss ein aktives Konto in myVolkswagen vorhanden sein und die "Volkswagen App" muss eingerichtet sein. - -**WICHTIG:** -VW ändert gelegentlich die Bedingungen für die Nutzung der Online-Services. - -Diese müssen bestätigt werden. Wenn der SOC-Abruf plötzlich nicht mehr funktioniert, VOR dem Posten bitte Schritt 1 ausführen. - -Bei Problemen zunächst bitte diese Schritte durchführen: - -1. sicherstellen, dass auf diesen VW-Seiten alle Einverständnisse gegeben wurden. - - - - - - In einigen Fällen wurden die Einverständnisse gegeben und trotzdem funktionierte die Abfrage nicht. - Hier hat folgendes Vorgehen geholfen: Im Volkswagen Konto das Land temporär umstellen, d.h. - - auf ein anderes Land als das eigene ändern - - sichern - - zurück auf das eigene Land ändern - - sichern. - -2. Nach einem manuellen SOC-Abruf (Kreispfeil hinter dem SOC klicken) auf der Status - Seite EV-SOC Log und Debug log auf Fehler kontrollieren -3. Falls im Ev-SOC Log ein fehlendes Modul gemeldet wird, z.B. - - `ImportError: No module named 'lxml' (LV0)` - - in openWB 1.9 sicherstellen, dass 1.9.304 (Nightly) installiert ist. - - einen Reboot durchführen (Einstellungen - System - Reboot, Fahrzeug dazu abstecken!) - Bei dem Neustart sollten fehlende Module installiert werden. - Falls das nicht hilft gibt es den Support im Forum; dazu den Log der Startphase (1.9: Debug Log, 2.x Main Log) als code block () posten. -4. Falls im log evcc erwähnt wird: von VW ID (alt) auf VW ID umstellen. -5. Falls im Ev-Soc Log Fehler 303 (unknown redirect) gemeldet wird: - - Ursache 1: Bestimmte Sonderzeichen im Passwort funktionieren nicht mit dem Modul. Bitte das Passwort auf eines ohne Sonderzeichen ändern und testen. - - Ursache 2: Falsche Email, Passwort oder VIN eingegeben. Alle 3 löschen, speichern, neu eingeben, speichern und testen. -6. Falls eine Firewall im Spiel ist: Es gab einzelne Probleme beim Internet-Zugriff der openWB auf Python Archive und Fahrzeug-Server wenn IPV6 aktiv ist. -7. Nach Neustart bzw. Änderung der LP-Konfiguration werden im EV-Soc-Log Fehler ausgegeben (permission oder fehlende Datei). - - Diese Fehler sind normal und können ignoriert werden. Leider wird im Debug Mode 0 keine Positiv-Meldung ausgegeben. - Empfehlung: - - In Einstellungen - System - Debugging dies einstellen: Debug Mode 1/Regelwerte - - dann einen manuellen SOC-Abruf durchführen (im Dashboard auf Kreispfeil klicken). - - danach sollte im EV-SOC-Log eine Zeile ähnlich dieser kommen: - - `2023-02-12 11:57:14 INFO:soc_vwid:Lp1 SOC: 61%@2023-02-12T11:53:20` - - Diese Zeile zeigt folgende Information: - - ```text - 2023-02-12 11:57:14 - Timestamp des SOC-Abrufs - INFO - Debug Level INFO - soc_vwid - SOC-Modul - Lp1 - Ladepunkt - SOC: 61% - SOC Stand - @2023-02-12T11:53:20 - Timestamp des Updates vom EV zum VW Cloud-Server - ``` - -8. Falls diese Schritte nicht zum Erfolg führen, das Problem im [Support Thema](https://forum.openwb.de/viewtopic.php?t=4803) posten mit Angabe relevanter Daten - - oWB SW Version - - oWB gekauft oder selbst installiert - - wenn selbst installiert: welches OS(Stretch/Buster) - - welches Fahrzeug - - falls vorhanden Angaben über Firewall, VPN, etc., also Appliances, die den Internetzugang limitieren könnten - - relevante Abschnitte der Logs, vor allem Fehlermeldungen, als CODE-blocks (). - -Das SoC-Log mit evtl. Fehlermeldungen kann wie folgt eingesehen werden: - -- openWB 1.x (Status - EV SoC Log) -- openWB 2.x (Einstellungen - System - Fehlersuche) - diff --git a/docs/SolarEdge 1.9 komplett.png b/docs/SolarEdge 1.9 komplett.png deleted file mode 100644 index c6d2ec1b31..0000000000 Binary files a/docs/SolarEdge 1.9 komplett.png and /dev/null differ diff --git a/docs/Speichersteuerung-SolarEdge.md b/docs/Speichersteuerung-SolarEdge.md deleted file mode 100644 index be303f2853..0000000000 --- a/docs/Speichersteuerung-SolarEdge.md +++ /dev/null @@ -1,18 +0,0 @@ -# Speichersteuerung openWB - - Um die Speicher-Entladung ins Fahrzeug zu steuern muss zunächst unter "Ladeeinstellungen -> Übergreifendes" die Speicher-Entladung ins Fahrzeug konfiguriert werden: - - ![openWB Speichersteuerung](pictures/Speichersteuerung_openWB-Einstellungen.png "openWB Speichersteuerung") - -## SolarEdge und Mindest-SoC bzw. SoC-Reserve - -SolarEdge entlädt nicht alle Speicher bis 0%, sondern nur bis zu einem Mindest-SoC (Ab hier als SoC-Reserve bezeichnet). Um Probleme bei der Speichersteuerung mit SolarEdge zu verhindern, muss diese SoC-Reserve der openWB bekannt sein. Bei Unterschreiten dieser SoC-Reserve erfolgt ggf. eine Zwangsladung des Speichers durch das SolarEdge Portal, um die Tiefentladung des Speichers zu verhindern. Diese kann nur erfolgen, wenn die Speichersteuerung durch openWB beendet wurde. -Die SoC-Reserve ist je nach verwendetem Speicher unterschiedlich. Bei BYD LVS Speichern beträgt sie z.B. meist 10%, kann je nach Typ aber auch bei 15% liegen. Einige LG-Speicher verwenden 5% und die HomeBattery von SolarEdge kann bis zu 0% entladen werden. -Um einen zusätzlichen Konfigurationsaufwand pro Speicher zu vermeiden, verwendet die Speichersteuerung als Default-Wert für die SoC-Reserve 15%. Nach einem Reboot der openWB wird nun ständig der SoC-Wert des Speichers überwacht und bei Auftreten eines geringeren Wertes als 15% wird dieser als SoC-Reserve übernommen. Nach einem Neustart wird der gelernte Wert wieder verworfen, damit im Fehlerfall nicht ein falscher Wert dauerhaft erhalten bleibt. -Dies führt dazu, dass sich nach einem Neustart der openWB die Speichersteuerung sicherheitshalber bei 15% beendet, wenn noch kein niedrigerer Wert gelernt wurde. In diesem Fall wird dann der Rest vom Speicher, wie in der Standardkonfiguration, immer ins Fahrzeug entladen. Wenn dies einmal erfolgt ist, bleibt die neu gelernte SoC-Reserve bis zum nächsten Neustart erhalten. - -### Backup-Modul -Systeme mit einem Backup-Modul können mit einer Backup-Reserve konfiguriert werden, die für den Backup-Fall reserviert bleibt. Wenn diese Konfiguration erfolgt ist, so hat sie Vorrang vor dem oben beschriebenen Vorgang und wird immer berücksichtigt. - -Feedback gerne im Forum: -https://forum.openwb.de/viewtopic.php?t=9934 \ No newline at end of file diff --git a/docs/Strompreisbasiertes Laden.md b/docs/Strompreisbasiertes Laden.md deleted file mode 100644 index 3de589cb1a..0000000000 --- a/docs/Strompreisbasiertes Laden.md +++ /dev/null @@ -1,11 +0,0 @@ -Einige Stromanbierter berechnen die Strompreise stundenweise anhand des Strompreises an der Börse. openWB bietet die Möglichkeit, die günstigen Zeiten optimal zu nutzen. Eine Übersicht über die unterstützten Anbieter findest Du hier: - -Unter `Einstellungen → Ladeeinstellungen → Übergreifendes` muss der Stromanbieter konfiguriert werden. Die dort abgefragten Preise werden dann auch zur Berechnung der Ladekosten für den Netzanteil im Ladeprotokoll verwendet. - -Im Ladeprofil des Fahrzeugs muss das strompreisbasierte Laden aktiviert werden. Die Berücksichtigung des Strompreises in den verschiedenen Lademodi erfolgt folgendermaßen: - -* Sofort- und Zeitladen: Es wird nur geladen, wenn der Strompreis unter dem maximalen angegeben Strompreis liegt. -* Zielladen: Die openWB berechnet anhand der eingestellten Stromstärke und Phasenanzahl für diesen Lademodus, wie lange geladen werden, muss um den konfigurierten SoC oder die konfigurierte Energiemenge zu erreichen. Dieses Ladefenster wird automatisch auf die günstigsten Stunden des Stromtarifs gelegt. Ist PV-Überschuss vorhanden, wird dieser immer zuerst genutzt und verkürzt das besagte Ladefenster. -* PV-Laden: keine Berücksichtigung des Strompreises - -Wenn keine Preise abgefragt werden können, wird bei Sofort- und Zeitladen immer geladen und bei Zielladen zunächst mit PV-Überschuss und zum Erreichen des Zieltermins mit Netzstrom. diff --git a/docs/Tutorial b/docs/Tutorial deleted file mode 100644 index e69de29bb2..0000000000 diff --git "a/docs/Typische-Anwendungsf\303\244lle.md" "b/docs/Typische-Anwendungsf\303\244lle.md" deleted file mode 100644 index ea2f18874c..0000000000 --- "a/docs/Typische-Anwendungsf\303\244lle.md" +++ /dev/null @@ -1,47 +0,0 @@ -## Übersicht - -| Szenario | Konfiguration | -|---------------|---------------| -|Ich muss schnell weg und brauche ein voll geladenes Fahrzeug. | Sofortladen | -|Ich stecke mittags an, möchte PV nutzen und brauch am nächsten Morgen um 8:00 mindestens 75% SoC. | Zielladen | -|Ich habe einen dynamischen Stromtarif und stecke mittags an, möchte PV nutzen und brauch am nächsten Morgen um 8:00 mindestens 75% SoC. | Zielladen: Anhand der berechneten Ladedauer werden die günstigsten Stunden ermittelt und dann geladen.| -|Ich habe einen dynamischen Stromtarif und möchte nur laden, wenn Überschuss vorhanden ist oder der Strompreis unter einer von mir festgelegten Grenze liegt. | Eco | -|Ich möchte nur Überschuss laden. | PV | -|Ich möchte Überschuss laden. Falls ich spontan fahren möchte, brauche ich immer mind 40% SoC. | PV mit Mindest-SoC | -|Ich möchte Überschuss laden. Ich habe kein SoC-Modul und möchte das mein Auto immer etwas geladen wird, falls ich spontan fahren möchte. | PV mit Begrenzung Energiemenge | -|Für meinen Arbeitstag brauche ich mind 60% SoC. Falls Überschuss da ist, soll der auch in mein Auto geladen werden. Mein Auto soll immer mindestens 25% haben, falls ich spontan fahren möchte. | Zielladen und Zeitladen mit Begrenzung SoC | - -## Privater Haushalt, ein E-Auto und PV-Anlage - -In diesem Szenario sind die Ziele meistens, das Auto morgens für den Weg zur Arbeit fahrbereit zu haben, aber bis dahin möglichst viel Energie aus der PV-Anlage zum Laden zu nutzen. -Hierfür ist die Funktion *Zielladen* zu nutzen. Auch, wenn es vom Namen her scheint, dass nur zu einem festen Zeitpunkt eine definierte Energiemenge in das EV geladen sein soll, wird dennoch bis zum Beginn dieses erzwungenen Ladevorgangs PV-Energie, sofern vorhanden, genutzt. - -![Zielladen](pictures/Anwendungsfaelle_zielladen.jpg) - -Einstellbar ist der Ziel SoC, der in vielen Fällen auf 80% eingestellt wird, da eine höhere Ladung den Akku des EV überproportional belastet. Dennoch sollte ab und zu der Akku auf 100% geladen und dort über kurze Zeit gehalten werden, damit die Zellen sich wieder balancieren können. -In dem oben gezeigten Beispiel ist der Ladestrom mit 13A eingestellt. Somit bleibt bei einem 3-phasigen 11kW-Lader noch Reserve, um die Stromstärke kurz vor Ende ggf. noch zu erhöhen. - -Als Zielzeit ist die Abfahrtzeit Abfahrt einzustellen. Die Regelung berechnet aus dem aktuellen SoC des Fahrzeugs, sowie aus den zwingend korrekt anzugebenden Maximalwerten der Ladeströme im Ladeprofil, den Zeitpunkt, an dem die Ladung starten muss. -Es empfiehlt sich den Ladestrom im Ladeprofil unter Zielladen etwas niedriger als die Möglichkeiten der Wallbox und des Fahrzeugs anzugeben, damit etwas Puffer vorhanden ist, falls das Auto zu spät angesteckt worden ist. - -Falls das EV durch eine Standheizung vor Fahrtbeginn vorgeheizt werden soll, kann hierfür ein Zeitslot mit _Laden nach Zeitplan_ konfiguriert werden. Zeitladen kann zusätzlich zum gewählten Lademodus, hier Zielladen, aktiviert werden. So wird der Akku durch die Standheizung nicht belastet, sondern der Strom kommt aus dem EVU-Netz. Hier kann dann ein minimaler Strom von z.B. 6A gewählt werden, da die Leistungsaufnahme für die Heizung meist nicht mehr als 1kW benötigt. - -### Außerplanmäßige Fahrt - -Wird das Fahrzeug außer der Reihe benötigt und es soll kurzfristig viel Energie in den Akku geladen werden, ist die openWB auf der Startseite auf *Sofortladen* zu stellen. Hier ist es möglich, mit der maximal verfügbaren Leistung den Akku so schnell wie möglich aufzuladen. - -### Ausnutzen der PV-Anlage bei wechselndem Wetter - -Insbesondere im Frühling und Herbst kann die PV-Leistung bei bewölktem Himmel stark schwanken. Um ein häufiges Beenden und Starten des Ladevorgangs zu vermeiden, kann bei dem Modus PV ein *Minimaler Dauerstrom* eingestellt werden. -Ist die Einstellung auf 0A, so wird ausschließlich mit solarem Überschuss geladen. Steigt die Netzeinspeisung über den in _Konfiguration->Ladeeinstellungen ->PV-Laden_ eingestellten Grenzwert, wird nach Ablauf der Einschaltverzögerung die Ladung gestartet. Mit der nächstgrößeren Einstellmöglichkeit 6A, wird (z.B. bei einphasigem Laden) kontinuierlich mit ~1,3kW geladen. Wird ins Netz eingespeist, wird die Ladeleistung hochgeregelt, sodass möglichst weder Strom eingespeist noch bezogen wird und, je nach Möglichkeiten des Fahrzeugs, auf 3-phasiges Laden umgeschaltet. - -![PV-Min](pictures/Anwendungsfaelle_minStrom.jpg) - -## Integration in Hausautomation - -openWB eignet sich hervorragend zur Integration in eine bestehende Hausautomation, da über den integrierten MQTT-Broker Befehle sowie Statusmeldungen ausgetauscht werden können. - -### MQTT - -Zum Debugging empfiehlt sich das Programm [MQTT-Explorer?](http://mqtt-explorer.com/). -Eine detaillierte Erklärung ist auf der [MQTT-Seite](https://github.com/openWB/core/wiki/MQTT) zu finden. diff --git a/docs/WiCAN.md b/docs/WiCAN.md deleted file mode 100644 index e55aac6bb9..0000000000 --- a/docs/WiCAN.md +++ /dev/null @@ -1,155 +0,0 @@ -# WiCAN-OBD2 mit manuellem SoC Modul der openWB - -Mit Hilfe des WiCAN OBD2 Dongles von meatPi Electronics können die Werte des Fahrzeugs über die OBD2-Schnittstelle ausgelesen und im WLAN per MQTT an die openWB Wallbox gesendet werden. -In Verbindung mit dem manuellem SoC Modul der openWB ist hiermit die Nutzung ohne Cloud-Dienste der Fahrzeughersteller möglich. - - -Die erste Umsetzung erfolgte von zut im openWB Forum, der hierfür auch eine Unterstützung von Spritmonitor umgesetzt hat. Hierfür ist ein weiteres Gerät im Netzwerk nötig, auf dem ein kleines Programm (soc_helper) laufen kann: - - -Im Laufe der weiteren Entwicklung wurde die Möglichkeit des automatischen Auslesen (AutoPID) in die Firmware des Gerätes integriert. Hierfür ist nun keine zusätzliche Hardware mehr nötig, da der Dongle die Daten direkt per MQTT an die openWB sendet. Die Unterstützung von Spritmonitor ist hiermit jedoch nicht möglich. Die Einrichtung dieser Funktion soll hier näher beschrieben werden. - -## 1. Voraussetzungen - -* WiCAN Dongle mit Firmware 3.48, 4.03 oder neuer (4.00 ist fehlerhaft). -* Konfiguration des Manuellen SoC Moduls im Fahrzeug der openWB. -* WLAN Empfang im Bereich der openWB bzw. des Fahrzeugs. -* Ggf. Beachtung einer Alarmanlage, die den OBD2 Port überwacht. - -## 2. WiCAN Dongle - -Die Beschaffung der Hardware ist zunächst die größte Hürde, da die Firma meatPi Electronics Ihren Sitz in Australien hat. -Es sind aktuell 2 Bezugsquellen bekannt: - -Es ist hierbei darauf zu achten, dass nur der WiCAN-OBD2 oder der WiCAN PRO (Coming soon) verwendet werden kann. Bei Bestellung über Mouser erfolgt der Versand ab 50€ Versandkostenfrei, so dass sich idealerweise 2 oder mehr Besteller zu einer Sammelbestellung zusammentun können. -Achtung: Die angegeben Preise sind Nettopreise. - -## 3. Konfiguration manueller SoC in openWB - -* In der Fahrzeugkonfiguration der openWB muss das manuelle SoC Modul eingerichtet werden. Für die spätere Konfiguration der MQTT-Topics wird die Fahrzeug-ID benötigt. Diese kann man am besten auf der Status Seite der openWB auslesen: - - ![Status](pictures/WiCAN_openWB-Status.png "openWB Status") - -## 4. Konfiguration WiCAN Settings - -* Zunächst muss der WiCAN ins Heim-WLAN geholt werden: - - -* Nun werden die weiteren Parameter konfiguriert: -![WiCAN Settings](pictures/WiCAN_Settings.png "WiCAN Settings") - -* Protocol AutoPID wird zur automatischen Abfrage der PIDs benötigt (Bereich Automate) -* MQTT zur openWB erfolgt mit leerem User und Passwort -* RX und Status Topic müssen mit others/ beginnen, damit sie von openWB beachtet werden. Diese dienen nur der Fehleranalyse und Überwachung mit MQTT-Explorer. Für die eigentliche Funktion werden sie nicht benötigt. - ---- - -* Sleep Mode (Bereich Power Saving): Bei Unterschreiten der Sleep Voltage schaltet sich der WiCAN ab. Hierdurch wird ein Entladen der 12V Batterie verhindert. -![WiCAN Power Saving](pictures/WiCAN_PowerSaving.png "WiCAN Settings") - -## 5. Ermittlung der PID Parameter aus dem Vehicle Profile bei meatPi - -Es werden bei meatPi die benötigten Parameter verschiedener Fahrzeuge in Vehicle-Profilen gesammelt. -Die Informationen aus diesen Profilen können wir verwenden, um die Parameter, die wir für die openWB benötigen, zu ermitteln. - -Die Profile sind hier einzeln verfügbar: - - -Anhand des Beispiels eines VW:ID, die wichtigen Informationen (fettgedruckt). -Wir benötigen zwingend den SoC, optional können wir auch die Reichweite (Range) gebrauchen: - ---- -{ - "car_model":"VW: ID", - **"init":"ATST96;ATFCSD300000;ATFCSM1;",** - "pids":[ - { - **"pid":"22028C1",** - **"pid_init":"ATSP7;ATCP17;ATSHFC007B;ATFCSH17FC007B;ATCRA17FE007B;",** - "parameters":[ - { - "class":"battery", - **"expression":"B4\*0.4425-6.1947",** - **"name":"soc",** - "unit":"%" - } - ] - }, - { - **"pid":"222AB62",** - **"pid_init":"ATSP6;ATCP18;ATSH710;ATFCSH710;ATCRA77A;",** - "parameters":[ - { - "class":"none", - **"expression":"[B5:B6]",** - **"name":"range",** - "unit":"km" - } - ] - } - -## 6. Übernahme der Werte für die Custom PIDs (Automate-Tab) - -die gefundenen Werte werden nun im Bereich Automate bei den Custom PIDs eingetragen: -![WiCAN Automate Tab](pictures/WiCAN_Automate.png "WiCAN Automate") - -* Das Feld "Custom Initialization" wird aus "**init**" vom Vehicle-Profile übernommen. -* Das Feld Name muss für den SoC "manual_soc" lauten, für die Reichweite "range". -* Falls vorhanden wird das Feld "Init" aus "**pid_init**" vom Vehicle-Profile übernommen. Dieses Feld kann auch leer sein, wenn für die einzelnen PIDs keine besondere Initialisierung benötigt wird. -* Das Feld PID wird aus "**pid**" übernommen. -* Das Feld Expression wird aus "**expression**" übernommen. -* Period(ms) ist das Intervall, in denen die Werte abgefragt werden. -* Im Feld "Destination Type" muss für den SoC "MQTT_Topic", für die Reichweite jedoch "MQTT_Wallbox" eingestellt werden. -* Im Feld Send_to muss die Fahrzeug ID aus der openWB, die wir in [Punkt 3](#3-konfiguration-manueller-soc-in-openwb) ermittelt haben, eingesetzt werden (...vehicle/**x**/...): - -Die Werte lauten für den SoC: -openWB/set/vehicle/**x**/soc_module/calculated_soc_state -Für die Reichweite: -openWB/set/vehicle/**x**/get/range - -Das Ergebnis sieht dann z.B. so aus: - -Name|Init|PID|Expression|Period(ms)|Type|Send_to --|-|-|-|-|-|- -manual_soc|ATSP7;ATSHFC007B;ATCP17;ATCRA17FE007B;ATFCSH17FC007B;|22028C1|B4*0.4425‑6.1947|10000|MQTT_Topic|openWB/set/vehicle/**3**/soc_module/calculated_soc_state -range|ATSP6;ATSH710;ATCP18; ATCRA77A;ATFCSH710;|222AB62|[B5:B6]|10000|MQTT_Topic|openWB/set/vehicle/**3**/get/range - -### Ergänzung zur openWB 1.9 - -Bei openWB 1.9 wird das SOC Modul Manuell+Berechnung am Ladepunkt konfiguriert, das Topic benötigt hier den Typ MQTT_Wallbox. -Am Beispiel Ladepunkt 1 würde dies dann so aussehen: - -Name|Init|PID|Expression|Period(ms)|Type|Send_to --|-|-|-|-|-|- -manualSoC|ATSP7;ATSHFC007B;ATCP17;ATCRA17FE007B;ATFCSH17FC007B;|22028C1|B4*0.4425‑6.1947|60000|MQTT_Wallbox|openWB/set/lp/**1** - -Nachtrag: openWB 1.9 akzeptiert nur Ganzzahlige SOC-Werte und kann daher aktuell nicht verwendet werden. - -## 7. Alarmanlage des Fahrzeugs - -Bei Fahrzeugen mit einer Alarmanlage wird häufig auch der OBD2-Port überwacht, so dass bei einer Abfrage die Alarmanlage auslöst. -Um dieses Problem zu umgehen sind momentan folgende Lösungen bekannt: - -* Bei einigen Fahrzeugen liegt an PIN1 des OBD2-Ports nur bei eingeschalteter Zündung eine Spannung von 12V an. Diese kann dann zur Versorgung des WiCAN Dongles verwendet werden, so dass dieser bei abgeschalteter Zündung gar keine Spannungsversorgung hat. Normalerweise liegt an PIN16 die Versorgungsspannung für den WiCAN an. -Es kann also in diesem Fall mit einem entsprechend "manipuliertem" Adapterkabel z.B. PIN1 und PIN16 getauscht werden: - -* Ggf. ist eine Anpassung der OBD2-Überwachung der Alarmanlage möglich: - - -Beide Lösungen dienen nur zur Info und erfolgen stets auf eigene Gefahr - -## 8. Übersicht erfolgreich getesteter Fahrzeuge - -Abschliessend noch eine kurze Auflistung von bereits erfolgreich getesteten Fahrzeugen. -Gerne kann und sollte diese Liste erweitert werden. -Zur besseren Übersicht werden hier nur die tatsächlich verwendeten Fahrzeuge (am besten mit Modelljahr) sowie nur der SoC aufgeführt: - -Fahrzeug|Custom Initialization|Name|Init|PID|Expression --|-|-|-|-|- -CUPRA Born 2022|ATST96;ATFCSD300000;ATFCSM1;|manual_soc|ATSP7;ATCP17;ATSHFC007B;ATFCSH17FC007B;ATCRA17FE007B;|22028C1|B4*0.4425‑6.1947 -Hyundai Ioniq (28 kWh) 2017|ATSP6;ATSH7E4;ATST96;|manual_soc||2105|B39/2 -Peugeot iOn|ATSP6;ATFCSH761;ATFCSD300000;ATFCSM1;ATSH761;ATCRA762;|manual_soc||2101|(B4/2)‑5 - -Anmerkungen zur Tabelle: - -Um einen Zeilenumbruch zu verhindern, müssen Leerzeichen durch einen "no-break space character" (\ ) und ein Minuszeichen durch "no-break hyphen" (\‑) im Markdown Quelltext ersetzt werden. diff --git a/docs/Wiki-Eintrag erstellen.md b/docs/Wiki-Eintrag erstellen.md deleted file mode 100644 index 04df94fff6..0000000000 --- a/docs/Wiki-Eintrag erstellen.md +++ /dev/null @@ -1,17 +0,0 @@ -Wiki-Beiträge werden per Pull Request beigesteuert. Im Ordner ./docs des Core-Repository sind die Dateien des Wikis im Markdown-Format enthalten. Nach dem Merge des Pull Requests werden die Änderungen aus dem docs-Ordner mit dem Wiki per GitHub-Workflow automatisch synchronisiert. - -Der Name der Markdown-Datei ist der Titel der Wiki-Seite. Die Datei _Sidebar.md enthält die Einträge, die rechts in der Sidebar des Wikis angezeigt werden. - -### Ablauf mit Github - -Wenn ihr euch am Wiki beteiligen wollt müsst ihr zunächst einen Github Account erstellen bzw. euch mit eurem anmelden. Dann geht ihr auf die [Projektseite](https://github.com/openWB/core) und erstellt einen Fork: - -![Fork](pictures/Wiki-Eintrag_erstellen_Fork.png) - -Dies ist nötig, da dem "normalen Mitarbeiter" das Projekt nicht gehört und man somit keine Schreibrechte im Projekt des OpenWB Accounts hat. Man erstellt also eine verknüfpte Kopie in seinem eigenen Account. -Hier wird dann am besten ein Branch erstellt, den ihr sinnvoll benennt (z.B. Wiki oder ähnlich). In diesem Branch arbeitet ihr und ändert und ergänzt entsprechend euren Erfahrungen zu den Themen in denen ihr euch auskennt. Danach müsst ihr Änderungen mit *Commit* in die (lokale) Git-Umgebung übernehmen und mit *Push* zu Github übertragen. -Dies beginnt ihr in eurem eigenen Branch und wählt im Menü oben Pull-Request aus und füllt die Felder mit einer Beschreibung was ihr gemacht habt. - -![Pull-Request](pictures/Wiki-Eintrag_erstellen_Pull.jpg) - -Für euren ersten Beitrag müsst ihr noch von einem Projektmitarbeiter freigeschaltet werden. Dies kann einige Zeit dauern. Eventuell werden auch noch Änderungen vorgeschlagen, die ihr dann diskutieren oder einfach annehmen könnt. diff --git a/docs/_Sidebar.md b/docs/_Sidebar.md index a748e2d8da..61853e632c 100644 --- a/docs/_Sidebar.md +++ b/docs/_Sidebar.md @@ -1,45 +1,7 @@ -# openWB2-Wiki +GitHub-Wiki für openWB software2 * [Home](https://github.com/openWB/core/wiki/Home) -* [Grundkonzept](https://github.com/openWB/core/wiki/Grundkonzept) -* [Ladepunkte](https://github.com/openWB/core/wiki/Ladepunkte) -* [Fahrzeuge](https://github.com/openWB/core/wiki/Fahrzeuge) - * [Manueller SoC](https://github.com/openWB/core/wiki/Manueller-SoC) - * [SoC BMW & Mini](https://github.com/openWB/core/wiki/SoC-BMW-Mini) - * [SoC Cupra](https://github.com/openWB/core/wiki/SoC-Cupra) - * [SoC OVMS](https://github.com/openWB/core/wiki/SoC-OVMS) - * [SoC Skoda](https://github.com/openWB/core/wiki/SoC-Skoda) - * [SoC VWId](https://github.com/openWB/core/wiki/SoC-VWId) - * [WiCAN OBD2-Dongle mit manuellem SoC](https://github.com/openWB/core/wiki/WiCAN) -* [Lademodi](https://github.com/openWB/core/wiki/Lademodi) -* Zähler - * [Grundsätzliches zu Zählern](https://github.com/openWB/core/wiki/Grundsätzliches-zu-Zählern) - * [Lastmanagement und kaskadierte Zähler](https://github.com/openWB/core/wiki/Lastmanagement-und-kaskadierte-Zähler) - * [Ermittlung des Hausverbrauchs](https://github.com/openWB/core/wiki/Hausverbrauch) -* Speicher - * [Speichersteuerung SolarEdge](https://github.com/openWB/core/wiki/speichersteuerung-solaredge) -* Oberfläche - * [Anzeige - Steuerung](https://github.com/openWB/core/wiki/Anzeige-Steuerung) -* Features - * [Identifikation](https://github.com/openWB/core/wiki/Identifikation) - * [IO-Geräte & -Aktionen](https://github.com/openWB/core/wiki/IO-Geräte-&--Aktionen) - * [OCPP](https://github.com/openWB/core/wiki/OCPP) - * [Strompreisbasiertes Laden](https://github.com/openWB/core/wiki/Strompreisbasiertes-Laden) - * [Steuerbare Verbrauchseinrichtungen](https://github.com/openWB/core/wiki/Steuerbare-Verbrauchseinrichtungen-nach-§14a) -* Szenarien - * [Typische Anwendungsfälle](https://github.com/openWB/core/wiki/Typische-Anwendungsfälle) - * [Hybrid-System aus Wechselrichter und Speicher](https://github.com/openWB/core/wiki/Hybrid-System-aus-Wechselrichter-und-Speicher) -* Integration in Heimautomation - * [MQTT](https://github.com/openWB/core/wiki/MQTT) * Mitarbeit am Projekt - * [Wiki-Eintrag erstellen](https://github.com/openWB/core/wiki/Wiki-Eintrag_erstellen) * [Entwicklungsumgebung](https://github.com/openWB/core/wiki/Entwicklungsumgebung) * [Neues Modul programmieren](https://github.com/openWB/core/wiki/Neues-Modul-programmieren) * [Einstellungs-Seite erstellen](https://github.com/openWB/core/wiki/Einstellungs-Seite-erstellen) -* Konfiguration - * [Huawei Smartlogger 3000a](https://github.com/openWB/core/wiki/Huawei-Smartlogger) - * [Cloud-Sicherung](https://github.com/openWB/core/wiki/Cloud-Sicherung) - * [NextCloud](https://github.com/openWB/core/wiki/NextCloud-als-Sicherungs-Cloud-einrichten) - * [Samba](https://github.com/openWB/core/wiki/Samba-als-Sicherung-einrichten) -* Sonstiges - * [Fehlersuche](https://github.com/openWB/core/wiki/Fehlersuche) diff --git a/docs/hybrid.png b/docs/hybrid.png deleted file mode 100644 index 3734a76974..0000000000 Binary files a/docs/hybrid.png and /dev/null differ diff --git a/docs/kaskadierte_zaehler.png b/docs/kaskadierte_zaehler.png deleted file mode 100644 index f253d38e09..0000000000 Binary files a/docs/kaskadierte_zaehler.png and /dev/null differ diff --git a/docs/standard.png b/docs/standard.png deleted file mode 100644 index 78ab4db309..0000000000 Binary files a/docs/standard.png and /dev/null differ