> For the complete documentation index, see [llms.txt](https://docs.myrspoven.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/podlacz-swoj-budynek/bms-integrations.md).

# Integracje BMS

## Przegląd

myCoreAI łączy się z istniejącym w budynku systemem zarządzania budynkiem (BMS), aby odczytywać wartości z czujników i liczników oraz zapisywać wartości zadane, którymi został skonfigurowany do sterowania. BMS zachowuje kontrolę operacyjną; zmieniane są wyłącznie uzgodnione sygnały.

**Zarządzanie aktywami i obiektami:** myCoreAI poprawia komfort użytkowników i efektywność energetyczną w już zainstalowanym BMS — bez wymiany sprzętu sterującego.

**Obsługa techniczna:** myCoreAI udostępnia zachowanie wartości zadanych, ich zakresy oraz nadpisania jako sygnały podlegające audytowi. BMS pozostaje jedynym źródłem informacji o stanie operacyjnym.

**Integratorzy:** myCoreAI łączy się za pomocą standardowych protokołów (REST, OPC UA, BACnet, Modbus lub SDK dostawcy); gdy bezpośredni dostęp nie jest możliwy, dostępne jest rozwiązanie brzegowe Myrspoven.

### Jak działa integracja

Komunikacja między Myrspoven a budynkiem może odbywać się na dwa główne sposoby:

1. **Bezpośrednie połączenie z BMS.** myCoreAI łączy się z BMS przez interfejs dostępny w sieci — jest to najczęstsze rozwiązanie, gdy budynkiem można sterować za pośrednictwem platformy chmurowej lub gdy lokalny BMS jest dostępny z internetu przez lokalną zaporę sieciową. Dane przepływają w obu kierunkach w ramach uzgodnionej listy sygnałów.
2. **Za pośrednictwem rozwiązania brzegowego Myrspoven.** Jeśli bezpośredni dostęp nie jest możliwy — na przykład z powodu zamkniętych sieci, starszych protokołów lub segmentowanych środowisk IT — niewielka aplikacja brzegowa działa na serwerze wirtualnym w sieci budynku i łączy BMS z serwerami Myrspoven. Aplikacja brzegowa odpytuje serwery Myrspoven, wysyła dane i pobiera aktualizacje wartości zadanych, więc nie są wymagane przychodzące reguły zapory sieciowej.

W obu scenariuszach BMS zachowuje kontrolę operacyjną. myCoreAI odczytuje wyłącznie sygnały, do których odczytu został skonfigurowany, i zapisuje wyłącznie wartości zadane, których zapisywanie zostało skonfigurowane.

### Odczyt i zapis

Odczyty są wykonywane według harmonogramu: domyślnie co 15 minut w przypadku większości integracji, co 12 minut w przypadku Web Port oraz codziennie w przypadku danych energetycznych z Mestro i Metry. Interwał można zmienić dla każdego budynku. Dotyczy to również budynków połączonych za pośrednictwem rozwiązania brzegowego Myrspoven: rozwiązanie brzegowe wykonuje odczyty i zapisy zaplanowane dla niego przez serwery Myrspoven, w interwałach ustawionych dla danej integracji. Schneider EBO przesyła swoje wartości za pośrednictwem złącza. Dane przesyłane przez Myrspoven AI-API docierają w tempie ustalanym przez nadawcę. Integracje strumieniowe są ograniczane osobno dla każdej integracji, na przykład do około jednej wartości co 15 minut w przypadku Yggio oraz około co 5 minut w przypadku danych z inteligentnych liczników przesyłanych przez MQTT. Typowe odczyty obejmują dane z czujników wewnętrznych (temperaturę, CO₂ i wilgotność), temperaturę zewnętrzną, wskazania liczników energii, bieżące wartości zadane oraz stan urządzeń.

Zapisy są ograniczone do wartości zadanych uzgodnionych podczas uruchomienia. Typowe wartości zadane obejmują temperaturę zasilania obiegu grzewczego, temperaturę nawiewu i prędkość wentylatora centrali wentylacyjnej (AHU), wartości zadane chłodzenia oraz wartości zadane urządzeń końcowych na poziomie strefy, jeśli BMS je udostępnia. Po każdym pomyślnym przebiegu optymalizacji myCoreAI zapisuje nowe wartości zadane co 15 minut.

Dla każdej zapisywanej wartości zadanej z góry uzgadnia się dolny i górny limit, a myCoreAI nie zapisuje wartości poza tym zakresem. Jedynym wyjątkiem jest [zabezpieczenie przed punktem rosy](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/jak-ai-oszczedza-energie/dew-point-function.md), które może podnieść wartość zadaną temperatury wody lodowej, aby zapobiec kondensacji. Ręczna zmiana w BMS sygnału kontrolowanego przez myCoreAI zaczyna obowiązywać natychmiast i utrzymuje się do następnego zapisu, czyli maksymalnie przez 15 minut, chyba że sterowanie AI dla tego sygnału zostanie wyłączone. Zapisy można też wstrzymać dla danego budynku: odczyty i raportowanie są kontynuowane, ale sterowanie zostaje zatrzymane.

### Umowa dotycząca zachowania awaryjnego, funkcji watchdog i ręcznego nadpisania

myCoreAI zapisuje wartości po pomyślnym przebiegu optymalizacji, zwykle co 15 minut. Interwały odczytu i zapisu mogą się różnić w zależności od integracji. Pominięcie standardowego zapisu nie oznacza uniwersalnego limitu czasu. Gdy zapisy lub sterowanie AI są wstrzymane, BMS nadal odpowiada za logikę operacyjną budynku.

Przed włączeniem zapisów dla każdego sterowanego punktu należy uzgodnić mechanizm awaryjny po stronie BMS:

* Zachowaj natywną lub pierwotną wartość zadaną albo krzywą sterowania BMS.
* Wybieraj wartość AI tylko wtedy, gdy spełnione są skonfigurowany warunek zezwolenia na sterowanie AI oraz warunek poprawnego i aktualnego zapisu.
* Po upływie skonfigurowanego limitu czasu, jawnym wstrzymaniu lub wystąpieniu warunku bezpiecznego sterowania przestań wybierać wartość AI. Wznów zachowaną strategię natywną. Nie utrzymuj bezterminowo nieaktualnej wartości AI.
* Wznów wybór wartości AI dopiero po spełnieniu skonfigurowanego warunku przywrócenia i warunków poprawnych zapisów.

Projekt integracji musi wskazywać osobę odpowiedzialną za każdy sterowany punkt. Osoba ta tworzy, utrzymuje, weryfikuje i zmienia natywną strategię lub wartość awaryjną. Projekt musi również określać, gdzie się ona znajduje: w BMS, skrypcie integracyjnym lub brzegowym albo na platformie. Zależy to od konkretnej integracji. myCoreAI nie stosuje jednej uniwersalnej wartości awaryjnej. Uzgodnij i skonfiguruj ją przed włączeniem zapisów.

Poniższe pola są wymaganymi parametrami uruchomieniowymi, jeśli nie udokumentowano wspólnej wartości.

| Element umowy                | Kierunek i właściciel                                                                                  | Typ danych lub stany                                            | Warunek aktualizacji lub zdarzenia                                                             | Skonfigurowany limit czasu        | Zachowanie po upływie limitu czasu lub w trybie awaryjnym                           | Przywrócenie                                                                                   |
| ---------------------------- | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | --------------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `AiControlEnabled`           | Stan zezwolenia po stronie BMS. Właściciel: wskazany na liście sygnałów obiektu.                       | Wartość logiczna lub uzgodnione stany.                          | Zmienia się, gdy sterowanie AI zostaje włączone, wstrzymane lub przełączone w tryb bezpieczny. | Wymagany parametr uruchomieniowy. | Wartość AI nie jest wybierana, gdy sterowanie jest wyłączone.                       | Użyj warunku zezwolenia określonego dla danego obiektu.                                        |
| `AiControlActive`            | Stan wyboru po stronie BMS. Właściciel: wskazany na liście sygnałów obiektu.                           | Wartość logiczna lub uzgodnione stany.                          | Zmienia się, gdy BMS zaczyna wybierać wartość AI lub przestaje ją wybierać.                    | Wymagany parametr uruchomieniowy. | Wskazuje, że po zaprzestaniu wybierania wartości AI aktywna jest strategia natywna. | Uaktywnia się tylko po spełnieniu warunków zezwolenia, aktualności i przywrócenia.             |
| `Watchdog` lub aktualności   | Dowód po stronie BMS potwierdzający prawidłowy zapis. Właściciel: wskazany na liście sygnałów obiektu. | Znacznik czasu, licznik, wartość logiczna lub uzgodnione stany. | Aktualizowane prawidłowym zapisem w skonfigurowanym przedziale czasu.                          | Wymagany parametr uruchomieniowy. | Po upływie tego czasu przestań wybierać wartość AI i wznów natywną strategię.       | Resetuj wyłącznie po prawidłowych zapisach i spełnieniu skonfigurowanego warunku przywrócenia. |
| Schneider EBO SmartConnector | Integracja specyficzna dla Schneider EBO.                                                              | Mechanizm awaryjny SmartConnector.                              | Zaktualizowane wartości przestają napływać.                                                    | 900 sekund.                       | Po upływie czasu działania mechanizmu awaryjnego przywracane są wartości domyślne.  | Postępuj zgodnie z udokumentowaną procedurą przywracania EBO.                                  |
| Web Port                     | Integracja obiektu z Web Port.                                                                         | Sygnały specyficzne dla obiektu i logika skryptów.              | Zdefiniowane na liście sygnałów obiektu.                                                       | Wymagany parametr uruchomieniowy. | Zdefiniowane przez wygenerowany skrypt awaryjny.                                    | Zdefiniowane przez uzgodniony warunek przywrócenia.                                            |

`Myr_D` i `Myr_DS` to nazwy używane wyłącznie w Schneider EBO. Semantyka sygnałów Ouman i wartości limitów czasu zależą od integracji i nie zostały jeszcze opublikowane. Korzystaj z uzgodnionej listy sygnałów obiektu. Nie wyciągaj wniosków na temat działania sygnałów Ouman, limitu czasu ani procedury przywracania na podstawie Schneider EBO lub zwykłej częstotliwości zapisów.

#### Uruchomienie kontraktu

Przed włączeniem zapisów odnotuj skonfigurowany limit czasu, właścicieli, lokalizację przechowywania oraz wyniki testów w dokumentacji uruchomienia obiektu.

1. Wykonaj ograniczony zapis testowy. Potwierdź odczyt zwrotny z BMS.
2. Zasymuluj brak prawidłowych zapisów aż do upływu skonfigurowanego limitu czasu.
3. Potwierdź, że zaczyna obowiązywać natywna lub pierwotna wartość zadana albo krzywa sterowania.
4. Wstrzymaj sterowanie AI. Przetestuj ręczne zmiany wartości zadanej i krzywej sterowania.
5. Przywróć komunikację. Potwierdź skonfigurowane zachowanie przywracania.

Skorzystaj z wytycznych dotyczących wdrożenia i weryfikacji dla [Web Port](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/podlacz-swoj-budynek/bms-integrations/web-port.md) oraz z informacji o zachowaniu specyficznym dla EBO dla [Schneider](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/podlacz-swoj-budynek/bms-integrations/schneider.md). Klienci powinni korzystać z [FAQ](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/uzyskaj-pomoc/faq.md) wskazówek dotyczących nadpisywania oraz z [myPortal (wersja klasyczna)](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/inne-interfejsy/myportal.md) informacji o zakresie monitorowania. Zastosowanie ma wyłącznie udokumentowany kontrakt dla określonej integracji.

### Obsługiwane platformy i protokoły BMS

Poniższe platformy są obecnie używane produkcyjnie, o ile przy ich statusie nie podano inaczej. Są to typowe ścieżki wdrożenia, a nie sztywne ograniczenie możliwości łączenia się systemu Myrspoven.

| Platforma                                | Dostawca           | Połączenie                                                                                                                                                                              | Status                       | Szczegóły |
| ---------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | --------- |
| **Web Port**                             | Kiona              | Lokalny serwer Web Port (Windows) → Myrspoven Web Port-Cloud; Modbus / BACnet / protokoły przemysłowe po stronie lokalnej                                                               | W użyciu produkcyjnym        | Web Port  |
| **EcoStruxure Building Operation (EBO)** | Schneider Electric | Lokalnie za pośrednictwem urządzenia brzegowego Myrspoven albo w chmurze za pośrednictwem Schneider SmartConnector; dedykowane foldery Read / Write / Overwrite-Bindings po stronie EBO | W użyciu produkcyjnym        | Schneider |
| **Building X (BPCloud)**                 | Siemens            | JSON:API przez HTTPS, dane uwierzytelniające klienta OAuth2. Semantyczne mapowanie oznaczonych urządzeń/punktów → komponenty i sygnały Myrspoven                                        | W użyciu produkcyjnym        | Siemens   |
| **Desigo CC**                            | Siemens            | Starsza, lokalna ścieżka integracji; wymaga ręcznej konfiguracji sygnałów wirtualnych w systemie BMS                                                                                    | W produkcji (starsza wersja) | Siemens   |
| **Ouman**                                | Ouman              | Odczyt i zapis                                                                                                                                                                          | W użyciu produkcyjnym        |           |
| **Fidelix Analytics**                    | Fidelix            | Odczyt i zapis                                                                                                                                                                          | W użyciu produkcyjnym        |           |
| **ProptechOS**                           | ProptechOS         | Odczyt i zapis                                                                                                                                                                          | W trakcie opracowywania      |           |

### Szerszy zakres obsługiwanych protokołów dzięki Web Port

Web Port działa jako brama protokołów. Obsługuje szeroki zestaw sterowników do automatyki budynkowej i protokołów przemysłowych. Dzięki temu praktyczny zakres integracji jest znacznie szerszy niż lista wymienionych na tej stronie dostawców.

Jeśli budynek udostępnia wymagane sygnały za pośrednictwem sterownika obsługiwanego przez Web Port, Myrspoven często może przeprowadzić integrację bez dedykowanego złącza dla konkretnego dostawcy. Ostateczna możliwość integracji zależy jednak od dostępności sygnałów, zakresu zapisu, dostępu do sieci i wymagań projektu.

Zobacz [Web Port](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/podlacz-swoj-budynek/bms-integrations/web-port.md) oraz [obsługę sterowników Web Port](https://kiona.com/products/web-port/driver-support).

W przypadku platform niewymienionych tutaj skontaktuj się z Myrspoven, aby ocenić najlepszą ścieżkę integracji — bezpośrednie złącze, Web Port lub Myrspoven AI-API.

### Co jest potrzebne do wdrożenia nowego budynku

Właściciel budynku lub integrator zazwyczaj zapewnia:

* Listę **sygnałów** do odczytu oraz listę dozwolonych wartości zadanych do zapisu. Przygotowywane wspólnie podczas przeglądu technicznego.
* Osobę **kontaktową** po stronie integratora BMS do przeprowadzenia uruchomienia.

W przypadku budynku, którego system BMS znajduje się za zaporą sieciową i wymaga rozwiązania Myrspoven edge, obowiązują dodatkowe wymagania:

* Serwer **wirtualny** w sieci budynku na potrzeby rozwiązania Myrspoven edge (jeśli jest ono używane).
* **Dostęp do sieci wychodzącej** z tego serwera do chmury Myrspoven.
* **Dostęp do systemu BMS** — do odczytu i zapisu — za pośrednictwem obsługiwanego protokołu.
* **Tymczasowy dostęp VPN** na czas instalacji i konfiguracji rozwiązania edge. Ruch operacyjny nie odbywa się przez VPN.

### Bezpieczeństwo

Wszystkie połączenia z systemem BMS są szyfrowane. Zakres zapisu jest ograniczony do uzgodnionej listy wartości zadanych i nie można go rozszerzyć bez jawnej konfiguracji. Rozwiązanie edge odpytuje system wyłącznie w kierunku wychodzącym — w sieci budynku nie są otwierane żadne porty przychodzące.

***


---

# 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.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/podlacz-swoj-budynek/bms-integrations.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.
