Kostal Plenticore: clarify template and documentation (#17793)

templates/definition/meter/kostal-plenticore-gen2.yaml

@@ -1,8 +1,9 @@
-template: kostal-plenticore-hw0200
+template: kostal-plenticore-gen2
 products:
   - brand: Kostal
     description:
-      generic: Plenticore Hybrid (Gen2)
+      de: Plenticore Hybrid, inkl. Netzladung der Hausbatterie
+      en: Plenticore Hybrid, incl. grid charging of the house battery
 capabilities: ["battery-control"]
 linked:
   - template: kostal-ksem-inverter
@@ -10,13 +11,17 @@ linked:
   - template: kostal-ksem
     usage: grid
     excludetemplate: kostal-ksem-inverter
-covers: ["kostal-plenticore-gen2"]
+covers: ["kostal-plenticore-hw0200"]
 requirements:
   description:
     de: |
-      Nur ein System kann und darf auf den Wechselrichter zugreifen! Für die aktive Batteriesteuerung muss die externe Batteriesteuerung über Modbus mit dem Handwerkerzugang aktiviert sein. Das Netzladen steht mit dieser Vorlage zur Verfügung, ist aktuell jedoch inkompatibel mit Wechselrichtern der HW-Version 0100).
+      Nur ein System kann und darf auf den Wechselrichter zugreifen! Für die aktive Batteriesteuerung muss die Funktion externe Batteriesteuerung über Modbus mit dem Handwerkerzugang aktiviert sein. **_Ist grundsätzlich anwendbar für verschiedene Wechselrichter Generationen (G1/G2/G3)._**
+      **Das Netzladen der Batterie steht mit dieser Vorlage zur Verfügung, ist aktuell jedoch inkompatibel mit wenigen älteren Wechselrichtern - _sorgfältig testen_!**
+      _siehe auch https://github.com/evcc-io/evcc/wiki/Kostal-Plenticore_
     en: |
-      Only a single system may access the inverter! For active battery control, the external battery control via Modbus must be activated using installer access. The function for grid charging the battery is available using this template, but is currently incompatible with inverters of HW version 0100.
+      Only a single system may access the inverter! For active battery control, the feature external battery control via modbus must be activated using installer access. **_Can basically be used for various inverter generations (G1/G2/G3)._**
+      **The function for grid charging the battery is available using this template, but is currently incompatible with some older inverters - _test carefully_!**
+      _see also https://github.com/evcc-io/evcc/wiki/Kostal-Plenticore_
 params:
   - name: usage
     choice: ["pv", "battery"]

templates/definition/meter/kostal-plenticore.yaml

@@ -13,9 +13,11 @@ linked:
 requirements:
   description:
     de: |
-      Nur ein System kann und darf auf den Wechselrichter zugreifen! Für die aktive Batteriesteuerung muss die externe Batteriesteuerung über Modbus mit dem Handwerkerzugang aktiviert sein. Diese Vorlage ist für Wechselrichter mit der HW Version 0100. Netzladen steht nicht zur verfügung.
+      Nur ein System kann und darf auf den Wechselrichter zugreifen! Für die aktive Batteriesteuerung muss die Funktion externe Batteriesteuerung über Modbus mit dem Handwerkerzugang aktiviert sein. 
+      **Das Netzladen der Batterie steht nicht zur Verfügung!** _siehe auch https://github.com/evcc-io/evcc/wiki/Kostal-Plenticore_
     en: |
-      Only a single system may access the inverter! For active battery control, the external battery control via Modbus must be activated using installer access. This template is for inverters with HW version 0100. Grid charging is not available.
+      Only a single system may access the inverter! For active battery control the function external battery control via Modbus must be activated using installer access.
+      **Grid charging is not available!** _see also https://github.com/evcc-io/evcc/wiki/Kostal-Plenticore_
 params:
   - name: usage
     choice: ["pv", "battery"]
@@ -39,8 +41,7 @@ params:
     type: int
     advanced: true
   - name: maxsoc
-    type: int
-    advanced: true
+    deprecated: true
   - name: watchdog
     type: duration
     default: 60s
@@ -77,17 +78,38 @@ render: |
     source: sunspec
     {{- include "modbus" . | indent 2 }}
     value: 802:SoC # 802 battery control
-  limitsoc:
+  batterymode:
     source: watchdog
     timeout: {{ .watchdog }} # re-write at timeout/2
+    reset: 1 # reset watchdog on normal
     set:
-      source: modbus
-      {{- include "modbus" . | indent 4 }}
-      register:
-        address: 1042 # limit soc
-        type: writemultiple
-        encoding: {{ if (eq .endianness "big") }}float32{{ else }}float32s{{ end }}
+      source: switch
+      switch:
+      - case: 1 # normal
+        set:
+          source: const
+          value: {{ .minsoc }} # % (set once to reset from forced charge)
+          set:
+            source: modbus
+            {{- include "modbus" . | indent 10 }}
+            register:
+              address: 1042 # minsoc
+              type: writemultiple
+              encoding: {{ if (eq .endianness "big") }}float32{{ else }}float32s{{ end }}
+      - case: 2 # hold
+        set:
+          source: const
+          value: 100 # %
+          set:
+            source: modbus
+            {{- include "modbus" . | indent 10 }}
+            register:
+              address: 1042 # minsoc
+              type: writemultiple
+              encoding: {{ if (eq .endianness "big") }}float32{{ else }}float32s{{ end }}
+      - case: 3 # charge (not implemented -> keep last state, no action)
+        set:
+          source: error
+          error: ErrNotAvailable
   capacity: {{ .capacity }} # kWh
-  minsoc: {{ .minsoc }} # %
-  maxsoc: {{ .maxsoc }} # %
   {{- end }}