> 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/konfiguracja-unwaste-robot/configuration.md).

# Podstawy konfiguracji

Dowiedz się, jak modelować swoją instalację elektryczną do monitorowania i sterowania energią.

## Co oznacza Konfiguracja w Unwaste

**Konfiguracja** to proces opisywania twojej rzeczywistej Instalacja elektryczna w systemie Unwaste. Umożliwia systemowi [Unwaste Robot](/aneksy/glossary.md#h-unwaste-robot) poprawnie:

* zrozumieć, jak Energia przepływa przez twoją instalację,
* Monitorowanie produkcji Energii, zużycia i magazynowania,
* wysyłać znaczące sygnały Sterowanie do wybranych urządzeń.

Konfiguracja **nie** zmienia sposobu, w jaki twoja Instalacja elektryczna działa fizycznie. Tworzy **model logiczny** który odzwierciedla to, co już istnieje w rzeczywistości.

Jakość Konfiguracji bezpośrednio wpływa na:

* poprawność obliczeń Energii,
* dokładność Statystyki i Oszczędności,
* skuteczność i bezpieczeństwo Sterowanie urządzeniami.

***

## Jak jest zbudowana Konfiguracja

Konfiguracja w Unwaste jest zbudowana w **warstwy**, od najbardziej ogólnego do najbardziej szczegółowego:

1. **Połączenie** – twoje połączenie z Sieć elektroenergetyczna
2. **Obwody** – jak Energia przepływa wewnątrz twojej instalacji
3. **Źródła Energii i magazynowanie** – gdzie Energia jest wytwarzana lub magazynowana
4. **Urządzenia** – co zużywa energię i co może być sterowane

Każda warstwa zależy od poprzedniej i powinna być Konfigurowana po kolei.

Wspólne mechanizmy używane w kilku warstwach:

* [Opcjonalne monitorowanie](/konfiguracja-unwaste-robot/optional-monitoring.md) – dodatkowe odczyty elektryczne i wykresy
* [Dodatkowe odczyty](/konfiguracja-unwaste-robot/optional-monitoring/additional-readings.md) – czujniki o niestandardowych nazwach
* [Alerty monitorowania](/konfiguracja-unwaste-robot/optional-monitoring/monitoring-alerts.md) – Alerty progowe dla odczytów

***

## Krok 1: Skonfiguruj połączenie

To [**połączenie**](/aneksy/glossary.md#h-connection) reprezentuje twoje fizyczne połączenie z Sieć elektroenergetyczna.

Tutaj określasz:

* liczbę faz (Jednofazowy lub Trójfazowy),
* lokalizację (używaną do Prognoza i obliczeń solarnych),
* informacje związane z taryfą,
* metodę Prognoza zużycia (Wymagane, jeśli używany jest Magazyn energii),
* Opcjonalne **Tryb nadwyżki** (dla instalacji z PV i sterowanymi obciążeniami).

Ten krok ustanawia **globalny kontekst** dla całej dalszej Konfiguracji.

> Uwaga: Większość instalacji ma dokładnie jedno połączenie.

***

## Krok 2: Zdefiniuj obwody (struktura elektryczna)

[**Obwody**](/aneksy/glossary.md#h-circuit) opisują, jak Energia przepływa przez twoją instalację.

Tworzą strukturę drzewa:

* to **Obwód główny** reprezentuje całą instalację,
* **podobwody** reprezentują gałęzie (na przykład: ogrzewanie, gniazdka, Ładowarka EV),
* urządzenia i liczniki są przypisywane do obwodów.

Obwody elektryczne są niezbędne do:

* prawidłowych obliczeń przepływu Energii,
* oddzielania różnych typów zużycia,
* prawidłowego przypisywania liczników, urządzeń i źródeł produkcji.

> Ważne: Obwód główny jest obowiązkowy. Inne obwody są Opcjonalne, ale zdecydowanie zalecane.

***

## Krok 3: Dodaj produkcję Energii i magazynowanie

Na tym etapie opisujesz, skąd pochodzi Energia i gdzie może być magazynowana.

Może to obejmować:

* falowniki solarne (produkcja Energii),
* baterie lub inne [systemy Magazyn energii](/aneksy/glossary.md#h-storage).

Konfiguracja określa:

* ile Energii jest produkowane lub magazynowane,
* jak Unwaste Robot może odczytywać dane z tych urządzeń,
* czy Unwaste Robot może wysyłać do nich sygnały Sterowanie.

> Ważne: sygnały Sterowanie mają charakter doradczy. Urządzenia i falowniki mogą je przyjąć, ograniczyć lub zignorować zgodnie z własną logiką i zasadami bezpieczeństwa.

***

## Krok 4: Skonfiguruj Urządzenia

Jeden [**urządzenie**](/aneksy/glossary.md#h-device) to dowolne urządzenie, które zużywa energię.

Dla każdego urządzenia decydujesz niezależnie:

* czy jest **monitorowane** (zużycie energii jest mierzone),
* czy jest **sterowane** (otrzymuje sygnały Eco / Komfort / Boost / Wyłącz / Surplus).

Monitorowanie i Sterowanie są odrębne:

* urządzenie może być sterowane bez monitorowania,
* urządzenie może być monitorowane bez sterowania.

Urządzenia są przypisywane do obwodów, aby zapewnić prawidłowe zliczanie ich zużycia energii.

***

## Konfiguracja kontra Sterowanie

Konfiguracja opisuje tylko **to, co istnieje** i **to, co jest możliwe**.

Rzeczywiste zachowanie (kiedy urządzenia działają, który tryb jest aktywny) jest później określane przez:

* logikę opartą na cenach (domyślną),
* profile,
* harmonogramy,
* nadpisania.

Mechanizmy te są opisane w osobnych sekcjach Dokumentacja i opierają się na poprawnej Konfiguracji.

***

## Typowy przebieg pracy przy Konfiguracji

Zalecany przebieg pracy dla nowej instalacji:

1. Ukończ [Ustawienia robota](/konfiguracja-unwaste-robot/robot-settings.md) i wdrożenie
2. Skonfiguruj **połączenie**
3. Utwórz **Obwód główny**
4. Dodaj ważne **podobwody**
5. Przypisz **liczniki** do obwodów
6. Skonfiguruj **źródła produkcji** (na przykład PV)
7. Skonfiguruj **Magazyn energii** (jeśli obecny)
8. Dodaj i przypisz **urządzenia**
9. Włącz Sterowanie tam, gdzie ma to sens
10. Opcjonalnie skonfiguruj [Tryb nadwyżki](/konfiguracja-unwaste-robot/connection.md#surplus-mode) i [Alerty Monitorowanie](/konfiguracja-unwaste-robot/optional-monitoring/monitoring-alerts.md)

Możesz wrócić do Konfiguracji w dowolnym momencie, aby ją dopracować lub rozszerzyć.

***

## Ważne uwagi

* Konfiguracja powinna odzwierciedlać **rzeczywistą fizyczną Instalacja elektryczna**, a nie pożądane zachowanie.
* Nieprawidłowa struktura obwodów prowadzi do nieprawidłowych Statystyki Energii.
* Sterowanie urządzeniem zależy od **Funkcjonalność urządzenia** i **Funkcjonalność instalacji**, a nie tylko na Konfiguracji.
* Niektóre Zaawansowane funkcje wymagają dodatkowego sprzętu (liczników, buforów, zaworów mieszających).


---

# 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/konfiguracja-unwaste-robot/configuration.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.
