How rub-syssec/dronesecurity works
Project Type and Purpose
• This is a Python-based proof-of-concept receiver for DJI’s proprietary Drone-ID protocol. It can operate in two modes:
• Offline mode: reads raw I/Q sample files from disk
• Live mode: captures I/Q samples in real time from an SDR (e.g., Ettus USRP B205-mini via UHD)
• The goal is to reverse-engineer, detect, decode, and display Drone-ID frames, optionally in a GUI for debugging.
File-Structure Analysis
Top-level:
src/ directory:
• droneid_receiver_offline.py – CLI entry point for offline decoding
• droneid_receiver_live.py – CLI entry point for live decoding via UHD
• SpectrumCapture.py – captures or loads raw samples and performs packet detection
• Packet.py – per-frame processing: CFO estimation, timing, ZC sequence detection
• zcsequence.py – Zadoff–Chu sequence correlation routines
• qpsk.py – QPSK demodulation logic (brute-force orientation, soft bits)
• packetizer.py / droneid_packet.py – descrambling, turbo-decode, unpack bitstream into fields
• .py / helpers.py / goldgen.py – coordinate transformations, plotting, helper utilities
README Insights
• Describes the staged pipeline: capture → detection → synchronization → OFDM demod → decoding → CRC check → statistics & plotting.
• Lists external dependencies: Python3, numpy, scipy, matplotlib, UHD driver, inspectrum for offline visualization.