From b3d5ec35f416deb5e62444020b095e555f7c242f Mon Sep 17 00:00:00 2001 From: Michael Geers Date: Fri, 13 Jun 2025 12:34:15 +0200 Subject: [PATCH 1/2] Docs: sgready-boost --- docs/devices/heating.mdx | 59 +++---------------- .../current/devices/heating.mdx | 57 ++---------------- 2 files changed, 13 insertions(+), 103 deletions(-) diff --git a/docs/devices/heating.mdx b/docs/devices/heating.mdx index b4c414e56f..38de42f5ea 100644 --- a/docs/devices/heating.mdx +++ b/docs/devices/heating.mdx @@ -60,7 +60,7 @@ Dies empfiehlt sich eigentlich fast immer, da die intern ermittelten Daten bei d Im Diagram ist ein Shelly 3EM dargestellt, hier kann aber ein beliebiger [Zähler](./meters) verwendet werden. Dieses Code-Beispiel zeigt, wie du eine Wärmepumpe mittels Shelly 1 und Shelly 3EM konfigurieren kannst. -Dafür kommt der spezielle Typ `sgready` zum Einsatz. +Dafür kommt der spezielle Typ `sgready-boost` zum Einsatz. ```yaml loadpoints: @@ -84,51 +84,11 @@ meters: chargers: - name: heatpump_control - type: sgready - setmode: - source: switch - switch: - - case: 1 # dimm (not supported, yet) - set: - source: error - error: ErrNotAvailable - - case: 2 # normal - set: - # Hier wird der Funktionsaufruf eingefügt, der die Heizung in den Normalbetrieb setzt. - # Dafür können alle üblichen Plugins verwendet werden. - source: const - value: false - set: - source: charger - config: - type: template - template: shelly # Boost-Kontakt der Wärmepumpe - host: 192.168.0.101 - - case: 3 # boost - set: - # Hier wird der Funktionsaufruf eingefügt, der die Heizung in den Boostbetrieb setzt. - source: const - value: true - set: - source: charger - config: - type: template - template: shelly # Boost-Kontakt der Wärmepumpe - host: 192.168.0.101 - getmode: - # hier wird der Funktionsaufruf eingefügt, der den Status der Heizung zurückmeldet: - # 1 für reduzierte Leistung - # 2 für Normalbetrieb - # 3 für Boostbetrieb - source: calc - add: - - source: const - value: 2 - - source: charger - config: - type: template - template: shelly # Boost-Kontakt der Wärmepumpe - host: 192.168.0.101 + type: sgready-boost + charger: + type: template + template: shelly # Boost-Kontakt der Wärmepumpe + host: 192.168.0.101 # temp: # source: http # uri: "http://192.168.0.103/temperature" @@ -136,12 +96,7 @@ chargers: # [...] ``` -:::note -Dieses Code-Beispiel enthält einige Redundanzen. -Wir werden später Templates für die einfachere Konfiguration gängiger Konstellationen bereitstellen. -::: - -Neben `setmode` und `getmode`, kannst du optional auch die aktuelle Temperatur (`temp`) [via Plugin](./plugins) hinzufügen. +Optional kannst du auch die aktuelle Temperatur (`temp`) [via Plugin](./plugins) hinzufügen. Diese dient lediglich zur Anzeige und wird bei Wärmepumpen nicht für die Steuerung verwendet. ## Heizstäbe diff --git a/i18n/en/docusaurus-plugin-content-docs/current/devices/heating.mdx b/i18n/en/docusaurus-plugin-content-docs/current/devices/heating.mdx index bbd05e2cf1..26f25baf9b 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/devices/heating.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/devices/heating.mdx @@ -79,51 +79,11 @@ meters: chargers: - name: heatpump_control - type: sgready - setmode: - source: switch - switch: - - case: 1 # dimm (not supported, yet) - set: - source: error - error: ErrNotAvailable - - case: 2 # normal - set: - source: const - value: false - set: - # Add the function here to set the heatpump in normal operation mode. - # All types of plugins can be used. - source: charger - config: - type: template - template: shelly # Boost contact of the heat pump - host: 192.168.0.101 - - case: 3 # boost - set: - # Add the function here to set the heatpump in boost mode. - source: const - value: true - set: - source: charger - config: - type: template - template: shelly # Boost contact of the heat pump - host: 192.168.0.101 - getmode: - # Add function here to get the current mode of the heatpump, return - # 1 for reduced operation - # 2 for normal operation - # 3 for boost operation - source: calc - add: - - source: const - value: 2 - - source: charger - config: - type: template - template: shelly # Boost contact of the heat pump - host: 192.168.0.101 + type: sgready-boost + charger: + type: template + template: shelly # Boost contact of the heat pump + host: 192.168.0.101 # temp: # source: http # uri: "http://192.168.0.103/temperature" @@ -131,12 +91,7 @@ chargers: # [...] ``` -:::note -This code example contains some redundancies. -We will later provide templates for easier configuration of common hardware constellations. -::: - -In addition to `setmode` and `getmode`, you can optionally add the current temperature (`temp`) [via Plugin](./plugins). +You can optionally add the current temperature (`temp`) [via Plugin](./plugins). This is only used for display. evcc does not use this value for regulation. From d6498e6c0f0290b71a49bc94a7b27e52094100f4 Mon Sep 17 00:00:00 2001 From: Michael Geers Date: Fri, 13 Jun 2025 12:35:34 +0200 Subject: [PATCH 2/2] wip --- .../docusaurus-plugin-content-docs/current/devices/heating.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/en/docusaurus-plugin-content-docs/current/devices/heating.mdx b/i18n/en/docusaurus-plugin-content-docs/current/devices/heating.mdx index 26f25baf9b..a805b0084a 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/devices/heating.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/devices/heating.mdx @@ -57,7 +57,7 @@ If you want to monitor the power and energy consumption of the heat pump, you ca In the diagram, a Shelly 3EM is shown, but any [meter](./meters) can be used. This example shows how to configure a heat pump using a Shelly 1 and a Shelly 3EM. -The special type `sgready` is used for this. +The special type `sgready-boost` is used for this. ```yaml loadpoints: