Merge master into Release

.github/workflows/build_display_theme_cards.yml

@@ -0,0 +1,37 @@
+name: Build Display Theme Cards
+
+on:
+  push:
+    paths:
+      - packages/modules/display_themes/cards/source/**
+    branches:
+      - master
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js (v20)
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: packages/modules/display_themes/cards/source/package-lock.json
+
+      - name: Install Dependencies and Build
+        run: |
+          cd packages/modules/display_themes/cards/source
+          npm install
+          npm run build --if-present
+
+      - name: Commit and Push Changes
+        run: |
+          git config user.name "${{ github.actor }}"
+          git config.user.email "${{ github.actor }}@users.noreply.github.com"
+          git add packages/modules/display_themes/cards/web
+          git commit -m "Build Display Theme: Cards"
+          git push

.github/workflows/github-actions-python.yml

@@ -6,16 +6,14 @@ jobs:
   build:
     runs-on: ubuntu-20.04
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Python 3.9
-        uses: actions/setup-python@v3
+        uses: actions/setup-python@v5
         with:
-          python-version: "3.9"
+          python-version: "3.9.2"
       - name: Install dependencies
         run: |
-          python -m pip install --upgrade pip
-          pip install flake8 pytest paho-mqtt requests-mock jq pyjwt==2.6.0 bs4 pkce typing_extensions python-dateutil==2.8.2 cryptography==40.0.1 msal
-          pip install umodbus
+          pip3 install -r "/home/runner/work/core/core/requirements.txt"
       - name: Flake8 with annotations in packages folder
         uses: TrueBrain/actions-flake8@v2.1
         with:

.github/workflows/publish_docs_to_wiki.yml

@@ -21,7 +21,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       # 1. Create folder named `tmp_wiki`
       # 2. Initialize Git

README.md

@@ -18,23 +18,25 @@ Keine Gewährleistung für die Software - use at your own RISK!
 
 ## Wofür?
 
-Steuerung einer EVSE DIN oder anderer Ladepunkte für sofortiges laden, Überwachung der Ladung, PV Überschussladung und Lastmanagement mehrerer WB.
+Steuerung einer EVSE DIN oder anderer Ladepunkte für sofortiges laden, Überwachung der Ladung, PV Überschussladung und Lastmanagement mehrerer Wallboxen.
 
-Unterstützt wird jedes EV das den AC Ladestandard unterstützt.
+Unterstützt wird jedes Fahrzeug, das den AC Ladestandard unterstützt.
 
 ## Bezug
 
 openWB gibt es unter <https://openwb.de/shop/>.
 
 ## Installation
 
-Bei fertigen openWB bereits vorinstalliert.
+Bei fertig erworbenen openWB ist die Software bereits vorinstalliert.
 
 Software:
 
-- Installiertes Raspberry Pi OS auf einem Raspberry Pi 3b+ oder besser.
-- Raspberry Pi OS Lite installieren. Aktuell werden in der Version 1.99 nur Bullseye (bevorzugt) und Buster unterstützt.
-<http://downloads.raspberrypi.org/raspios_lite_armhf/images/>
+- Installiertes Raspberry Pi OS auf einem Raspberry Pi 3b oder besser.
+- Raspberry Pi OS Lite installieren. Aktuell wird in der Version 2.1 nur **Debian 11 "Bullseye"** (derzeit "oldstable") unterstützt.
+<https://downloads.raspberrypi.org/raspios_oldstable_lite_armhf/>
+- alternativ kann auch ein x86_64 System (Hardware oder als VM) mit installiertem **Debian 11 "Bullseye"** als Basis verwendet werden.
+- Eine Installation unter **Debian 12 "Bookworm"** wird noch nicht unterstützt!
 
 In der Shell folgendes eingeben:
 

docs/Grundkonzept.md

@@ -0,0 +1,36 @@
+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 auseinander setzen, 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 11kW 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 22kW openWBs angeschlossen sind, in den seltensten Fällen mit den dafür notwendigen 63A abgesichert; häufig z.B. nur 35A. 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 24kW / 35A 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 ergibt 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 hinzu gekommenen 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)

docs/Hausverbrauchs-Zähler.md

@@ -1,7 +1,13 @@
-Einige Zähler, wie zB Solar-Log und Kostal Plenticore, werden im Hausverbrauchs-Zweig und nicht am EVU-Punkt installiert. Die für die Reglung erforderlichen Werte des EVU-Punkts werden mit einem virtuellen Zähler ermittelt. Dazu ein Virtuelles Gerät mit einem virtuellen Zähler anlegen. Die Komponenten müssen in der Hierarchie wie in der Abbildung angeordnet werden:
+Einige Zähler, wie zB Solar-Log und Kostal Plenticore, werden im Hausverbrauchs-Zweig und nicht am EVU-Punkt installiert. Die für die Reglung erforderlichen Werte des EVU-Punkts werden mit einem virtuellen Zähler ermittelt. Dazu ein Virtuelles Gerät mit einem virtuellen Zähler anlegen. Die Komponenten müssen in der Hierarchie wie in den Abbildungen angeordnet werden:
+
+Misst der Zähler den Hausverbrauch, ergibt sich folgende Anordnung:
 
 <img src="Hausverbrauchs-Zaehler.png" width="500">
 
-Ist ein Hybrid-Wechselrichter vorhanden, ergibt sich folgende Struktur:
+Misst der Zähler den Hausverbrauchs und ist ein Hybrid-Wechselrichter vorhanden, ergibt sich folgende Struktur:
+
+<img src="Hausverbrauchs-Zaehler_Hybrid.png" width="500">
+
+Ist der Zähler wie üblich am EVU-Punkt installiert und misst den gesamten Verbrauch/Einspeisung, muss die Struktur wie folgt aussehen:
 
-<img src="Hausverbrauchs-Zaehler_Hybrid.png" width="500">
+<img src="standard.png" width="500">

docs/Hybrid System aus Wechselrichter und Speicher.md

@@ -1,11 +1,16 @@
-Bei Hybrid-Systemen ist der Speicher an den Wechselrichter angeschlossen. Bei den meisten Herstellern wird dann die Speicherleistung mit der PV-Leistung des Wechselrichters verrechnet und die ins Hausnetz abgegebene Leistung ausgegeben. Auch die Zählerstände werden miteinander verrechnet. In openWB wird die PV-Leistung und Speicher-Leistung getrennt ausgegeben.
+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. 
 
-Wenn die PV-Leistung um die Ladeleistung des Speichers zu niedrig ist, liegt ein Hybrid-System vor. (Achtung: Auch der Hausverbrauch stimmt dann nicht, da dieser aus den gemessenen Größen berechnet wird.)
+Wechselrichter-Leistung: Summe aus PV- und Speicher-Leistung, die der Wechselrichter ins Hausnetz abgibt.
+PV-Leistung: Auf dem Dach erzeugte Leistung.
 
-Das Verrechnen von Hybrid-Systemen erfolgt automatisch und muss nicht im Wechselrichter-Modul implementiert werden. Wenn ein Hybrid-System vorhanden ist und die Speicher-Leistung aus der Wechselrichter-Leistung herausgerechnet werden muss, ordne den Speicher in der Hierarchie unter dem Wechselrichter an.
+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.
 
-Bei einem Hybrid-System wird der Speicher in der Hierarchie hinter dem Wechselrichter angeordnet:
-![Hybrid-System](hybrid.png)
+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.)
 
-Im Vergleich dazu die Standard-Konfiguration:
-![Standard-System](standard.png)
+Hybrid-System, wenn die Wechselrichter-Leistung ausgegeben wird:
+
+<img src="hybrid.png" width="500">
+
+Hybrid-System, wenn die PV-Leistung ausgegeben wird:
+<img src="standard.png" width="500">

docs/Ladeprofile.md

@@ -0,0 +1,2 @@
+_Einstellungen -> Konfiguration -> Fahrzeuge -> Lade-Profile_
+

docs/Ladepunkte.md

@@ -4,6 +4,7 @@ Die Einstellungen für Ladepunkte unterteilen sich in die spezifischen Einstellu
 
 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 automatischen Sperren (Autolock) und für RFID von Ladepunkten 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.
+In dem Ladepunkt-Profil sind die Einstellungen zum automatischen Sperren (Autolock) 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 Vorhalten eines RFID-Tags (verbauter RFID-Leser erforderlich) oder die Pin-Eingabe (Display erforderlich, Eingabefeld muss im Steuerungsmodus 'secondary' aktiviert werden) werden gleich verarbeitet.
+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.

docs/Ladung nur nach Freischaltung.md

@@ -17,6 +17,9 @@ Hierzu ist folgendes zu konfigurieren:
 
 Wenn die Freischaltung mittels PIN, RFID oder MAC-Adresse erfolgen soll:
 
-- Einstellungen -> Optionale Hardware: **RFID aktivieren** + Speichern
-- unter Konfiguration -> Fahrzeuge -> gewünschtes Fahrzeug -> Zugeordnete Tags: dem jeweiligen Fahrzeug **den Tag (PIN/RFID-Tag/MAC-Adresse) zuweisen** + Speichern
-- unter Konfiguration -> Ladepunkte -> Ladepunkt-Profile -> im gewünschten Ladepunkt-Profil: **Freischaltung mit RFID aktivieren und die gültigen Tags eintragen** + Speichern
+- Einstellungen -> Optionale Hardware: **Identifikation aktivieren** + Speichern
+- unter Konfiguration -> Fahrzeuge -> gewünschtes Fahrzeug -> Zugeordnete ID-Tags: dem jeweiligen Fahrzeug **den ID-Tag (PIN/RFID-Tag/MAC-Adresse) zuweisen** + Speichern
+- unter Konfiguration -> Ladepunkte -> Ladepunkt-Profile -> im gewünschten Ladepunkt-Profil: **Freigabe durch ID-Tags aktiviere** + Speichern
+
+Wenn die Tags an allen Ladepunkten genutzt werden dürfen, müssen die Tags nur bei den Fahrzeugen eingetragen werden. Wenn im Ladepunkt-Profil Tags eingetragen werden, können nur die eingetragenen Tags zur Fahrzeug-Zuordnung genutzt werden. Sind keine Tags eingetragen, wird nur die Zuordnung zum Fahrzeug geprüft. Durch die Begrenzung der Freischaltung auf bestimmte Tags, lassen sich zB Mitarbeiter- und Gäste-Parkplätze abbilden.
+- unter Konfiguration -> Ladepunkte -> Ladepunkt-Profile -> im gewünschten Ladepunkt-Profil: **die gültigen ID-Tags zuordnen** + Speichern

docs/Wiki-Eintrag erstellen.md

@@ -1,3 +1,15 @@
 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](pictures/Wiki-Eintrag erstellen_Pull.png)
+Für euren ersten Beitrag müsst ihr noch von einem Projektmitarbeiter freigeschaltet werden. Dies kann einige Zeit dauern.