How marios2004/rf-mobile-controller works
RF Mobile Controller lets a phone browser control RF testing through an ESP8266 web interface and a laptop Python backend. The backend dispatches serial commands to scanning, HackRF replay and rollback, jammer, and diagnostic workflows; it forwards progress and results back to the phone. Evil Crow control and the local h-RAT proxy are separate paths. The README documents the device topology and capabilities; sampled source confirms backend dispatch and selected controller behavior, but firmware internals and several backend paths were not sampled.
Main entry points: server.py Serial command server · esp8266_controller.ino ESP8266 interface · hackrf_controller.py HackRF control · signal_processor.py Signal processing
Components 13
Mobile interface
- ESP8266 interface
firmware/esp8266_controller/esp8266_controller.ino - Evil Crow web proxy
ecrf_proxy.py
Backend orchestration
- Serial command server
backend/server.py - Backend configuration
backend/config.py
RF operations
- HackRF control
backend/hackrf_controller.py - Rollback sessions
backend/hackrf_controller.py - Evil Crow control
backend/evil_crow_controller.py - Capture files
backend/config.py
Diagnostics
- Signal processing
backend/signal_processor.py - GNU Radio flows
grc
Other components
- Phone browser
- HackRF One
- Evil Crow RF2
Connections 20
- Phone browser → ESP8266 interface: sends commands
README.md - ESP8266 interface → Serial command server: relays serial
README.md - Serial command server → ESP8266 interface: sends results
README.md - ESP8266 interface → Phone browser: shows results
README.md - Serial command server → Backend configuration: uses settings
backend/server.py - Serial command server → HackRF control: dispatches RF commands
backend/server.py - Serial command server → Rollback sessions: creates rollback handler
backend/server.py - Serial command server → Evil Crow control: dispatches ECRF commands
backend/server.py - Serial command server → Signal processing: dispatches diagnostics
backend/server.py - Serial command server → HackRF control: forwards events
backend/server.py - HackRF control → HackRF One: scans and transmits
README.md - Rollback sessions → HackRF One: captures and replays
README.md - Evil Crow control → Evil Crow RF2: controls over HTTP/WS
README.md - HackRF control → Capture files: saves IQ files
backend/hackrf_controller.py - Rollback sessions → Capture files: stores sessions
backend/hackrf_controller.py - Signal processing → Capture files: writes decoded captures
backend/signal_processor.py - Signal processing → HackRF One: monitors RF
README.md - GNU Radio flows → HackRF One: supports RF analysis
README.md - Phone browser → Evil Crow web proxy: opens local panel
ecrf_proxy.py - Evil Crow web proxy → Evil Crow RF2: proxies HTTP/WS
ecrf_proxy.py