DroneSecurity 项目安装和配置指南

1. 项目基础介绍和主要的编程语言

项目基础介绍

DroneSecurity 是一个用于接收和解析 DJI 无人机 Drone-ID 协议的项目。该项目允许用户通过软件定义无线电（SDR）实时接收 Drone-ID 信号，或者在离线模式下处理预先录制的捕获数据。该项目的主要目的是帮助研究人员和开发者理解和分析 DJI 无人机的 Drone-ID 协议，从而评估其安全性和隐私影响。

主要的编程语言

该项目主要使用 Python 编程语言进行开发。Python 是一种广泛使用的高级编程语言，以其简洁易读的语法和丰富的库支持而闻名。

2. 项目使用的关键技术和框架

关键技术

• 软件定义无线电（SDR）: 用于实时接收 Drone-ID 信号。
• OFDM（正交频分复用）: 用于信号的解调和解码。
• Zadoff-Chu 序列: 用于信号的同步和检测。
• CRC（循环冗余校验）: 用于数据完整性检查。

框架

• UHD（通用硬件驱动）: 用于与 SDR 设备通信。
• Inspectrum: 用于可视化原始样本文件。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保您的系统满足以下要求：

• 操作系统：Linux（推荐 Ubuntu 20.04 或更高版本）
• Python 3.6 或更高版本
• 软件定义无线电（SDR）设备（如 Ettus USRP B205-mini）
• Git（用于克隆项目仓库）

安装步骤

步骤 1：克隆项目仓库

首先，使用 Git 克隆 DroneSecurity 项目到您的本地机器：

git clone https://github.com/RUB-SysSec/DroneSecurity.git
cd DroneSecurity

步骤 2：创建虚拟环境

为了隔离项目的依赖环境，建议创建一个 Python 虚拟环境：

python3 -m venv venv
source venv/bin/activate

步骤 3：安装依赖项

在虚拟环境中安装项目所需的 Python 依赖项：

pip3 install -r requirements.txt

步骤 4：安装 UHD 驱动

如果您计划使用 SDR 设备进行实时接收，您需要安装 UHD 驱动：

sudo apt install libuhd-dev uhd-host python3-uhd

步骤 5：运行离线解码器

如果您有预先录制的样本文件，可以使用离线解码器进行处理：

./src/droneid_receiver_offline.py -i samples/mini2_sm

步骤 6：运行实时接收器（可选）

如果您有 SDR 设备并希望进行实时接收，可以运行实时接收器：

./src/droneid_receiver_live.py

注意事项

• 实时接收器需要强大的计算资源，建议在高性能机器上运行。
• 如果遇到 CRC 错误，可能是由于信号质量不佳或设备问题，建议检查设备连接和环境。

通过以上步骤，您应该能够成功安装和配置 DroneSecurity 项目，并开始进行 Drone-ID 信号的接收和分析。