Externe Signaal Onboarding Stroom
Tip
De Onboarding richtlijn is bedoeld voor nieuwe integraties die het Eniris MQTT Protocol gebruiken.
Een nadeel van het MQTT-protocol is dat er geen melding of gegevensoverdracht plaatsvindt wanneer een nieuwe installatie wordt toegevoegd. Daarom wordt aanbevolen de volgende stappen op te nemen voordat volledig wordt geïntegreerd met de SmartgridOne Controller.
Setup
Het volgende is vereist om een onboarding stroom op te zetten
-
Externe API
- Een publieke API is vereist
-
Minimaal twee eindpunten
- Onboarding eindpunt Het onboarding eindpunt kan worden gebruikt door de SmartgridOne Controller om een signaal te verzenden dat aangeeft dat de installatie klaar is om te worden aangestuurd. Extra info kan contractnummers bevatten die door gebruikers zijn ingevoerd, installatielocatie, apparaatgegevens
- Offboarding eindpunt Het offboarding eindpunt kan worden gebruikt om aan te geven dat het externe regelsignaal is verwijderd van de SmartgridOne Controller, en dat aansturing niet langer mogelijk is.
- Status/healthcheck eindpunt Het healthcheck eindpunt kan regelmatig worden opgevraagd door de SmartgridOne Controller om een statusupdate te geven van de apparaten, of het systeem als geheel.
Voorbeeld
-
Een nieuwe gebruiker voegt het externe signaal toe in de SmartgridOne Controller. Het Onboarding eindpunt wordt aangeroepen om aan te geven dat de SmartgridOne Controller klaar is om commando's te ontvangen.
-
De SmartgridOne Controller is de verbinding met de batterij kwijtgeraakt. Het healthcheck eindpunt zal een foutmelding bevatten.
-
Een contractnummer is vereist om een SmartgridOne Controller serienummer aan een klant te koppelen. Een contractnummer kan worden opgenomen in de onboarding stroom, waardoor heen-en-weer communicatie tussen externe signalen en eindgebruikers wordt verminderd.