MAVLink Router 使用与部署指南

1. 目录结构及介绍

MAVLink Router 作为一个重要的中间件应用，其内部结构设计旨在高效转发MAVLink消息。以下是典型项目结构的概述：

mavlink-router/
|-- src                    # 源代码主目录，包含核心功能实现
|   |-- main.cpp           # 主入口文件，程序启动逻辑所在
|   |-- ...                # 其他cpp及h头文件，实现具体功能
|-- examples               # 示例目录，包含配置文件示例以及使用案例
|   |-- config             # 配置文件样本
|   |-- ...                # 更多样例
|-- doc                    # 文档目录，可能包含API文档或者用户手册
|-- scripts                # 辅助脚本，如编译、部署相关脚本
|-- CMakeLists.txt         # CMake构建文件，定义编译规则
|-- README.md              # 项目说明文件，快速了解项目概况
|-- ...

注释: src 目录下的代码负责 MAVLink 消息的接收、路由和发送，而 examples 提供了配置及使用的参考。

2. 启动文件介绍

MAVLink Router 的主要执行入口点位于 src/main.cpp 文件中。该文件不仅初始化应用程序，还设置消息路由的基本逻辑。运行这个项目时，通常通过命令行界面调用 mavlink-routerd 命令，附带一系列参数来指定端口、协议等配置，例如：

mavlink-routerd -e 192.168.7.1:14550 -e 127.0.0.1:14550 -d 0:24550

这里 -e 参数定义了进入（endpoint）连接，表明监听特定的UDP地址和端口。

3. 配置文件介绍

主配置文件 (main.conf)

默认情况下，MAVLink Router 寻找 /etc/mavlink-router/main.conf 作为它的配置文件。配置文件允许更精细地控制路由行为，接口设置等。配置语法简洁，可通过环境变量 MAVLINK_ROUTERD_CONF_FILE 或 -c 命令行开关自定义位置。

配置目录 (config.d)

除了单一的配置文件外，MAVLink Router 支持配置目录 /etc/mavlink-router/config.d，其中包含多个配置文件按字母顺序读取。每个文件可以添加或覆盖之前的配置项，提供了一种灵活的方式来细分和管理复杂的配置需求。目录路径同样可定制，利用 MAVLINK_ROUTERD_CONF_DIR 环境变量或 -d 命令行选项进行设定。

配置文件的内容涉及端点定义、过滤规则、日志级别等，确保了 MAVLink Router 可以适应多种网络架构和应用场景的需求。

---

此指南提供了 MAVLink Router 在基本层面的结构概览、启动机制和配置管理的说明，帮助用户快速上手并根据实际需求调整应用配置。对于深入了解和高级用法，建议查阅官方文档和源码注释。