Quick Guide – B.One Middleware

- Lesedauer 5 Minuten -

Dieser Quick Guide soll dir dabei helfen, dass du dich in der B.One Middleware einfacher zurechtfindest. In der folgenden Schritt-für-Schritt-Anleitung werden die Ansichten der Geräte und Gateways erläutert. Du fragst dich jetzt, was die Middleware überhaupt ist? Dann empfehlen wir dir zunächst unseren Artikel B.One Middleware – Eine Einführung.

1. Einloggen

Damit Du dich in der B.One Middleware einloggen kannst, benötigst Du einen Benutzernamen, ein Passwort und einen Mandanten. Diese Information erhälst Du per E-Mail, nachdem du im ZENNER Shop ein GatewayPLUS Smart, Indoor oder Outdoor erworben hast.

2. Menü Struktur

Über das Navigationsmenü auf der linken Seite der Oberfläche hast Du schnellen Zugriff auf alle wichtigen Bereiche. Das Menü lässt sich per Klick auf die Menüschaltfläche am oberen Rand jederzeit minimieren und wieder aufrufen.

 

3. Passwort ändern

Nach dem ersten Log-In raten wir Dir schnellstmöglich Dein Passwort zu ändern. Die Möglichkeit dazu findest Du über die Navigationsleiste in “Management” → “User” → “Password” → “Change”.

4. Übersicht der Gateways

Die Übersicht der Gateways findest Du auf der linken Seite in der Navigationsleiste unter “Gateways” → “List”. Hier siehst Du eine Übersicht der Gateways, die sich in Deinem Mandanten befinden. Hier lässt sich nach bestimmten Gateways suchen und das Ergebnis nach Status (On-/Offline) und Type filtern.

 

5. Neues Gateway anlegen

Den Button “ADD GATEWAY” siehst Du in der Gatewayübersicht am rechten oberen Bildrand. Der Button ist im Bild unter “4. Übersicht der Gateways” zu erkennen. Alternativ erreichst Du dieselbe Seite auch über das Navigationsmenü unter “Gateways” → “New Gateway”.
Beim Anlegen eines neuen Gateways öffnet sich ein Assistent. Anschließend müssen alle Felder, die mit einem Stern markiert sind, ausgefüllt werden.

Um die Anlage eines neuen Gateways abschließen zu können, klickst Du auf den Button “SAVE GATEWAY”. Dieser bleibt ausgegraut, bis alle erforderlichen Angaben gemacht wurden.
Sind die Metainformationen zu einem Gateway vollständig eingetragen, wird das Gateway bei der nächsten Aktualisierung in der Community-Karte angezeigt. Details hierzu, findest du im Blogbeitrag “QuickGuide – Community-Karte“.

6. Gateway Statistik Daten

Die Gateway Details erreichst Du per Klick auf ein Gateway in der Übersicht. Hier findest Du nähere Informationen über das ausgewählte Gateway. Über die verschiedenen Reiter kannst Du dir genauere Details zum Traffic, der Verbindung oder der Hardware anzeigen lassen. Im Reiter Management gibt es zudem die Möglichkeit, die Verbindung des Gateways zu trennen oder es neuzustarten.

 

7. Ändern von Gatewayinformationen

Befindest Du dich in der “Gateway Detail”-Ansicht, ist auf der rechten Seite eine Zusammenfassung mit den wichtigsten Informationen zu sehen. Wenn Du etwas an deinem bestehenden Gateway ändern möchtest, gelangst Du über den Punkt “Edit Gateway” in der Zusammenfassung in den Assistenten zur Eingabe der Informationen zu diesem Gateway.

 

8. Übersicht der Sensoren

Die Übersicht der Sensoren erreichst Du über die Navigationsleiste über “Devices” → “List”. Hier erhälst Du eine Auflistung der angelegten Geräte. Mittels der Suchfunktion lassen sich Geräte einfacher finden. Zusätzlich ist die Suche mit Teilstrings möglich. Per Klick auf einen Sensor erreichst Du die Statistik des jeweiligen Gerätes.

9. Anlegen eines neuen Sensors

Den Assistenten für das Anlegen eines neuen Sensors erreichst Du über den blauen Button “ADD DEVICE” auf der rechten Seite der Sensorübersicht oder über die Navigation unter “Devices” → “New Device”. Die erforderlichen Informationen sind, analog zum Assistenten für das Anlegen eines Gateways, mit einem Stern markiert. Die notwendigen Angaben für ein neues Gerät unterscheiden sich nach dem gewählten Device Type. Für den Type “OTAA” ist eine “DevEUI”, eine “JoinEUI” und ein “AppKey” erforderlich. Für den Type “ABP” sind zusätzlich zur “DevEUI”, auch Angaben zur “Dev Adress”, zum “NwkSKey” und dem “AppSKey” Pflicht.

Um die Anlage eines neuen Geräts abzuschließen, klickst Du auf den Button “SAVE DEVICE”. Dieser bleibt ausgegraut, bis alle erforderlichen Angaben gemacht wurden.

10. Geräte Statistik Daten

Die Device Details erreichst Du per Klick auf ein bestimmtes Gerät in der Übersicht. Die Ansicht ist in verschiedene Reiter unterteilt.

Im Reiter “General Information” befinden sich die “Meta Data”, die allgemeine Informationen über das Gerät beinhalten und der “Session Context”. In diesem befinden sich die Daten zum Join des Geräts, sowie die DevEUI und den Typ der Verbindung.

Der Reiter “Traffic” zeigt die Telegramme in einer tabellarischen Auflistung und einem Chart, welche den zeitlichen Verlauf von Up- und Downlinks grafisch darstellt. Außerdem gibt es verschiedene Diagramme zur Empfangsqualität (SNR und RSSI), dem verwendeten Spreading Factor, eine Auflistung der Gateways, die Daten dieses Sensors empfangen haben und die letzten Telegramme im JSON-Format. Der Abfragebereich lässt sich im oberen Bereich unter den Reitern per Start- und Enddatum definieren.

Der Reiter “Downlinks” bietet die Möglichkeit einen Downlink an den Sensor zu senden. Über die Felder lässt sich die zu sendende Payload, der zu verwendende Port und die Anzahl der Sendeversuche definieren. Außerdem kann gewählt werden, ob eine Bestätigung seitens des Gerätes angefordert werden soll oder nicht. Das Feld “Imme” bedeutet “Immediately” und löst den Downlink bei der Auswahl “True” sofort aus. Achtung bei dieser Einstellung: eine sofortige Übermittlung ist nur bei Class-C-Geräten möglich, ansonsten muss hier “False” gewählt werden. Per Button “CREATE DOWNLINK” wird der Downlink bestätigt. Er bleibt ausgegraut, bis alle erforderlichen Angaben gemacht wurden.

Weitere Informationen zum Thema Downlinks erfährst Du im Blogbeitrag Versenden von Downlinks mithilfe der B.One Middleware.

Im Reiter “Joining” werden die empfangenen “Join Requests” und die gesendeten “Join Accepts” aufgelistet.
Unter “Readings” werden die empfangen Werte aufgelistet und, sofern vorhanden, von einem Parser übersetzt.

11. Ändern von Geräteinformationen

Änderungen an Geräten lassen sich über den Punkt “Edit device” auf der rechten Seite in der “Device Details”-Ansicht vornehmen. Über diesen Punkt gelangt man in denselben Assistenten, wie bei der Neuanlage eines Gerätes und kann die entsprechenden Informationen abändern. Einige Felder, die nicht geändert werden können, bleiben ausgegraut wie der “Device Type”, die “DevEUI” und der “Rx-Delay”.

12. Löschen eines Gerätes

Um ein Gerät zu löschen wählst Du im Navigationsbereich “Devices” → “List” aus und suchen per Suchfeld das entsprechenden Gerät. Ganz rechts finden Sie die Schaltfläche “Delete”, mit der Geräte entfernt werden können. Danach werden keine Daten mehr vom entsprechenden Gerät empfangen.

Bitte beachten: Das Löschen eines Gerätes kann nicht ohne Weiteres rückgängig gemacht werden!

 

13. Übersicht Daten Weiterleitungen (Forwarding)

Im Reiter “Forwarding” in den “Device Details” werden die Weiterleitungsregeln aufgeführt. Im Oberen Bereich werden die für dieses Gerät aktiven Weiterleitungsregeln angezeigt und im unteren Bereich, die generell für diesen Mandanten verfügbaren Regeln. Der komplette Traffic des ausgewählten Gerätes wird gemäß den Regeln weitergeleitet.

 

14. Neue Daten Weiterleitung einrichten

Über den Button “ADD NEW FORWARD RULE” lassen sich neue Weiterleitungsregeln einrichten. Hierfür muss man der Regeln einen Namen geben und eine URL bestimmen, an die der Traffic weitergeleitet wird. Außerdem kann der Typ der Weiterleitung gewählt werden. Der Button “SAVE FORWARD RULE” bleibt ausgegraut, bis alle nötigen Angaben gemacht wurden.

Weitere Informationen zum Thema “Forwarding” erfährst Du im Blogbeitrag “Weiterleitungsmöglichkeiten B.One Middleware“.

Empfehlen0 EmpfehlungenVeröffentlicht in B.One Middleware, Bedienungshilfen

Zum Thema passende Artikel

Kommentare