MikroTik Beacon Manager voor Android-apparaten

Overview

De MikroTik Beacon Manager-app is ontworpen voor het configureren van Bluetooth-tags (TG-BT5-XX). Omdat de tags Bluetooth-apparaten zijn, moet u Bluetooth op de telefoon inschakelen voordat u met de configuratie begint.

Voor Android-apparaten kunt u de app vinden via deze link.

Scherm van de beacon manager

Het eerste scherm dat u ziet wanneer u de app start is het "MikroTik Beacon Manager" scherm, waar alle Bluetooth-tags in de buurt worden getoond.

Als de lijst leeg is, betekent dit dat alle tags in de buurt zich in de factory-sleep modus bevinden. Zodra de tag in de advertising- of configuratiemodus staat, verschijnt hij in de lijst. Om de tag uit de factory-sleep modus te wekken, houdt u de magneet 3 tot 10 seconden boven de tag (activeert de reed-switch).

Info Als de lijst geen enkele tag oppikt terwijl u zeker weet dat er zich een tag binnen het bereik van de telefoon bevindt → probeer dan "Location=ON" in te schakelen in de GPS-instellingen van de telefoon.

Rechtsboven in het scherm bevinden zich 3 knoppen:

OR Code Reader

De knop "QR Code reader" waarmee je de tag via een QR-code kunt toevoegen (het MAC-adres wordt gebruikt als ID van de tag):

NFC-ondersteuning

Info Deze sectie is alleen beschikbaar voor het model TG-BT5-OUT

Je kunt de tag ook vinden (vergelijkbaar met de QR-codelezerfunctie) met NFC (het MAC-adres wordt gebruikt als ID van de tag).

U hoeft alleen NFC in te schakelen in de instellingen van uw telefoon en de MikroTik Beacon Manager-app te openen.

Zodra u het beginscherm ziet (lijst met tags), houdt u de tag bij de NFC-antenne van de telefoon en krijgt u de mogelijkheid om de apparaatinstellingen te openen:

Als u op "YES" drukt, wordt u doorgestuurd naar de hieronder getoonde pagina. In het menu hebt u de mogelijkheid om het apparaat uit de lijst te verwijderen of om via de knop "Configure" naar de configuratiemodus te gaan.

Sorteren op

De knop "Order by", waarmee u de volgorde van de apparaatlijst kunt wijzigen of de lijst simpelweg kunt filteren zodat alleen MikroTik-beacons worden getoond door het selectievakje "Show only MikroTik beacons" aan te vinken:

Instellingen en batchconfiguratie

Het tabblad "⋮" is onderverdeeld in 2 subtabbladen - "Settings" en "Batch Configuration".

Settings

De eerste optie op dit tabblad is het instellen van een "Discovery refresh interval", dat is het interval voor het scannen naar tags in de buurt.

De tweede optie is het in- of uitschakelen van de instelling "Save triggers". Wanneer deze is ingeschakeld, slaat de app gedetecteerde triggers op in de database. U kunt de triggers controleren in het menu "Sensor Triggers" (het menu "Sensor Triggers" wordt getoond in de sectie "Tag Management" van deze handleiding). Als deze optie is uitgeschakeld, worden de gegevens van "Sensor Triggers" gewist zodra de app wordt gesloten.

En tot slot toont het veld "App version" de huidige versie/build van de app.

Batchconfiguratie

Met deze optie kunt u meerdere tags in bulk met dezelfde instellingen configureren.

Om dat te doen, moet u het configuratiebestand van een van de tags exporteren. Het exporteren en importeren van de tagconfiguratie wordt getoond in de sectie "Tag Configuration" van deze handleiding.

Nadat u het configuratiebestand hebt opgeslagen, drukt u eenvoudig op de knop "Batch Configuration" en wordt u naar het bestandsmenu geleid waar u het bestand moet selecteren. Kies het configuratiebestand (dat u op meerdere units wilt toepassen) en de app toont u het scherm met alle in de buurt gedetecteerde tags:

De laatste stap is het in configuratiemodus zetten van die tags (door de magneet 5-10 seconden op de tag te houden). Nadat het apparaat in configuratiemodus is gezet, ziet u het bericht "Uploading configuration". Het bericht verandert in "Configuration updated" wanneer de configuratie succesvol is toegepast.

Tagbeheer

Wanneer de tag in de lijst staat, kunt u op het MAC-adres klikken en krijgt u de volgende opties te zien:

Om de tag op te slaan ("SAVE") of om direct naar het configuratiemenu van de tag te gaan via de knop "CONFIG ONLY".

Eerst leggen we de optie "SAVE" nader uit. Het configuratiemenu van de tag wordt later uitgelegd in de sectie "Tag Configuration".

Wanneer u op de eerder opgeslagen tag klikt, ziet u het volgende menu:

Het eerste dat u zou moeten opvallen is de indicatie van de signaalsterkte (RSSI-signaal voor de tag - hoe ver de tag weg is). Wanneer alle cirkels groen zijn, betekent dit dat de signaalsterkte ongeveer -60 RSSI is. Wanneer slechts 2 cirkels groen zijn, betekent dit dat de signaalsterkte ongeveer -70 RSSI is. Wanneer slechts één cirkel groen is, betekent dit dat de signaalsterkte -80 RSSI is. Wanneer geen enkele cirkel groen is, betekent dit dat de signaalsterkte -90 RSSI of meer is.

Onder de indicator van de signaalsterkte hebt u 2 opties: naar het configuratiemenu van de tag gaan (knop "Configure") of het apparaat verwijderen (knop "Delete").

In het veld "Name/Display Name" kunt u de naam van de tag wijzigen:

In het veld "Sensors" kunt u het batterijniveau of de temperatuur van de tag bekijken.

Info Het model TG-BT5-IN heeft geen temperatuursensor

In het veld "Sensor Triggers" kunt u de triggers bekijken die door de tag zijn gemeld:

Tagconfiguratie

Om toegang te krijgen tot het configuratiemenu van de tag, moet u ofwel op de knop "CONFIG ONLY" ofwel op de knop "Configure" drukken, zoals hieronder getoond:

Direct daarna moet u gedurende 5-10 seconden een magneet boven de reed-switch houden:

Na een korte opstarttijd zou het apparaat in de configuratiemodus moeten staan:

De app toont algemene informatie over de tag op het tabblad "Status" (zoals te zien in de schermafbeelding hierboven).

De configuratie kan worden aangepast op het tabblad "Settings":

Schrijfbeveiliging

Met dit menu kunt u de instellingen van de tag vergrendelen met een wachtwoord van 6 tekens:

Zodra het wachtwoord is ingesteld, is er geen manier om de wachtwoordbeveiliging te verwijderen (u kunt deze alleen bewerken).

De volgende keer dat u probeert de tag te configureren, krijgt u de melding dat deze "write protected" is en kunt u kiezen om in de "READ-ONLY"-modus te blijven (waarmee u de instellingen kunt bekijken en lezen maar geen configuratiewijzigingen kunt maken) of om de instellingen te "UNLOCK"-en door het ingestelde wachtwoord in te voeren:

Beacon-instellingen

In de advertising-modus zendt de tag informatie over zichzelf uit in Bluetooth advertising-pakketten. Welke informatie dat is, hangt af van het type advertising-pakket (het type kan in de instellingen worden gewijzigd).

Op dit moment zijn dit alle ondersteunde typen:

DeviceName, MikroTik, Eddystone-TLM, Eddystone-UID en iBeacon.

Advertisement-eigenschappen

Geschatte levensduur van de batterij

Deze sectie toont de geschatte batterijduur:

De geschatte levensduur van de batterij hangt sterk af van het aantal verzonden advertising-pakketten (zoals geconfigureerd). De app berekent hoeveel pakketten er naar schatting dagelijks worden uitgezonden, hoe lang de tag actief zal zijn en wat het gemiddelde dagelijkse stroomverbruik naar schatting is.

Accelerometerinstellingen

De accelerometer kan volledig worden uitgeschakeld en weer worden ingeschakeld met de schakelknop "Use Accelerometer".

In deze sectie kunt u de parameters wijzigen die in de onderstaande schermafbeelding worden getoond:

Mode en datasnelheid

In dit menu kunt u kiezen tussen 2 modi: "Low power" en "High power". In de modus "Low power" krijgt u een lagere precisie, maar ook een lager stroomverbruik. In de modus "High power" krijgt u een hogere precisie, maar ook een hoger stroomverbruik.

De instelling "Data Rate" geeft het aantal versnellingsmetingen binnen een venster van 1 seconde weer (meetfrequentie). Hoe minder pakketten per seconde worden verzonden → hoe lager het stroomverbruik.

Full Scale

Kan variëren tussen (2g...16g). Het is het meetbereik dat gebruikt wordt om de wake-up-drempel te berekenen. De volledige schaal bepaalt het versnellingsbereik dat de versnellingsmeter kan meten (hoe groter het bereik, hoe lager de nauwkeurigheid van de gemeten versnelling).

Bandbreedtefilter

Is een digitale filterafsnijding (een bandbreedte van een hoogdoorlaatfilter).

Als de bandbreedte = "x" Hz, dan filtert de tag veranderingen in de versnelling eruit die minder vaak dan "x" keer per seconde optreden.

Als het apparaat bijvoorbeeld op tafel ligt, toont de versnelling 0g (in plaats van 1g), ook al is de zwaartekracht van de aarde aanwezig → (omdat de zwaartekracht van de aarde constant is, is de frequentie van de verandering 0 Hz, wat < "x" Hz is) wordt deze eruit gefilterd.

Wakeup Threshold en Duration

De "Wakeup Threshold" definieert een wakeup-zone/versnellingsbereik. De "Wakeup Duration" definieert de tijd gedurende welke de versnelling boven de geconfigureerde wakeup threshold ligt. Er wordt een wakeup-gebeurtenis gegenereerd (een wakeup-voorwaarde wordt geactiveerd) wanneer de versnelling op een van de assen (X, Y of Z) gedurende de geconfigureerde wakeup duration een drempel overschrijdt. Om beter te begrijpen wat wordt bedoeld met "acceleration on any axis (X, Y, or Z)", stelt u zich een 3D cartesiaans coördinatenstelsel voor met in de oorsprong (het gemeenschappelijke punt) de accelerometer van de tag of de tag zelf:

Stel dat de wakeup-drempel bijvoorbeeld is ingesteld op 1,0g (dit betekent dat elke versnelling tussen -1,0g en +1,0g binnen de geconfigureerde drempel/versnellingsrange valt) en de wakeup-duur op 0,12s. Zodra het apparaat tegen een van de assen wordt geduwd of geworpen (het apparaat begint in een willekeurige richting te bewegen) met een versnelling die de geconfigureerde drempel overschrijdt (acceleration> +1.0g of acceleration< -1.0g) gedurende langer dan 0,12s → wordt de wakeup-conditie geactiveerd.

Free Fall Threshold en Duration

De "Free Fall Threshold" definieert een vrijeval-zone/versnellingsbereik. De "Free Fall Duration" definieert de tijd gedurende welke de versnelling binnen de geconfigureerde vrijeval-drempel blijft. Het vrijeval-event wordt gegenereerd (de vrijeval-conditie wordt geactiveerd) wanneer de versnelling op alle 3 de assen (X, Y en Z) gedurende de geconfigureerde vrijeval-duur binnen de vrijeval-zone/drempel blijft. Om beter te begrijpen wat wordt bedoeld met "versnelling op alle assen (X, Y en Z)", bekijkt u de foto's van het apparaat hierboven in het gedeelte "Wakeup Threshold and Duration".

Stel dat de freefall-drempel bijvoorbeeld is ingesteld op 156,25g (dit betekent dat elke versnelling tussen -156,25g en +156,25g binnen de geconfigureerde drempel/versnellingsrange valt) en de freefall-duur op 0,2s. Zodra het apparaat zich in een vrije val bevindt met een versnelling op alle assen binnen de geconfigureerde drempel (-156.25g<acceleration<+156.25g) gedurende langer dan 0,2s → wordt er een vrije-valconditie geactiveerd.

Angle Threshold

Kan variëren tussen 50°...80°. Het is de drempelwaarde voor een kantelfunctie. Wanneer de drempel bijvoorbeeld op 60° is ingesteld en het apparaat over die hoek wordt gekanteld, wordt de kantelactie geactiveerd en wordt het advertisement-pakket verzonden.

Low noise filter

Een optie om het low noise filter in of uit te schakelen. Een low noise filter wordt gebruikt om de ruisdichtheid in de metingen te verlagen. Het inschakelen van deze functie verhoogt het stroomverbruik licht.

Temperature Offset

Info Het model TG-BT5-IN heeft geen temperatuursensor!

Kan variëren tussen -10°C...+10°C. De offset in centicelsius die op ruwe temperatuurmetingen toegepast wordt.

Tx Power

Het zendvermogen in decibel-milliwatt. Kan variëren tussen -28dBm...6dBm. Tx Power wordt simpelweg gebruikt om het zendvermogen van de tag te verhogen/verlagen.

Datalogs

Info Deze sectie is alleen beschikbaar voor het model TG-BT5-OUT.

In deze sectie kunt u logs configureren/bekijken (die alleen toegankelijk zijn via de app):

Configureer logging

In het menu "Configure logging" kunt u de logginginstellingen instellen:

Je hebt de mogelijkheid om "Periodic logging interval (s)" in te stellen (of je kunt het uitschakelen). Wanneer dit is ingeschakeld, worden de gegevenslogs automatisch elke "x" seconden opgeslagen:

Een andere optie is het inschakelen van "Log Triggers" (periodieke logging en triggerlogging kunnen samen worden gebruikt). Wanneer log triggers worden gebruikt, worden er logs opgeslagen telkens wanneer de actie kantelen, vrije val en/of impact wordt gedetecteerd.

Bijvoorbeeld: wanneer een tilt trigger is ingeschakeld en door de tag wordt gedetecteerd, wordt het bericht gelogd.

Je kunt in de sectie "Field config" instellen welke parameters gelogd gaan worden:

Je hebt de mogelijkheid om 3 parameters te loggen: 1) Batterijniveau; 2) Temperatuur; 3) Versnelling.

Je kunt elke parameter uitschakelen als je er niet in geïnteresseerd bent en je kunt er ook drempelwaarden voor instellen.

Als u het batterijniveau alleen wilt loggen wanneer het lager is dan 40%, kunt u een drempel instellen van minimum=0% tot maximum=40%, waardoor het batterijniveau (percentage batterijniveau) alleen in het log wordt weergegeven wanneer het binnen het geconfigureerde bereik ligt. Hetzelfde principe geldt voor de andere 2 parameters.

Datalogs

De gelogde berichten worden weergegeven op het tabblad "Data Logs":

Je kunt het log exporteren als een .csv-bestand via de knop "Export as .csv":

System

Op het tabblad "System" synchroniseert u de tijd, bekijkt u het systeemlogboek, zet u de tag in de factory sleep mode en werkt u de firmware bij:

Unix Time

Met deze instelling kunt u de huidige tijd en datum voor de tag synchroniseren:

Logs

Menu waar u het systeemlog kunt bekijken:

Factory sleep

Met deze optie kan de fabrieks-slaapmodus voor de tag worden gestart:

Firmware upgraden

Met dit menu kunt u de firmwareversie van de tag upgraden:

Automatische upgrade

Klik op "Download and install" en wacht tot het apparaat opnieuw is opgestart.

Handmatige upgrade

Om het firmwarebestand van de tag handmatig te downloaden, gaat u naar https://download.mikrotik.com/firmware/bt-tag/latest. Daar kunt u het bestand "latest" downloaden, dat in een kladblok of een andere teksteditor kan worden geopend. De inhoud van het bestand geeft de nieuwste beschikbare TG-BT5-XX-versies aan:

2.3.1 1638358509
1326c554c18340a41e79fd88abbea193dc53b99931eddecd018e33cff577f6d3 bt-tag_HT_app_2.3.1-0rr.gbl
9dc21eb980e8bd36732ec4db8e4b03a8177885fccdbbd87122f7d9bf76410b8b bt-tag_HT_apploader_3.2.3-0rr.gbl
9e4f30d9006f24063ac96d0fb1181d135929d86d0e243d3b3985cc5e43d6b448 bt-tag_IN_app_2.3.1-0rr.gbl
e03fa2987b874463e9a5c686303f4d75fef0c0f8d89dde14f8c4b04be4838a93 bt-tag_IN_apploader_3.2.3-0rr.gbl
54e959dd9cc1da3a5408b5dc7c797c52ae1a1685122e14d966cbe433ec1d1b3c bt-tag_OUT_app_2.3.1-0rr.gbl
e0bc2e8a1a9de6a1974c201a48cfea2276465414e07efc07816400abca91aa14 bt-tag_OUT_apploader_3.2.3-0rr.gbl
5257a1b06cb8d57d06ae10ef2c87abf0df0a3ab8a9ac7f9229a9a421b8a0c0fc bt-tag_HT_app_2.3.1-000.gbl
caf3e333721852077945c8a766db32ee5e478f1e7844dcb3e0e3d700dbab009f bt-tag_HT_apploader_3.2.3-000.gbl
0f6603d97df5fc4b3f260b410628b3c62fb2562f26e85e44b6cdfdf1b58d04f8 bt-tag_IN_app_2.3.1-000.gbl
caf3e333721852077945c8a766db32ee5e478f1e7844dcb3e0e3d700dbab009f bt-tag_IN_apploader_3.2.3-000.gbl
3235db7bb9a9cca0d5e59ae774c3cd004be4e58b44c1ae40e6e3bb84feb077a6 bt-tag_OUT_app_2.3.1-000.gbl
caf3e333721852077945c8a766db32ee5e478f1e7844dcb3e0e3d700dbab009f bt-tag_OUT_apploader_3.2.3-000.gbl

Controleer de firmwareversie van de huidige tag nogmaals met de app:

Wetende dat de tag bijvoorbeeld het model TG-BT5-IN is en dat de huidige versie 1.6.1-000 is, kunnen we concluderen dat de nieuwste release "bt-tag_IN_app_2.3.1-000.gbl" is.

Let op dat voor het merendeel van de tags de firmwareversie 1.6.1-0rr zal zijn (in plaats van 1.6.1-000). U moet dan het x.x.x-0rr bestand gebruiken.

Om het daadwerkelijke firmwarebestand te downloaden, wijzigt u het deel "latest" van de link in "bt-tag_IN_app_2.3.1-000.gbl".

Dus als uw huidige versie bijvoorbeeld "1.6.1-000" is (TG-BT5-IN tag), kan de firmware worden gedownload via de link:

https://download.mikrotik.com/firmware/bt-tag/bt-tag_IN_app_2.3.1-000.gbl

Als uw huidige versie bijvoorbeeld "1.6.1-0rr" is (TG-BT5-OUT-tag), kan de firmware via deze link worden gedownload:

https://download.mikrotik.com/firmware/bt-tag/bt-tag_OUT_app_2.3.1-0rr.gbl

Upgrade-instellingen

Waarschuwing Als u problemen hebt met het bijwerken van de tag, waarbij de tag in de OTA-/updatemodus blijft staan → probeer dan "Reliable write" in te schakelen!

Wanneer de tag "vastzit" in de OTA-/upgrademodus, kunnen zich twee scenario's voordoen: a) De taglijst van Beacon Manager toont de tag nog steeds in de lijst, maar er is geen indicatie dat de tag "configureerbaar" is. U kunt nog steeds op de tag in de lijst klikken (zelfs zonder het "tandwiel"-icoon) en de instellingen doorlopen zonder de magnetische schakelaar te activeren;

b) De tag kan uit de lijst met beheerbare tags verdwijnen. Probeer in dat geval de tag handmatig toe te voegen met de QR-codelezerfunctie en keur de "configuration" goed.

Om het menu met aanvullende upgrade-instellingen te openen, klikt u op de knop "Upgrade settings":

Hiermee kunt u de configuratie van "Reliable write" wijzigen:

Wanneer dit is ingeschakeld, kunt u met het selectievakje het Bluetooth-upgradeproces "langzamer" maar "betrouwbaarder" maken (waarbij er extra uitwisselings- en verificatiestappen plaatsvinden tussen de telefoon en de tag).

Importeren/Exporteren

Rechtsboven in het scherm hebt u de mogelijkheid om de huidige instellingen te importeren of te exporteren:

Als u op de exportknop drukt, opent de app het bestandsmenu van de telefoon, waar u het configuratiebestand een naam kunt geven en kunt opslaan.

Als u op de importknop drukt, opent de app het bestandsmenu van de telefoon, waar u het configuratiebestand kunt selecteren en toepassen.