SIA Connect Connector

Connectorn SIA Connect gör det möjligt för plattformen att publicera kommandon och ta emot enhets-uplinks på sin MQTT broker från en SIA Connect IIoT Edge Gateway. SIA Connects edge-gateway stödjer över 30 industriella protokoll, vilket möjliggör smidig integration med ett brett utbud av PLC- och BMS-leverantörer. Den har intuitiv konfigurationsmjukvara och stödjer upp till 500 taggar.

Funktioner som stöds av plattformen:

• Import av enheter
• Ta emot uplink-uppdateringar från enheter
• Publicera kommandon

Nyckelprotokoll som stöds:

• BACnet IP
• BACnet MS/TP
• Beckhoff TwinCAT ADS
• Modbus TCP
• Modbus RTU
• Modbus RTU over TCP
• M-Bus
• Wireless M-Bus (wM-Bus)
• OPC-UA client
• OPC-UA server
• Diverse tillverkarspecifika protokoll.

Connector-detaljer SIA Connect

Nödvändig Information

För att sätta upp en anslutning till en SIA Connect Edge Gateway, ange gatewayens UUID:

• a. Edge Gateway UUID: Detta är den universella unika identifieraren för Edge Gatewayen. Den används i MQTT-topic-strukturen för att identifiera inkommande enhetsuppdateringar från gatewayen.
• b. MQTT Username: MQTT-användarnamnet, ej tillgängligt i gränssnittet och måste konfigureras av plattformens supportteam.
• c. MQTT Password: MQTT-lösenordet, ej tillgängligt i gränssnittet och måste konfigureras av plattformens supportteam.

Valfritt för Kommandon (ej tillgängligt i gränssnittet)

• d. SIA Web Interface URL: URL:en till webbgränssnittet för SIA Edge Gateway
• e. SIA Username: Ditt API-användarnamn.
• f. SIA Password: Ditt API-lösenord.

Så når enhetsdatan Yggio

Varje meddelande som gatewayen publicerar bär ett t-fält, som talar om för Yggio hur det ska läsas. Två värden stöds, bacnet och adstwincat, motsvarande de två mallarna ovan. Ett tredje värde, status, är gatewayens egen hjärtslagssignal: Yggio tar emot den men lagrar den inte.

Varje tagg eller objekt blir en egen enhet. Yggio identifierar en enhet utifrån gatewayens UUID plus vad meddelandet bär med sig, så samma tagg hamnar alltid på samma enhet, och en ny tagg skapar en enhet automatiskt:

Mall	Enheten identifieras av	Namn vid skapande
adstwincat	Gatewayens UUID och taggnamnet	Taggnamnet
bacnet	Gatewayens UUID, objekttyp och objektinstans	SIAConnect-<UUID>

Med TwinCAT ADS innebär det att varje tagg du mappar blir en separat enhet i Yggio, så taggnamngivningen på gatewayen avgör hur din enhetslista ser ut. Namnge dem medvetet.

Beskrivningsfältet blir ett fältnamn. I ADS-mallen lagrar ett ifyllt d värdet under det namnet utöver under taggen, vilket är så en avläsning får ett läsbart fältnamn i stället för bara ett taggnamn.

Obs: unit accepteras i båda mallarna men lagras för närvarande inte på enheten.

Konfigurera Edge Gateway

Hårdvarukonfiguration

Gatewayen levereras förkonfigurerad med en statisk IP 10.20.30.40. Genom att komma åt webbgränssnittet (via den IP:n eller via direkt USB-C-anslutning på 192.168.42.42) kan nätverkskonfigurationen ändras.

Det är viktigt att gatewayen kan komma åt plattformens MQTT broker via det konfigurerade nätverket, eftersom den saknar internetanslutning.

Mjukvarukonfiguration

Gatewayen måste installera MQTT SIA Connector för att kunna ansluta till plattformens MQTT broker.

• För varje protokoll utöver MQTT du vill stödja måste rätt SIA Connector installeras i gatewayen.
• En MQTT-instans för plattformen bör skapas som pekar mot plattformens MQTT broker (mqtt.staging.yggio.net) och med det MQTT-användarnamn och lösenord som konfigurerats på plattformens sida.

Konfigurera Item

Ett Item bör skapas för varje SIA Connector som stödjer uplinks, med följande alternativ:

• Write only
• Topic: siaconnect/%UUID%
• Input template (unik för varje SIA Connector). Exempel för BACnet:

{
"t": "bacnet",
"ts": "%ITEM.VALUE.TIME%",
"v": {
  "unit": "%ITEM.UNIT%",
  "objectType": "%ITEM.OBJECT_TYPE%",
  "objectInstance": "%ITEM.OBJECT_INSTANCE%",
  "property": "%ITEM.PROPERTY%",
  "dataType": "%ITEM.DATA_TYPE%",
  "value": %VALUE%
  }
}

För Varje Uplink-protokoll

Du behöver:

1. Se till att SIA Connector är installerad.
2. Skapa en instance konfigurerad för din enhet.
3. Skapa items för varje input du önskar. Items behöver inkludera MQTT-topic och input template.

Observera: Items bör inte behöva någon ytterligare konfiguration som standard.

Exempel på Beckhoff TwinCAT-installation i SIA Edge Gateway

Lägg till TwinCAT-connectorn

1. Logga in på SIA-instansen.

2. Gå till Connectors i sidomenyn.

3. Lägg till Beckhoff TwinCAT connector om den inte redan är tillagd.

4. Klicka på + Add instance på Beckhoff TwinCAT.

5. Det mesta (om inte all) information bör komma från PLC:n. Rådgör med personerna som arbetar med PLC:n på plats.

   Exempelkonfiguration (med kommentarer):

   • Name: 85000 A ABF01 (PLC för byggnad på plats)
   • Address: 25.75.0.20 (PLC:ns IP-adress)
   • Target Ams NetID: 25.75.0.20.1.1 (Vid skrivandets tidpunkt har alla NetID varit <ip>.1.1, men rådgör med PLC-teamet)
   • Target Ads Port: 851 (PLC:ns ADS-port)
   • Timeout: 5000

Konfigurera Item

1. I sidomenyn, gå till Instances och välj din instans (t.ex. 85000 A AB01).

2. Klicka på knappen + New Item.

3. Konsultera tag-listan för att få informationen.

   Exempelkonfiguration:

   • Name: F85000_EASTERN_A_1501.GT13_AI.rOut
   • Type: REAL
   • Read/Write: Read only
   • Variable Name: F85000_EASTERN_A_1501.GT13_AI.rOut
   • Input template:

{
  "t": "adstwincat",
  "v": %VALUE%,
  "tag": "%ITEM_SENDER.NAME%",
  "type": "%ITEM_SENDER.TYPE%",
  "ts": "%VALUE.EPOCH_TIME_MS%",
  "unit": "%ITEM_SENDER.UNIT%",
  "d": "%ITEM_SENDER.DESCRIPTION%"
}