Hoppa till huvudinnehåll

Connectors

Connectors fungerar som gränssnittet mellan Yggio och externa datakällor genom att hantera nödvändiga autentiseringsuppgifter, endpoints och prenumerationstopics. De möjliggör ett obrutet dataflöde in i plattformen, ut ur plattformen, eller både in och ut.

Att sätta upp en connector innebär ofta autentisering mot fjärrsystem och konfiguration av rätt behörigheter, vilket kräver god kännedom om det specifika externa systemets arkitektur. Vanligtvis hanterar REST-API:er den initiala provisioneringen, medan MQTT strömmar realtidsdata från sensorer. Undantag är äldre IoT-protokoll som BACnet och Modbus.

Vid felsökning är samarbete mellan plattformens support och fjärrsystemets supportteam avgörande.

Retention Policy​

Definierar hur länge inkommen data lagras i plattformens databas. Denna period kan konfigureras från minst 2 dagar upp till obegränsad lagring (för alltid), beroende på verksamhetens behov och regelefterlevnad.

Flow Identifier​

Definierar vilket Data Flow som ska vara standardval för nya enheter som skapas med connectorn.

Skapa en Connector​

Så här skapar du en ny connector:

  1. Klicka på Connectors i den övre navigeringsraden.
  2. Välj önskad connector-typ.
  3. Följ de specifika installationsinstruktionerna för den connectorn, eftersom konfigurationen varierar beroende på datakälla och protokoll.

Hantera en Connector​

Öppna en connector från connector-listan för att se dess inställningar, dela den, lämna över den till någon annan, redigera den där det stöds, eller ta bort den.

Connector-översikten med ägaren och knappen Change owner, flikarna Organization, User och User group för delning, och tabellen över användaråtkomst med kolumnerna admin, write, read, peek och owner

Ägare​

Varje connector har exakt en ägare. Change owner lämnar över den till en annan användare, vilket är vad du gör när den som skapade den slutar, eller när en connector bör tillhöra ett driftkonto i stället för en enskild person.

Dela åtkomst​

Åtkomst ges på tre flikar: Organization, User och User group. Att dela till en användargrupp eller en organisation är oftast bättre än till enskilda personer, eftersom åtkomsten då följer gruppen i stället för att behöva underhållas person för person.

Nivåerna är samma fyra som används överallt i Yggio, admin, write, read och peek, och beskrivs under Åtkomsträttigheter.

Connectors följer inte det vanliga mönstret för åtkomsträttigheter​

Det här är den del som överraskar folk, så den är värd att säga rakt ut.

För att använda en connector, alltså lägga till enheter genom den, behöver en annan användare write, read och peek tillsammans. Ingen av dem räcker på egen hand. Om en kollega ser en connector men inte kan skapa enheter med den är det nästan alltid orsaken.

För att redigera en connector krävs admin på connectorn, och användaren måste dessutom ha en administratörsroll i Yggio. Båda, inte antingen eller.

På andra ställen i Yggio räcker read för att använda en resurs och write för att ändra den. Connectors är striktare, så ge de tre nivåerna tillsammans när du delar en som andra ska arbeta med.

Redigera​

Alla connector-typer går inte att redigera efter att de skapats. De som går att redigera är Netmore, Actility / Netmore ThingPark och ChirpStack; för övriga typer innebär en ändrad inställning att en ny connector skapas. Edit Connector kräver dessutom admin-rättigheter på själva connectorn plus en administratörsroll, enligt ovan.

Ta bort​

Att ta bort en connector går inte att ångra. Notera att på connectors mot nätverksservrar kan det också avveckla en enhet på den fjärrservern när du tar bort den, om du inte väljer bort det i bekräftelsedialogen; se respektive connector-sida.

Tillgängliga Connectors​

LoRaWAN​

  • Actility / Netmore ThingPark - För LoRaWAN-servern ThingPark från Actility.
  • ChirpStack V3 - För den öppna källkodsservern ChirpStack v3 för LoRaWAN.
  • ChirpStack V4 - För den öppna källkodsservern ChirpStack v4 för LoRaWAN.
  • Loriot - För LoRaWAN-servern Loriot. Denna integration är endast mottagande.
  • Helium - För LoRaWAN-servern Helium. Denna integration är endast mottagande.
  • Netmore - För LoRaWAN-servern Netmore.
  • TTN – (The Things Network) - För LoRaWAN-servern TTN (The Things Network).

Generic (NB-IoT / Cat-M / WiFi / BLE / Ethernet / etc.)​

  • CoAP - Connector för att ta emot data från CoAP-enheter.
  • UDP - Connector för att ta emot data från UDP-enheter.
  • MQTT - Connector för att publicera valfri data på plattformens MQTT broker eller på en extern broker.
  • HTTP - Befintlig global connector för att skicka HTTP POST-uppdateringar. Tillgänglig via "Channels" på alla enheter i enhetslistan.
  • BACnet IP - Möjliggör att plattformen kommunicerar med en BACnet-server (kräver direkt nätverksåtkomst). Kontakta support för att aktivera.
  • Modbus TCP - Möjliggör att plattformen kommunicerar med Modbus-enheter (kräver direkt nätverksåtkomst). Kontakta support för att aktivera.

Hubbar (Z-Wave, Zigbee, Matter)​

  • Hubitat - För att ansluta en Hubitat-hubb. Allt hubben talar blir vanliga Yggio-enheter, och länken går åt båda hållen, så Yggio kan styra dem lika väl som läsa dem.
  • Z-Wave - Stöds via Hubitat-connectorn.
  • Zigbee - Stöds via Hubitat-connectorn.
  • Matter och Thread - Stöds via Hubitat-connectorn.
  • Lutron, LAN- och molnenheter - Allt annat Hubitat stöder via egna eller community-drivrutiner, också det via Hubitat-connectorn.

Meddelanden​

De här bär meddelanden ut ur Yggio i stället för data in. En regelåtgärd avgör mottagarna, så en connector räcker för hela kontot.

  • E-post - Skickar e-post via valfri SMTP-kompatibel leverantör.
  • SMS - Skickar SMS via 46elks, Telnyx eller Twilio.
  • WhatsApp - Skickar WhatsApp-meddelanden via MessageBird, Plivo, Sinch, TextMagic, Twilio eller Vonage.

Väg och trafik​

  • Road Maintenance - Läser meddelanden om vägarbeten från en brevlåda med en LLM och gör om dem till väghinder, så att navigationen leder utryckningsfordon runt avstängningar. Se Väghinder.
  • RSMP Traffic Light Controllers - För övervakning av trafikljusstyrningar över RSMP, det öppna protokollet för vägutrustning från de nordiska vägmyndigheterna. Signalgrupper och detektorlogiker blir enskilda enheter. Se RSMP (Trafikledning).

Tillverkar- eller Tjänstespecifik​

  • BLE Dusoniot - För anslutning till BLE-gateways från Dusoniot.
  • Celsiview - För att ta emot data från Celsiview-enheter via deras portal (vanligtvis NB-IoT-enheter).
  • Delta Controls – BACnet - För integration med Delta Controls BMS via EnteliWeb REST-API.
  • Elvaco CME - För att ta emot data från flera sensorer via HTTP från Elvaco CME-enheter, med Elvaco-specifikationen 3108.
  • Klimator RSI - För att ta emot väderdata från Klimators väderstationer för vägväder via deras RSI-portal.
  • SIA Connect - För anslutning till edge-gateways från SIA Connect. Möjliggör integration med olika BMS-plattformar (t.ex. Siemens, Schneider, Beckhoff).
  • Siemens Desigo CC - För att tillhandahålla sensordata till Siemens Desigo CC via dess REST-API.
  • Open Weather Map - För att ta emot väder- och prognosdata från Open Weather Map. Skapa väderenheter med specifik latitud och longitud för att hämta data.

AI​

  • AI - Kopplar AI-chattbotar (LLM) till plattformen, så att de kan svara på frågor om Yggio utifrån dokumentationen.

Observera​

Vissa connectors är endast tillgängliga när en enhet skapas via alternativet "New Device" i enhetslistan. Dessa är äldre connectors och kommer med tiden att migreras till Connector-gränssnittet.

Andra connectors är endast åtkomliga via API:et och är odokumenterade, men kommer att läggas till i gränssnittet i framtida plattformsuppdateringar.

Connectors är nödvändiga för att lägga till och hantera enheter i Yggio. Om den connector du behöver inte finns tillgänglig i gränssnittet, kontakta din supportrepresentant.