> 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 brama Systemu Zarządzania Budynkiem (BMS) firmy Kiona. myCoreAI używa go do odczytu sygnałów — oraz zapisu wartości zadanych — do szaf sterowniczych i DUC-ów 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 finalizację przepływu sygnałów w myPortal.

## Komponenty

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

1. **Lokalny Web Port.** Usługa Windows działająca na miejscu (lub za VPN), która komunikuje się bezpośrednio z szafami sterowniczymi i DUC-ami. 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ę do niej w górę; myCoreAI odczytuje stamtąd tagi.
3. **myPortal.** Generuje końcowy skrypt sygnałowy i skrypt awaryjny, które podłączają budynek do myCoreAI.

## Wymagania wstępne

* Host 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 i 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).
* Osoba kontaktowa w Myrspoven w sprawie poświadczeń po stronie chmury, szablonu listy sygnałów i wersji edge Myrspoven.

## Zainstaluj lokalny Web Port

{% stepper %}
{% step %}

## Pobierz najnowsze wydanie

Pobierz najnowsze wydanie serwera Web Port ze strony [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 używanych w obiekcie (Modbus TCP, BACnet itp.).
* **Tryb uruchomienia:** **Uruchom jako usługę Windows** aby Web Port uruchamiał się 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 admina i wyłącz lub zmień domyślne, zanim host zostanie udostępniony poza localhostem.
{% endhint %}

## Skonfiguruj lokalny Web Port

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

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

{% stepper %}
{% step %}

## Połącz 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 oznaczone na zielono po obu stronach.
{% endstep %}
{% endstepper %}

### Włącz rejestrowanie trendów

Rejestrowanie trendów musi być włączone, w przeciwnym razie nie będzie 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 Windows powodują przesunięcie 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ę bezpośrednio z każdym z nich.

Przykład używa Modbus TCP — tworzenie 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 albo numer DUC z dopiskiem nazwy budynku (np. `DUC1-PrzykładowyBudynek`).
   * **Opis:** opcjonalne.
   * **Sterownik:** sterownik używany w obiekcie (w tym przykładzie Modbus).
4. Zapisz. Urządzenie pojawi się na liście i pozostanie czerwone, dopóki nie zostanie skonfigurowane.
   {% endstep %}
   {% endstepper %}

### Skonfiguruj urządzenie I/O

Ten przykład dotyczy 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 urządzenia nadrzędnego 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 port na docelowym IP jest zamknięty, eskaluj sprawę do właściciela obiektu lub zespołu sieciowego przed kontynuowaniem.
  {% endstep %}

{% step %}

## Zapisz i zweryfikuj

Zapisz. Osiągalny adres IP z otwartym portem zmienia kolor sterownika na zielony ze stanem **OK**.
{% endstep %}
{% endstepper %}

### Utwórz listę tagów

Najprostszym podejściem jest pusta lista, uzupeł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:** taka sama konwencja jak dla urządzenia I/O — nazwa budynku plus urządzenie.

Zapisz.

Aby później edytować, kliknij ikonę tagu po lewej stronie nazwy albo 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 `BuildingName_Unit_Sensor_Property` — np. `ExampleBuilding_HC1_AHU1_TE1_SP`. Spójne prefiksy sprawiają, że listy sygnałów są przenośne między budynkami. Unikaj Å, Ä, Ö — baza danych czasem zastępuje je podkreślnikiem.
* **Urządzenie I/O:** urządzenie, do którego należy tag.
* **Adres:** mapuje tag do obiektu bazowego i kontroluje dostęp do odczytu/zapisu.
* **Typ danych:** `INT` dla wejść/wyjść analogowych; `CYFROWY` dla sygnałów cyfrowych (0/1).
* **Surowe min./maks.** i **Końcowe min./maks.:** skalują surową wartość.
* **Jednostka:** jednostka SI.
* **Format:** cztery miejsca po przecinku to standard.
* **Opis:** co reprezentuje tag.
* **Dziennik trendów:** musi być włączony. Wystarczy interwał 300-sekundowy.
  {% endstep %}

{% step %}

## Zapisz

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

### Filtruj sygnały

Wyklucz każdy sygnał nieużywany do optymalizacji ani raportowania. Mniej 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 podłącza chmurowy Web Port do myCoreAI.

### Utwórz grupę

Każdy budynek otrzymuje własną grupę. Członkowie grupy dziedziczą dostęp do API Web Port oraz do tagów budynku i 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ę ustawień domyślnych 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 %}

### Przyznaj 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 %}

## Pobierz wersję

Pobierz najnowszą wersję 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ń archiwum zip po potwierdzeniu rozpakowania.
{% endstep %}

{% step %}

## Utwórz folder harmonogramu

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

{% step %}

## Dodaj zaplanowane zadania

W nim utwórz zaplanowane zadania dostarczone przez Myrspoven (nazwy, akcje i wyzwalacze są z góry zdefiniowane).
{% endstep %}

{% step %}

## Skonfiguruj dane logowania

Skonfiguruj dane logowania, na których uruchamiane są 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 %}

## Dokoń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łowy i skrypt awaryjny.
{% endstep %}

{% step %}

## Dostosuj, jeśli trzeba

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 aplikacji 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ń Windows. Najczęstsze przyczyny: brakujący lub wygasły plik licencji albo inny proces zajmujący skonfigurowany port.
* **Sygnały są zbierane, ale znaczniki czasu wyglądają nieprawidłowo.** Ponownie sprawdź strefę czasową hosta i potwierdź, że podstawowe ustawienia Trend są włączone.
* **Myrspoven edge działa ręcznie, ale nie z Harmonogramu zadań.** Sprawdź, czy dane logowania zadania mają dostęp do odczytu do katalogu danych Web Port oraz wychodzący dostęp sieciowy.
* **Sterownik jest czerwony, a nie OK.** Potwierdź, że docelowy adres IP jest osiągalny z hosta, a skonfigurowany port TCP (502 dla Modbus) jest otwarty na całej trasie.


---

# 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:

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

The question should be specific, self-contained, and written in natural language.
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.