chirpstack

CHIRPSTACK Open Source Lorawan (R) servidor de rede

O Chirpstack é um servidor de rede Lorawan (R) de código aberto (R) que pode ser usado para configurar as redes de Lorawan. O ChirpStack fornece uma interface da Web para o gerenciamento de gateways, dispositivos e inquilinos, além de configurar integrações de dados com os principais provedores de nuvem, bancos de dados e serviços comumente usados ​​para lidar com dados do dispositivo. O ChirpStack fornece uma API baseada em GRPC que pode ser usada para integrar ou estender o Chirpstack.

Documentação e binários

Consulte o site Chirpstack para documentação e binários pré-compilados.

Edifício da fonte

Requisitos

Construir Chirpstack requer:

• Nix (recomendado) e
• 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, pode usar o ambiente NIX baseado no Docker Compose Docker. Para iniciar este ambiente, execute o seguinte comando:

make docker-devshell

NOTA: Você poderá executar os comandos de teste e executar cargo build , mas a compilação cruzada não funcionará nesse ambiente (porque tentaria iniciar o Docker no Docker).

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

Ou se você não tiver o NIX instalado, execute o seguinte comando:

make docker-devshell

Construindo a interface do usuário

Para construir a interface do usuário Chirpstack, execute o seguinte comando:

 make build-ui

Executando testes Chirpstack

Inicie os serviços necessários

O Chirpstack requer vários serviços como PostgreSQL, Redis, Mosquitto, ... para executar antes que você possa executar os testes. Você precisa iniciar esses serviços manualmente se iniciar o Shell de Desenvolvimento usando nix-shell :

docker compose up -d

Executar testes

Execute o seguinte comando para executar os testes Chirpstack:

 # Test (with PostgresQL database backend)
make test

# Test with SQLite database backend
DATABASE=sqlite make test

Construindo binários Chirpstack

Antes de compilar os binários, você precisa instalar algumas ferramentas de desenvolvimento adicionais (para compilação cruzada, embalagem, ed). Execute o seguinte comando:

make dev-dependencies

Execute o seguinte comando dentro do sub-Foldador ./chirpstack :

 # Build AMD64 debug build (optimized for build speed)
make debug-amd64

# Build AMD64 release build (optimized for performance and binary size)
make release-amd64

# Build all packages (all targets, .deb, .rpm and .tar.gz files)
make dist

Por padrão, os comandos acima criarão o Chirpstack com o back -end do banco de dados PostGresql. Defina o DATABASE=sqlite Env. Variável para compilar Chirpstack com o back -end do banco de dados SQLite.

Migrações de banco de dados

Para criar uma nova migração de banco de dados, execute:

 make migration-generate NAME=test-migration

Para aplicar migrações, execute:

 make migration-run

Para reverter uma migração, execute:

 make migration-revert

Por padrão, os comandos acima executarão os comandos de migração usando o back -end do banco de dados PostGresql. Para executar comandos de migração para o back -end do banco de dados SQLite, defina o banco de DATABASE=sqlite ENV. variável.

Licença

O Chirpstack Network Server está distribuído sob a licença do MIT. Veja também Licença.