Krolyxon
Commit f34b1e2

Branches

Tags

Refs →

orion-rfREADME.md

128 lines ยท 2.8 KB ยท Markdown

1# ๐Ÿ›ฐ๏ธ Orion RF (WIP)
2
3**Orion RF** is a portable RF & wireless experimentation toolkit built for the ESP32 platform with NRF24 support.
4
5> โš ๏ธ This project is currently under active development. Some features are experimental, incomplete, or may change frequently.
6
7---
8
9# ๐Ÿš€ Current Features
10
11## ๐Ÿ“ก Wireless Tools
12
13### BLE Scan
14- Discover nearby Bluetooth Low Energy devices
15- View MAC address, RSSI, and device information
16- Real-time scanning interface
17
18### WiFi Scan
19- Scan nearby WiFi access points
20- View:
21 - SSID
22 - Signal strength (RSSI)
23 - Channel
24 - Encryption type
25
26### WiFi Analyzer
27- Analyze surrounding WiFi activity
28- Useful for understanding channel congestion and wireless environments
29
30### RF Capture *(WIP)*
31- Experimental RF packet capture functionality
32- Replay support planned
33
34---
35
36# ๐Ÿ“ป NRF24 Tools
37
38### BLE Jammer
39- NRF24-based BLE interference testing
40- Functional
41
42### Bluetooth Jammer
43- NRF24-based Bluetooth interference testing
44- Functional
45
46### WiFi Jammer
47- NRF24-based WiFi interference testing
48- Able to jam 2.4Ghz wifi connections (Not 5G)
49
50---
51
52# โŒจ๏ธ BadUSB
53
54- HID keyboard emulation
55- Execute automated payloads/scripts
56- Useful for testing and automation workflows
57
58---
59
60# ๐Ÿ–ฑ๏ธ BLE Mouse
61
62- ESP32-based Bluetooth mouse emulation
63- Experimental HID functionality
64
65---
66
67# ๐Ÿ”ง System Utilities
68
69### System Info
70- Display device/system information
71- Useful for debugging and diagnostics
72
73### Device Check
74- Verify connected peripherals/modules
75- Hardware diagnostics utility
76
77### Restart
78- Quick device reboot option from UI
79
80---
81
82# ๐Ÿงฉ Project Status
83
84| Feature | Status |
85| -------------------- | ----------------- |
86| BLE Scan | โœ… Working |
87| WiFi Scan | โœ… Working |
88| WiFi Analyzer | โœ… Working |
89| BadUSB | โœ… Working |
90| BLE Mouse | โœ… Working |
91| BLE Jammer | โœ… Working |
92| Bluetooth Jammer | โœ… Working |
93| WiFi Jammer | โš ๏ธ Experimental |
94| RF Capture | ๐Ÿšง WIP |
95| RF Replay | ๐Ÿšง WIP |
96| SD Card Support | ๐Ÿšง Planned |
97| Emulator | ๐Ÿšง Planned |
98| NFC | ๐Ÿšง Planned |
99
100---
101
102# ๐Ÿ› ๏ธ Hardware
103
104- 1 x ESP32-S3
105- 2 x NRF24L01 Modules
106- 2 x CC1101 Modules
107- 1 x OLED Display
108- Battery-powered portable setup
109
110---
111
112# ๐Ÿ“Œ Notes
113
114- Designed primarily for learning, experimentation, and embedded RF research
115- Optimized for portable usage
116- UI-driven navigation system
117
118---
119
120# โš–๏ธ Disclaimer
121
122This project is intended for:
123- Educational purposes
124- RF experimentation
125- Hardware research
126- Authorized security testing
127
128The authors are not responsible for misuse or illegal operation of this project.