Netwerk en Portaal verbinden (KPN)
- Tim van Osch
De Multiflexmeters kunnen via verschillende LoRaWAN netwerken de meetdata versturen. Het netwerk ontvangt ruwe data en heeft geen besef wat de data inhoudt. Daarom stuurt het netwerk deze data door naar de Multiflexmeter Servers (ook wel Multiflexmeter Portaal genoemd). Deze servers decoderen de data en ontsluiten dit naar andere systemen, waaronder FEWS. De afbeelding hieronder geeft een overzicht van de datastroom.
Bij de netwerk provider moet ingesteld worden hoe de ruwe data doorgestuurd wordt naar de Multiflexmeter Servers. Dit gebeurt op een versleutelde wijze met behulp van een HTTPS verbinding. Deze handleiding legt uit hoe deze dataverbinding ingesteld kan worden.
Let op, u kunt afbeeldingen vergroten door erop te klikken.
Inloggen KPN
Om te beginnen moet u in bezit zijn van de inloggegevens van KPNThings. Dit is het portaal van KPN waarop apparaten aangemaakt kunnen worden en ook de dataverbindingen kunnen worden ingesteld.
Een “destination” aanmaken
Het doorsturen van de ruwe data gebeurd bij KPN door middel van “Destinations” dit is de plek waar de data naartoe gestuurd zal worden.
Eenmaal ingelogd op het portaal ziet u het volgende scherm. Klik in het menu op “All Destinations”. Dit is in de afbeelding hieronder met rood gemarkeerd.
U wordt nu naar een nieuw scherm gebracht. Hier ziet u rechtsboven op de website de knop “Add new Destination”. Klik hierop. Vervolgens kunt u een “Destination Type” kiezen uit een lijst. Hier kiest u “HTTPS endpoint”
In het formulier dat u nu voor u heeft, kunt u zelf de “Destination Name” invullen. In deze handleiding gebruiken we “MFM Portal”.
Bij URL geeft u het volgende op:
https://portal.multiflexmeter.net/api/v1/networks/kpn/up/Bij Headers geeft u het volgende op.
Let op dat u de tekst TOKEN vervangt met uw eigen authenticatie token.
{
"Authorization": "Bearer TOKEN"
}Als laatst vereist KPN een “Shared Secret” op te geven. Ons systeem maakt geen gebruik van deze authenticatie methode. Hier kunt u willekeurig 32 letters en cijfers invoeren die aan de eisen voldoen.
U kunt gebruik maken van een generator online om aan de eisen te voldoen. Gebruik de volgende URL en zet de lengte op 32
Nu kun u de “Destination” aanmaken door te klikken op “Add HTTPS endpoint”
Een Flow aanmaken
Een “Flow” wordt gebruikt om een project met apparaten te koppelen aan een “Destination”. In uw geval moet het project waar de Multiflexmeters in zijn aangemaakt gekoppeld worden met de “Destination” die in de vorige stap is aangemaakt.
Om te beginnen klikt u in het linker menu op uw project naam, vervolgens op “Flows” en als laatste op “Add Flow”
In het nieuwe scherm kunt u een naam en omschrijving opgeven voor de “Flow”. Dit mag u zelf kiezen. In deze handleiding gebruiken we de naam “MFM Portal”. Klik als laatste op “Create Flow”.
Na het aanmaken van de “Flow”, wordt u doorgestuurd naar een nieuwe pagina. Op deze pagina moeten drie dingen gebeuren:
apparaten koppelen met deze “Flow”;
instellen welke data wordt doorgestuurd;
en de eerder gemaakte “Destination” koppelen.
Apparaten koppelen met Flow
In de pagina van de “Flow” klikt u op “Link Device” zoals in de afbeelding hieronder. Vervolgens kiest u ervoor om een nieuw apparaat aan te maken of een bestaande te koppelen. In deze handleiding gaan we er van uit dat er een bestaand apparaat gekoppeld wordt. Als laatst kiest u welk apparaat u wilt koppelen. Herhaal dit proces totdat elke Multiflexmeter gekoppeld is.
Instellen welke data doorgestuurd word
Ga terug naar uw “Flow” via het linker menu of klik op uw Flow naam bovenin het pad. Klik vervolgens op “Data Processing”. In dit scherm moet u onder beide kopjes “Raw LoRa Payload” aanzetten.
Flow aan Destination verbinden
Als laatste stap moet de eerder aangemaakte “Destination” verbonden worden met de “Flow” die u nu aan het configureren bent. Hiervoor gaat u terug naar uw “Flow” en klikt u op “Link Destination”.
In het nieuwe scherm moet u de “Destination” selecteren die u heeft aangemaakt in de eerdere stap. In deze handleiding is dat “MFM Portal”. Eenmaal geselecteerd kunt u klikken op “Add Destination”.
De ruwe data van uw Multiflexmeter apparaten wordt nu doorgestuurd naar de Multiflexmeter Servers. Vanuit daar wordt de data ontsloten naar FEWS en andere applicaties.