Skip to content

Commit 1bf47ec

Browse files
authored
Docs: sgready-boost (#819)
1 parent ec1c711 commit 1bf47ec

File tree

2 files changed

+14
-104
lines changed

2 files changed

+14
-104
lines changed

docs/devices/heating.mdx

Lines changed: 7 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ Dies empfiehlt sich eigentlich fast immer, da die intern ermittelten Daten bei d
6060
Im Diagram ist ein Shelly 3EM dargestellt, hier kann aber ein beliebiger [Zähler](./meters) verwendet werden.
6161

6262
Dieses Code-Beispiel zeigt, wie du eine Wärmepumpe mittels Shelly 1 und Shelly 3EM konfigurieren kannst.
63-
Dafür kommt der spezielle Typ `sgready` zum Einsatz.
63+
Dafür kommt der spezielle Typ `sgready-boost` zum Einsatz.
6464

6565
```yaml
6666
loadpoints:
@@ -84,64 +84,19 @@ meters:
8484

8585
chargers:
8686
- name: heatpump_control
87-
type: sgready
88-
setmode:
89-
source: switch
90-
switch:
91-
- case: 1 # dimm (not supported, yet)
92-
set:
93-
source: error
94-
error: ErrNotAvailable
95-
- case: 2 # normal
96-
set:
97-
# Hier wird der Funktionsaufruf eingefügt, der die Heizung in den Normalbetrieb setzt.
98-
# Dafür können alle üblichen Plugins verwendet werden.
99-
source: const
100-
value: false
101-
set:
102-
source: charger
103-
config:
104-
type: template
105-
template: shelly # Boost-Kontakt der Wärmepumpe
106-
host: 192.168.0.101
107-
- case: 3 # boost
108-
set:
109-
# Hier wird der Funktionsaufruf eingefügt, der die Heizung in den Boostbetrieb setzt.
110-
source: const
111-
value: true
112-
set:
113-
source: charger
114-
config:
115-
type: template
116-
template: shelly # Boost-Kontakt der Wärmepumpe
117-
host: 192.168.0.101
118-
getmode:
119-
# hier wird der Funktionsaufruf eingefügt, der den Status der Heizung zurückmeldet:
120-
# 1 für reduzierte Leistung
121-
# 2 für Normalbetrieb
122-
# 3 für Boostbetrieb
123-
source: calc
124-
add:
125-
- source: const
126-
value: 2
127-
- source: charger
128-
config:
129-
type: template
130-
template: shelly # Boost-Kontakt der Wärmepumpe
131-
host: 192.168.0.101
87+
type: sgready-boost
88+
charger:
89+
type: template
90+
template: shelly # Boost-Kontakt der Wärmepumpe
91+
host: 192.168.0.101
13292
# temp:
13393
# source: http
13494
# uri: "http://192.168.0.103/temperature"
13595

13696
# [...]
13797
```
13898

139-
:::note
140-
Dieses Code-Beispiel enthält einige Redundanzen.
141-
Wir werden später Templates für die einfachere Konfiguration gängiger Konstellationen bereitstellen.
142-
:::
143-
144-
Neben `setmode` und `getmode`, kannst du optional auch die aktuelle Temperatur (`temp`) [via Plugin](./plugins) hinzufügen.
99+
Optional kannst du auch die aktuelle Temperatur (`temp`) [via Plugin](./plugins) hinzufügen.
145100
Diese dient lediglich zur Anzeige und wird bei Wärmepumpen nicht für die Steuerung verwendet.
146101

147102
## Heizstäbe

i18n/en/docusaurus-plugin-content-docs/current/devices/heating.mdx

Lines changed: 7 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ If you want to monitor the power and energy consumption of the heat pump, you ca
5757
In the diagram, a Shelly 3EM is shown, but any [meter](./meters) can be used.
5858

5959
This example shows how to configure a heat pump using a Shelly 1 and a Shelly 3EM.
60-
The special type `sgready` is used for this.
60+
The special type `sgready-boost` is used for this.
6161

6262
```yaml
6363
loadpoints:
@@ -79,64 +79,19 @@ meters:
7979

8080
chargers:
8181
- name: heatpump_control
82-
type: sgready
83-
setmode:
84-
source: switch
85-
switch:
86-
- case: 1 # dimm (not supported, yet)
87-
set:
88-
source: error
89-
error: ErrNotAvailable
90-
- case: 2 # normal
91-
set:
92-
source: const
93-
value: false
94-
set:
95-
# Add the function here to set the heatpump in normal operation mode.
96-
# All types of plugins can be used.
97-
source: charger
98-
config:
99-
type: template
100-
template: shelly # Boost contact of the heat pump
101-
host: 192.168.0.101
102-
- case: 3 # boost
103-
set:
104-
# Add the function here to set the heatpump in boost mode.
105-
source: const
106-
value: true
107-
set:
108-
source: charger
109-
config:
110-
type: template
111-
template: shelly # Boost contact of the heat pump
112-
host: 192.168.0.101
113-
getmode:
114-
# Add function here to get the current mode of the heatpump, return
115-
# 1 for reduced operation
116-
# 2 for normal operation
117-
# 3 for boost operation
118-
source: calc
119-
add:
120-
- source: const
121-
value: 2
122-
- source: charger
123-
config:
124-
type: template
125-
template: shelly # Boost contact of the heat pump
126-
host: 192.168.0.101
82+
type: sgready-boost
83+
charger:
84+
type: template
85+
template: shelly # Boost contact of the heat pump
86+
host: 192.168.0.101
12787
# temp:
12888
# source: http
12989
# uri: "http://192.168.0.103/temperature"
13090

13191
# [...]
13292
```
13393

134-
:::note
135-
This code example contains some redundancies.
136-
We will later provide templates for easier configuration of common hardware constellations.
137-
:::
138-
139-
In addition to `setmode` and `getmode`, you can optionally add the current temperature (`temp`) [via Plugin](./plugins).
94+
You can optionally add the current temperature (`temp`) [via Plugin](./plugins).
14095
This is only used for display.
14196
evcc does not use this value for regulation.
14297

0 commit comments

Comments
 (0)