chirpstack packet multiplexer

Multiplexador de pacotes Chirpstack

O multiplexador de pacotes ChirpStack possibilita conectar gateways usando o protocolo de forçador de pacotes UDP Semtech a vários servidores, com a opção de marcar apenas os servidores como uplink.

Instalar

Debian / Ubuntu

O Chirpstack fornece um repositório compatível com o sistema de pacotes APT Debian / Ubuntu. Primeiro, verifique se o dirmngr e apt-transport-https estão instalados:

 sudo apt install apt-transport-https dirmngr

Configure a chave para este novo repositório:

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

Adicione o repositório à lista de repositórios criando um novo arquivo:

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

Atualize o cache do pacote apt e instale chirpstack-packet-multiplexer :

 sudo apt update
sudo apt install chirpstack-packet-multiplexer

Para concluir a instalação, atualize o arquivo de configuração localizado em /etc/chirpstack-packet-multiplexer/chirpstack-packet-multiplexer.toml e (re) inicie o serviço:

 sudo systemctl restart chirpstack-packet-multiplexer

Edifício da fonte

Requisitos

Construir o multiplexador de pacotes Chirpstack requer:

• Nix
• Docker

Nix

O NIX é usado para configurar o ambiente de desenvolvimento que é usado para o desenvolvimento local e para criar os binários.

Se você não possui o NIX instalado e não deseja instalá -lo, também pode replicar o ambiente de desenvolvimento instalando os pacotes listados no shell.nix manualmente.

Docker

O Docker é usado pelos Cross-Rs para compilação cruzada, bem como alguns dos comandos make .

Iniciando a concha de desenvolvimento

Execute o seguinte comando para iniciar o shell de desenvolvimento:

nix-shell

Testes de execução

Execute o seguinte comando para executar os testes:

make test

Binários de construção

Execute os seguintes comandos para construir os binários e pacotes do multiplexador de pacotes Chirpstack:

 # Only build binaries
make build

# Build binaries + distributable packages.
make dist

Uso

Execute chirpstack-packet-multiplexer --help para informações de uso.

Exemplo de configuração

A execução chirpstack-packet-multiplexer configfile retorna o seguinte modelo de configuração:

 # 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 compor exemplo

 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

O exemplo acima assume que você possui um diretório de configuração local chamado config , que contém um arquivo chirpstack-packet-multiplexer.toml .

Changelog

v4.0.0

• Refactor Código de Go para Rust.
• Permitir a filtragem do prefixo do ID do gateway.
• Encaminhe todos os gateways, caso gateway_id_prefixes esteja vazio.
• Expor métricas de Prometheus.

v3.1.0

Esta versão renomeia o multiplexador de pacotes Lora para o multiplexador de pacotes Chirpstack. Veja o anúncio de renomeação para obter mais informações.

v3.0.2

• Corrija a configuração da variável de configuração (usada para resolver se o back -end permitir downlink).

v3.0.1

• IDs de gateway configurados automaticamente-lowercase.

v3.0.0

• Liberação inicial (parte do repositório Lora Server V3).

Licença

O multiplexador de pacotes Chirpstack é distribuído sob a licença do MIT. Veja também Licença.