DroneSecurity 项目使用教程

1. 项目目录结构及介绍

DroneSecurity/
├── samples/
│   └── 包含预录制的样本文件
├── src/
│   ├── droneid_receiver_offline.py
│   ├── droneid_receiver_live.py
│   └── 其他源代码文件
├── .gitignore
├── LICENSE
├── README.md
└── requirements.txt

目录结构说明

• samples/: 包含预录制的样本文件，用于离线测试和分析。
• src/: 包含项目的核心源代码文件，包括离线接收器 (droneid_receiver_offline.py) 和实时接收器 (droneid_receiver_live.py)。
• .gitignore: Git 忽略文件，指定哪些文件和目录不需要被版本控制。
• LICENSE: 项目使用的开源许可证文件，本项目使用 AGPL-3.0 许可证。
• README.md: 项目的介绍文档，包含项目的基本信息、使用方法和相关链接。
• requirements.txt: 项目依赖的 Python 包列表，用于安装所需的依赖库。

2. 项目启动文件介绍

2.1 离线接收器 (droneid_receiver_offline.py)

离线接收器用于处理预录制的样本文件，进行 Drone-ID 协议的检测和解码。

启动命令

python3 src/droneid_receiver_offline.py -i samples/mini2_sm

参数说明

• -i: 指定输入的样本文件路径。

2.2 实时接收器 (droneid_receiver_live.py)

实时接收器用于通过 SDR (软件定义无线电) 设备实时接收和处理 Drone-ID 信号。

启动命令

python3 src/droneid_receiver_live.py

依赖安装

实时接收器需要安装 UHD 驱动和相关依赖库：

sudo apt install libuhd-dev uhd-host python3-uhd
pip3 install -r requirements.txt

3. 项目配置文件介绍

3.1 requirements.txt

requirements.txt 文件列出了项目运行所需的 Python 依赖包。使用以下命令安装这些依赖：

pip3 install -r requirements.txt

3.2 .gitignore

.gitignore 文件用于指定哪些文件和目录不需要被 Git 版本控制。通常包含虚拟环境目录、编译输出文件等。

3.3 LICENSE

LICENSE 文件包含了项目的开源许可证信息，本项目使用 AGPL-3.0 许可证。

3.4 README.md

README.md 文件是项目的介绍文档，包含了项目的基本信息、使用方法、依赖安装步骤以及相关链接。建议在开始使用项目前仔细阅读此文件。

---

通过以上步骤，您可以顺利启动和配置 DroneSecurity 项目，进行 Drone-ID 协议的接收和分析。