chirpstack

Chirpstack de código abierto Lorawan (R) Network Server

ChirpStack es un servidor de red Lorawan (R) de código abierto que puede usarse para configurar las redes Lorawan. ChirpStack proporciona una interfaz web para la administración de puertas de enlace, dispositivos e inquilinos, así para configurar las integraciones de datos con los principales proveedores de nubes, bases de datos y servicios comúnmente utilizados para manejar los datos del dispositivo. ChirpStack proporciona una API basada en GRPC que puede usarse para integrar o extender Chirpstack.

Documentación y binarios

Consulte el sitio web de Chirpstack para obtener documentación y binarios precompilados.

Edificio de la fuente

Requisitos

Construir Chirpstack requiere:

• Nix (recomendado) y
• 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, puede usar el entorno NIX basado en Docker Compose proporcionado. Para iniciar este entorno, ejecute el siguiente comando:

make docker-devshell

Nota: Podrá ejecutar los comandos de prueba y ejecutar cargo build , pero la compilación cruzada no funcionará dentro de este entorno (porque intentaría Start Docker dentro de Docker).

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

O si no tiene NIX instalado, ejecute el siguiente comando:

make docker-devshell

Construyendo la interfaz de usuario

Para construir el chirpstack ui, ejecute el siguiente comando:

 make build-ui

Ejecución de pruebas de chirpstack

Inicie los servicios requeridos

Chirpstack requiere varios servicios como PostgreSQL, Redis, Mosquitto, ... para ejecutar antes de que pueda ejecutar las pruebas. Debe iniciar estos servicios manualmente si comenzó el shell de desarrollo usando nix-shell :

docker compose up -d

Ejecutar pruebas

Ejecute el siguiente comando para ejecutar las pruebas ChirpStack:

 # Test (with PostgresQL database backend)
make test

# Test with SQLite database backend
DATABASE=sqlite make test

Construcción de binarios de chirpstack

Antes de compilar los binarios, debe instalar algunas herramientas de desarrollo adicionales (para compilación cruzada, empaque, ed). Ejecutar el siguiente comando:

make dev-dependencies

Ejecute el siguiente comando dentro del Sub-hilador ./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

De manera predeterminada, los comandos anteriores construirán ChirpStack con el backend de la base de datos de la base de datos PostgreSQL. Establezca la DATABASE=sqlite env. variable para compilar Chirpstack con el backend de la base de datos SQLite.

Migraciones de bases de datos

Para crear una nueva migración de base de datos, ejecute:

 make migration-generate NAME=test-migration

Para aplicar migraciones, ejecute:

 make migration-run

Para revertir una migración, ejecute:

 make migration-revert

De manera predeterminada, los comandos anteriores ejecutarán los comandos de migración utilizando el backend de la base de datos PostgreSQL. Para ejecutar los comandos de migración para el backend de la base de datos SQLite, establezca la DATABASE=sqlite env. variable.

Licencia

Chirpstack Network Server se distribuye bajo la licencia MIT. Ver también Licencia.