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

# Web Port

Web Port är en gateway för ett byggnadsledningssystem (BMS) från Kiona. myCoreAI använder den för att läsa signaler från — och skriva börvärden till — styrskåp och DUC:er via Modbus, BACnet och andra industriella protokoll. Den här sidan täcker hela integreringen: 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.

## 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å driftas av en partner som 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 de slutgiltiga signal- och fallback-skript 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](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net481)).
* En Web Port-licensfil (`WebPort.lic`) från [market.webport.se](https://market.webport.se/webport).
* Nätverksåtkomst från värden till lokala I/O-enheter 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 på Myrspoven för molnsidans inloggningsuppgifter, signalistmallen och Myrspovens edge-bygge.

## Installera den lokala Web Port

{% stepper %}
{% step %}

## Ladda ned den senaste versionen

Ladda ned den senaste Web Port-serverversionen från den [Web Ports releasesida](https://iwmac.zendesk.com/hc/sv/articles/5100183398684-Senaste-releasen-Web-Port).
{% endstep %}

{% step %}

## Kör installationsprogrammet

Kör installationsprogrammet. Leverantörens fullständiga [installationsgenomgång](https://iwmac.zendesk.com/hc/en-gb/articles/6253490179996-Installation#Server) täcker varje skärm. Viktiga val:

* **Drivrutiner:** välj de drivrutiner som krävs för anläggningens protokoll (Modbus TCP, BACnet etc.).
* **Körningsläge:** **Kör som en Windows-tjänst** så att Web Port startar tillsammans med värden.
* **Serverport:** standard `8090`. Ändra endast vid portkonflikter.
  {% endstep %}

{% step %}

## Placera licensfilen

Placera `WebPort.lic` filen i Web Ports datakatalog.
{% endstep %}

{% step %}

## Logga in

Öppna `http://localhost:8090` och logga in.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Byt omedelbart ut standardinloggningsuppgifterna.** Web Port levereras med en standardadministratörsinloggning. Efter den första inloggningen, skapa ett nytt administratörskonto och inaktivera eller byt ut standardkontot innan värden exponeras utanför localhost.
{% endhint %}

## 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](#create-an-io-device).

{% stepper %}
{% step %}

## 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.
   {% endstep %}

{% step %}

## Aktivera anslutningen i Web Port-Cloud

Aktivera anslutningen på Myrspovens sida:

1. Logga in på [https://myrspoven.webport.se](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önt på båda sidor.
{% endstep %}
{% endstepper %}

### Aktivera trendloggning

Trendloggning måste vara aktiverad, 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 driver och förstör efterföljande analys. Verifiera innan du fortsätter.

### Skapa en I/O-enhet

En I/O-enhet länkar 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 varje enhet.

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

{% stepper %}
{% step %}

## 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 konfigureras.
   {% endstep %}
   {% endstepper %}

### Konfigurera I/O-enheten

Det här exemplet täcker Modbus TCP. Andra drivrutiner visar andra fält — se relevant [drivrutinshandboken](https://iwmac.zendesk.com/hc/sv/articles/10579102738332-Drivrutinsmanualer-Web-Port).

{% stepper %}
{% step %}

## Öppna enhetskonfigurationen

Öppna den nya I/O-enheten.
{% endstep %}

{% step %}

## Ange Modbus-fälten

Bläddra till **Slavadress**, **Modbus-typ**, **(TCP) Värd**, **(TCP) Port**.
{% endstep %}

{% step %}

## 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.
  {% endstep %}

{% step %}

## Spara och verifiera

Spara. En nåbar IP med öppen port gör att drivrutinen blir grön med status **OK**.
{% endstep %}
{% endstepper %}

### Skapa en tagglista

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

{% stepper %}
{% step %}

## Öppna Taggar

Öppna **Systeminställningar → Taggar**.
{% endstep %}

{% step %}

## Skapa listan

Klicka på **Ny tagglista**.
{% endstep %}

{% step %}

## 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**.
{% endstep %}
{% endstepper %}

### Skapa taggar

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

{% stepper %}
{% step %}

## Skapa en ny tagg

Klicka på **Ny tagg**.
{% endstep %}

{% step %}

## Fyll i fälten

Fyll i:

* **Namn:** struktur `BuildingName_Unit_Sensor_Property` — t.ex. `ExampleBuilding_HC1_AHU1_TE1_SP`. Konsekventa prefix gör signalistor portabla mellan byggnader. Undvik Å, Ä, Ö — databasen ersätter dem ibland med understreck.
* **I/O-enhet:** enheten som taggen tillhör.
* **Adress:** kopplar 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.
  {% endstep %}

{% step %}

## Spara

Spara taggen och sedan tagglistan.
{% endstep %}
{% endstepper %}

### Filtrera signaler

Exkludera 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

De här stegen görs i [myrspoven.webport.se](https://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.

{% stepper %}
{% step %}

## Skapa gruppen

1. Öppna **Systeminställningar → Grupper**.
2. Klicka på **Ny grupp**.
3. **Gruppnamn:** byggnadens namn plus protokollsuffix — t.ex. `ExampleBuilding_Modbusgrupp`.
4. Lämna resten på standardvärdena och spara.
   {% endstep %}
   {% endstepper %}

### Skapa användare

Tre användare per byggnad: **identifiering**, **läs**, **skriv**.

{% stepper %}
{% step %}

## Skapa en användare

1. Öppna **Systeminställningar → Användare**.
2. Klicka på **Ny användare**.
3. Ange användarnamnet:
   * `BuildingName_identifiering`
   * `BuildingName_läs`
   * `BuildingName_skriv`
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 till byggnadens grupp och spara.
6. Upprepa för de återstående användarna.
   {% endstep %}
   {% endstepper %}

### Bevilja behörigheter

#### Taggbehörigheter

{% stepper %}
{% step %}

## 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.
   {% endstep %}
   {% endstepper %}

#### Funktionsbehörigheter

{% stepper %}
{% step %}

## 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.
   {% endstep %}
   {% endstepper %}

## Installera Myrspovens 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.

{% stepper %}
{% step %}

## Skaffa bygget

Skaffa den senaste Myrspoven edge-versionen från Myrspoven.
{% endstep %}

{% step %}

## Skapa mappen

Skapa `C:\Myrspoven` på värden.
{% endstep %}

{% step %}

## Kopiera och extrahera paketet

Kopiera edge-paketet till `C:\Myrspoven\MyrspovenEDGE` och packa upp det. Ge den uppackade mappen namnet `Myrspoven Edge`. Ta bort zip-filen när extraktionen har verifierats.
{% endstep %}

{% step %}

## Skapa schemaläggningsmappen

Öppna Windows Aktivitetsschemaläggaren och skapa en `Myrspoven` mapp.
{% endstep %}

{% step %}

## Lägg till de schemalagda uppgifterna

Skapa inne i den de schemalagda uppgifter som tillhandahålls av Myrspoven (namn, åtgärder och utlösare är fördefinierade).
{% endstep %}

{% step %}

## Konfigurera inloggningsuppgifter

Konfigurera de inloggningsuppgifter som de schemalagda uppgifterna körs som.
{% endstep %}

{% step %}

## Testa edge-komponenten

Testa Myrspoven edge manuellt från en kommandotolk innan du förlitar dig på utlösarna. Bekräfta att signaler visas i myCoreAI inom det förväntade intervallet.
{% endstep %}
{% endstepper %}

## Slutför i myPortal

De sista stegen görs i myPortal:

{% stepper %}
{% step %}

## Välj byggnaden

Välj byggnaden.
{% endstep %}

{% step %}

## Öppna verktyget Web Port Script

Öppna **Verktyg → Web Port Script**.
{% endstep %}

{% step %}

## Generera skripten

Följ instruktionerna i appen för att generera signalskriptet och fallback-skriptet.
{% endstep %}

{% step %}

## Justera vid behov

Justera skriptet i en textredigerare vid behov.
{% endstep %}

{% step %}

## Klistra in i Web Port

Klistra in skriptet i den lokala Web Port.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
myPortals instruktioner i appen är giltiga. Vid eventuell konflikt med den här sidan under skriptgenerering har myPortal företräde.
{% endhint %}

## 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 upptagen.
* **Signaler samlade 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.** Kontrollera att den schemalagda uppgiftens inloggningsuppgifter har läsåtkomst till Web Ports datakatalog och utgående nätverksåtkomst.
* **Drivrutinen visas röd, 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.


---

# 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-sv/integrationer/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.