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

# Sterowanie urządzeniem

## "Co oznacza sterowanie urządzeniem"

Gdy sterowanie jest włączone, **Unwaste Robot wysyła sygnały sterujące** do urządzenia. Sygnały te żądają określonego trybu pracy.

Unwaste Robot **nie wymusza bezpośrednio określonego zachowania**. Wysyła jedynie sygnał, a urządzenie decyduje, czy i jak go zastosować. Rzeczywiste zachowanie zależy od oprogramowania sprzętowego urządzenia, implementacji producenta i konfiguracji instalacji. W szczególności:

* Unwaste Robot nie zastępuje mechanizmów bezpieczeństwa producenta,
* Unwaste Robot nie nadpisuje termostatów ani systemu BMS pojazdu,
* z powodu tych ograniczeń Unwaste Robot nie gwarantuje komfortu ani gotowości.

Działa to tak:

* Co 15 minut Unwaste Robot analizuje ceny i określa, czy energia elektryczna jest w danym momencie tania czy droga.
  * W przypadku taryf statycznych (które zwykle są dwustopniowe) po prostu ustawia Eco dla wyższego progu cenowego i Komfort dla niższego progu cenowego; tryby Wyłącz i Boost nie są używane
  * W przypadku dynamicznych cen (które bardzo się zmieniają) przypisuje Wyłącz, Eco, Komfort lub Boost na podstawie tego, jak tani lub drogi jest bieżący okres w porównaniu z innymi okresami tego dnia oraz z niedawną historią cen (zob. [Sterowanie urządzeniem oparte na cenie](/dzialanie-unwaste-robot/technical-details/price-based-device-control.md))
* Gdy [Tryb nadwyżki](/konfiguracja-unwaste-robot/connection.md#surplus-mode) jest włączone na połączeniu i warunki eksportu/importu są spełnione, Unwaste Robot może zażądać **Nadwyżka** trybu zamiast bieżącego trybu opartego na cenie (Wyłącz, Eco lub Komfort). Jeśli tryb oparty na cenie jest **Boost**, Boost ma pierwszeństwo przed Nadwyżką. Nadwyżka nie jest używana w harmonogramach ani nadpisaniach.
* Następnie Unwaste Robot decyduje, o który tryb poprosić dla każdego urządzenia, biorąc pod uwagę:
  * Cena energii elektrycznej (tryb oparty na cenie)
  * Warunki nadwyżki, jeśli tryb Surplus jest Włączone na połączeniu
  * Harmonogram ustawiony dla tego Urządzenie
  * jeśli są obecne nadpisania
* Unwaste Robot wysyła odpowiedni sygnał do Urządzenie.
* Urządzenie decyduje, jak (lub czy) reaguje.
* Instalacja ogranicza to, co jest fizycznie możliwe - na przykład nie jest możliwe ogrzać całego domu ani całkowite Ładowanie samochodu w ciągu kilku minut.

Nie ma gwarantowanego wyniku wysłania tego sygnału do Urządzenie, ale Unwaste Robot robi, co może.

Dokładne wyniki nie mogą być zagwarantowane. Unwaste Robot optymalizuje na podstawie dostępnych informacji, ale końcowe zachowanie zależy od Urządzenie.

***

## Jak działa Sterowanie Urządzenie

Sterowanie Urządzenie opiera się na definiowaniu **nazwane parametry sterowalne** oraz przypisywanie **wartości specyficzne dla trybu** dla nich. Konfiguracja składa się z dwóch głównych kroków:

1. **Zdefiniuj parametry sterowalne** — wskaż systemowi, jakie aspekty Urządzenie mogą być sterowane, i przypisz każdemu przyjazną dla użytkownika Nazwa.
2. **Przypisz wartości dla każdego trybu pracy** — zdecyduj, jakie wartości każdy parametr powinien otrzymać w każdym trybie.

***

## Włączanie Sterowanie (warunek wstępny)

Zanim jakiekolwiek parametry lub tryby mogą zostać skonfigurowane, **Sterowanie musi być Włączone** dla Urządzenie.

Bez Włączone Sterowanie, Urządzenie pozostaje w *Niezarządzane* trybie i jest tylko monitorowane.

Gdy włączasz Sterowanie, musisz wybrać **rodzaj Sterowanie**:

* "None" - dla tego Urządzenie nie jest dostępne żadne Sterowanie. Oznacza to, że Sterowanie nie ma zastosowania; nie jest to liczone jako Wyłączone.
* "State" - Urządzenie jest sterowane poprzez ustawianie stanów dla każdego trybu. Encje Sterowanie muszą zostać wybrane, a na końcu wartości muszą zostać zdefiniowane dla każdej encji i dla każdego obsługiwanego trybu Sterowanie (lub Wyłączone dla określonych trybów, jeśli 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.

„None” oznacza, że w ogóle nie ma dostępnego sterowania. Jest to przydatne, gdy pusty formularz „State” wymagałby wartości, które nie mają zastosowania.

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

***

## Krok 1: Zdefiniuj sterowalne parametry

W tym kroku definiujesz **które części urządzenia można sterować**. Każdy sterowalny parametr składa się z:

* a **encję Home Assistant** (na przykład encji przełącznika lub wyboru), oraz
* a **nazwa** nadana przez użytkownika.

Nazwa służy jako punkt odniesienia przy przypisywaniu wartości dla poszczególnych trybów pracy. W tym kroku nie są wysyłane żadne wartości do urządzenia; informujesz jedynie Unwaste Robot, co potencjalnie można kontrolować.

Pomyśl o tym jak o *tworzeniu nazwanych kanałów sterowania*.

### Przykłady typów encji

* **Przełącznik** encje przyjmują proste wartości włącz/wyłącz.
* **Wybór** encje pozwalają wybrać jedną wartość z predefiniowanej listy (na przykład stan pracy obsługiwany przez urządzenie).
* **Liczba** encje przyjmują wartość liczbową w określonym zakresie.

***

### **Uwaga: wybieranie encji Home Assistant**

* Unwaste Robot integruje się z Home Assistant, a właściwa encja do użycia zależy od konkretnej integracji urządzenia.
* Ponieważ nazewnictwo encji i ich możliwości różnią się między producentami i integracjami, ta dokumentacja nie udostępnia uniwersalnego „przewodnika wyboru encji”.
* Jeśli nie masz pewności, której encji użyć, sprawdź w Home Assistant, czy obsługuje wymaganą czynność (na przykład przełączanie trybów lub włączanie/wyłączanie).

***

## Krok 2: Przypisz wartości dla każdego trybu pracy

Po zdefiniowaniu parametrów i nadaniu im nazw, przypisz **wartości dla każdego trybu pracy** w **Mapa stanów**:

* Wyłączone
* Niezarządzane
* Wyłącz
* Eco
* Komfort
* Nadwyżka (wymagane, gdy tryb Nadwyżka jest włączony na połączeniu — zobacz [Połączenie](/konfiguracja-unwaste-robot/connection.md#surplus-mode))
* Boost

Dla każdego trybu musisz:

* włączyć lub wyłączyć tryb (jeśli jest obsługiwany), oraz
* określić, jaką wartość otrzymuje każda encja sterująca, lub wyłączyć określone parametry dla tego trybu.

Gdy tryb staje się aktywny, wszystkie włączone encje sterujące dla tego trybu są ustawiane jednocześnie.

**Ważne uwagi dotyczące trybów:**

* Każdy stan musi mieć **co najmniej jedną włączoną encję** skonfigurowaną.
* Jeśli urządzenie nie obsługuje określonego trybu, można zastosować konfigurację przybliżoną (na przykład mapując Boost na Komfort).
* Jeśli brakuje trybu Eco lub Tryb komfortowy, urządzenie może nie być gotowe do pracy w sieci i powinno zostać przypisane do prostych semantyk włącz/wyłącz:
  * Tryby Wyłączone, Wyłącz i Eco powinny być mapowane do stanu wyłączenia
  * Niezarządzany, Komfort i Boost powinny być mapowane do stanu włączenia

***

## Tryby sterowania urządzeniem

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

* **Tryb Wyłączone** – urządzenie jest tymczasowo wyłączone przez użytkownika lub Unwaste Robot
* **Tryb niezarządzany** – urządzenie nie jest sterowane przez Unwaste Robot
* **Tryb wyłączony** – Urządzenie otrzymuje polecenie wyłączenia się lub używania tylko minimalnej możliwej Energia
* **Tryb ekonomiczny** – Urządzenie otrzymuje polecenie działania w trybie niskiego zużycia Energia
* **Tryb komfortowy** – Urządzenie ma pozwolenie na działanie przy wyższym zużyciu Energia
* **Tryb nadwyżki** – Urządzenie otrzymuje polecenie użycia większej ilości Energia, aby wchłonąć lokalną nadwyżkę PV (tylko gdy Tryb nadwyżki jest Włączone na połączeniu)
* **Tryb intensywny** – Urządzenie otrzymuje polecenie użycia jak największej ilości Energia i jej magazynowania, jeśli Urządzenie obsługuje na przykład przegrzewanie

## Zrzut ekranu

![](https://3030738239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWf3M0a04WuhvfEbAgXFl%2Fuploads%2Fgit-blob-e0544bcd977c801a487f79f23885b2d967fdf029%2F2026-07-10_Configuration_device_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/device/device-control.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.
