
Chirpstackは、ロラワンネットワークのセットアップに使用できるオープンソースロラワン(R)ネットワークサーバーです。 Chirpstackは、ゲートウェイ、デバイス、テナントの管理用のWebインターフェイスを提供し、デバイスデータの取り扱いに一般的に使用される主要なクラウドプロバイダー、データベース、サービスとのデータ統合をセットアップします。 Chirpstackは、Chirpstackの統合または拡張に使用できるGRPCベースのAPIを提供します。
ドキュメントと事前にコンパイルされたバイナリについては、Chirpstack Webサイトを参照してください。
Chirpstackの構築には次のことが必要です。
NIXは、現地開発やバイナリの作成に使用される開発環境のセットアップに使用されます。
Nixをインストールしておらず、インストールを希望しない場合は、提供されたDockerベースのNIX環境を使用できます。この環境を開始するには、次のコマンドを実行します。
make docker-devshell注:テストコマンドを実行してcargo buildを実行することができますが、クロスコンパイルはこの環境内では機能しません(Docker内でDockerを開始するため)。
Dockerは、Cross-RSでクロスコンパイルと、 makeコマンドの一部に使用されます。
開発シェルを開始するには、次のコマンドを実行します。
nix-shellまたは、nixをインストールしていない場合は、次のコマンドを実行します。
make docker-devshellChirpstack UIを構築するには、次のコマンドを実行します。
make build-ui
Chirpstackには、PostgreSQL、Redis、Mosquittoなど、テストを実行する前に実行する必要があります。 nix-shellを使用して開発シェルを開始する場合は、これらのサービスを手動で開始する必要があります。
docker compose up -d次のコマンドを実行して、Chirpstackテストを実行します。
# Test (with PostgresQL database backend)
make test
# Test with SQLite database backend
DATABASE=sqlite make testバイナリをコンパイルする前に、いくつかの追加の開発ツールをインストールする必要があります(クロスコンパイル、パッケージング、ED用)。次のコマンドを実行します。
make dev-dependencies ./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デフォルトでは、上記のコマンドは、PostgreSQLデータベースデータベースバックエンドを使用してChirpstackを構築します。 DATABASE=sqlite envを設定します。 SQLiteデータベースバックエンドでChirpstackをコンパイルする変数。
新しいデータベースの移行を作成するには、実行してください。
make migration-generate NAME=test-migration
移行を適用するには、実行してください。
make migration-run
移行を戻すには、実行してください。
make migration-revert
デフォルトでは、上記のコマンドは、PostgreSQLデータベースバックエンドを使用して移行コマンドを実行します。 SQLiteデータベースバックエンドの[移行]コマンドを実行するには、 DATABASE=sqlite envを設定します。変数。
Chirpstackネットワークサーバーは、MITライセンスの下で配布されます。ライセンスも参照してください。