DeDECTive

⚠️ Юридическое предупреждение

Перехват или декодирование беспроводных сообщений, к которым вы не авторизованы, может нарушать федеральные, государственные и местные законы, включая Закон США об электронной коммуникационной конфиденциальности (18 U.S.C. § 2511) и аналогичные законы в других юрисдикциях. Данное программное обеспечение предназначено для использования исключительно в контролируемых лабораторных/тестовых средах. Автор не несёт ответственности за то, как это программное обеспечение используется. Используя DeDECTive, вы принимаете на себя полную юридическую ответственность за свои действия.

DeDECTive — это сканер и декодер голоса DECT 6.0 для Linux, предназначенный для HackRF One. Он включает GUI на Dear ImGui и терминальный CLI — без необходимости GNU Radio.

GUI

Широкополосный сканер

Захватывает весь диапазон DECT (США или ЕС) за один проход HackRF со скоростью 18.432 Msps с отображением в реальном времени FFT, водопада и обнаружением активности/голоса по каналам.

)

• Отображение FFT и водопада в реальном времени с ползунками настройки диапазона dB
• Обнаружение активности по каналам с гистерезисом для стабильных показаний
• Декодирование DECT-пакетов по каналам с отображением частей RFP/PP, наличия голоса и статуса синхронизации Qt
• Таблица деталей каналов с кнопками Настроить для переключения на узкополосный режим одним нажатием

Узкополосный декодер голоса

Настраивается на один канал DECT для полного декодирования голоса G.721 ADPCM, смешивая аудио RFP и PP в один поток.

)

• Декодирование G.721 ADPCM аудио как RFP (базовой станции), так и PP (телефона)
• Смешивание аудио RFP + PP, чтобы слышать обе стороны разговора одновременно
• Воспроизведение через PulseAudio в реальном времени с регулировкой громкости
• Отслеживание временных слотов (слоты 0–11 нисходящий канал, 12–23 восходящий)
• Заполнение пропусков с использованием шума комфорта G.721 для плавного звука
• Следить за вызовом — автоматическая перенастройка при смене канала; возврат к широкополосному сканированию после 2 секунд тишины

CLI

Следование за голосом (по умолчанию)

Запуск dedective без флагов включает режим следования за голосом. Он сканирует весь диапазон для DECT-вызовов и автоматически настраивается на первый активный голосовой канал.

)

После обнаружения вызова переключается в узкополосный режим и воспроизводит декодированное аудио через PulseAudio. Обе стороны RFP и PP смешаны. По окончании вызова возвращается к сканированию.

)

Управление клавишами: n — следующий голосовой канал · p — предыдущий · q — выход

Широкополосный монитор (-W)

Текстовый широкополосный монитор, отображающий полосы мощности по каналам, количество пакетов, статус голоса и общее количество пакетов.

)

Возможности

• Поддержка диапазонов США и ЕС — выбирается в выпадающем списке GUI или в CLI (флаг -e)
• Следование за вызовом — автоматическое отслеживание переключения каналов в GUI и CLI
• Коррекция DC-всплеска — IIR-фильтр высоких частот удаляет DC-смещение HackRF
• Сглаживание FFT — быстрая атака / медленное затухание для чистого отображения спектра
• Смешивание аудио — декодирование и смешивание RFP + PP в один поток
• Заполнение пропусков — шум комфорта G.721 при пропущенных кадрах предотвращает щелчки аудио
• Настраиваемое усиление — LNA, VGA и усилитель HackRF

Сборка

Зависимости: libhackrf, libpulse-simple, SDL2, imgui, OpenGL

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j

Использование

# GUI (рекомендуется)
./build/dedective_gui

# CLI — следование за голосом (по умолчанию)
./build/dedective

# CLI — диапазон ЕС
./build/dedective -e

# CLI — широкополосный монитор
./build/dedective -W -l

# CLI — фиксированное сканирование канала с декодированием голоса
./build/dedective -c 0 -V -l

Архитектура

Базовый код разделён на переиспользуемую библиотеку ядра и два интерфейса:

• dedective_core — статическая библиотека: интерфейс HackRF, приёмник/декодер пакетов DECT, широкополосный монитор, вывод аудио, кодек G.721
• dedective — CLI с режимами следования за голосом, широкополосного монитора и сканирования каналов
• dedective_gui — интерфейс на Dear ImGui + SDL2 + OpenGL

Справочник

Пайплайн протокола DECT (демодуляция по разности фаз, приём пакетов, декодирование полей A/B, таблицы скремблирования) был портирован и адаптирован из gr-dect2 Павла Язева.