SNS3-Satellite 项目安装与使用指南

1. 项目目录结构及介绍

SNS3-Satellite 项目是基于 NS-3 网络模拟器的卫星网络扩展模块。以下是项目的目录结构及其主要文件的介绍：

sns3-satellite/
├── data/
│   └── ...  # 包含模拟场景的数据文件
├── doc/
│   └── ...  # 包含项目的文档文件
├── examples/
│   └── ...  # 包含示例模拟场景的代码
├── ext-utils/
│   └── ...  # 包含外部工具和实用程序
├── helper/
│   └── ...  # 包含辅助类和函数
├── model/
│   └── ...  # 包含卫星网络模型的实现
├── stats/
│   └── ...  # 包含统计相关的代码
├── test/
│   └── ...  # 包含单元测试代码
├── utils/
│   └── ...  # 包含通用工具和实用程序
├── .gitignore
├── .gitlab-ci.yml
├── .gitmodules
├── .hgignore
├── CMakeLists.txt
├── LICENSE
├── README.md
└── wscript

主要目录介绍：

• data/：包含模拟场景的数据文件。
• doc/：包含项目的文档文件。
• examples/：包含示例模拟场景的代码。
• ext-utils/：包含外部工具和实用程序。
• helper/：包含辅助类和函数。
• model/：包含卫星网络模型的实现。
• stats/：包含统计相关的代码。
• test/：包含单元测试代码。
• utils/：包含通用工具和实用程序。

2. 项目的启动文件介绍

SNS3-Satellite 项目的启动文件通常是 examples/ 目录下的示例代码文件。以下是一些主要的启动文件及其功能介绍：

• sat-cbr-example.cc：简单的 CBR（恒定比特率）流量示例。
• sat-regeneration-example.cc：测试卫星上不同再生模式的示例。
• sat-constellation-example.cc：包含 LEO 和 GEO 卫星星座的示例，使用 ISL（星间链路）进行路由。
• sat-vhts-example.cc：创建 VHTS（高吞吐量和高链路容量）场景的示例。
• sat-iot-example.cc：创建 IoT（物联网）场景的示例。
• sat-logon-example.cc：使用 logon 功能将 UT（用户终端）登录到 NCC 的示例。
• sat-ncr-example.cc：使用 NCR（网络时钟同步）在 UT 和 GW（网关）之间进行同步的示例。
• sat-lora-example.cc：创建 LoRa 配置场景的示例。

3. 项目的配置文件介绍

SNS3-Satellite 项目的配置文件主要包括 CMakeLists.txt 和 wscript 文件。以下是这些配置文件的介绍：

CMakeLists.txt

CMakeLists.txt 是用于配置和构建项目的 CMake 配置文件。它定义了项目的依赖关系、编译选项和构建目标。以下是一些关键配置项：

# 设置项目名称和版本
project(sns3-satellite VERSION 1.0)

# 添加子目录
add_subdirectory(data)
add_subdirectory(doc)
add_subdirectory(examples)
add_subdirectory(ext-utils)
add_subdirectory(helper)
add_subdirectory(model)
add_subdirectory(stats)
add_subdirectory(test)
add_subdirectory(utils)

# 设置编译选项
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 添加可执行文件
add_executable(sat-cbr-example examples/sat-cbr-example.cc)
target_link_libraries(sat-cbr-example ns3::core ns3::network)

wscript

wscript 是用于配置和构建项目的 Waf 配置文件。它定义了项目的编译选项和构建目标。以下是一些关键配置项：

# 定义项目名称和版本
def options(opt):
    opt.load('compiler_cxx')
    opt.load('ns3')

def configure(conf):
    conf.load('compiler_cxx')
    conf.load('ns3')

def build(bld):
    obj = bld.create_ns3_program('sat-cbr-example', ['core', 'network'])
    obj.source = 'examples/sat-cbr-example.cc'

通过以上配置文件，可以自定义项目的编译选项和构建目标，以满足不同的需求。