Netmore Connector

Netmore-connectorn gör det möjligt för plattformen att provisionera enheter och prenumerera på enhetsuppdateringar från Netmores LoRaWAN-server. Detta automatiserar Netmore-integrationen och möjliggör full enhetshantering direkt i Yggio. Funktioner som stöds:

• Import av befintliga enheter
• Provisionering av nya enheter
• Prenumeration på enhetsuppdateringar
• Borttagning av enheter

Nödvändig Information

För att sätta upp en anslutning till Netmore, ange följande:

• a. Netmore MQTT broker URL: mq.netmoregroup.com
• b. Netmore API URL: https://api.blink.services
• c. Username: Ditt API-användarnamn
• d. Password: Ditt lösenord
• e. Service Provider Code: Kod för Service Provider
• f. (Valfritt) Customer Code: Kod för kunden

⚠️ API-användaren måste ha lämpliga roller för att kunna utföra dessa åtgärder. Om du får ett 40x-felsvar beror det troligen på otillräckliga åtkomsträttigheter. Dessa måste ses över och korrigeras.

Börja med att Sätta upp Netmore-åtkomsten

1. Logga in på Netmore och skapa ett API-användarkonto via Netmore-portalen: portal.blink.services Om du inte har åtkomst för att skapa ett API-användarkonto, kontakta Netmore support.

   • a. Kontot måste vara kopplat till en Service Provider för att möjliggöra enhetsprovisionering.

     • Användaren måste ha rollen Sensor - Admin för Service Providern

   • b. Användarkontot måste ha Netmore-rollerna:

     • API user

     • Service Provider

       

2. Hitta Service Providern och identifiera Service Provider Code (vanligtvis en sträng i versaler).

   • a. Bekräfta att API-användaren har rollen Sensor - Admin för Service Providern.

   

3. (Valfritt) Hitta kunden och identifiera Customer Code (även vanligtvis en sträng i versaler).

   • a. Bekräfta att API-användaren även har rollen Sensor - Admin för kunden.

   

Sätta upp Connectorn

När Netmore-konfigurationen är klar, fortsätt till Yggio:

1. Navigera till Connectors → New Connector → Netmore Connector
2. Fyll i de nödvändiga fälten med den insamlade informationen.

Som standard sätts MQTT-topic till Netmores exportstandard (sensor/<Service provider code>/+/+/+/payload). Om du använder ett anpassat topic, klicka på knappen Override för att ange ditt eget. Standard MQTT-wildcards stöds:

• # - matchar valfritt antal topic-nivåer
• + - matchar en enskild nivå i topic-sökvägen

Verifiera Connectorn

• Plattformen verifierar automatiskt anslutningen när connectorn skapas, men detta garanterar inte full funktionalitet.

• För att utföra en fullständig verifiering:

  1. Skapa en enhet i plattformen med Netmore-connectorn.
  2. Öppna enhetssidan efter att den skapats.
  3. Gå till Tools och kontrollera statusen för Synchronize - den bör inte visa "never".
  4. Klicka på Synchronize-knappen manuellt för att bekräfta att det fungerar.
  5. Logga in på Netmore och bekräfta att enheten har provisionerats.
  6. Utlös (eller vänta på) enhetens första uplink.
  7. Kontrollera att uplinken tas emot och avkodas korrekt av plattformen.

Importera enheter:

När connectorn är korrekt konfigurerad kan du vilja importera befintliga enheter från Netmore till IoT-plattformen. Detta kan göras direkt från Connector-gränssnittet.

• Om ingen customer code anges i connectorn kommer plattformen att försöka importera alla tillgängliga enheter.
• Om en customer code anges, importeras endast enheter med matchande customer code.

Connectorn inkluderar följande Netmore-metadata på varje importerad sensor:

• Alias blir enhetens namn
• Description
• Sensorns position (latitud och longitud)
• Address sparas i kontextuella parametrar
• Customer sparas i kontextuella parametrar
• Serienummer
• Prismodell
• LoRaWAN: Activation type
  • appEui
  • appKey
  • nwkSKey
  • devEuiActivation type
  • appEui
  • appKey
  • nwkSKey
  • devEui

Multikonto-installation:

Det finns två huvudsakliga sätt att integrera Netmore med IoT-plattformen. Den viktigaste faktorn är hur fakturering till slutanvändare ska hanteras – via Netmore, via IoT-plattformen, eller en kombination av båda. Om dina användare kommer att komma åt IoT-plattformen direkt måste du konfigurera Organization Manager för att säkerställa att varje användare bara ser de enheter de har behörighet till.

Integrationsalternativ

• Fakturering via Netmore eller båda systemen: Spegla Netmores organisationsstruktur i IoT-plattformen. Skapa en connector per Netmore-kund.

• Fakturering enbart via IoT-plattformen: Använd en platt struktur i Netmore, där alla enheter hanteras på ett och samma ställe. Endast en connector behövs i IoT-plattformen.

⚠️ Viktigt:

Om en enhet tas bort från Yggio kommer den som standard även att tas bort och avvecklas från Netmores LoRaWAN-server. För att undvika detta, se till att välja bort borttagningsåtgärden när du blir tillfrågad i bekräftelsedialogen.

---

Felsökning

Jag får ett 40x-fel

• Detta tyder vanligtvis på ett problem med din URL, dina autentiseringsuppgifter eller åtkomsträttigheter. Uteslut dessa en i taget:
  • Dubbelkolla URL:en – se till att det inte finns ett avslutande / i slutet.
  • Verifiera att användarnamn, lösenord och åtkomstbehörigheter är korrekta.
• Tips: Använd Netmores Swagger UI. Logga in med din API-användare, försök skapa en enhet och se om förfrågan lyckas.

---

Jag får ingen data när enheten skickar uplinks

• Gå till sensorn i Netmore-portalen.
• Bekräfta att MQTT Export är aktiverat.
• Se till att MQTT-topic matchar det Yggio är konfigurerat att prenumerera på.

---

Jag har en API Gateway mellan mig och Netmore - vad ska jag göra?

• Se till att API Gateway ger åtkomst till både Netmore-API:et och Netmores MQTT broker.
• När du skapar connectorn, uppdatera API- och MQTT-URL:erna till att peka på de gateway-endpoints som routar korrekt till Netmore.

---

Jag får ett 40x-fel när jag försöker importera eller skapa enheter - vad kan det bero på?

• Ett 40x-fel innebär att Netmore avvisar förfrågan. Detta orsakas vanligtvis av:
  • Felaktiga autentiseringsuppgifter
  • Fel URL
  • Saknade eller felaktiga åtkomsträttigheter på Netmores sida
• Gå igenom exempelbilderna för installationen och verifiera följande:
  • Username, password, API URL
  • Service Provider Code
  • (Valfritt) Customer Code
• Bekräfta även:
  • Att användarkontot är markerat som API User
  • Att användaren har rollen Sensor Admin

---

Jag får fortfarande ett 40x-fel efter att ha följt stegen ovan. Vad nu?

• Om allt ser korrekt ut i ditt Netmore-konto, fortsätt med avancerad felsökning:

  1. Gå till Netmores Swagger UI.
  2. Använd inloggnings-endpointen: https://api.blink.services/#/Platform%20core%20functionality/login
  3. Försök logga in med din API-användares autentiseringsuppgifter.

• Om inloggningen misslyckas, kontakta Netmore support – API-autentiseringen kanske inte är fullständigt konfigurerad på deras sida.

• Om inloggningen lyckas, testa andra endpoints för att bekräfta dina åtkomsträttigheter via API:et.