chirpstack Download - chirpstack Source Code Download

chirpstack

AI-Quellcode

v4.10.2

Herunterladen

ChirpStack Open-Source Lorawan (R) Netzwerkserver

ChirpStack ist ein Open-Source Lorawan (R) -Netzwerkserver, mit dem Lorawan-Netzwerke eingerichtet werden können. ChirpStack bietet eine Weboberfläche für die Verwaltung von Gateways, Geräten und Mietern sowie für die Einrichtung von Datenintegrationen mit den wichtigsten Cloud-Anbietern, Datenbanken und Diensten, die üblicherweise zur Bearbeitung von Gerätedaten verwendet werden. ChirpStack bietet eine GRPC -basierte API, mit der Chirpstack integriert oder erweitert werden kann.

Dokumentation und Binärdateien

Weitere Dokumentationen und vorgefertigte Binärdateien finden Sie auf der ChirpStack-Website.

Gebäude aus der Quelle

Anforderungen

Erstellen von Chirpstack erfordert:

Nix (empfohlen) und
Docker

Nix

NIX wird zur Einrichtung der Entwicklungsumgebung verwendet, die für die lokale Entwicklung und für die Erstellung der Binärdateien verwendet wird.

Wenn Sie Nix nicht installiert haben und nicht installieren möchten, können Sie die bereitgestellte Docker -Kompose -basierte NIX -Umgebung verwenden. Um diese Umgebung zu starten, führen Sie den folgenden Befehl aus:

make docker-devshell

Hinweis: Sie können die Testbefehle ausführen und cargo build ausführen, aber Cross-Compiling funktioniert nicht in dieser Umgebung (da es versuchen würde, Docker in Docker zu starten).

Docker

Docker wird von Cross-Rs für Cross-Compiling sowie einige der make -Befehle verwendet.

Starten Sie die Entwicklungsschale

Führen Sie den folgenden Befehl aus, um die Entwicklungsschale zu starten:

nix-shell

Wenn Sie Nix nicht installiert haben, führen Sie den folgenden Befehl aus:

make docker-devshell

Bauen Sie die Benutzeroberfläche auf

Führen Sie den folgenden Befehl aus, um die ChirpStack -Benutzeroberfläche zu erstellen:

 make build-ui

Ausführen von ChirpStack -Tests

Starten Sie die erforderlichen Dienste

ChirpStack benötigt mehrere Dienste wie PostgreSQL, Redis, Mosquitto, um zu laufen, bevor Sie die Tests ausführen können. Sie müssen diese Dienste manuell starten, wenn Sie die Entwicklungsschale mit nix-shell gestartet haben:

docker compose up -d

Tests ausführen

Führen Sie den folgenden Befehl aus, um die ChirpStack -Tests auszuführen:

 # Test (with PostgresQL database backend)
make test

# Test with SQLite database backend
DATABASE=sqlite make test

Bauen von Chirpstack -Binärdateien

Bevor Sie die Binärdateien zusammenstellen, müssen Sie einige zusätzliche Entwicklungstools (für Cross-Compiling, Verpackung, ED) installieren. Führen Sie den folgenden Befehl aus:

make dev-dependencies

Führen Sie den folgenden Befehl innerhalb des Unterordners ./chirpstack aus:

 # 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

Standardmäßig erstellen die obigen Befehle ChirpStack mit dem PostgreSQL -Datenbank -Datenbank -Backend. Setzen Sie die DATABASE=sqlite Env. Variable zum Kompilieren von Chirpstack mit dem SQLite -Datenbank -Backend.

Datenbankmigrationen

Um eine neue Datenbankmigration zu erstellen, führen Sie aus:

 make migration-generate NAME=test-migration

Um Migrationen anzuwenden, führen Sie aus:

 make migration-run

Führen Sie aus, um eine Migration zurückzuführen:

 make migration-revert

Standardmäßig werden die obigen Befehle die Migrationsbefehle mit dem PostgreSQL -Datenbank -Backend ausführen. Um Migrationsbefehle für das SQLite -Datenbank -Backend auszuführen, setzen Sie die DATABASE=sqlite Env. Variable.