chirpstack

Chirpstack Open-source Lorawan (R) Server réseau

ChirpStack est un serveur de réseau Lorawan (R) open source qui peut être utilisé pour configurer les réseaux Lorawan. ChirpStack fournit une interface Web pour la gestion des passerelles, des appareils et des locataires pour configurer des intégrations de données avec les principaux fournisseurs de cloud, bases de données et services couramment utilisés pour gérer les données des périphériques. ChirpStack fournit une API basée sur GRPC qui peut être utilisée pour intégrer ou étendre ChirpStack.

Documentation et binaires

Veuillez vous référer au site Web de Chirpstack pour la documentation et les binaires pré-compilés.

Bâtiment de Source

Exigences

Construire Chirpstack nécessite:

• Nix (recommandé) et
• Docker

Rien

Nix est utilisé pour mettre en place l'environnement de développement qui est utilisé pour le développement local et pour la création des binaires.

Si vous n'avez pas installé NIX et ne souhaitez pas l'installer, vous pouvez utiliser l'environnement NIX basé sur Docker Compose. Pour démarrer cet environnement, exécutez la commande suivante:

make docker-devshell

Remarque: vous pourrez exécuter les commandes de test et exécuter cargo build , mais la compilation croisée ne fonctionnera pas dans cet environnement (car il essaierait de démarrer Docker dans Docker).

Docker

Docker est utilisé par Cross-RS pour la compilation croisée, ainsi que certaines des commandes make .

Démarrer le shell de développement

Exécutez la commande suivante pour démarrer le shell de développement:

nix-shell

Ou si vous n'avez pas installé NIX, exécutez la commande suivante:

make docker-devshell

Construire l'interface utilisateur

Pour construire l'interface utilisateur Chirpstack, exécutez la commande suivante:

 make build-ui

Exécution de tests de chirpstack

Démarrer les services requis

ChirpStack nécessite plusieurs services comme PostgreSQL, Redis, Mosquitto, ... à exécuter avant de pouvoir exécuter les tests. Vous devez démarrer ces services manuellement si vous avez démarré le shell de développement à l'aide de nix-shell :

docker compose up -d

Exécuter des tests

Exécutez la commande suivante pour exécuter les tests chirpstack:

 # Test (with PostgresQL database backend)
make test

# Test with SQLite database backend
DATABASE=sqlite make test

Construire des binaires de chirpstack

Avant de compiler les binaires, vous devez installer des outils de développement supplémentaires (pour compilation croisée, emballage, ED). Exécutez la commande suivante:

make dev-dependencies

Exécutez la commande suivante dans le sous-fichier ./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

Par défaut, les commandes ci-dessus créeront ChirpStack avec le backend de la base de données de la base de données PostgreSQL. Définissez la DATABASE=sqlite Env. Variable pour compiler ChirpStack avec le backend de la base de données SQLite.

Migrations de base de données

Pour créer une nouvelle migration de la base de données, exécutez:

 make migration-generate NAME=test-migration

Pour appliquer des migrations, exécutez:

 make migration-run

Pour réintégrer une migration, exécutez:

 make migration-revert

Par défaut, les commandes ci-dessus exécuteront les commandes de migration à l'aide du backend de la base de données PostgreSQL. Pour exécuter les commandes de migration pour le backend de la base de données SQLite, définissez la DATABASE=sqlite Env. variable.

Licence

ChirpStack Network Server est distribué sous la licence MIT. Voir aussi Licence.