LoRa网络包转发器(packet_forwarder)安装与使用教程

LoRa网络包转发器(packet_forwarder)安装与使用教程

packet_forwarder A LoRa packet forwarder is a program running on the host of a LoRa gateway that forwards RF packets receive by the concentrator to a server through a IP/UDP link, and emits RF packets that are sent by the server. 项目地址: https://gitcode.com/gh_mirrors/pa/packet_forwarder

本教程基于GitHub上的LoRa网络包转发器项目，旨在指导用户理解该项目的目录结构、启动文件以及配置文件的使用方法。

1. 项目目录结构及介绍

LoRa网络包转发器项目遵循清晰的结构来组织代码和资源：

packet_forwarder/
│
├── lora_pkt_fwd          # 核心包转发程序源码
│   ├── *.c               # 主要的C语言源文件
│   └── *.h               # 头文件定义
├── util_*                # 辅助程序集合，如util_sink, util_ack, util_tx_test用于测试和辅助操作
│   ├── util_sink         # 接收并显示UDP数据的简单示例程序
│   ├── util_ack          # 响应PUSH_DATA/PULL_DATA的UDP数据包确认
│   └── util_tx_test      # 发送数据包通过网关至服务器的测试工具
├── Makefile              # 编译控制文件
├── README.md             # 项目读我文件，包含概述和快速指南
├── LICENSE               # 许可证文件
├── PROTOCOL.TXT          # 网关与服务器间通信协议描述
├── cfg                   # 配置文件夹，存放各种场景下的global_conf.json配置文件
│   ├── global_conf.json  # 主配置文件，适用于不同板子和应用场景
├── scripts               # 脚本文件夹，包括重置和更新Gateway_ID等实用脚本
│   ├── reset_lgw.sh      # 重置集中器芯片的脚本（特定平台）
│   └── update_gwid.sh    # 自动更新packet forwarder配置中的Gateway_ID的脚本
└── ...                   # 其他可能包含的支持文件和文档

2. 项目的启动文件介绍

启动文件主要是指lora_pkt_fwd目录下的执行程序源代码。核心程序通过编译Makefile生成可执行文件。用户在编译项目后，主要运行的是由lora_pkt_fwd编译得到的二进制文件。这个程序负责监听LoRa接收的射频包，并通过IP/UDP连接将其转发给服务器，同时也能接收服务器发送的数据并转发到指定的LoRa频道上。

如何启动

虽然具体的启动命令依赖于项目编译后的具体命名和环境配置，通常操作流程如下：

make            # 编译整个项目
./lora_pkt_fwd  # 运行包转发器程序（路径依据实际编译输出而定）

3. 项目的配置文件介绍

配置文件主要是cfg/global_conf.json，它是项目运行的关键，包含了一系列动态参数设置，比如RSSI偏移、集中器时钟源、无线电类型、TX增益表、网络类型等。对于不同的部署需求，用户需要编辑此JSON文件以适应特定的硬件配置、网络设置和服务器地址等。

例如，一个基本的global_conf.json结构可能包含以下关键字段：

{
  "gatewayID": "YOUR_GATEWAY_ID",
  "serverAddress": "your.server.address:port",
  "packetForwarderVersion": "版本号",
  "rfChains": [
    {"enable": true, "freq": 868100000},
    ...
  ],
  // 更多配置项...
}

每个配置项都对项目运行有直接影响，确保仔细调整并匹配您的设备和网络要求。在进行重大更改前，建议备份原始配置文件。

总结，正确理解和配置这些要素是成功部署LoRa网络包转发器的基础。务必详细阅读官方文档和提供的示例，确保所有设置符合您的应用环境。

packet_forwarder A LoRa packet forwarder is a program running on the host of a LoRa gateway that forwards RF packets receive by the concentrator to a server through a IP/UDP link, and emits RF packets that are sent by the server. 项目地址: https://gitcode.com/gh_mirrors/pa/packet_forwarder