> 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 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](https://kiona.com/products/web-port/driver-support) 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](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net481)).
* En licensfil för Web Port (`WebPort.lic`) från [market.webport.se](https://market.webport.se/webport).
* 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

{% stepper %}
{% step %}

## Ladda ner den senaste utgåvan

Ladda ner den senaste Web Port-serverutgåvan från [Web Ports utgivningssida](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 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.
  {% 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 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.
{% endhint %}

## 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](#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ön på båda sidor.
{% endstep %}
{% endstepper %}

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

{% 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 webbplatsen (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 den relevanta [drivrutinshandboken](https://iwmac.zendesk.com/hc/sv/articles/10579102738332-Drivrutinsmanualer-Web-Port).

{% stepper %}
{% step %}

## Öppna enhetskonfigurationen

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

{% step %}

## Ställ in Modbus-fälten

Rulla till **Slavadress**, **Modbus-typ**, **(TCP) värd**, **(TCP) port**.
{% endstep %}

{% step %}

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

{% step %}

## Spara och verifiera

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

Om du vill redigera senare, klicka på taggikonen till vänster om namnet, eller klicka på raden och välj **Redigera**.
{% endstep %}
{% endstepper %}

### Skapa taggar

Taggskapandet är identiskt för alla 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 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.
  {% endstep %}

{% step %}

## Spara

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

### 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](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 följt av protokollsuffix — t.ex. `ExampleBuilding_Modbusgroup`.
4. Lämna resten på standardvärden och spara.
   {% endstep %}
   {% endstepper %}

### Skapa användare

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

{% stepper %}
{% step %}

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

### Tilldela 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. 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.
   {% 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. Ställ in:
   * **Användare/Grupp:** byggnadens grupp.
   * **Funktion:** **API-åtkomst**.
   * **Behörigheter:** **ADMIN**.
4. Spara.
   {% endstep %}
   {% endstepper %}

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

{% stepper %}
{% step %}

## Hämta bygget

Hämta 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. Namnge den uppackade mappen `Myrspoven Edge`. Ta bort zip-filen när extraheringen har verifierats.
{% endstep %}

{% step %}

## Skapa schemapappen

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

{% step %}

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

{% step %}

## Konfigurera autentiseringsuppgifter

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

{% step %}

## 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.
{% 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 signal- och fallbackskriptet.
{% 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 vägledande. Vid eventuell konflikt med den här sidan under skriptgenerering gäller myPortal.
{% endhint %}

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


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-sv/integrationer/overview/bms-integrations/web-port.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.