chirpstack

CHIRPSTACK開源Lorawan（R）網絡服務器

Chirpstack是一家開源Lorawan（R）網絡服務器，可用於設置Lorawan網絡。 Chirpstack提供了一個網絡，設備和租戶管理的Web界面，以及與主要用於處理設備數據的主要雲提供商，數據庫和服務建立數據集成。 Chirpstack提供了基於GRPC的API，可用於集成或擴展Chirpstack。

文檔和二進製文件

請訪問Chirpstack網站以獲取文檔和預編譯的二進製文件。

從來源建造

要求

建築物Chirpstack需要：

• 尼克斯（推薦）和
• Docker

尼克斯

NIX用於設置用於本地開發和創建二進製文件的開發環境。

如果您沒有安裝NIX並且不希望安裝它，則可以使用提供的Docker基於撰寫的Nix環境。要啟動此環境執行以下命令：

make docker-devshell

注意：您將能夠運行測試命令並運行cargo build ，但是交叉編譯將在此環境中無法使用（因為它將嘗試在Docker中啟動Docker）。

Docker

Cross-Rs使用Docker進行交叉編譯以及一些make 。

開始開發外殼

運行以下命令來啟動開發外殼：

nix-shell

或者，如果您沒有安裝NIX，請執行以下命令：

make docker-devshell

構建UI

要構建Chirpstack UI，請執行以下命令：

 make build-ui

運行CHIRPSTACK測試

開始所需的服務

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

建造Chirpstack二進製文件

在編譯二進製文件之前，您需要安裝一些其他開發工具（用於交叉編譯，包裝等）。執行以下命令：

make dev-dependencies

在./chirpstack sub-folder中運行以下命令：

 # 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許可證分發的。另請參閱許可證。