Externer Signal-Onboarding-Ablauf
Tipp
Die Onboarding-Richtlinie ist für neue Integrationen vorgesehen, die das Eniris MQTT-Protokoll verwenden.
Ein Nachteil des MQTT-Protokolls ist, dass keine Benachrichtigung oder Datenübertragung erfolgt, wenn eine neue Installation hinzugefügt wird. Daher wird empfohlen, die folgenden Schritte vor der vollständigen Integration mit dem SmartgridOne Controller durchzuführen.
Einrichtung
Für die Einrichtung eines Onboarding-Ablaufs werden die folgenden Punkte benötigt:
-
Externe API
- Eine öffentliche API ist erforderlich
-
Mindestens zwei Endpunkte
- Onboarding-Endpunkt Der Onboarding-Endpunkt kann vom SmartgridOne Controller verwendet werden, um ein Signal zu senden, das anzeigt, dass die Installation zur Steuerung bereit ist. Zusätzliche Informationen können Vertragsnummern, eingetragen von Nutzern, Installationsadresse, Geräteinformationen umfassen.
- Offboarding-Endpunkt Der Offboarding-Endpunkt kann verwendet werden, um anzuzeigen, dass das externe Steuersignal vom SmartgridOne Controller entfernt wurde und eine Steuerung nicht mehr möglich ist.
- Status-/Healthcheck-Endpunkt Der Healthcheck-Endpunkt kann regelmäßig vom SmartgridOne Controller abgefragt werden, um eine Statusaktualisierung der Geräte oder des Systems insgesamt bereitzustellen.
Beispiel
-
Ein neuer Nutzer fügt das externe Signal in dem SmartgridOne Controller hinzu. Der Onboarding-Endpunkt wird aufgerufen, um anzuzeigen, dass das SmartgridOne Controller bereit ist, Befehle zu empfangen.
-
Das SmartgridOne Controller hat die Verbindung zur Batterie verloren. Der Healthcheck-Endpunkt enthält eine Fehlermeldung.
-
Eine Vertragsnummer wird benötigt, um eine SmartgridOne Controller Seriennummer mit einem Kunden zu verknüpfen. Eine Vertragsnummer kann im Onboarding-Ablauf mit aufgenommen werden, um die Kommunikation zwischen externen Signalen und Endkunden zu reduzieren.