Web Port

Web Port är en gateway för byggnadshanteringssystem (BMS). myCoreAI använder det för att läsa signaler, skriva börvärden och styra PLC:er via Modbus, BACnet och andra industriella protokoll. Den här sidan täcker den fullständiga integrationen: installation av en lokal Web Port-server, anslutning till Myrspovens Web Port-Cloud, konfiguration av enheter och taggar samt slutförande av signalflödet i myPortal.

Varför Web Port är viktigt

Web Port är inte bara en enda leverantörsintegration. Det är en protokollgateway med drivrutinsstöd för ett brett utbud av byggnads- och industriella enheter.

Det betyder att Myrspoven inte är begränsat till en kort leverantörslista när Web Port är leveransvägen. Om det lokala systemet exponerar de signaler som krävs via en drivrutin som stöds, kan Myrspoven ofta integrera via Web Port i stället för att behöva en dedikerad anslutning för det BMS-varumärket.

Slutlig lämplighet beror fortfarande på signalernas tillgänglighet, skrivomfattning, nätverksåtkomst och idriftsättningskrav. Se stöd för Web Port-drivrutiner för aktuell drivrutinstäckning.

Komponenter

Integrationen har tre delar:

1. Lokal Web Port. En Windows-tjänst som körs på plats (eller bakom en VPN) och som kommunicerar direkt med styrskåp och DUC:er. Kan också drivas av en partner som molntjänst.
2. Myrspovens Web Port-Cloud. En delad molninstans av Web Port. Den lokala Web Port ansluter upp till den; myCoreAI läser taggar därifrån.
3. myPortal. Genererar de slutliga signal- och fallback-skript som kopplar in byggnaden i myCoreAI.

Förutsättningar

• En Windows-värd för att köra Web Port som en tjänst. Windows 10 eller senare rekommenderas. Äldre versioner kräver .NET Framework 4.8 eller senare (från Microsoft).
• En licensfil för Web Port (WebPort.lic) från market.webport.se.
• Nätverksåtkomst från värden till I/O-enheter på plats och till Myrspovens Web Port-Cloud på https://myrspoven.webport.se.
• Administratörsrättigheter på värden (krävs för att installera Web Port som en Windows-tjänst).
• En kontakt på Myrspoven för molnuppgifter, signal-listmallen och Myrspoven edge-bygget.

Installera den lokala Web Port

1

Ladda ner den senaste utgåvan

Ladda ner den senaste Web Port-serverutgåvan från Web Ports releasesida.

2

Kör installationsprogrammet

Kör installationsprogrammet. Leverantörens fullständiga installationsgenomgång täcker varje skärm. Viktiga val:

• Drivrutiner: välj de drivrutiner som krävs för anläggningens protokoll (Modbus TCP, BACnet osv.).
• Körläge: Kör som en Windows-tjänst så att Web Port startar med värden.
• Serverport: standard 8090. Ändra endast vid portkonflikter.

3

Placera licensfilen

Placera WebPort.lic filen i Web Ports datakatalog.

4

Logga in

Öppna http://localhost:8090 och logga in.

Byt ut standarduppgifterna omedelbart. Web Port levereras med ett standardadministratörsinlogg. Efter den första inloggningen, skapa ett nytt administratörskonto och inaktivera eller byt ut standardkontot innan värden exponeras utanför localhost.

Konfigurera den lokala Web Port

Anslut till Web Port-Cloud

Hoppa över det här avsnittet för partnerdriven moln-Web Port — gå direkt till Skapa en I/O-enhet.

1

Anslut från den lokala Web Port

I den lokala Web Port:

1. Öppna Systeminställningar → Kommunikation → Nodkonfiguration.
2. Klicka på Anslut portal.
3. Fyll i:

   • Namn: företags- eller fastighetsnamn.
   • Beskrivning: t.ex. "Web Port-Cloud Myrspoven".
   • Portaladress: https://myrspoven.webport.se/
4. Spara.

2

Aktivera anslutningen i Web Port-Cloud

Aktivera anslutningen på Myrspovens sida:

1. Logga in på https://myrspoven.webport.se.
2. Öppna Systeminställningar → Kommunikation → Nodkonfiguration.
3. Välj den nya noden.
4. Markera Aktiv enhet och spara.

En aktiv anslutning visas grönt på båda sidor.

Aktivera trendloggning

Trendloggning måste vara på, annars lagras ingen signalhistorik.

1. Öppna Systeminställningar → Trend → Grundinställningar.
2. Aktivera Trendstöd och spara.

Kontrollera värdens tidszon

Felaktiga Windows-tidszoner gör att signalernas tidsstämplar förskjuts och stör efterföljande analys. Kontrollera innan du fortsätter.

Skapa en I/O-enhet

En I/O-enhet kopplar Web Port till ett styrskåp eller en DUC. Minst en TCP/IP-enhet krävs. När varje skåp eller DUC har sin egen IP-adress kommunicerar Web Port direkt med var och en.

Exemplet använder Modbus TCP — skapandet är identiskt oavsett drivrutin.

1

Lägg till enheten

1. Öppna Systeminställningar → Kommunikation → Enhet.
2. Klicka på Lägg till enhet.
3. Fyll i:

   • Namn: styrskåpets namn, eller DUC-numret följt av byggnadens namn (t.ex. DUC1-ExampleBuilding).
   • Beskrivning: valfritt.
   • Drivrutin: drivrutinen för anläggningen (Modbus i det här exemplet).
4. Spara. Enheten visas i listan och förblir röd tills den har konfigurerats.

Konfigurera I/O-enheten

Det här exemplet täcker Modbus TCP. Andra drivrutiner visar andra fält — se relevant drivrutinshandbok.

1

Öppna enhetskonfigurationen

Öppna den nya I/O-enheten.

2

Ange Modbus-fälten

Bläddra till Slavadress, Modbus-typ, (TCP) Värd, (TCP) Port.

3

Fyll i värdena

Ange:

• Slavadress: 1 för master eller första DUC, 2 för nästa, och så vidare.
• Modbus-typ: vanligtvis Modbus TCP.
• (TCP) Värd: IP-adressen till styrskåpet eller DUC:en.
• (TCP) Port: 502 är standard för Modbus. Om den är stängd på mål-IP:n, eskalera till anläggningsägaren eller nätverksteamet innan du fortsätter.

4

Spara och verifiera

Spara. En nåbar IP med porten öppen gör drivrutinen grön med status OK.

Skapa en tagglista

Det enklaste tillvägagångssättet är en tom lista som fylls i manuellt.

1

Öppna Taggar

Öppna Systeminställningar → Taggar.

2

Skapa listan

Klicka på Ny tagglista.

3

Namnge och spara

Namn: samma konvention som för I/O-enheten — byggnadens namn plus enheten.

Spara.

För att redigera senare, klicka på taggikonen till vänster om namnet, eller klicka på raden och välj Redigera.

Skapa taggar

Skapandet av taggar är identiskt mellan protokoll — bara adressformatet ändras.

1

Skapa en ny tagg

Klicka på Ny tagg.

2

Fyll i fälten

Fyll i:

• Namn: struktur Byggnadsnamn_Enhet_Sensor_Egenskap — t.ex. ExampleBuilding_HC1_AHU1_TE1_SP. Konsekventa prefix gör signalistor portabla mellan byggnader. Undvik Å, Ä, Ö — databasen ersätter dem ibland med ett understreck.
• I/O-enhet: enheten som taggen tillhör.
• Adress: mappar taggen till det underliggande objektet och styr läs-/skrivåtkomst.
• Datatyp: INT för analog I/O; DIGITAL för digitala signaler (0/1).
• Rå min/max och Slut min/max: skalar det råa värdet.
• Enhet: SI-enhet.
• Format: fyra decimaler är standard.
• Beskrivning: vad taggen representerar.
• Trendlogg: måste vara aktiverad. Ett intervall på 300 sekunder räcker.

3

Spara

Spara taggen och sedan tagglistan.

Filtrera signaler

Uteslut signaler som inte används för optimering eller rapportering. Färre irrelevanta signaler innebär renare mappning senare och mindre brus längre ned i myCoreAI.

Konfigurera Web Port-Cloud

Dessa steg utförs i myrspoven.webport.se och kopplar moln-Web Port till myCoreAI.

Skapa en grupp

Varje byggnad får sin egen grupp. Gruppmedlemmar ärver åtkomst till Web Ports API och till byggnadens taggar, och kopplas till myCoreAI.

1

Skapa gruppen

1. Öppna Systeminställningar → Grupper.
2. Klicka på Ny grupp.
3. Gruppnamn: byggnadens namn plus protokollsuffix — t.ex. ExampleBuilding_Modbusgroup.
4. Lämna resten som standard och spara.

Skapa användare

Tre användare per byggnad: upptäckt, läs, skriv.

1

Skapa en användare

1. Öppna Systeminställningar → Användare.
2. Klicka på Ny användare.
3. Ange användarnamnet:

   • Byggnadsnamn_discovery
   • Byggnadsnamn_read
   • Byggnadsnamn_write
4. Ange ett starkt, unikt lösenord för varje användare och lagra det i en lösenordshanterare. Återanvänd aldrig lösenord mellan byggnader. Inga inledande eller avslutande mellanslag.
5. Tilldela användaren byggnadens grupp och spara.
6. Upprepa för de återstående användarna.

Tilldela behörigheter

Taggbehörigheter

1

Skapa taggbehörigheten

1. Öppna Systeminställningar → Åtkomst → Behörigheter.
2. Klicka på Ny behörighet → Ny taggbehörighet.
3. Ange:

   • Användare/grupp: byggnadens grupp.
   • Taggfilter: byggnadens namn följt av _* (t.ex. ExampleBuilding_*). Begränsar behörigheten till den byggnadens taggar.
   • Behörigheter: ADMIN.
4. Spara.

Funktionsbehörigheter

1

Skapa funktionsbehörigheten

1. Öppna Systeminställningar → Åtkomst → Behörigheter.
2. Klicka på Ny behörighet → Ny funktionsbehörighet.
3. Ange:

   • Användare/grupp: byggnadens grupp.
   • Funktion: API-åtkomst.
   • Behörigheter: ADMIN.
4. Spara.

Installera Myrspoven edge

Myrspoven edge läser taggar från Web Port och vidarebefordrar dem till myCoreAI. Den körs på samma värd som Web Port eller på en värd med nätverksåtkomst till den.

1

Hämta bygget

Hämta det senaste Myrspoven edge-bygget från Myrspoven.

2

Skapa mappen

Skapa C:\\Myrspoven på värden.

3

Kopiera och packa upp paketet

Kopiera edge-paketet till C:\\Myrspoven\\MyrspovenEDGE och packa upp det. Namnge den uppackade mappen Myrspoven Edge. Ta bort zip-filen när uppackningen har verifierats.

4

Skapa schemaläggningsmappen

Öppna Windows Aktivitetsschemaläggaren och skapa en Myrspoven mapp.

5

Lägg till de schemalagda uppgifterna

Skapa där de schemalagda uppgifter som tillhandahålls av Myrspoven (namn, åtgärder och utlösare är fördefinierade).

6

Konfigurera autentiseringsuppgifter

Konfigurera de autentiseringsuppgifter som de schemalagda uppgifterna körs med.

7

Testa edge

Testa Myrspoven edge manuellt från kommandotolken innan du förlitar dig på utlösarna. Bekräfta att signalerna visas i myCoreAI inom förväntat intervall.

Slutför i myPortal

De sista stegen sker i myPortal:

1

Välj byggnaden

Välj byggnaden.

2

Öppna Web Port Script-verktyget

Öppna Verktyg → Web Port Script.

3

Generera skripten

Följ instruktionerna i appen för att generera signal-skriptet och fallback-skriptet.

4

Justera vid behov

Justera skriptet i en textredigerare vid behov.

5

Klistra in i Web Port

Klistra in skriptet i den lokala Web Port.

myPortals instruktioner i appen är de som gäller. Vid konflikt med den här sidan under skriptgenereringen är det myPortal som gäller.

Felsökning

• Web Port startar inte som en tjänst. Kontrollera Windows-händelseloggen. Vanligaste orsakerna: saknad eller utgången licensfil, eller en annan process som håller den konfigurerade porten.
• Signaler samlas in men tidsstämplarna ser fel ut. Kontrollera värdens tidszon igen och bekräfta att Trend grundinställningar är aktiverat.
• Myrspoven edge körs manuellt men inte från Aktivitetsschemaläggaren. Verifiera att den schemalagda uppgiftens autentiseringsuppgifter har läsbehörighet till Web Ports datakatalog och utgående nätverksåtkomst.
• Drivrutinen visas röd, inte OK. Bekräfta att mål-IP:n kan nås från värden och att den konfigurerade TCP-porten (502 för Modbus) är öppen hela vägen.