Krolyxon
Commit 2922e83

Branches

Tags

Refs →

orion-rfREADME.md

130 lines ยท 2.9 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- Experimental
49
50> โš ๏ธ These tools are intended strictly for wireless research, testing, and educational purposes in authorized environments.
51
52---
53
54# โŒจ๏ธ BadUSB
55
56- HID keyboard emulation
57- Execute automated payloads/scripts
58- Useful for testing and automation workflows
59
60---
61
62# ๐Ÿ–ฑ๏ธ BLE Mouse
63
64- ESP32-based Bluetooth mouse emulation
65- Experimental HID functionality
66
67---
68
69# ๐Ÿ”ง System Utilities
70
71### System Info
72- Display device/system information
73- Useful for debugging and diagnostics
74
75### Device Check
76- Verify connected peripherals/modules
77- Hardware diagnostics utility
78
79### Restart
80- Quick device reboot option from UI
81
82---
83
84# ๐Ÿงฉ Project Status
85
86| Feature | Status |
87| -------------------- | ----------------- |
88| BLE Scan | โœ… Working |
89| WiFi Scan | โœ… Working |
90| WiFi Analyzer | โœ… Working |
91| BadUSB | โœ… Working |
92| BLE Mouse | โœ… Working |
93| BLE Jammer | โœ… Working |
94| Bluetooth Jammer | โœ… Working |
95| WiFi Jammer | โš ๏ธ Experimental |
96| RF Capture | ๐Ÿšง WIP |
97| RF Replay | ๐Ÿšง WIP |
98| SD Card Support | ๐Ÿšง Planned |
99| Emulator | ๐Ÿšง Planned |
100| NFC | ๐Ÿšง Planned |
101
102---
103
104# ๐Ÿ› ๏ธ Hardware
105
106- 1 x ESP32-S3
107- 2 x NRF24L01 Modules
108- 2 x CC1101 Modules
109- 1 x OLED Display
110- Battery-powered portable setup
111
112---
113
114# ๐Ÿ“Œ Notes
115
116- Designed primarily for learning, experimentation, and embedded RF research
117- Optimized for portable usage
118- UI-driven navigation system
119
120---
121
122# โš–๏ธ Disclaimer
123
124This project is intended for:
125- Educational purposes
126- RF experimentation
127- Hardware research
128- Authorized security testing
129
130The authors are not responsible for misuse or illegal operation of this project.