> For the complete documentation index, see [llms.txt](https://docs.unwaste.energy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unwaste.energy/dzialanie-unwaste-robot/technical-details/surplus-mode.md).

# Tryb nadwyżki

Użyj trybu nadwyżki, aby zwiększyć zużycie, gdy dostępna jest nadwyżkowa produkcja energii słonecznej.

Ta strona wyjaśnia, jak Unwaste Robot decyduje, kiedy zażądać **Nadwyżka** trybu pracy na urządzeniach zarządzanych.

Konfiguracja (progi, wymagane odczyty, Mapa stanów) jest opisana w [Połączenie](/konfiguracja-unwaste-robot/connection.md#surplus-mode) i [Sterowanie urządzeniem](/konfiguracja-unwaste-robot/device/device-control.md).

***

## Cel

Tryb Nadwyżka zwiększa lokalne wykorzystanie produkcji fotowoltaicznej, gdy instalacja **eksportuje energię do sieci**. Celem jest pochłanianie nadmiaru energii słonecznej przez sterowalne obciążenia zamiast oddawania jej z powrotem do sieci.

Nadwyżka jest oddzielnym sygnałem sterującym od trybów opartych na cenach. W Mapie stanów przypisujesz, co Nadwyżka oznacza dla każdego urządzenia, tak samo jak Eco lub Komfort.

***

## Miejsce Nadwyżki wśród trybów pracy

Dla urządzeń tryby pracy tworzą skalę od niższego do wyższego zużycia energii:

```
Wyłącz < Eco < Komfort < Nadwyżka < Boost
```

Nadwyżka znajduje się między Komfort a Boost. Zachęca do większego zużycia niż Komfort, ale nie jest tym samym co Boost — Boost jest sterowany przez korzystne **ceny energii elektrycznej**, podczas gdy Nadwyżka jest sterowana przez **eksport do sieci**.

***

## Niezależne od cen energii elektrycznej

Decyzja o wejściu do trybu Nadwyżka lub wyjściu z niego opiera się na **pomiach importu i eksportu** na Obwodzie głównym oraz progach skonfigurowanych na Przyłączu do sieci.

Sterowanie oparte na taryfach działa **równolegle**. Unwaste Robot ocenia oba:

* tryb sugerowany przez **taryfy** (Wyłącz, Eco, Komfort lub Boost), oraz
* czy **warunki Nadwyżki** są obecnie spełnione.

Jeśli warunki Nadwyżki są spełnione, a tryb oparty na cenach to Wyłącz, Eco lub Komfort, urządzenie może otrzymać **Nadwyżka** zamiast tego.

Jeśli warunki Nadwyżki są spełnione, ale tryb oparty na cenach to **Boost**, **Boost ma pierwszeństwo**. Boost może zwiększyć zużycie ponad Nadwyżkę i może pobierać energię z sieci; system traktuje to jako ekonomicznie preferowany wybór, gdy ceny to uzasadniają.

***

## Gdy system wchodzi w tryb Nadwyżka

Wejście w Nadwyżkę jest oceniane na końcu każdego **15-minutowego** interwału sterowania.

System sprawdza **średnią moc eksportu** z **poprzedniego** zakończonego 15-minutowego okresu. Jeśli ta średnia jest równa lub wyższa od Twojego **progu Nadwyżki włączenia**, warunki Nadwyżki stają się aktywne dla urządzeń zarządzanych (z zastrzeżeniem powyższej zasady Boost).

Oznacza to, że wejście nie jest natychmiastowe — robot czeka na pełne 15-minutowe okno utrzymującego się eksportu, zanim zareaguje.

***

## Gdy system opuszcza tryb Nadwyżka

Gdy Nadwyżka jest aktywna, wyjście jest sprawdzane znacznie częściej — przy każdym **5-sekundowym** cyklu odczytu.

System śledzi **energię importu** w **bieżącym** 15-minutowym okresie. Jeśli import osiągnie poziom wynikający z Twojego **progu wyłączenia Nadwyżki**, Nadwyżka kończy się natychmiast, a urządzenie wraca do bieżącego **trybu opartego na cenach** (Wyłącz, Eco, Komfort lub Boost).

Zatem wejście jest oceniane co 15 minut, ale wyjście może nastąpić w ciągu kilku sekund, gdy import rośnie.

***

## Antyoscylacja

Jeśli Nadwyżka kończy się, ponieważ import przekroczył próg wyłączenia, system **nie wraca do Nadwyżki w tym samym 15-minutowym okresie** na podstawie tego okna eksportu.

Zmniejsza to szybkie przełączanie, gdy eksport i import szybko się na przemian pojawiają — na przykład gdy obciążenie włącza się i wyłącza blisko progu.

Ponowne wejście jest rozważane dopiero po następnym pełnym 15-minutowym cyklu oceny i tylko wtedy, gdy warunki eksportu zostaną ponownie spełnione.

***

## Magazyn energii i eksport

Nadwyżka reaguje na **eksport na Przyłączu do sieci**. W praktyce eksport oznacza zwykle energię, która nie została zużyta lokalnie i nie została zmagazynowana w baterii.

Typowa kolejność wykorzystania produkcji PV:

1. Pokryj bieżące zużycie w instalacji
2. Ładuj magazyn energii (jeśli jest dostępny i niepełny)
3. Eksportuj pozostałą nadwyżkę do sieci

Tryb Nadwyżka kieruje obciążenia wtedy, gdy w przeciwnym razie nastąpiłby krok 3 — czyli gdy występuje mierzalny eksport mimo lokalnego zużycia i magazynowania.

***

## Czego Nadwyżka nie robi

* Nadwyżka jest **nie** dostępna w harmonogramach ani nadpisaniach — tylko przez domyślny mechanizm sterowania, gdy tryb Nadwyżka jest włączony na Przyłączu do sieci.
* Nadwyżka nie **nie** zastępuje logiki bezpieczeństwa producenta ani nie gwarantuje, że urządzenie pochłonie określoną ilość energii.
* Nadwyżka nie **nie** sterować ładowaniem baterii bezpośrednio; magazyn energii podlega własnym zasadom (zobacz [Sterowanie magazynem energii](/dzialanie-unwaste-robot/technical-details/storage-control.md)).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.unwaste.energy/dzialanie-unwaste-robot/technical-details/surplus-mode.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
