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 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).
• Plik licencji Web Port (WebPort.lic) z market.webport.se.
• 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

1

Pobierz najnowsze wydanie

Pobierz najnowsze wydanie serwera Web Port ze strony wydania Web Port.

2

Uruchom instalator

Uruchom instalator. Pełna instrukcja instalacji 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.

3

Umieść plik licencji

Umieść WebPort.lic plik w katalogu danych Web Port.

4

Zaloguj się

Otwórz http://localhost:8090 i zaloguj się.

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.

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.

1

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.

2

Aktywuj połączenie w Web Port-Cloud

Aktywuj połączenie po stronie Myrspoven:

1. Zaloguj się do 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.

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.

1

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.

Skonfiguruj urządzenie I/O

Ten przykład obejmuje Modbus TCP. Inne sterowniki udostępniają inne pola — zobacz odpowiednią instrukcję sterownika.

1

Otwórz konfigurację urządzenia

Otwórz nowe urządzenie I/O.

2

Ustaw pola Modbus

Przewiń do Adres slave, Typ Modbus, (TCP) Host, (TCP) Port.

3

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.

4

Zapisz i zweryfikuj

Zapisz. Dostępny adres IP z otwartym portem zmienia sterownik na zielony ze stanem OK.

Utwórz listę tagów

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

1

Otwórz Tagi

Otwórz Ustawienia systemowe → Tagi.

2

Utwórz listę

Kliknij Nowa lista tagów.

3

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.

Utwórz tagi

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

1

Utwórz nowy tag

Kliknij Nowy tag.

2

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.

3

Zapisz

Zapisz tag, a następnie listę tagów.

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 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.

1

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.

Utwórz użytkowników

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

1

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.

Nadaj uprawnienia

Uprawnienia tagów

1

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.

Uprawnienia funkcji

1

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.

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.

1

Uzyskaj build

Uzyskaj najnowszy build Myrspoven edge od Myrspoven.

2

Utwórz folder

Utwórz C:\Myrspoven na hoście.

3

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.

4

Utwórz folder harmonogramu

Otwórz Harmonogram zadań systemu Windows i utwórz Myrspoven folder.

5

Dodaj zaplanowane zadania

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

6

Skonfiguruj poświadczenia

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

7

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.

Zakończ w myPortal

Ostatnie kroki wykonuje się w myPortal:

1

Wybierz budynek

Wybierz budynek.

2

Otwórz narzędzie Web Port Script

Otwórz Narzędzia → Web Port Script.

3

Wygeneruj skrypty

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

4

Dostosuj w razie potrzeby

W razie potrzeby dostosuj skrypt w edytorze tekstu.

5

Wklej do Web Port

Wklej skrypt do lokalnego Web Port.

Instrukcje w myPortal są nadrzędne. W przypadku jakiegokolwiek konfliktu z tą stroną podczas generowania skryptu, decyduje myPortal.

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.