From f96a4266f61591d109101da1a1814d59228b601f Mon Sep 17 00:00:00 2001
From: Markus Thierolf <77847348+thierolm@users.noreply.github.com>
Date: Sun, 2 Jul 2023 07:16:23 +0200
Subject: [PATCH] Homematic: expose cache parameter (#7863)

---
 templates/definition/charger/homematic.yaml | 12 ++++++++++++
 templates/definition/meter/homematic.yaml   | 14 +++++++++++++-
 templates/docs/charger/homematic_0.yaml     |  1 +
 templates/docs/meter/homematic_0.yaml       |  3 +++
 4 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/templates/definition/charger/homematic.yaml b/templates/definition/charger/homematic.yaml
index b90508a29..6f424d8fc 100644
--- a/templates/definition/charger/homematic.yaml
+++ b/templates/definition/charger/homematic.yaml
@@ -46,6 +46,15 @@ params:
     help:
       en: Homematic switch actor channel number like shown in the CCU web user interface.
       de: Kanalnummer der schaltbaren Steckdose, wie im CCU Webfrontend angezeigt.
+  - name: cache
+    advanced: true
+    default: 1s
+    description:
+      en: XML-RPC api cache duration - Default 1s. (valid units are s,m,h)
+      de: XML-RPC API Cache Zeitraum - Default 1s. (gültige Einheiten s,m,h)
+    help:
+      en: In case of duty cycle problems try a cache setting of 30s.
+      de: Bei Problemen mit dem Duty Cycle setze den Cache auf bspw 30s.
   - preset: switchsocket
 render: |
   type: homematic
@@ -60,3 +69,6 @@ render: |
   meterchannel: {{ .meterchannel }}
   switchchannel: {{ .switchchannel }}
   {{ include "switchsocket" . }}
+  {{- if .cache }}
+  cache: {{ .cache }}
+  {{- end }}
diff --git a/templates/definition/meter/homematic.yaml b/templates/definition/meter/homematic.yaml
index 40ba5ccd6..2e472b6fc 100644
--- a/templates/definition/meter/homematic.yaml
+++ b/templates/definition/meter/homematic.yaml
@@ -32,10 +32,19 @@ params:
     help:
       en: Homematic meter channel number like shown in the CCU web user interface.
       de: Kanalnummer des Messwertkanals, wie im CCU Webfrontend angezeigt.
+  - name: cache
+    advanced: true
+    default: 1s
+    description:
+      en: XML-RPC api cache duration - Default 1s. (valid units are s,m,h)
+      de: XML-RPC API Cache Zeitraum - Default 1s. (gültige Einheiten s,m,h)
+    help:
+      en: In case of duty cycle problems try a cache setting of 30s.
+      de: Bei Problemen mit dem Duty Cycle setze den Cache auf bspw 30s.
 render: |
   type: homematic
   usage: {{ .usage }}
-  uri: {{ .host }}:{{- if (eq .usage "grid") }}2001{{ else }}2010{{ end }}
+  uri: {{ .host }}:{{- if (eq .usage "grid") }}2001{{- else }}2010{{- end }}
   device: {{ .device }}
   meterchannel: {{ if (eq .usage "grid") }}1{{ else }}{{ .meterchannel }}{{ end }}
   {{- if .user }}
@@ -44,3 +53,6 @@ render: |
   {{- if .password }}
   password: {{ .password }}
   {{- end }}
+  {{- if .cache }}
+  cache: {{ .cache }}
+  {{- end }}
diff --git a/templates/docs/charger/homematic_0.yaml b/templates/docs/charger/homematic_0.yaml
index 99acaf077..66ad91b00 100644
--- a/templates/docs/charger/homematic_0.yaml
+++ b/templates/docs/charger/homematic_0.yaml
@@ -21,6 +21,7 @@ render:
       password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen) (Optional)
       meterchannel: 6 # Kanalnummer des Messwertkanals, wie im CCU Webfrontend angezeigt.
       switchchannel: 3 # Kanalnummer der schaltbaren Steckdose, wie im CCU Webfrontend angezeigt.
+      cache: 1s # Bei Problemen mit dem Duty Cycle setze den Cache auf bspw 30s. (Optional)
       standbypower: 15 # Leistung oberhalb des angegebenen Wertes wird als Ladeleistung gewertet (Optional)
       integrateddevice: # Optional
       icon: # Icon in der Benutzeroberfläche (Optional)
diff --git a/templates/docs/meter/homematic_0.yaml b/templates/docs/meter/homematic_0.yaml
index 6b8c0a333..384be2c5b 100644
--- a/templates/docs/meter/homematic_0.yaml
+++ b/templates/docs/meter/homematic_0.yaml
@@ -20,6 +20,7 @@ render:
       user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.) (Optional)
       password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen) (Optional)
       meterchannel: 6 # Kanalnummer des Messwertkanals, wie im CCU Webfrontend angezeigt.
+      cache: 1s # Bei Problemen mit dem Duty Cycle setze den Cache auf bspw 30s. (Optional)
   - usage: pv
     default: |
       type: template
@@ -38,6 +39,7 @@ render:
       user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.) (Optional)
       password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen) (Optional)
       meterchannel: 6 # Kanalnummer des Messwertkanals, wie im CCU Webfrontend angezeigt.
+      cache: 1s # Bei Problemen mit dem Duty Cycle setze den Cache auf bspw 30s. (Optional)
   - usage: charge
     default: |
       type: template
@@ -56,3 +58,4 @@ render:
       user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.) (Optional)
       password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen) (Optional)
       meterchannel: 6 # Kanalnummer des Messwertkanals, wie im CCU Webfrontend angezeigt.
+      cache: 1s # Bei Problemen mit dem Duty Cycle setze den Cache auf bspw 30s. (Optional)