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许可证分发的。另请参阅许可证。