> 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/integracje/overview/bms-integrations/web-port.md).

# Web Port

Web Port to bramka systemu zarządzania budynkiem (BMS). myCoreAI używa jej do odczytu sygnałów, zapisu wartości zadanych oraz sterowania PLC przez Modbus, BACnet i inne protokoły przemysłowe. Ta strona obejmuje pełną integrację: instalację lokalnego serwera Web Port, połączenie go z Web Port-Cloud firmy Myrspoven, konfigurację urządzeń i tagów oraz finalne uruchomienie przepływu sygnałów w myPortal.

## Dlaczego Web Port ma znaczenie

Web Port to nie tylko integracja z jednym dostawcą. To bramka protokołów z obsługą sterowników dla szerokiej gamy urządzeń budynkowych i przemysłowych.

Oznacza to, że Myrspoven nie jest ograniczony do krótkiej listy dostawców, gdy Web Port jest ścieżką dostarczenia. Jeśli lokalny system udostępnia wymagane sygnały przez obsługiwany sterownik, Myrspoven często może zintegrować się przez Web Port zamiast potrzebować dedykowanego łącznika dla tej marki BMS.

Końcowe dopasowanie nadal zależy od dostępności sygnałów, zakresu zapisu, dostępu do sieci i wymagań uruchomieniowych. Zobacz [obsługę sterowników Web Port](https://kiona.com/products/web-port/driver-support) aktualny zakres obsługiwanych sterowników.

## Komponenty

Integracja składa się z trzech części:

1. **Lokalny Web Port.** Usługa systemu Windows uruchamiana na miejscu (lub za VPN), która komunikuje się bezpośrednio z szafami sterowniczymi i DUC. Może też być hostowana przez partnera jako usługa chmurowa.
2. **Web Port-Cloud firmy Myrspoven.** Wspólna chmurowa instancja Web Port. Lokalny Web Port łączy się z nią w górę; myCoreAI odczytuje stamtąd tagi.
3. **myPortal.** Generuje końcowy skrypt sygnałów i skrypt awaryjny, które łączą budynek z myCoreAI.

## Wymagania wstępne

* Host z systemem Windows do uruchomienia Web Port jako usługi. Zalecany Windows 10 lub nowszy. Starsze wersje wymagają .NET Framework 4.8 lub nowszego (z [Microsoft](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net481)).
* Plik licencji Web Port (`WebPort.lic`) z [market.webport.se](https://market.webport.se/webport).
* Dostęp sieciowy z hosta do lokalnych urządzeń I/O oraz do Web Port-Cloud firmy Myrspoven pod adresem `https://myrspoven.webport.se`.
* Uprawnienia administratora na hoście (wymagane do zainstalowania Web Port jako usługi Windows).
* Kontakt w Myrspoven do uzyskania poświadczeń po stronie chmury, szablonu listy sygnałów i builda brzegowego Myrspoven.

## Zainstaluj lokalny Web Port

{% stepper %}
{% step %}

## Pobierz najnowsze wydanie

Pobierz najnowsze wydanie serwera Web Port ze strony [wydania Web Port](https://iwmac.zendesk.com/hc/sv/articles/5100183398684-Senaste-releasen-Web-Port).
{% endstep %}

{% step %}

## Uruchom instalator

Uruchom instalator. Pełna [instrukcja instalacji](https://iwmac.zendesk.com/hc/en-gb/articles/6253490179996-Installation#Server) obejmuje każdy ekran. Kluczowe wybory:

* **Sterowniki:** wybierz sterowniki wymagane dla protokołów w obiekcie (Modbus TCP, BACnet itd.).
* **Tryb uruchamiania:** **Uruchamiaj jako usługę systemu Windows** tak, aby Web Port startował wraz z hostem.
* **Port serwera:** domyślny `8090`. Zmieniaj tylko w przypadku konfliktu portów.
  {% endstep %}

{% step %}

## Umieść plik licencji

Umieść `WebPort.lic` plik w katalogu danych Web Port.
{% endstep %}

{% step %}

## Zaloguj się

Otwórz `http://localhost:8090` i zaloguj się.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Natychmiast zmień domyślne dane logowania.** Web Port jest dostarczany z domyślnym kontem administratora. Po pierwszym logowaniu utwórz nowe konto administratora i wyłącz lub zmień domyślne, zanim host zostanie wystawiony poza localhost.
{% endhint %}

## Skonfiguruj lokalny Web Port

### Połącz z Web Port-Cloud

Pomiń tę sekcję dla chmurowego Web Port hostowanego przez partnera — przejdź od razu do [Utwórz urządzenie I/O](#create-an-io-device).

{% stepper %}
{% step %}

## Połączenie z lokalnego Web Port

W lokalnym Web Port:

1. Otwórz **Ustawienia systemowe → Komunikacja → Konfiguracja węzła**.
2. Kliknij **Połącz portal**.
3. Wypełnij:
   * **Nazwa:** nazwa firmy lub nieruchomości.
   * **Opis:** np. „Web Port-Cloud Myrspoven”.
   * **Adres portalu:** `https://myrspoven.webport.se/`
4. Zapisz.
   {% endstep %}

{% step %}

## Aktywuj połączenie w Web Port-Cloud

Aktywuj połączenie po stronie Myrspoven:

1. Zaloguj się do [https://myrspoven.webport.se](https://myrspoven.webport.se/).
2. Otwórz **Ustawienia systemowe → Komunikacja → Konfiguracja węzła**.
3. Wybierz nowy węzeł.
4. Zaznacz **Aktywne urządzenie** i zapisz.

Aktywne połączenie jest zielone po obu stronach.
{% endstep %}
{% endstepper %}

### Włącz logowanie trendów

Logowanie trendów musi być włączone, inaczej nie jest zapisywana historia sygnałów.

1. Otwórz **Ustawienia systemowe → Trend → Ustawienia podstawowe**.
2. Włącz **Obsługa trendów** i zapisz.

### Sprawdź strefę czasową hosta

Nieprawidłowe strefy czasowe systemu Windows powodują przesunięcia znaczników czasu sygnałów i psują dalszą analizę. Sprawdź przed kontynuowaniem.

### Utwórz urządzenie I/O

Urządzenie I/O łączy Web Port z szafą sterowniczą lub DUC. Wymagane jest co najmniej jedno urządzenie TCP/IP. Gdy każda szafa lub DUC ma własny adres IP, Web Port komunikuje się z każdym z nich bezpośrednio.

Przykład wykorzystuje Modbus TCP — utworzenie jest identyczne niezależnie od sterownika.

{% stepper %}
{% step %}

## Dodaj urządzenie

1. Otwórz **Ustawienia systemowe → Komunikacja → Urządzenie**.
2. Kliknij **Dodaj urządzenie**.
3. Wypełnij:
   * **Nazwa:** nazwa szafy sterowniczej lub numer DUC z sufiksem nazwy budynku (np. `DUC1-ExampleBuilding`).
   * **Opis:** opcjonalnie.
   * **Sterownik:** sterownik dla obiektu (w tym przykładzie Modbus).
4. Zapisz. Urządzenie pojawia się na liście i pozostaje czerwone, dopóki nie zostanie skonfigurowane.
   {% endstep %}
   {% endstepper %}

### Skonfiguruj urządzenie I/O

Ten przykład obejmuje Modbus TCP. Inne sterowniki udostępniają inne pola — zobacz odpowiednią [instrukcję sterownika](https://iwmac.zendesk.com/hc/sv/articles/10579102738332-Drivrutinsmanualer-Web-Port).

{% stepper %}
{% step %}

## Otwórz konfigurację urządzenia

Otwórz nowe urządzenie I/O.
{% endstep %}

{% step %}

## Ustaw pola Modbus

Przewiń do **Adres slave**, **Typ Modbus**, **(TCP) Host**, **(TCP) Port**.
{% endstep %}

{% step %}

## Wypełnij wartości

Ustaw:

* **Adres slave:** `1` dla mastera lub pierwszego DUC, `2` dla następnego i tak dalej.
* **Typ Modbus:** zazwyczaj **Modbus TCP**.
* **(TCP) Host:** adres IP szafy sterowniczej lub DUC.
* **(TCP) Port:** `502` jest standardem dla Modbus. Jeśli na docelowym adresie IP jest zamknięty, zgłoś to właścicielowi obiektu lub zespołowi sieciowemu przed kontynuowaniem.
  {% endstep %}

{% step %}

## Zapisz i zweryfikuj

Zapisz. Dostępny adres IP z otwartym portem zmienia sterownik na zielony ze stanem **OK**.
{% endstep %}
{% endstepper %}

### Utwórz listę tagów

Najprostsze podejście to pusta lista, wypełniana ręcznie.

{% stepper %}
{% step %}

## Otwórz Tagi

Otwórz **Ustawienia systemowe → Tagi**.
{% endstep %}

{% step %}

## Utwórz listę

Kliknij **Nowa lista tagów**.
{% endstep %}

{% step %}

## Nadaj nazwę i zapisz

**Nazwa:** ta sama konwencja co dla urządzenia I/O — nazwa budynku plus urządzenie.

Zapisz.

Aby edytować później, kliknij ikonę tagu po lewej stronie nazwy lub kliknij wiersz i wybierz **Edytuj**.
{% endstep %}
{% endstepper %}

### Utwórz tagi

Tworzenie tagów jest identyczne we wszystkich protokołach — zmienia się tylko format adresu.

{% stepper %}
{% step %}

## Utwórz nowy tag

Kliknij **Nowy tag**.
{% endstep %}

{% step %}

## Wypełnij pola

Wypełnij:

* **Nazwa:** struktura `NazwaBudynku_Jednostka_Czujnik_Właściwość` — np. `ExampleBuilding_HC1_AHU1_TE1_SP`. Spójne prefiksy sprawiają, że listy sygnałów są przenośne między budynkami. Unikaj Å, Ä, Ö — baza danych czasami zastępuje je podkreśleniem.
* **Urządzenie I/O:** urządzenie, do którego należy tag.
* **Adres:** mapuje tag na obiekt bazowy i kontroluje dostęp do odczytu/zapisu.
* **Typ danych:** `INT` dla wejść/wyjść analogowych; `DIGITAL` dla sygnałów cyfrowych (0/1).
* **Surowe min./maks.** oraz **Krańcowe min./maks.:** skalują surową wartość.
* **Jednostka:** jednostka SI.
* **Format:** cztery miejsca po przecinku to standard.
* **Opis:** co oznacza tag.
* **Log trendów:** musi być włączone. Wystarczy interwał 300 sekund.
  {% endstep %}

{% step %}

## Zapisz

Zapisz tag, a następnie listę tagów.
{% endstep %}
{% endstepper %}

### Filtruj sygnały

Wyklucz każdy sygnał, który nie jest używany do optymalizacji lub raportowania. Mniejsza liczba nieistotnych sygnałów oznacza czystsze mapowanie później i mniej szumu dalej w myCoreAI.

## Skonfiguruj Web Port-Cloud

Te kroki wykonuje się w [myrspoven.webport.se](https://myrspoven.webport.se/) i łączy chmurowy Web Port z myCoreAI.

### Utwórz grupę

Każdy budynek ma własną grupę. Członkowie grupy dziedziczą dostęp do API Web Port i do tagów budynku oraz są powiązani z myCoreAI.

{% stepper %}
{% step %}

## Utwórz grupę

1. Otwórz **Ustawienia systemowe → Grupy**.
2. Kliknij **Nowa grupa**.
3. **Nazwa grupy:** nazwa budynku plus sufiks protokołu — np. `ExampleBuilding_Modbusgroup`.
4. Pozostaw resztę jako domyślne i zapisz.
   {% endstep %}
   {% endstepper %}

### Utwórz użytkowników

Trzech użytkowników na budynek: **discovery**, **read**, **write**.

{% stepper %}
{% step %}

## Utwórz użytkownika

1. Otwórz **Ustawienia systemowe → Użytkownicy**.
2. Kliknij **Nowy użytkownik**.
3. Ustaw nazwę użytkownika:
   * `BuildingName_discovery`
   * `BuildingName_read`
   * `BuildingName_write`
4. Ustaw silne, unikalne hasło dla każdego użytkownika i przechowuj je w menedżerze haseł. Nigdy nie używaj ponownie haseł między budynkami. Bez spacji na początku ani na końcu.
5. Przypisz użytkownika do grupy budynku i zapisz.
6. Powtórz dla pozostałych użytkowników.
   {% endstep %}
   {% endstepper %}

### Nadaj uprawnienia

#### Uprawnienia tagów

{% stepper %}
{% step %}

## Utwórz uprawnienie do tagów

1. Otwórz **Ustawienia systemowe → Dostęp → Uprawnienia**.
2. Kliknij **Nowe uprawnienie → Nowe uprawnienie do tagów**.
3. Ustaw:
   * **Użytkownik/Grupa:** grupa budynku.
   * **Filtr tagów:** nazwa budynku, po której następuje `_*` (np. `ExampleBuilding_*`). Ogranicza uprawnienie do tagów tego budynku.
   * **Uprawnienia:** **ADMIN**.
4. Zapisz.
   {% endstep %}
   {% endstepper %}

#### Uprawnienia funkcji

{% stepper %}
{% step %}

## Utwórz uprawnienie funkcji

1. Otwórz **Ustawienia systemowe → Dostęp → Uprawnienia**.
2. Kliknij **Nowe uprawnienie → Nowe uprawnienie funkcji**.
3. Ustaw:
   * **Użytkownik/Grupa:** grupa budynku.
   * **Funkcja:** **dostęp do API**.
   * **Uprawnienia:** **ADMIN**.
4. Zapisz.
   {% endstep %}
   {% endstepper %}

## Zainstaluj Myrspoven edge

Myrspoven edge odczytuje tagi z Web Port i przekazuje je do myCoreAI. Działa na tym samym hoście co Web Port albo na hoście z dostępem sieciowym do niego.

{% stepper %}
{% step %}

## Uzyskaj build

Uzyskaj najnowszy build Myrspoven edge od Myrspoven.
{% endstep %}

{% step %}

## Utwórz folder

Utwórz `C:\Myrspoven` na hoście.
{% endstep %}

{% step %}

## Skopiuj i rozpakuj pakiet

Skopiuj pakiet edge do `C:\Myrspoven\MyrspovenEDGE` i rozpakuj go. Nazwij rozpakowany folder `Myrspoven Edge`. Usuń plik zip po potwierdzeniu rozpakowania.
{% endstep %}

{% step %}

## Utwórz folder harmonogramu

Otwórz Harmonogram zadań systemu Windows i utwórz `Myrspoven` folder.
{% endstep %}

{% step %}

## Dodaj zaplanowane zadania

Wewnątrz niego utwórz zaplanowane zadania dostarczone przez Myrspoven (nazwy, akcje i wyzwalacze są już zdefiniowane).
{% endstep %}

{% step %}

## Skonfiguruj poświadczenia

Skonfiguruj poświadczenia, na których działają zaplanowane zadania.
{% endstep %}

{% step %}

## Przetestuj edge

Przetestuj Myrspoven edge ręcznie z wiersza polecenia, zanim zaczniesz polegać na wyzwalaczach. Potwierdź, że sygnały pojawiają się w myCoreAI w oczekiwanym interwale.
{% endstep %}
{% endstepper %}

## Zakończ w myPortal

Ostatnie kroki wykonuje się w myPortal:

{% stepper %}
{% step %}

## Wybierz budynek

Wybierz budynek.
{% endstep %}

{% step %}

## Otwórz narzędzie Web Port Script

Otwórz **Narzędzia → Web Port Script**.
{% endstep %}

{% step %}

## Wygeneruj skrypty

Postępuj zgodnie z instrukcjami w aplikacji, aby wygenerować skrypt sygnałów i skrypt awaryjny.
{% endstep %}

{% step %}

## Dostosuj w razie potrzeby

W razie potrzeby dostosuj skrypt w edytorze tekstu.
{% endstep %}

{% step %}

## Wklej do Web Port

Wklej skrypt do lokalnego Web Port.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Instrukcje w myPortal są nadrzędne. W przypadku jakiegokolwiek konfliktu z tą stroną podczas generowania skryptu, decyduje myPortal.
{% endhint %}

## Rozwiązywanie problemów

* **Web Port nie uruchamia się jako usługa.** Sprawdź Dziennik zdarzeń systemu Windows. Najczęstsze przyczyny: brakujący lub wygasły plik licencji albo inny proces zajmujący skonfigurowany port.
* **Sygnały zebrane, ale znaczniki czasu wyglądają na nieprawidłowe.** Ponownie sprawdź strefę czasową hosta i potwierdź, że włączone są podstawowe ustawienia trendów.
* **Myrspoven edge działa ręcznie, ale nie z Harmonogramu zadań.** Sprawdź, czy poświadczenia zadania mają dostęp do odczytu katalogu danych Web Port oraz wychodzący dostęp do sieci.
* **Sterownik pokazuje czerwony, a nie OK.** Potwierdź, że docelowy adres IP jest osiągalny z hosta i że skonfigurowany port TCP (502 dla Modbus) jest otwarty end-to-end.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/integracje/overview/bms-integrations/web-port.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.