chirpstack packet multiplexer

Multiplexor de paquetes Chirpstack

El multiplexor de paquetes ChirpStack permite conectar las puertas de enlace utilizando el protocolo Semtech UDP Packet-Forwarder a múltiples servidores, con la opción de marcar los servidores solo como enlace ascendente.

Instalar

Debian / Ubuntu

ChirpStack proporciona un repositorio que es compatible con el sistema de paquetes Debian / Ubuntu Apt. Primero asegúrese de que se instalen dirmngr y apt-transport-https :

 sudo apt install apt-transport-https dirmngr

Configure la clave para este nuevo repositorio:

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

Agregue el repositorio a la lista de repositorio creando un nuevo archivo:

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

Actualice el paquete APT en caché e instale chirpstack-packet-multiplexer :

 sudo apt update
sudo apt install chirpstack-packet-multiplexer

Para completar la instalación, actualice el archivo de configuración que se encuentra en /etc/chirpstack-packet-multiplexer/chirpstack-packet-multiplexer.toml y (re) iniciar el servicio:

 sudo systemctl restart chirpstack-packet-multiplexer

Edificio de la fuente

Requisitos

Construir el multiplexor de paquetes Chirpstack requiere:

• Nada
• Estibador

Nada

NIX se utiliza para configurar el entorno de desarrollo que se utiliza para el desarrollo local y para crear los binarios.

Si no tiene NIX instalado y no desea instalarlo, también puede replicar el entorno de desarrollo instalando los paquetes enumerados en shell.nix manualmente.

Estibador

Docker es utilizado por RS-RS para compilación cruzada, así como algunos de los comandos make .

Comenzando el caparazón de desarrollo

Ejecute el siguiente comando para iniciar el shell de desarrollo:

nix-shell

Pruebas de ejecución

Ejecute el siguiente comando para ejecutar las pruebas:

make test

Construcción de binarios

Ejecute los siguientes comandos para construir los binarios y paquetes de multiplexador de paquetes ChirpStack:

 # Only build binaries
make build

# Build binaries + distributable packages.
make dist

Uso

Ejecute chirpstack-packet-multiplexer --help para información de uso.

Configuración de ejemplo

Ejecutar chirpstack-packet-multiplexer configfile Devuelve la siguiente plantilla de configuración:

 # 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 = " " 

Ejemplo de composición de Docker

 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

El ejemplo anterior supone que tiene un directorio de configuración local llamado config que contiene un archivo chirpstack-packet-multiplexer.toml .

Colegio de cambios

V4.0.0

• Código de refactorización desde ir a Rust.
• Permitir el filtrado de prefijo ID de ID de puerta de enlace.
• Reenviar todas las puertas de enlace en Case gateway_id_prefixes está vacía.
• Exponer las métricas Prometheus.

v3.1.0

Esta versión renombra el multiplexor de paquetes Lora al multiplexor de paquetes Chirpstack. Vea el anuncio de renombro para obtener más información.

v3.0.2

• Arreglar la configuración de la variable de configuración (se usa para resolver si el backend permite el enlace descendente).

v3.0.1

• ID de puerta de enlace configurados por autos-lowercase.

v3.0.0

• Liberación inicial (parte del repositorio de Lora Server V3).

Licencia

El multiplexor de paquetes Chirpstack se distribuye bajo la licencia MIT. Ver también Licencia.