Skip to content

Commit

Permalink
sg ready diagram
Browse files Browse the repository at this point in the history
  • Loading branch information
naltatis committed Jan 9, 2025
1 parent bb2917f commit a4ce117
Show file tree
Hide file tree
Showing 21 changed files with 964 additions and 1,035 deletions.
6 changes: 3 additions & 3 deletions docs/devices/chargers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import SponsorshipRequired from "/docs/_sponsorship_required.mdx";
import PhaseSwitchSupported from "/docs/_phase_switch_supported.mdx";
import DeviceConfig from "../../src/components/DeviceConfig";
import DeviceFeatures from "../../src/components/DeviceFeatures";
import DeviceFeatureFilter from "../../src/components/DeviceFeatureFilter";
import DeviceConfig from "/src/components/DeviceConfig";
import DeviceFeatures from "/src/components/DeviceFeatures";
import DeviceFeatureFilter from "/src/components/DeviceFeatureFilter";

# Wallboxen

Expand Down
55 changes: 49 additions & 6 deletions docs/devices/heating.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,20 +6,63 @@ import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import SponsorshipRequired from "/docs/_sponsorship_required.mdx";
import PhaseSwitchSupported from "/docs/_phase_switch_supported.mdx";
import DeviceConfig from "../../src/components/DeviceConfig";
import DeviceFeatures from "../../src/components/DeviceFeatures";
import DeviceFeatureFilter from "../../src/components/DeviceFeatureFilter";
import DeviceConfig from "/src/components/DeviceConfig";
import DeviceFeatures from "/src/components/DeviceFeatures";

# Wärmeerzeuger

:::warning Experimentell
Integration mit Wärmeerzeugern ist noch in der Erprobungsphase.
:::warning In Entwicklung
Das Thema Wärmeerzeugung ist noch in der Erprobungsphase.<br/>
Für die hier aufgeführten Geräte wird später ein [Sponsoring erforderlich](/docs/sponsorship) sein.
:::

evcc unterstützt unterschiedliche Arten von Wärmeerzeugern.
Einfache Geräte wie Heizlüfter oder Ventilatoren können über [Smarte Schalter](./smartswitches) ein/ausgeschaltet werden.
Auf dieser Seite erfährst du, wie du auch Wärmepumpen oder Heizstäbe regeln kannst.
Auf dieser Seite erfährst du wie du auch **Wärmepumpen** oder **Heizstäbe** regeln kannst.

## Wärmepumpen

Viele Wärmepumpen unterstützen das SG-Ready Modell um ihren Betrieb an die Energiesituation vor Ort anzupassen.
Neben dem **Normalbetrieb** kann darüber von außen ein **verstärkter Betrieb (Boost)** und ein **Sperrbetrieb (Dimming)** signalisiert werden.

Ist [Überschussstrom vorhanden](/docs/features/solar-charging) oder der [Netzstrom besonders günstig](/docs/features/dynamic-prices) bzw. [sauber](/docs/features/co2), kann evcc die Wärmepumpe anweisen, die Heizleistung zu erhöhen und in den **verstärkten Betrieb (Boost)** zu schalten.

Die Dimming-Funktion wird noch nicht unterstützt.
Wir planen dies über das [Lastmanagement](/docs/features/loadmanagement) zu integrieren.
Damit werden auch die Anforderungen für §14e EnWG abgedeckt.

### direkte Kommunikation

Viele moderne Wärmepumpen bieten API-Schnittstellen an, über die nicht nur der Betriebsmodus gesetzt, sondern auch der Zustand des Gerätes (z.B. Temperatur) abgefragt werden kann.
Unter [Wärmeerzeuger](#wärmeerzeuger) findest du eine Liste aller unterstützten Geräte.

Sollte deine Wärmepumpe eine Schnittstelle haben, die wir noch nicht unterstützen, erstelle gerne ein [GitHub Issue](https://github.com/evcc-io/evcc/issues) mit allen notwendigen Informationen.

### über Relais-Kontakte

Ältere Wärmepumpen verfügen häufig über SG-Ready Relais-Kontakte, über die der Betriebszustand (Normal, Boost, Dimming) signalisiert werden kann.
In unserem Beispiel konzentrieren wir uns auf den Wechsel zwischen Normal- und Boostbetrieb.
Hierfür wird ein steuerbares Relais verwendet, bpsw. ein Shelly 1.
Dieses Relais wird mit den ensprechenden SG-Ready Kontakten der Wärmepumpe verbunden.
Die genaue Verkablung hängt vom Gerät ab und sollte in Absprache dem Installateur erfolgen.
Ist PV-Überschuss oder günstige Energie vorhanden schaltet evcc das Relais und gibt der Wärmepumpe das Signal für den verstärkten Betrieb (Boost).

![Diagram für die Steuerung einer Wärmepumpe über ein SG-ReadyRelais](./heating/sgready.svg)

Möchtest du die Leistung und den Energieverbrauch der Wärmepumpe erfassen, kannst du optional einen Zähler an der Stromversorgung des Geräts installieren.
Im Diagram ist ein Shelly 3EM dargestellt, hier kann aber ein beliebiger [Wallbox-Zähler](./meters) verwendet werden.

## Heizstäbe

Bei Heizstäben gibt evcc die aktuell verfügbare Leistung an das Gerät weiter.
Diese verfügbare Leistung wird, analog zum Ladevorgang eines Fahrzeuges, permanent an die aktuelle Situation angepasst.

evcc bietet einstellbare Limits an, mit denen du deine Wunschtemperatur einstellen kannst.
Dies darf aber nicht als Sicherheitsfunktion verstanden werden.

:::danger
Dein Heizstab muss eine eigene Temperaturlimitierung mitbringen, die bei einer Fehlfunktion von evcc eine Überhitzung verhindert.
:::

---

Expand Down
1 change: 1 addition & 0 deletions docs/devices/heating/sgready.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 3 additions & 3 deletions docs/devices/meters.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ sidebar_position: 4

import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import DeviceFeatures from "../../src/components/DeviceFeatures";
import DeviceFeatureFilter from "../../src/components/DeviceFeatureFilter";
import DeviceConfig from "../../src/components/DeviceConfig";
import DeviceFeatures from "/src/components/DeviceFeatures";
import DeviceFeatureFilter from "/src/components/DeviceFeatureFilter";
import DeviceConfig from "/src/components/DeviceConfig";
import SponsorshipRequired from "/docs/_sponsorship_required.mdx";

# PV, Batterie, Netz
Expand Down
6 changes: 3 additions & 3 deletions docs/devices/smartswitches.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import SponsorshipRequired from "/docs/_sponsorship_required.mdx";
import PhaseSwitchSupported from "/docs/_phase_switch_supported.mdx";
import DeviceConfig from "../../src/components/DeviceConfig";
import DeviceFeatures from "../../src/components/DeviceFeatures";
import DeviceFeatureFilter from "../../src/components/DeviceFeatureFilter";
import DeviceConfig from "/src/components/DeviceConfig";
import DeviceFeatures from "/src/components/DeviceFeatures";
import DeviceFeatureFilter from "/src/components/DeviceFeatureFilter";

# Smarte Schalter

Expand Down
2 changes: 1 addition & 1 deletion docs/devices/vehicles.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ sidebar_position: 5
import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import SponsorshipRequired from "/docs/_sponsorship_required.mdx";
import DeviceConfig from "../../src/components/DeviceConfig";
import DeviceConfig from "/src/components/DeviceConfig";

# Fahrzeuge

Expand Down
2 changes: 1 addition & 1 deletion docs/features/co2.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ tariffs:
```
In diesem Beispiel verwenden wir die Daten von [GrünstromIndex.de](https://www.gruenstromindex.de/).
Unter [Stromtarife](../devices/tariffs) findest du eine Liste aller unterstützten Datenquellen.
Unter [Stromtarife](../tariffs) findest du eine Liste aller unterstützten Datenquellen.
## Sauberes Netzladen
Expand Down
2 changes: 1 addition & 1 deletion docs/features/dynamic-prices.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ tariffs:
token: "..." # Access Token
```

Unter [Stromtarife](../devices/tariffs) findest du eine Liste aller unterstützten Tarife.
Unter [Stromtarife](../tariffs) findest du eine Liste aller unterstützten Tarife.
Wenn dein Anbieter eine Schnittstelle hat, aber noch nicht von evcc unterstützt wird, dann mach gerne einen [Feature Request](https://github.com/evcc-io/evcc/issues/new/choose) auf.

## Günstiges Netzladen
Expand Down
2 changes: 1 addition & 1 deletion docs/tariffs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ sidebar_position: 5

import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import DeviceConfig from "../src/components/DeviceConfig";
import DeviceConfig from "/src/components/DeviceConfig";


# Stromtarife
Expand Down
5 changes: 4 additions & 1 deletion docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,9 @@ import { themes as prismThemes } from "prism-react-renderer";
organizationName: "evcc-io", // Usually your GitHub org/user name.
projectName: "docs", // Usually your repo name.
trailingSlash: false,
markdown: {
mermaid: true,
},
i18n: {
defaultLocale: "de",
locales: ["de", "en"],
Expand Down Expand Up @@ -55,7 +58,7 @@ import { themes as prismThemes } from "prism-react-renderer";
}),
],
],

themes: ["@docusaurus/theme-mermaid"],
themeConfig:
/** @type {import('@docusaurus/preset-classic').ThemeConfig} */
({
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@ sidebar_position: 1

import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import SponsorshipRequired from "../_sponsorship_required.mdx";
import PhaseSwitchSupported from "../_phase_switch_supported.mdx";
import DeviceConfig from "../../../../../src/components/DeviceConfig";
import DeviceFeatures from "../../../../../src/components/DeviceFeatures";
import DeviceFeatureFilter from "../../../../../src/components/DeviceFeatureFilter";
import SponsorshipRequired from "/docs/_sponsorship_required.mdx";
import PhaseSwitchSupported from "/docs/_phase_switch_supported.mdx";
import DeviceConfig from "/src/components/DeviceConfig";
import DeviceFeatures from "/src/components/DeviceFeatures";
import DeviceFeatureFilter from "/src/components/DeviceFeatureFilter";

# Chargers

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,14 @@ import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import SponsorshipRequired from "/docs/_sponsorship_required.mdx";
import PhaseSwitchSupported from "/docs/_phase_switch_supported.mdx";
import DeviceConfig from "../../src/components/DeviceConfig";
import DeviceFeatures from "../../src/components/DeviceFeatures";
import DeviceFeatureFilter from "../../src/components/DeviceFeatureFilter";
import DeviceConfig from "/src/components/DeviceConfig";
import DeviceFeatures from "/src/components/DeviceFeatures";

# Heating

:::warning Experimentell
Integration mit Wärmeerzeugern ist noch in der Erprobungsphase.
Für die hier aufgeführten Geräte wird später ein **[Sponsoring](/docs/sponsoring) erforderlich** sein.
Für die hier aufgeführten Geräte wird später ein **[Sponsoring](/docs/sponsorship) erforderlich** sein.
:::

evcc unterstützt unterschiedliche Arten von Wärmeerzeugern.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ sidebar_position: 2

import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import DeviceConfig from "../../../../../src/components/DeviceConfig";
import DeviceFeatures from "../../../../../src/components/DeviceFeatures";
import DeviceFeatureFilter from "../../../../../src/components/DeviceFeatureFilter";
import SponsorshipRequired from "../_sponsorship_required.mdx";
import DeviceConfig from "/src/components/DeviceConfig";
import DeviceFeatures from "/src/components/DeviceFeatures";
import DeviceFeatureFilter from "/src/components/DeviceFeatureFilter";
import SponsorshipRequired from "/docs/_sponsorship_required.mdx";

# PV, Battery, Grid

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@ sidebar_position: 1

import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import SponsorshipRequired from "../_sponsorship_required.mdx";
import PhaseSwitchSupported from "../_phase_switch_supported.mdx";
import DeviceConfig from "../../../../../src/components/DeviceConfig";
import DeviceFeatures from "../../../../../src/components/DeviceFeatures";
import DeviceFeatureFilter from "../../../../../src/components/DeviceFeatureFilter";
import SponsorshipRequired from "/docs/_sponsorship_required.mdx";
import PhaseSwitchSupported from "/docs/_phase_switch_supported.mdx";
import DeviceConfig from "/src/components/DeviceConfig";
import DeviceFeatures from "/src/components/DeviceFeatures";
import DeviceFeatureFilter from "/src/components/DeviceFeatureFilter";

# Smart Switches

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@ sidebar_position: 3

import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import SponsorshipRequired from "../_sponsorship_required.mdx";
import DeviceConfig from "../../../../../src/components/DeviceConfig";
import SponsorshipRequired from "/docs/_sponsorship_required.mdx";
import DeviceConfig from "/src/components/DeviceConfig";


# Vehicles
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ tariffs:
```
In this example, we'll use data from GrünstromIndex.
See [tariffs](../devices/tariffs) for a list of all supported data sources.
See [tariffs](../tariffs) for a list of all supported data sources.
## Clean web charging
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ tariffs:
token: "..." # Access Token
```

You can find a list of all supported tariffs under [tariffs](../devices/tariffs).
You can find a list of all supported tariffs under [tariffs](../tariffs).
If your provider has an interface but is not yet supported by evcc, please submit a [Feature Request](https://github.com/evcc-io/evcc/issues/new/choose).

## Cheap grid charging
Expand Down
2 changes: 1 addition & 1 deletion i18n/en/docusaurus-plugin-content-docs/current/tariffs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ sidebar_position: 4

import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
import DeviceConfig from "../../../../src/components/DeviceConfig";
import DeviceConfig from "/src/components/DeviceConfig";


# Tariffs
Expand Down
Loading

0 comments on commit a4ce117

Please sign in to comment.