> 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/storage.md).

# Magazyn energii

Skonfiguruj systemy magazynowania energii do monitorowania i opcjonalnego sterowania automatycznego.

## Magazyn energii

## Czym jest magazyn energii?

Magazyn energii to dowolne urządzenie zaprojektowane do przechowywania energii elektrycznej.

Główną rolą magazynu jest poprawa ogólnej wydajności systemu poprzez magazynowanie nadmiaru energii i późniejsze jej oddawanie, gdy energia jest potrzebna.

Obsługiwane są zarówno samodzielne systemy magazynowania, jak i magazyny zintegrowane z falownikami hybrydowymi, pod warunkiem że Unwaste Robot może odczytywać ich dane i sterować ich trybami pracy.

***

## Konfiguracja

Konfigurowanie magazynu energii wymaga przypisania czujników Home Assistant do pojemności, liczników energii i opcjonalnych encji sterujących. Formularz jest taki sam dla wszystkich obsługiwanych typów baterii.

***

### Nazwa i Opis

**Nazwa** jest wymagane. **Opis** jest opcjonalne.

***

### Pojemność całkowita

**Wymagane.** Określa pojemność całkowitą magazynu energii.

Dostępne opcje:

* **Stała energia** – wprowadź stałą wartość pojemności w kWh
* **Odczyt energii** – wybierz encję Home Assistant, z której odczytywana jest pojemność całkowita, dla baterii o dynamicznej lub konfigurowalnej pojemności.

***

### Pojemność rezerwowa

**Wymagane.** Określa część pojemności, która musi zawsze pozostać niewykorzystana, aby chronić magazyn przed degradacją (zobacz *Poziomy energii w magazynie* w Uwagach).

Dostępne opcje:

* **Stała energia** – stała pojemność rezerwowa w kWh
* **Stały procent** – pojemność rezerwowa jako procent pojemności całkowitej
* **Odczyt energii** – encja Home Assistant dostarczająca pojemność rezerwową w kWh, dla baterii o dynamicznej lub konfigurowalnej pojemności.
* **Odczyt procentowy** – encja Home Assistant dostarczająca pojemność rezerwową jako procent, dla baterii o dynamicznej lub konfigurowalnej pojemności.

**Ważne:** Nieprawidłowa konfiguracja może uniemożliwić ładowanie lub rozładowanie.

***

### Energia zmagazynowana

**Wymagane.** Określa jedną lub trzy encje Home Assistant (w zależności od typu magazynu) używane do odczytu ilości energii zmagazynowanej.

Dla magazynu trójfazowego możesz podać:

* jeden czujnik dla sumarycznej energii (pozostawiając resztę pustą) — należy go określić w polu L1
* trzy czujniki, każdy odpowiadający jednej fazie — L1, L2, L3.

Dla magazynu jednofazowego w instalacji trójfazowej używane jest tylko jedno pole. Powinno ono odpowiadać fazie obwodu elektrycznego, do którego podłączony jest magazyn.

Nie jest to to samo co poziom naładowania. Energia zmagazynowana reprezentuje całkowitą ilość energii naładowanej do magazynu w dłuższym okresie czasu (w wielu cyklach ładowania).

Poziom naładowania to bieżąca wartość energii zmagazynowanej w magazynie.

Każdy blok odczytu ma **Alerty monitorowania** przycisk. Zobacz [Alerty monitorowania](/konfiguracja-unwaste-robot/optional-monitoring/monitoring-alerts.md).

***

### Energia pobrana

**Wymagane.** Określa jedną lub trzy encje Home Assistant (w zależności od typu magazynu) używane do odczytu ilości energii pobranej z magazynu.

Dla magazynu trójfazowego możesz podać:

* jeden czujnik dla sumarycznej energii (pozostawiając resztę pustą) — należy go określić w polu L1
* trzy czujniki, każdy odpowiadający jednej fazie — L1, L2, L3.

Dla magazynu jednofazowego w instalacji trójfazowej używane jest tylko jedno pole. Powinno ono odpowiadać fazie obwodu elektrycznego, do którego podłączony jest magazyn.

Energia pobrana oznacza całkowitą ilość energii pobranej z magazynu w dłuższym okresie czasu (w wielu cyklach rozładowania).

***

### Moc ładowania

**Opcjonalne.** Określa jedną do trzech encji używanych do odczytu bieżącej mocy ładowania.

Dla magazynu trójfazowego możesz podać:

* jeden czujnik dla sumarycznej mocy (pozostawiając resztę pustą) - musi być określony w polu L1
* trzy czujniki, każdy odpowiadający jednej fazie — L1, L2, L3.

Dla magazynu jednofazowego w instalacji trójfazowej używane jest tylko jedno pole. Powinno ono odpowiadać fazie obwodu elektrycznego, do którego podłączony jest magazyn.

***

### Moc rozładowania

**Opcjonalne.** Określa jedną do trzech encji używanych do odczytu bieżącej mocy rozładowania.

Dla magazynu trójfazowego możesz podać:

* jeden czujnik dla sumarycznej mocy (pozostawiając resztę pustą) - musi być określony w polu L1
* trzy czujniki, każdy odpowiadający jednej fazie — L1, L2, L3.

Dla magazynu jednofazowego w instalacji trójfazowej używane jest tylko jedno pole. Powinno ono odpowiadać fazie obwodu elektrycznego, do którego podłączony jest magazyn.

***

### Poziom naładowania

Określa encję używaną do odczytu bieżącego poziomu naładowania magazynu.

Poziom naładowania może być podany jako:

* "Brak" - brak dostępnego odczytu poziomu naładowania
* "Energia" - wartość energii **(kWh), lub** "Procent" - wartość procentowa
* szczegóły w Uwagach. **wartość procentowa**

Zobacz *Poziomy energii w magazynie* w Uwagach, aby poznać szczegóły.

Poziom naładowania jest opcjonalny, ale jest potrzebny do prawidłowego sterowania magazynem, gdy Unwaste Robot zarządza ładowaniem z Sieć.

Nie zawsze jest równy całkowitej energii zmagazynowanej minus całkowita energia pobrana, ponieważ wszystkie magazyny doświadczają pewnych strat energii.

***

### Sterowanie

***

### Włączanie sterowania

Aby umożliwić Unwaste Robot sterowanie magazynem, sterowanie musi najpierw zostać włączone.

Bez włączonego sterowania magazyn jest tylko monitorowany i pozostanie w trybie "Niezarządzany".

Następnie musisz wybrać typ sterowania:

* "Brak" - brak dostępnego sterowania. To jak wyłączone sterowanie, ale nie to samo.
* "Stan" - magazyn jest sterowany poprzez ustawianie stanów dla każdego trybu. Należy wybrać encje sterujące, a na końcu zdefiniować wartości dla każdej encji oraz dla każdego obsługiwanego trybu sterowania (lub wyłączyć dla określonych trybów, jeśli jest to wymagane).

Wybrany typ Sterowanie określa, czy **Mapa stanów** sekcja jest dostępna do konfiguracji.

Uwaga: „None” i „Wyłączone” to odrębne pojęcia i służą różnym celom.

"Brak" oznacza, że nie ma w ogóle dostępnego sterowania.

„Wyłączone” pozwala tymczasowo wyłączyć sterowanie, bez utraty całej konfiguracji zapisanej w formularzu „State”.

***

### Wybieranie encji

Pierwszym krokiem jest wybranie, które encje Home Assistant są używane do sterowania magazynem.

Obsługiwane typy encji sterujących obejmują **Przełącznik**, **Wybór**, i **Liczba** encje.

***

#### Encje przełącznika

Encje przełącznika akceptują prostą wartość Włączone/Wyłącz (true/false), podobnie jak włącznik światła.

***

#### Encje wyboru

Encje wyboru umożliwiają wybranie jednej wartości z predefiniowanej listy, na przykład wybranie trybu pracy obsługiwanego przez urządzenie.

***

### Tryby sterowania magazynu

Magazyn może działać w jednym z następujących trybów:

* **Tryb Wyłączone** – magazyn jest tymczasowo wyłączony przez użytkownika lub Unwaste Robot
* **Tryb niezarządzany** – magazyn nie jest sterowany przez Unwaste Robot
* **Tryb domyślny** – magazyn podąża za swoją logiką wewnętrzną - używane, gdy magazyn jest zarządzany, ale nie ma potrzeby podejmowania żadnych działań.
* **Wymuszone ładowanie** – magazyn otrzymuje polecenie ładowania z Sieć
* **Wymuszone rozładowanie** – magazyn otrzymuje polecenie rozładowania do Sieć
* **Blokada rozładowania** – magazyn otrzymuje polecenie, aby nie rozładowywać
* **Blokada obu** – magazyn otrzymuje polecenie, aby nie ładować ani nie rozładowywać

Włącz tylko te tryby, które obsługuje Twój sprzęt magazynu. Dla trybów, których nie używasz, pozostaw je wyłączone w Mapie stanów.

***

### Wybieranie wartości dla każdego trybu

Każdy tryb sterowania można skonfigurować niezależnie. Dla każdego trybu ustawiamy "stan" - czyli zbiór wartości dla każdej encji sterującej. Gdy tryb staje się aktywny, wszystkie włączone encje sterujące dla tego trybu są ustawiane jednocześnie.

Dla każdego trybu:

* włącz lub wyłącz tryb za pomocą przełącznika obok jego nazwy (jeśli dostępny)
* określ, jaka wartość ma zostać ustawiona dla każdej encji sterującej, lub wyłącz konkretną encję dla tego trybu

Uwaga: Każdy stan musi mieć włączoną co najmniej jedną encję.

Uwaga 2: (ważne) Jeśli magazyn nie obsługuje wybranego trybu, obowiązuje **Tryb domyślny** zamiast tego.

***

### Opcjonalne Monitorowanie

Opcjonalne czujniki napięcia, prądu, mocy i dodatkowe są konfigurowane w **Opcjonalne monitorowanie** sekcji. Zobacz [Opcjonalne monitorowanie](/konfiguracja-unwaste-robot/optional-monitoring.md) i [Dodatkowe odczyty](/konfiguracja-unwaste-robot/optional-monitoring/additional-readings.md).

***

## Ważne uwagi

***

### Poziomy energii w magazynie

Każdy magazyn definiuje dwie wartości pojemności:

* **całkowita pojemność** – teoretyczna maksymalna energia, jaką magazyn może przechować
* **Pojemność rezerwowa** – minimalny poziom energii, który musi pozostać, aby chronić kondycję magazynu

Na podstawie tych wartości system rozróżnia:

* **Energia w magazynie** – surową zgłaszaną wartość energii
* **dostępna Energia w magazynie** – energię w magazynie pomniejszoną o pojemność rezerwową

Ważne: Jeśli urządzenie magazynujące już wewnętrznie odejmuje pojemność rezerwową, skonfiguruj odpowiednio pojemność całkowitą i ustaw pojemność rezerwową na zero.

### Przepływ mocy

#### Typowy przypadek

Oddzielne parametry mocy ładowania i mocy rozładowania są najczęstszym sposobem określania całkowitego przepływu mocy w magazynach, ponieważ są intuicyjne w konfiguracji i jednoznaczne. System używa różnicy między nimi, aby przedstawić całkowity przepływ mocy magazynu na wykresie.

#### Niejednoznaczne urządzenia

Są jednak magazyny, które dostarczają tylko jedną wartość, a co gorsza, nie zawsze stosują tę samą konwencję kierunku przepływu mocy.

W takich przypadkach całkowity przepływ mocy należy wprowadzić do jednego z tych pól (pozostawiając drugie puste), a jeśli kierunek na wykresie jest nieprawidłowy, należy zamienić te pola.

Odczyty jednofazowe dla tych parametrów nie powinny być mieszane z odczytami trójfazowymi.

## Zrzut ekranu (główny formularz)

![](https://3030738239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWf3M0a04WuhvfEbAgXFl%2Fuploads%2Fgit-blob-77c697c9dcb7a6ffba65aa4576937ed488de26c8%2F2026-07-10_Configuration_storage.png?alt=media)

## Zrzut ekranu (sterowanie / Mapa stanów)

![](https://3030738239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWf3M0a04WuhvfEbAgXFl%2Fuploads%2Fgit-blob-5bb7107fa4dbb26d0590595aa79452a5ba85e7ff%2F2026-07-10_Configuration_storage_control.png?alt=media)


---

# 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/storage.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.
