Kapitel 3

Getting Started

Die folgenden Komponenten sind zum Starten erforderlich: Beacon Line Starterkit

  1. Ein Beacon Line Starterkit.
  2. Die Bline-Server Software.
  3. Die Bline-Log Software.
3.1 Beacon Line Starterkit

Die Einfachheit des Netzwerkkonzepts der Beacon Line macht es Ihnen leicht, große drahtlose BLE-Ideen mit einem hohen Maß an technischer Flexibilität und modularer Erweiterung zu realisieren. Im Lieferumfang enthalten: 1x Ethernet Gateway 9x Anker 3x Bluetooth Low Energy Beacon 1x POE (Power over Ethernet Netzteil) 10x Cat5-Kabel (5 Meter Länge) Wir verbinden die Anker mit dem Gateway. Das Gateway wird mit dem POE Port vom POE Netzteil verbunden. Den LAN Port verbinden wir mit unserem Switch (bis 1000 MBit/s).

3.2 Bline-Server Software

Die Bline-Server Software kann unter Linux, Windows und macOS gestartet werden. Der Bline-Server kann mit mehreren Beacon Line Gateways beziehungsweise Ankern eine Verbindung aufbauen. Das lässt sich in der Bline-Server.yaml Datei einstellen. Ein Beispiel (Bline-Server.yaml): Download: Bline-Server.yaml server: jwt: false # JSON Web Token basepath: /bline/v1 # HTTP Prefix www: vue/dist httpport: 8080 # Port Nummer für RESTful API scanport: 4000 # Scan TCP Port Nummer errorport: 4001 # Error Port Nummer grpcport: 50051 # gRPC Port Nummer verbose: false # Verbose Flag monitor: true # Monitor Flag monitorinterval: 30 # Monitoring Interval in Sekunden lines: line1: # Name des Gateways anchors: 1 # Anzahl der Anker verbunden mit dem Gateway desciption: blgd-8c8e76011316 # Die Beschreibung der Line url: blgd-8c8e76011316:3001 # Die IP-Adresse oder Hostname vom Gateway enabled: true # Enabled Flag scan: true # Scan Flag broadcast: false # Broadcast Flag line2: anchors: 3 desciption: blgd-8c8e76010477 url: blgd-8c8e76010477:3001 enabled: true scan: true broadcast: true Wir starten die Bline-Server:

3.3 Bline-Log Software

Die Bline-Log Software kann unter Linux, Windows und macOS gestartet werden. Der Bline-Log kann die Scan-Daten vom Bline-Server loggen. Ein Beispiel (Bline-Log.yaml): Download: Bline-Log.yaml cfgpath: . datapath: . logpath: log scanport: 4000 errorport: 3001 verbose: false Unter Windows starten wir in der Eingabeaufforderung mit folgendem Befehl: C:\beacon_line_2023\Bline-Log.221211\windows>Bline-Log.exe Log wird gestartet: datapath: . logpath: log ScanLog ([::1]:3936) connected to tcp://localhost:4000 Die Observerdaten werden in csv-Dateien umgeleitet Nähere Erklärung zu den Observer-Daten finden Sie in Kapitel 5.

Unterabschnitte von Getting Started

3.1 Beacon Line Starterkit

Die Einfachheit des Netzwerkkonzepts der Beacon Line macht es Ihnen leicht, große drahtlose BLE-Ideen mit einem hohen Maß an technischer Flexibilität und modularer Erweiterung zu realisieren.

Im Lieferumfang enthalten:

  1. 1x Ethernet Gateway
  2. 9x Anker
  3. 3x Bluetooth Low Energy Beacon
  4. 1x POE (Power over Ethernet Netzteil)
  5. 10x Cat5-Kabel (5 Meter Länge) Beacon Line Starterkit

Wir verbinden die Anker mit dem Gateway. Das Gateway wird mit dem POE Port vom POE Netzteil verbunden. Den LAN Port verbinden wir mit unserem Switch (bis 1000 MBit/s).

Das Gateway bekommt seine IP-Adresse dynamisch vom DHCP Server und ist erreichbar über die IP-Adresse oder Hostname (BLGD-MAC). Die MAC-Adresse ist auf dem Gehäuse des Gateways abgebildet (z.B. BLGD-8C8E7601441E). Um mit dem Gateway zu kommunizieren wird ein “.local” an den Hostnamen (MAC-Adresse) gehängt, also bei diesem Beispiel:

BLGD-8C8E7601441E.local

3.2 Bline-Server Software

Die Bline-Server Software kann unter Linux, Windows und macOS gestartet werden.

Der Bline-Server kann mit mehreren Beacon Line Gateways beziehungsweise Ankern eine Verbindung aufbauen. Das lässt sich in der Bline-Server.yaml Datei einstellen.

Bline-Server im Explorer

Ein Beispiel (Bline-Server.yaml):

Download: Bline-Server.yaml

server:
    jwt: false                              # JSON Web Token
    basepath: /bline/v1                     # HTTP Prefix
    www: vue/dist
    httpport: 8080                          # Port Nummer für RESTful API
    scanport: 4000                          # Scan TCP Port Nummer
    errorport: 4001                         # Error Port Nummer
    grpcport: 50051                         # gRPC Port Nummer
    verbose: false                          # Verbose Flag
    monitor: true                           # Monitor Flag
    monitorinterval: 30                     # Monitoring Interval in Sekunden
lines:
    line1:                                  # Name des Gateways
        anchors: 1                          # Anzahl der Anker verbunden mit dem Gateway
        desciption: blgd-8c8e76011316       # Die Beschreibung der Line
        url: blgd-8c8e76011316:3001         # Die IP-Adresse oder Hostname vom Gateway
        enabled: true                       # Enabled Flag
        scan: true                          # Scan Flag
        broadcast: false                    # Broadcast Flag
    line2:
        anchors: 3
        desciption: blgd-8c8e76010477
        url: blgd-8c8e76010477:3001
        enabled: true
        scan: true
        broadcast: true

Wir starten die Bline-Server:

Unter Windows starten wir in der Eingabeaufforderung mit folgendem Befehl:

C:\beacon_line_2023\Bline-Server.230210\windows>Bline-Server.exe

Dann wird der Bline-Server gestartet und initialisiert die Beacon Line:

#./Bline-Server
Bline-Server, V1.0 (24.09.2023), (C) taskit GmbH, 2023

Scan server listen to port 4000
Error server listen to port 4001

Web-Hosting: vue/dist
API Basepath: /bline/v1
⇨ http server started on [::]:8080

Connect Lines
    line1      with 1 anchors   Port: 48236 <-> blgd-8c8e76011316
    line2      with 3 anchors   Port: 48237 <-> blgd-8c8e76010477
Initialise Lines
    Waiting for Anchors
    Initialising Complete
Statup Lines     1   2   3   4   5   6   7   8   9  10  11  12  13  14  15  16  17  18  19  20
    line1       S-
    line2       SB  SB  SB

3.3 Bline-Log Software

Die Bline-Log Software kann unter Linux, Windows und macOS gestartet werden.

Der Bline-Log kann die Scan-Daten vom Bline-Server loggen.

Bline-Log im Explorer

Ein Beispiel (Bline-Log.yaml):

Download: Bline-Log.yaml

cfgpath: .
datapath: .
logpath: log
scanport: 4000
errorport: 3001
verbose: false

Unter Windows starten wir in der Eingabeaufforderung mit folgendem Befehl:

C:\beacon_line_2023\Bline-Log.221211\windows>Bline-Log.exe

Log wird gestartet:

datapath: .
logpath: log
ScanLog ([::1]:3936) connected to tcp://localhost:4000

Die Observerdaten werden in csv-Dateien umgeleitet

Bline-Log im Explorer

Nähere Erklärung zu den Observer-Daten finden Sie in Kapitel 5.