diff --git a/blog/2023-10-05/feature-highlights-10-2023.mdx b/blog/2023-10-05/feature-highlights-10-2023.mdx index 7dc2c7e42..b4820191b 100644 --- a/blog/2023-10-05/feature-highlights-10-2023.mdx +++ b/blog/2023-10-05/feature-highlights-10-2023.mdx @@ -34,8 +34,8 @@ Seit einigen Releases ist der Algorithmus keine Blackbox, da wir das Planungserg Zur Funktionsweise des Algorithmus: 1. Überschüssige Sonnenenergie wird priorisiert -2. Zeiten mit günstigem Netzstrom (wenn [dynamischer Stromtarif](/docs/reference/configuration/tariffs#type-awattar) existiert) -3. Zeiten mit sauberem Netzstrom (wenn [CO₂-Schnittstelle](/docs/reference/configuration/tariffs#co2) konfiguriert ist) +2. Zeiten mit günstigem Netzstrom (wenn [dynamischer Stromtarif](/docs/features/dynamic-prices) existiert) +3. Zeiten mit sauberem Netzstrom (wenn [CO₂-Schnittstelle](/docs/features/co2) konfiguriert ist) 4. Zeitfenster kurz vor Abfahrt **Ausblick:** Aktuell experimentieren wir mit PV-Prognosedaten von [Solcast](https://solcast.com/). diff --git a/docs/devices/tariffs.mdx b/docs/devices/tariffs.mdx index dfec30563..02751d934 100644 --- a/docs/devices/tariffs.mdx +++ b/docs/devices/tariffs.mdx @@ -65,6 +65,75 @@ From To Price/Cost ... ``` +## Börsenstrompreise + +Du hast einen Vertrag der nach Börsenpreisen berechnet wird? +Für viele Anbieter haben wir eine eigene Schnittstelle angebunden (z.B. [Awattar](#awattar) oder [Tibber](#tibber)). +Die Liste aller verfügbaren Anbieter findest du im Abschnitt [Dynamischer Strompreis](#dynamischer-strompreis). + +### Gebühren und Steuern + +Falls dein Anbieter nicht dabei ist, kannst du deinen Tarif auf Basis der Day-Ahead-Preise der europäischen Strombörse selbst berechnen. +Die [Energy-Charts API](https://www.energy-charts.info/charts/price_spot_market/chart.htm) vom Fraunhofer ISE liefert aktuelle und prognostizierte Preise. +Diese werden von fast allen Anbietern als Grundlage für die Berechnung ihrer Energiepreise verwendet. + +```yaml +tariffs: + grid: + type: template + template: energy-charts-api + bzn: DE-LU # Gebotszone, siehe https://api.energy-charts.info/#/prices/day_ahead_price_price_get + charges: 0.22 # Fester Aufschlag pro kWh (z.B. 20ct Netzentgelt, 2ct Gebühren) + tax: 0.19 # Prozentualer Aufschlag (z.B. 19% MwSt.) +``` + +Die Schnittstelle liefert die Börsenpreise in Euro ohne lokale Gebühren oder Steuern. +Mit den Parametern `charges` und `tax` kannst du einen zusätzlichen festen und prozentualen Aufschlag pro kWh definieren. +Die genauen Werte kannst du deinem Vertrag entnehmen. + +### Eigene Berechnungsformeln + +Falls das Modell des festen und prozentualen Aufschlags nicht ausreicht, kannst du eine individuelle Formel definieren. +Verwende dafür den `formula` Parameter. + +```yaml +tariffs: + grid: + type: template + template: energy-charts-api + bzn: DE-LU + charges: 0.22 # Fester Aufschlag pro kWh + tax: 0.19 # Prozentualer Aufschlag + formula: math.Min(0.5, (price + charges) * (1 + tax)) +``` + +Im obigen Beispiel wird eine Preisobergrenze von 50 ct/kWh definiert. +Die Formel wird in Go-Syntax geschrieben. +Neben den Werten `price`, `charges` und `tax` steht dir die [`math`-Bibliothek](https://pkg.go.dev/math) zur Verfügung. + +### Börsenpreise mit Zeitkomponente + +Die Formel wird für den aktuellen Strompreis und jeden Zeitslot in der Prognose ausgeführt. +Ist die Berechnung zeitabhängig, kannst du über `ts` auch auf die [Zeit](https://pkg.go.dev/time#Time) des jeweiligen Slots zugreifen. + +```yaml +tariffs: + grid: + type: template + template: energy-charts-api + bzn: DE-LU + formula: extra := 0.1; if ts.Hour() < 6 || ts.Hour() > 22 { extra = 0.0 }; price + extra +``` + +In diesem Beispiel gibt es einen Aufschlag von 10 ct/kWh. +In der Zeit von 22:00 Uhr bis 06:00 Uhr wird kein Aufschlag berechnet. +Der Fantasie sind hier keine Grenzen gesetzt. + +Der `formula` Mechanismus funktioniert auch für viele andere Datenquellen. +Schau dir die Konfigurationsoptionen der jeweiligen Quellen an. + +Der CLI Befehl `evcc tariff` ist hilfreich um die Berechnungsergebnisse zu überprüfen. + diff --git a/docs/features/co2.mdx b/docs/features/co2.mdx index ee39261b8..d09d04373 100644 --- a/docs/features/co2.mdx +++ b/docs/features/co2.mdx @@ -26,8 +26,8 @@ tariffs: zip: 12349 # Deine Postleitzahl ``` -In diesem Beispiel verwenden wir die Daten von [GrünstromIndex](https://www.gruenstromindex.de/). -Unter [tariffs](../devices/tariffs) findest du eine Liste aller unterstützten Datenquellen. +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. ## Sauberes Netzladen diff --git a/docs/features/dynamic-prices.mdx b/docs/features/dynamic-prices.mdx index ab8588874..0a007560c 100644 --- a/docs/features/dynamic-prices.mdx +++ b/docs/features/dynamic-prices.mdx @@ -57,7 +57,7 @@ tariffs: token: "..." # Access Token ``` -Unter [tariffs](../devices/tariffs) findest du eine Liste aller unterstützten Tarife. +Unter [Stromtarife](../devices/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 diff --git a/docs/reference/configuration/messaging.md b/docs/reference/configuration/messaging.md index 23b9474c5..104b018ee 100644 --- a/docs/reference/configuration/messaging.md +++ b/docs/reference/configuration/messaging.md @@ -148,8 +148,8 @@ Die von evcc bereitgestellten Variablen (siehe auch /api/state) müssen als rege - `pvConfigured` - Indikator, Solaranlagen/Photovoltaik-Meter konfiguriert (_bool_) - Infos zum Stromtarif - [`currency`](tariffs) - Tarif-Währung (_string_) - - [`tariffFeedIn`](tariffs#feedin) - PV-Einspeisevergütung pro kWh in der Tarif-Währung (float) - - [`tariffGrid`](tariffs#grid) - Netz-Abnahmepreis pro kWh in der Tarif-Währung (float) + - [`tariffFeedIn`](tariffs) - PV-Einspeisevergütung pro kWh in der Tarif-Währung (float) + - [`tariffGrid`](tariffs) - Netz-Abnahmepreis pro kWh in der Tarif-Währung (float) - Meter Infos - `batteryPower` - Aktuelle Hausbatterie/Powerwall-Leistung in Watt (_float_) - `batterySoc` - Aktueller Füllstand der Hausbatterie/Powerwall in Prozent (_integer_) @@ -240,7 +240,6 @@ Im folgenden werden nun alle erforderlichen Parameter erklärt. - `ntfy`: [ntfy](https://ntfy.sh). Siehe [`ntfy`](#ntfy) Definition - `custom`: Ermöglicht die Nutzung von allen [Plugins](../plugins), die einen Schreibzugriff erlauben. Siehe [`custom`](#custom) Definition. - --- ## Unterstützte Dienste @@ -339,13 +338,14 @@ Der Typ `custom` ermöglicht es, beliebige [Plugins](../plugins) für die Verarb **Mögliche Werte**: -* `send`: Definiert das zu verwendende Plugin mit dem Feld `source` und plugin-spezifische Parameter. Siehe das Beispiel weiter unten. -* `encoding`: Definiert das Format, in dem der Wert für `${send}` bereitgestellt wird. Die möglichen Werte sind: +- `send`: Definiert das zu verwendende Plugin mit dem Feld `source` und plugin-spezifische Parameter. Siehe das Beispiel weiter unten. +- `encoding`: Definiert das Format, in dem der Wert für `${send}` bereitgestellt wird. Die möglichen Werte sind: + - `json`: Der Wert wird als JSON-Objekt im Format `{ "msg": msg, "title": title }` bereitgestellt. Das Feld `title` wird nur hinzugefügt, wenn es im Abschnitt `events` definiert ist. - `csv`: Die Felder `title` und `msg` werden als kommaseparierte Liste bereitgestellt (`title, msg`) - `tsv`: Ähnlich wie `csv`, jedoch mit Tabulator als Trennzeichen. - `title`: Nur der Titel (`title`) wird bereitgestellt. - + Wenn `encoding` nicht definiert ist, wird die Nachricht `msg` ohne Titel direkt verwendet. Dabei wird nur die in `msg` definierte Nachricht ohne Titel in `${send}` verwendet. **Beispiel**: @@ -362,7 +362,7 @@ messaging: send: # Plugin Typ source: script - # Plugin-spezifische Konfiguration. + # Plugin-spezifische Konfiguration. # {{.send}} enthält die JSON Nachricht cmd: /usr/local/bin/evcc_message "{{.send}}" ``` diff --git a/docs/reference/configuration/tariffs.md b/docs/reference/configuration/tariffs.md index a5675d796..ccfcb4fda 100644 --- a/docs/reference/configuration/tariffs.md +++ b/docs/reference/configuration/tariffs.md @@ -4,9 +4,9 @@ sidebar_position: 11 # `tariffs` -Hier kannst du deinen Energietarif und ggf. deine Einspeisevergütung angeben. Evcc verwendet diese Werte für eine grobe [Einsparungsberechnung](/docs/faq#ersparnisberechnung), die in der Web-UI angezeigt wird. - -Desweiteren nutzt der Planner diese Einstellungen für Preis- bzw. CO2-optimiertes Zielladen. Dabei werden die Einstellungen in der folgenden Reihenfolge berücksichtigt: "flexibler Grid-Tarif" vor "CO2 Tarif" vor "konstantem Grid-Tarif". +Hier kannst du deinen Energietarif und gegebenenfalls deine Einspeisevergütung angeben. +evcc verwendet diese Werte für eine grobe [Einsparungsberechnung](/docs/faq#ersparnisberechnung), die in der Web-UI angezeigt wird. +Diese Daten werden auch vom [Planer](/docs/features/plans) für preis- und CO₂-optimiertes Laden verwendet. **Struktur** @@ -36,355 +36,4 @@ tariffs: price: 0.08 # [currency]/kWh ``` -**Beispiel: Konstanter Energiepreis mit zeitabhängigen Tarifen** - -::: info -Tagesübergreifende Zeitbereiche müssen um Mitternacht (= 0) geteilt werden. -Es sind zwei Einträge (z.B. 20-0 und 0-5) notwendig. -::: - -```yaml -tariffs: - currency: EUR # (default EUR) - grid: - # static grid price with price zones) - type: fixed - price: 0.294 # EUR/kWh - zones: - - days: Mo-Fr - hours: 20-0 - price: 0.2 # EUR/kWh - - days: Sa,So - price: 0.15 # EUR/kWh -``` - -evcc unterstützt die Verwendung von flexiblen Stromtarifen von [Awattar](https://www.awattar.de), [Tibber](https://tibber.com), oder [Octopus Energy](https://octopus.energy). Die Konfiguration erlaubt es "günstige" Preise zu definieren (siehe `smartCostLimit` in site), bei welchen das Laden vom Netz mit der maximal möglichen Leistung aktiviert wird, selbst wenn nicht genug PV Leistung zur Verfügung steht. - -**Beispiel: Flexibler Energiepreis** - -```yaml -tariffs: - grid: - # either - type: tibber - token: "476c477d8a039529478ebd690d35ddd80e3308ffc49b59c65b142321aee963a4" # access token - homeid: "cc83e83e-8cbf-4595-9bf7-c3cf192f7d9c" # optional if multiple homes associated to account - - # or - type: awattar - region: de # optional, choose at for Austria - charges: 0 # optional, additional charges per kWh - tax: 0 # optional, additional tax (0.1 for 10%) -``` - -Im Folgenden werden nun alle möglichen Parameter erklärt. - ---- - -## `currency` - -Währung in der Energiepreise dargestellt und berechnet werden. - -**Standardwert:** `EUR` - -**Mögliche Werte:** `EUR|CHF|USD|NOK|GBP|...` Währungskürzel nach [ISO 4217](https://de.wikipedia.org/wiki/ISO_4217) - ---- - -## `grid` - -Folgende Tariftypen (`type`) werden unterstützt: - -**Mögliche Werte** `fixed|custom|awattar|tibber|octopusenergy` - ---- - -### `type:` **`fixed`** - -Fester Energiepreis für Netzbezug. - -**Beispiel**: - -```yaml -type: fixed -price: 0.297 # 0,297 [currency]/kWh -``` - -### `type:` **`custom`** - -Fester Energiepreis für Netzbezug, der per Plugin gesetzt werden kann - -**Beispiel**: - -```yaml -type: custom -price: - source: ... -``` - -#### `price` - -Den Preis in [currency]/kWh den du an deinen Stromversorger zahlst. Wird für die Ersparnisberechnung verwendet. - -**Standardwert:** `0.30` - ---- - -### `type:` **`awattar`** - -Der Stromanbieter [Awattar](https://www.awattar.de) - -**Beispiel**: - -```yaml -type: awattar -region: de # optional -charges: 0 # optional, additional charges per kWh -tax: 0 # optional, additional tax (0.1 for 10%) -``` - -#### `region` - -Die Region in der man sich befindet - -**Mögliche Werte**: - -- **`de`**: Deutschland -- **`at`**: Österreich - ---- - -### `type:` **`tibber`** - -Der Stromanbieter [Tibber](https://www.tibber.com) - -**Beispiel**: - -```yaml -type: tibber -token: "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef" -homeid: "12345678-90ab-cdef-1234-567890abcdef" # optional -``` - -#### `token` - -Das Zugangstoken des Anbieters - -#### `homeid` - -Die ID des Standortes, falls es unter dem Account mehrere gibt - ---- - -### `type:` **`octopusenergy`** - -Der Stromanbieter [Octopus Energy](https://octopus.energy) im Vereinigten Königreich. - -:::tip Tarif- und Regionalcodes -Das Ermitteln des Tarif- und Regionalcodes ist nicht Gegenstand dieser Dokumentation. -::: - -**Beispiel**: - -```yaml -type: octopusenergy -tariff: AGILE-FLEX-22-11-25 # Tariff code -region: A # optional -``` - -#### `tariff` - -Der Tarifcode für deinen Energievertrag. - -#### `region` - -Die DNO Region in der du dich befindest: [Weitere Informationen](https://www.energy-stats.uk/dno-region-codes-explained/) - -**Mögliche Werte**: - -- **`A`**: Eastern England -- **`B`**: East Midlands -- **`C`**: London -- **`D`**: Merseyside and Northern Wales -- **`E`**: West Midlands -- **`F`**: North Eastern England -- **`G`**: North Western England -- **`H`**: Southern England -- **`J`**: South Eastern England -- **`K`**: Southern Wales -- **`L`**: South Western England -- **`M`**: Yorkshire -- **`N`**: Southern Scotland -- **`P`**: Northern Scotland - ---- - -### `type:` **`elering`** - -Der Stromanbieter [Nordpool Estonia](https://elering.ee) in Estland. - -**Beispiel**: - -```yaml -type: elering # Nordpool -region: ee # or lt, lv, fi -charges: # optional, additional charges per kWh -tax: # optional, additional tax (0.1 for 10%) -``` - ---- - -### `type:` **`energinet`** - -Der Stromanbieter [Energinet](https://energinet.dk) in Dänemark. - -**Beispiel**: - -```yaml -type: energinet # Energinet using the price in DKK -region: dk1 # or dk2 -charges: # optional, additional charges per kWh -tax: # optional, additional tax (0.1 for 10%) -``` - ---- - -### `type:` **`ENTSO-E`** - -European market date - -**Beispiel**: - -```yaml -type: entsoe # Entso-E european market data -domain: BZN|DE-LU # https://transparency.entsoe.eu/content/static_content/Static%20content/web%20api/Guide.html#_areas -securitytoken: # api token -charges: # optional, additional charges per kWh -tax: # optional, additional tax (0.1 for 10%) -``` - ---- - -## `feedin` - -Vergütung für eingespeisten Strom. Bei Alt-Anlagen (vor 1.4.2012) ist hier die Differenz zwischen der Einspeise- und der Selbstverbrauchsvergütung einzutragen. - -**Mögliche Werte** `fixed|octopusenergy` - -### `type:` **`fixed`** - -Feste Einspeisevergütung - -**Beispiel**: - -```yaml -type: fixed -price: 0.12 # 0,12 [currency]/kWh -``` - -### `type:` **`custom`** - -Feste Einspeisevergütung, die per Plugin gesetzt werden kann - -```yaml -type: custom -price: - source: ... -``` - -#### `price` - -Den Preis in [currency]/kWh den du vom Netzbetreiber bekommst. Wird für die Ersparnisberechnung verwendet. - -**Standardwert:** `0.08` - ---- - -### `type:` **`octopusenergy`** - -Der Stromanbieter [Octopus Energy](https://octopus.energy) im Vereinigten Königreich. - -:::tip Tarif- und Regionalcodes -Das Ermitteln des Tarif- und Regionalcodes ist nicht Gegenstand dieser Dokumentation. -::: - -**Beispiel**: - -```yaml -type: octopusenergy -tariff: AGILE-FLEX-22-11-25 # Tariff code -region: A # optional -``` - -#### `tariff` - -Der Tarifcode für Ihren Energievertrag. Stelle sicher, dass dies auf Ihren **Importtarifcode** eingestellt ist. - -#### `region` - -Die DNO Region in der man sich befindet: [Weitere Informationen](https://www.energy-stats.uk/dno-region-codes-explained/) - -**Mögliche Werte**: - -- **`A`**: Eastern England -- **`B`**: East Midlands -- **`C`**: London -- **`D`**: Merseyside and Northern Wales -- **`E`**: West Midlands -- **`F`**: North Eastern England -- **`G`**: North Western England -- **`H`**: Southern England -- **`J`**: South Eastern England -- **`K`**: Southern Wales -- **`L`**: South Western England -- **`M`**: Yorkshire -- **`N`**: Southern Scotland -- **`P`**: Northern Scotland - ---- - -## `co2` - -Neben der Optimierung der Ladeplanung nach Kosten kann diese auch nach anderen Kriterien erfolgen, z.B. nach CO₂-Intensität. Damit ist CO₂-optimales Laden auch möglich, wenn kein variabler Tarif verwendet wird. Die Optimierung kann mittels Grünstromindex oder ElectricityMaps erfolgen. - -### `type:` **`grünstromindex`** - -Nutzt [Grünstromindex](https://gruenstromindex.de) Vorhersagedaten. -Nur in Deutschland verfügbar. - -**Beispiel**: - -```yaml -co2: - type: grünstromindex - zip: meine PLZ # PLZ mit führender Null mit in "" setzen -``` - -### `type:` **`electricitymaps`** - -Nutzt [Electricity Maps](https://app.electricitymaps.com/) Vorhersagedaten. -[API-Zugriff](https://api-portal.electricitymaps.com) ist für diese Funktion erforderlich. -Die "Free Personal Tier" reicht leider nicht aus, da sie keine Vorhersagedaten liefert. - -**Beispiel**: - -```yaml -co2: - type: electricitymaps - uri: - token: - zone: DE -``` - -### `type:` **`ngeso`** - -Der National Grid Electricity Supply Operator (ESO) im Großbritannien. - -**Beispiel**: - -```yaml -co2: - type: ngeso # provides national data if both region and postcode are omitted - Choose ONE only! - region: 1 # optional, coarser than using a postcode - The region details are at https://carbon-intensity.github.io/api-definitions/#region-list - postcode: SW1 # optional - Outward postcode i.e. RG41 or SW1 or TF8. Do not include full postcode, outward postcode only -``` +Mehr Beispiele und eine Übersicht der verfügbaren Anbieter findest du unter [Stromtarife](/docs/devices/tariffs). diff --git a/i18n/en/docusaurus-plugin-content-blog/2023-10-05/feature-highlights-10-2023.mdx b/i18n/en/docusaurus-plugin-content-blog/2023-10-05/feature-highlights-10-2023.mdx index 6050629f8..1f825a2b9 100644 --- a/i18n/en/docusaurus-plugin-content-blog/2023-10-05/feature-highlights-10-2023.mdx +++ b/i18n/en/docusaurus-plugin-content-blog/2023-10-05/feature-highlights-10-2023.mdx @@ -34,8 +34,8 @@ Since a few releases the algorithm is no longer a black box, as we visualize the How does the algorithm work? 5. Surplus solar energy is prioritized -6. Times with cheap grid electricity (if [dynamic electricity tariff](/docs/reference/configuration/tariffs#type-awattar) exists) -7. Times with clean grid electricity (if [CO₂ interface](/docs/reference/configuration/tariffs#co2) is configured) +6. Times with cheap grid electricity (if [dynamic electricity tariff](/docs/features/dynamic-prices) exists) +7. Times with clean grid electricity (if [CO₂ interface](/docs/features/co2) is configured) 8. Time windows shortly before departure **Outlook:** We are currently experimenting with PV forecast data from [Solcast](https://solcast.com/). diff --git a/i18n/en/docusaurus-plugin-content-docs/current/devices/tariffs.mdx b/i18n/en/docusaurus-plugin-content-docs/current/devices/tariffs.mdx index 3d10153dc..743c2dab8 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/devices/tariffs.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/devices/tariffs.mdx @@ -66,6 +66,76 @@ From To Price/Cost ... ``` + +## Exchange Prices + +You have a contract that is calculated based on exchange prices? +For many providers, we have integrated a dedicated interface (e.g., [Awattar](#awattar) or [Tibber](#tibber)). +You can find the list of all available providers in the section [Dynamic Electricity Price](#dynamic-electricity-price). + +### Fees and Taxes + +If your provider is not included, you can calculate your tariff based on the day-ahead prices of the European electricity exchange yourself. +The [Energy-Charts API](https://www.energy-charts.info/charts/price_spot_market/chart.htm) from Fraunhofer ISE provides current and forecasted prices. +These are used by almost all providers as the basis for calculating their energy prices. + +```yaml +tariffs: + grid: + type: template + template: energy-charts-api + bzn: DE-LU # Bidding zone, see https://api.energy-charts.info/#/prices/day_ahead_price_price_get + charges: 0.22 # Fixed surcharge per kWh (e.g., 20ct grid fee, 2ct extra charges) + tax: 0.19 # Percentage surcharge (e.g., 19% VAT) +``` + +The interface provides the exchange prices in euros without local fees or taxes. +With the parameters `charges` and `tax`, you can define an additional fixed and percentage surcharge per kWh. +You can find the exact values in your contract. + +### Custom Formulas + +If the model of tax and charges is not sufficient, you can define an individual formula. +Use the `formula` parameter for for more flexible pricing. + +```yaml +tariffs: + grid: + type: template + template: energy-charts-api + bzn: DE-LU + charges: 0.22 # Fixed surcharge per kWh + tax: 0.19 # Percentage surcharge + formula: math.Min(0.5, (price + charges) * (1 + tax)) +``` + +In the example above, a price cap of 50 ct/kWh is defined. +The formula is written in Go syntax. +In addition to the values `price`, `charges`, and `tax`, the [`math` library](https://pkg.go.dev/math) is available. + +### Exchange Prices with Time Component + +The formula is executed for the current electricity price and each time slot in the forecast. +If the calculation is time-dependent, you can also access the [time](https://pkg.go.dev/time#Time) of the respective slot via `ts`. + +```yaml +tariffs: + grid: + type: template + template: energy-charts-api + bzn: DE-LU + formula: extra := 0.1; if ts.Hour() < 6 || ts.Hour() > 22 { extra = 0.0 }; price + extra +``` + +In this example, there is a surcharge of 10 ct/kWh. +No surcharge is calculated from 10:00 PM to 6:00 AM. +There are no limits to your imagination. + +The `formula` mechanism also works for many other data-providers. +Check the documentation below. + +You can view the respective calculation results using the command `evcc tariff`. + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/features/co2.mdx b/i18n/en/docusaurus-plugin-content-docs/current/features/co2.mdx index 085f92a76..769acc55d 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/features/co2.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/features/co2.mdx @@ -26,7 +26,8 @@ tariffs: zip: 12349 # ZIP code ``` -In this example, we'll use data from GrünstromIndex. See tariffs for a list of all [supported data sources](../devices/tariffs). +In this example, we'll use data from GrünstromIndex. +See [tariffs](../devices/tariffs) for a list of all supported data sources. ## Clean web charging diff --git a/i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/messaging.md b/i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/messaging.md index 424397cdb..632725333 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/messaging.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/messaging.md @@ -149,8 +149,8 @@ The variables provided by evcc (also see /api/state) must be defined as `${2 emissions. This enables CO₂-optimised charging even when a variable tariff is not used. Optimisation can be done using the Grünstromindex or ElectricityMaps. - -### `type:` **`grünstromindex`** - -Uses [Grünstromindex](https://gruenstromindex.de) forecast data. -Only available in Germany. - -**For example**: - -```yaml -co2: - type: grünstromindex - zip: my post code # For post codes with leading zeros, enclose in "" -``` - -### `type:` **`electricitymaps`** - -Uses [Electricity Maps](https://app.electricitymaps.com/) forecast data. -[API access](https://api-portal.electricitymaps.com) is required for this feature. -The "Free Personal Tier" is not sufficient, since it does not provide forecast data. - -**For example**: - -```yaml -co2: - type: electricitymaps - uri: - token: - zone: DE -``` - -### `type:` **`ngeso`** - -National Grid Electricity System Operator Data (GB Only) - -**For example**: - -```yaml -co2: - type: ngeso # provides national data if both region and postcode are omitted - Choose ONE only! - region: 1 # optional, coarser than using a postcode - The region details are at https://carbon-intensity.github.io/api-definitions/#region-list - postcode: SW1 # optional - Outward postcode i.e. RG41 or SW1 or TF8. Do not include full postcode, outward postcode only -``` +More examples and a list of available providers can be found in the section [Tariffs](/docs/devices/tariffs).