chirpstack

Server jaringan Lorawan Open-Source (R) ChirpStack

ChirpStack adalah server jaringan Lorawan (R) open-source yang dapat digunakan untuk mengatur jaringan Lorawan. ChirpStack menyediakan antarmuka web untuk pengelolaan gateway, perangkat, dan penyewa juga untuk mengatur integrasi data dengan penyedia cloud utama, basis data, dan layanan yang biasa digunakan untuk menangani data perangkat. ChirpStack menyediakan API berbasis GRPC yang dapat digunakan untuk mengintegrasikan atau memperluas ChirpStack.

Dokumentasi dan binari

Silakan merujuk ke situs web ChirpStack untuk dokumentasi dan binari yang telah dikompilasi sebelumnya.

Membangun dari sumber

Persyaratan

Membangun ChirpStack Membutuhkan:

• Nix (disarankan) dan
• Buruh pelabuhan

Nix

NIX digunakan untuk menyiapkan lingkungan pengembangan yang digunakan untuk pengembangan lokal dan untuk menciptakan binari.

Jika Anda tidak menginstal NIX dan tidak ingin menginstalnya, maka Anda dapat menggunakan lingkungan Nix berbasis Docker Compose yang disediakan. Untuk memulai lingkungan ini, jalankan perintah berikut:

make docker-devshell

CATATAN: Anda akan dapat menjalankan perintah uji dan menjalankan cargo build , tetapi kompilasi silang tidak akan bekerja di dalam lingkungan ini (karena akan mencoba memulai Docker di dalam Docker).

Buruh pelabuhan

Docker digunakan oleh Cross-RS untuk kompilasi silang, serta beberapa perintah make .

Memulai Shell Pengembangan

Jalankan perintah berikut untuk memulai shell pengembangan:

nix-shell

Atau jika Anda tidak menginstal NIX, jalankan perintah berikut:

make docker-devshell

Membangun UI

Untuk membangun UI ChirpStack, jalankan perintah berikut:

 make build-ui

Menjalankan tes ChirpStack

Mulai layanan yang diperlukan

ChirpStack memerlukan beberapa layanan seperti PostgreSQL, Redis, Mosquitto, ... untuk berjalan sebelum Anda dapat menjalankan tes. Anda perlu memulai layanan ini secara manual jika Anda memulai shell pengembangan menggunakan nix-shell :

docker compose up -d

Jalankan tes

Jalankan perintah berikut untuk menjalankan tes ChirpStack:

 # Test (with PostgresQL database backend)
make test

# Test with SQLite database backend
DATABASE=sqlite make test

Membangun binari Chirpstack

Sebelum menyusun binari, Anda perlu menginstal beberapa alat pengembangan tambahan (untuk kompilasi silang, pengemasan, ED). Jalankan perintah berikut:

make dev-dependencies

Jalankan perintah berikut di dalam sub-fold ./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

Secara default perintah di atas akan membangun ChirpStack dengan backend database database PostgreSQL. Atur DATABASE=sqlite env. Variabel untuk mengkompilasi ChirpStack dengan backend database SQLite.

Migrasi Basis Data

Untuk membuat migrasi basis data baru, jalankan:

 make migration-generate NAME=test-migration

Untuk menerapkan migrasi, jalankan:

 make migration-run

Untuk mengembalikan migrasi, eksekusi:

 make migration-revert

Secara default perintah di atas akan menjalankan perintah migrasi menggunakan backend database PostgreSQL. Untuk menjalankan perintah migrasi untuk backend database sqlite, atur DATABASE=sqlite env. variabel.

Lisensi

ChirpStack Network Server didistribusikan di bawah lisensi MIT. Lihat juga Lisensi.