/ra/ nRF24LU1+ Sniffer

"Парадный" репозиторий проекта на github: https://github.com/BastilleResearch/mousejack
Содержит доки с полезной инфой, и субмодуль с кодом: https://github.com/BastilleResearch/nrf-research-firmware
О нем-то и пойдет речь ниже.

Итак, что же мы видим интересного на данный момент:
Папки prog, src, tools
Makefile
readme.md - в комментариях не нуждается.

Начнем с последнего:
[b]Makefile[/b]
Он отвечает за компиляцию и создание бинарника [b]dongle.bin[/b] который будет загружен на ваш донгл при прошивке. dongle.bin - это и есть та прога, которая исполняется на nRF24LU1 и отвечает за всю хуйню. Все прочие питон-скрипты (из папки tools) служат лишь для передачи информации по USB и удобного отображения данных.

[b]prog[/b]
Эта папка содержит все, что касается прошивки.
Внутри мы увидим 2 папки:
[u]teensy-flasher[/u] - прошивка через SPI, при помощи Teensy (https://www.pjrc.com/teensy/teensy31.html), ардуино-совместима.
[i]lib[/i] - ничего ценного
[i]python[/i] - spi-flash.py передает на Teensy файл, ждет, пока он загрузится по SPI ну и делает проверку. spi-dump.py читает, что находится в памяти донгла.
[i]src[/i] - тут собственно программа, исполняемая на Teensy. Коммуникация с компом при помощи Serial, с nrf - по стандартной либе SPI. Как видим никаких библиотек производитель не предлагает, все написано через регистры.
[u]usb-flasher[/u]:
[i]logitech-usb-flash.py[/i] - оказывается Logitech Unifying Dongle (пикрил) тоже можно прошить для наших нужд. Похоже он основан на nRF.
[i]logitech-usb-restore.py[/i] - вернет на ваш Logitech Unifying Dongle исходную прошивку.
[i]unifying.py[/i] - вспомогательный класс про все тот же Logitech Unifying, содержит все необходимые команды.
[i]usb-flash.py[/i] - а это скрипт для прошивки схем на nRF24LU1, таких как crazyradio. Им можно воспользоваться, если пришедший с aliexpress донгл содержит дефолтный bootloader, в противном случае придется шить через SPI.

[b]src[/b]
Тут содержится код, из которого компилится dongle.bin. Код, исполняемый прямо на свистке.
[i]main.c[/i] - входная точка
[i]nRF24LU1P.h[/i] - всевозможные регистры и команды для низкоуровневой работы с периферией устройства. Взято из документации.
[i]radio.h, radio.c[/i] - здесь уже более высокоуровневая работа с радио, а так же SPI (когда устройство уже прошито, можно подключать и через SPI вместо USB)
[i]usb.h, usb.c[/i] - вся высокоуровневая работа с USB.
[i]usb_desc.h, usb_desc.c[/i] - тут собраны константы USB-дескриптора (инфа о себе, которую шлют все усб девайсы по запросу хоста).

[b]tools[/b]
Здесь все скрипты, которые взаимодействуют с прошитым устройством.
[u]lib[/u] - папка со сравнительно низкоуровневым кодом. Очень важный файл [i]common.py[/i], там почти вся логика.
[i]nrf24-continuous-tone-test.py[/i] - запускает встроенный в nRF тестовый режим, подача сигнала на заданном канале с постоянным тоном (около 300кГц).
[i]nrf24-network-mapper.py[/i] - я так и не понял, что он делает. Читайте readme.
[i]nrf24-scanner.py[/i] - сканирует каналы в поиске девайсов.
[i]nrf24-sniffer.py[/i] - слушает выбранный девайс, автоматически отслеживая его переключения по каналам.