Quick Guide – B.One Middleware

Screenshot der Gateway-Ansicht in der B.One Middleware
- 📖🕓≈ 6 min -

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.

 

Wichtig zu wissen: Hast du ein GatewayPLUS SMART, Indoor oder Outdoor ĂŒber den ZENNER Shop erworben, so ist dieses hier aktuell noch nicht fĂŒr dich sichtbar. Das liegt daran, dass sich alle diese Gateways aus technischen GrĂŒnden in einem ĂŒbergeordneten, nicht öffentlich einsehbaren Mandanten befinden und zudem keine Möglichkeit fĂŒr dich besteht, deren Konfiguration eigenstĂ€ndig zu Ă€ndern.

5. Neues Gateway anlegen

Bevor wir dir zeigen, wie du bei Bedarf ein neues Gateway anlegen kannst, beachte auch hier bitte den folgenden Hinweis: Alle im ZENNER Shop gekauften  GatewayPLUS wurden vorab bereits in der B.One Middleware angelegt, um direkt nach der Inbetriebnahme automatisch eine Verbindung zum Netz herzustellen. Auch wenn du wie oben beschrieben diese Gateways bisher nicht in deinem eigenen Account/Mandanten sehen kannst, musst du sie vor der Aktivierung nicht noch eigenstĂ€ndig dort anlegen. In dem Fall kannst du also diesen Abschnitt 5. und den darauffolgenden Abschnitt 6. einfach ĂŒberspringen.

Andernfalls siehst Du in der GatewayĂŒbersicht am rechten oberen Bildrand den Button “ADD GATEWAY”. 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 neu zu starten.

 

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