Webbport

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

Varför Web Port är viktigt

Web Port är inte bara en integration för en enskild leverantör. Det är en protokollgateway med drivrutinsstöd för ett brett spektrum 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 genom en drivrutin som stöds, kan Myrspoven ofta integreras via Web Port i stället för att behöva en dedikerad connector för det BMS-varumärket.

Den slutliga lämpligheten beror fortfarande på signalernas tillgänglighet, skrivomfattning, nätverksåtkomst och driftsättningskrav. Se Web Port-drivrutinsstöd 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 kommunicerar direkt med styrskåp och DUC:er. Kan också drivas av partner som en molntjänst.
2. Myrspovens Web Port-Cloud. En delad Web Port-instans i molnet. Den lokala Web Port ansluter uppåt till den; myCoreAI läser taggar därifrån.
3. myPortal. Genererar det slutliga signal- och fallbackskriptet som kopplar byggnaden till 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 kontaktperson hos Myrspoven för molnuppgifter, signal-listmallen och Myrspovens edge-bygge.

Installera den lokala Web Port

1

Ladda ner den senaste utgåvan

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

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 webbplatsens 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 standarduppgifterna omedelbart. Web Port levereras med en standardinloggning för administratör. Efter den första inloggningen, skapa ett nytt administratörskonto och inaktivera eller byt standarduppgifterna 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 Web Port-Cloud som driftas av partner — 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 → Nodinställning.
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 → Nodinställning.
3. Välj den nya noden.
4. Markera Aktiv enhet och spara.

En aktiv anslutning visas grön 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.

Verifiera värdens tidszon

Felaktiga Windows-tidszoner gör att signalernas tidsstämplar glider och förstör vidare analys. Verifiera 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 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 webbplatsen (Modbus i det här exemplet).
4. Spara. Enheten visas i listan och förblir röd tills den konfigureras.

Konfigurera I/O-enheten

Det här exemplet täcker Modbus TCP. Andra drivrutiner visar andra fält — se den relevanta drivrutinshandboken.

1

Öppna enhetskonfigurationen

Öppna den nya I/O-enheten.

2

Ställ in Modbus-fälten

Rulla till Slavadress, Modbus-typ, (TCP) värd, (TCP) port.

3

Fyll i värdena

Ställ in:

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

4

Spara och verifiera

Spara. En nåbar IP med öppen port gör drivrutinen grön med tillståndet 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.

Om du vill redigera senare, klicka på taggikonen till vänster om namnet, eller klicka på raden och välj Redigera.

Skapa taggar

Taggskapandet är identiskt för alla protokoll — endast adressformatet ändras.

1

Skapa en ny tagg

Klicka på Ny tagg.

2

Fyll i fälten

Fyll i:

• Namn: struktur BuildingName_Unit_Sensor_Property — t.ex. ExampleBuilding_HC1_AHU1_TE1_SP. Konsekventa prefix gör signallistor flyttbara 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-/skrivrättighet.
• Datatyp: INT för analog I/O; DIGITAL för digitala signaler (0/1).
• Rå min/max och Slut min/max: skalar rå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 alla 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 gö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 följt av protokollsuffix — t.ex. ExampleBuilding_Modbusgroup.
4. Lämna resten på standardvärden 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. Ställ in användarnamnet:

   • BuildingName_discovery
   • BuildingName_read
   • BuildingName_write
4. Ställ in 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 till byggnadens grupp och spara.
6. Upprepa för återstående användare.

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. Ställ in:

   • 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. Ställ in:

   • 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 skickar dem vidare 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 den senaste Myrspoven edge-versionen från Myrspoven.

2

Skapa mappen

Skapa C:\Myrspoven på värden.

3

Kopiera och extrahera paketet

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

4

Skapa schemapappen

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

5

Lägg till schemalagda uppgifter

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

7

Testa edge

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

Slutför i myPortal

De sista stegen görs i myPortal:

1

Välj byggnaden

Välj byggnaden.

2

Öppna verktyget Web Port Script

Öppna Verktyg → Web Port Script.

3

Generera skripten

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

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 vägledande. Vid eventuell konflikt med den här sidan under skriptgenerering gäller myPortal.

Felsökning

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