ChirpStack 开源项目安装与使用指南

ChirpStack 开源项目安装与使用指南

chirpstackChirpStack open-source LoRaWAN Network Server项目地址:https://gitcode.com/gh_mirrors/ch/chirpstack

1. 项目目录结构及介绍

ChirpStack 是一个开源的 LoRaWAN™ 网络服务器解决方案，其仓库位于 GitHub。下面是对核心目录结构的简要概述：

• cmd: 包含各个服务的主入口点，如 chirpstack-network-server, chirpstack-application-server, 和 chirpstack-gateway-bridge。

• configuration: 提供默认的配置文件模板，对于初次部署非常有用，它帮助用户快速理解如何设置各个组件。

• docs: 文档区域，包括API文档、用户手册等，但请注意本指南将提供关键部分的直接说明。

• internal: 包含核心业务逻辑，分为不同子包处理网络管理、数据处理等，对开发者而言这部分较为深入。

• pkg: 复用的工具包和库，如数据库抽象层、加密服务等。

• test: 单元测试和集成测试代码，确保项目质量。

• version: 存储版本信息，有助于跟踪部署的具体版本。

2. 项目的启动文件介绍

在 cmd 目录下，主要关注以下几个可执行文件作为项目启动的关键入口：

• chirpstack-gateway-bridge: 这个是网关桥接服务，负责接收来自LoRa网关的数据并转发到网络服务器，以及反之亦然。

• chirpstack-network-server: 核心网络服务器，处理节点注册、数据包路由、接入控制等LoRaWAN网络的核心功能。

• chirpstack-application-server: 应用服务器，对接网络服务器，处理应用层消息，如设备命令、数据解析等。

• chirpstack-api: 虽不是直接启动项，但它提供的gRPC和HTTP API定义了与这些服务交互的标准方式。

启动时，通常通过指定配置文件路径等方式调用上述程序，例如：

./chirpstack-network-server -c path/to/config.toml

3. 项目的配置文件介绍

配置文件通常遵循 TOML 格式，位于项目根目录或由命令行参数指定。以 chirpstack-network-server 的配置为例，config.toml.example 提供了一个基础示例：

• [global]: 包含通用设置，如日志级别、绑定地址等。

• [database]: 定义数据库连接信息，支持 PostgreSQL 或 BoltDB。

• [network_server]:

  • service_profile 和 device_profile 指向数据存储的位置。
  • gateway 部分配置网关的监听端口和协议。

• [integration.mqtt]: 若启用MQTT集成，这里配置MQTT broker的连接详情。

• [[api]]: 设置API访问的相关端口和认证模式，允许外部系统通过API接口与之交互。

每项配置都有详细的注释来解释其用途，因此强烈建议在实际部署前仔细阅读并调整这些配置以满足特定需求。

---

此指南提供了关于ChirpStack项目的基本框架和重要配置的概览，具体实施时还需参考项目官网和最新文档，以获取最详尽的信息和最佳实践。

chirpstackChirpStack open-source LoRaWAN Network Server项目地址:https://gitcode.com/gh_mirrors/ch/chirpstack