chirpstack

Сетевой сервер с открытым исходным кодом (R)

CHIRPSTACK-это сетевой сервер Lorawan с открытым исходным кодом (R), который можно использовать для настройки Lorawan Networks. CHIRPSTACK предоставляет веб-интерфейс для управления шлюзами, устройствами и арендаторами, а также для настройки интеграции данных с основными облачными поставщиками, базами данных и службами, обычно используемыми для обработки данных устройств. ChirpStack предоставляет API на основе GRPC, который можно использовать для интеграции или расширения ChirpStack.

Документация и двоичные файлы

Пожалуйста, обратитесь на веб-сайт Chirpstack для документации и предварительно скомпилированных двоичных файлов.

Здание из источника

Требования

Построение чирпстака требуется:

• Nix (рекомендуется) и
• Докер

Никс

NIX используется для настройки среды разработки, которая используется для локальной разработки и для создания двоичных файлов.

Если у вас нет NIX, и вы не хотите его устанавливать, то вы можете использовать предоставленную среду на основе Docker Compose Nix. Чтобы начать эту среду выполнить следующую команду:

make docker-devshell

Примечание. Вы сможете запустить тестовые команды и запустить cargo build , но перекрестная компиляция не будет работать в этой среде (потому что он будет пытаться запустить Docker в Docker).

Докер

Docker используется Cross-RS для перекрестной компиляции, а также некоторые команды make .

Запуск оболочки разработки

Запустите следующую команду, чтобы запустить оболочку разработки:

nix-shell

Или если у вас нет NIX, выполните следующую команду:

make docker-devshell

Создание пользовательского интерфейса

Чтобы построить пользовательский интерфейс chirpstack, выполните следующую команду:

 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

Строительство бинарных файлов чирпстака

Перед тем, как скомпилировать двоичные файлы, вам необходимо установить несколько дополнительных инструментов разработки (для перекрестной компилирования, упаковки, редакции). Выполнить следующую команду:

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. Установите DATABASE=sqlite env. Переменная для компиляции чирпстака с бэкэнд базы данных SQLite.

Миграции базы данных

Чтобы создать новую миграцию базы данных, выполните:

 make migration-generate NAME=test-migration

Чтобы применить миграции, выполнить:

 make migration-run

Чтобы вернуть миграцию, выполнить:

 make migration-revert

По умолчанию вышеуказанные команды выполнят команды миграции, используя бэкэнд базы данных PostgreSQL. Чтобы выполнить команды миграции для бэкэнда базы данных SQLite, установите DATABASE=sqlite Env. переменная.

Лицензия

Сетевой сервер CHIRPSTACK распределяется по лицензии MIT. Смотрите также лицензию.