chirpstack packet multiplexer -Download - chirpstack packet multiplexer -Quellcode herunterladen

chirpstack packet multiplexer

AI-Quellcode

1.0.0

Herunterladen

ChirpStack Packet Multiplexer

Der ChirpStack-Paket-Multiplexer ermöglicht es, Gateways mit dem Semtech UDP-Paket-Forward-Protokoll mit mehreren Servern zu verbinden, mit der Option, Server nur als Uplink zu markieren.

Installieren

Debian / Ubuntu

ChirpStack bietet ein Repository, das mit dem Debian / Ubuntu APT -Paketsystem kompatibel ist. Stellen Sie zunächst sicher, dass sowohl dirmngr als auch apt-transport-https installiert sind:

 sudo apt install apt-transport-https dirmngr

Richten Sie den Schlüssel für dieses neue Repository ein:

 sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 1CE2AFD36DBCCA00

Fügen Sie das Repository der Repository -Liste hinzu, indem Sie eine neue Datei erstellen:

 sudo echo "deb https://artifacts.chirpstack.io/packages/4.x/deb stable main" | sudo tee /etc/apt/sources.list.d/chirpstack.list

Aktualisieren Sie den APT-Paket-Cache und installieren Sie chirpstack-packet-multiplexer :

 sudo apt update
sudo apt install chirpstack-packet-multiplexer

Um die Installation zu vervollständigen, aktualisieren Sie die Konfigurationsdatei, die sich unter /etc/chirpstack-packet-multiplexer/chirpstack-packet-multiplexer.toml befindet und (wieder) den Dienst starten:

 sudo systemctl restart chirpstack-packet-multiplexer

Gebäude aus der Quelle

Anforderungen

Erstellen von ChirpStack -Paket -Multiplexer erfordert:

Nix
Docker

Nix

NIX wird zur Einrichtung der Entwicklungsumgebung verwendet, die für die lokale Entwicklung und für die Erstellung der Binärdateien verwendet wird.

Wenn Sie Nix nicht installiert haben und nicht installieren möchten, können Sie die Entwicklungsumgebung auch replizieren, indem Sie die in shell.nix aufgeführten Pakete manuell installieren.

Docker

Docker wird von Cross-Rs für Cross-Compiling sowie einige der make -Befehle verwendet.

Starten Sie die Entwicklungsschale

Führen Sie den folgenden Befehl aus, um die Entwicklungsschale zu starten:

nix-shell

Auslauftests

Führen Sie den folgenden Befehl aus, um die Tests auszuführen:

make test

Binärdateien

Führen Sie die folgenden Befehle aus, um das ChirpStack -Paket -Multiplexer -Binärdateien und -Pakete zu erstellen:

 # Only build binaries
make build

# Build binaries + distributable packages.
make dist

Verwendung

Führen Sie chirpstack-packet-multiplexer --help für Nutzungsinformationen.

Beispielkonfiguration

Ausführen chirpstack-packet-multiplexer configfile gibt die folgende Konfigurationsvorlage zurück:

 # Logging settings.
[ logging ]

  # Log level.
  #
  # Valid options are:
  #   * TRACE
  #   * DEBUG
  #   * INFO
  #   * WARN
  #   * ERROR
  level = " info "


# Multiplexer configuration.
[ multiplexer ]

  # Interface:port of UDP bind.
  #
  # This this is the interface:port on which the Multiplexer will receive
  # data from the gateways.
  bind = " 0.0.0.0:1700 "

  # Servers to forward gateway data to.
  #
  # Example configuration:
  # [[multiplexer.server]]

  #   # Hostname:port of the server.
  #   server="example.com:1700"

  #   # Only allow uplink.
  #   #
  #   # If set to true, any downlink will be discarded.
  #   uplink_only=false

  #   # Gateway ID prefix filters.
  #   #
  #   # If not set, data of all gateways will be forwarded. If set, only data
  #   # from gateways with a matching Gateway ID will be forwarded.
  #   #
  #   # Examplex:
  #   # * "0102030405060708/32": Exact match (all 32 bits of the filter must match)
  #   # * "0102030400000000/16": All gateway IDs starting with "01020304" (filter on 16 most significant bits)
  #   gateway_id_prefixes=[]


# Monitoring configuration.
[ monitoring ]

  # Interface:port.
  #
  # If set, this will enable the monitoring endpoints. If not set, the endpoint
  # will be disabled. Endpoints:
  #
  # * /metrics: Exposes Prometheus metrics.
  bind = " "

Docker Compose Beispiel

 services:
  chirpstack-packet-multiplexer:
    image: chirpstack/chirpstack-packet-multiplexer:4.0.0-test.2
    command: -c /etc/chirpstack-packet-multiplexer/chirpstack-packet-multiplexer.toml
    ports:
      - 1700:1700/udp
    volumes:
      - ./config:/etc/chirpstack-packet-multiplexer

Das obige Beispiel wird davon ausgegangen, dass Sie ein lokales Konfigurationsverzeichnis mit dem Namen config haben, das eine chirpstack-packet-multiplexer.toml Datei enthält.

Changelog

v4.0.0

Refaktorcode von Go to Rost.
Ermöglichen Sie die Gateway -ID -Präfix -Filterung.
Leiten Sie alle Gateways weiter, falls gateway_id_prefixes leer ist.
Enthüllen Sie Prometheus -Metriken.

v3.1.0

In dieser Version wird Lora Paket Multiplexer in ChirpStack Packet Multiplexer umgeleitet. Weitere Informationen finden Sie in der Umbenennamen -Ankündigung.