🚀 MARSHALL — Ultimate RF Security Toolkit

⚡ "The Air is Ours" ⚡

Master the 2.4GHz Spectrum

📖 Table of Contents

⚡ About Marshall
🎯 Key Features
🛠️ Hardware Requirements
📋 Bill of Materials (BOM)
🔌 Wiring Diagram
💻 Software Setup
📡 How It Works
🌐 Web Interface
🚀 Getting Started
🔧 Troubleshooting
📚 Learning Resources
🛡️ Legal & Ethical Disclaimer
🤝 Contributing
📄 License
👤 Developer
⭐ Support the Project

⚡ About Marshall

"In the world of wireless, silence is the loudest statement."

Marshall isn't just another RF tool — it's a revolutionary open-source RF security testing toolkit that puts the power of the 2.4GHz spectrum in your hands. Built on the ESP32 microcontroller and armed with three NRF24L01+ PA+LNA modules, this beast is designed to expose vulnerabilities and educate the next generation of security researchers.


🎯 Precision	🔥 Power	🧠 Intelligence
Targeted frequency attacks	Triple-module amplification	Smart channel selection

"Security is not a product, but a process." — Bruce Schneier

Marshall represents the evolution of legendary projects like RF-Clown and VOID, combining their strengths into a unified, unstoppable toolkit. Whether you're a cybersecurity student, hardware hacker, or professional penetration tester — Marshall transforms theory into real-world wireless warfare.

🎯 Key Features

Feature	Description	🔥 Power Level
🔴 9 Jamming Modes	WiFi, BLE, Bluetooth Classic, Video TX, RC, Zigbee, USB Wireless, NRF24, All-in-One	💀💀💀💀💀
📡 Triple NRF24 Modules	3 modules working simultaneously for maximum coverage	💀💀💀💀💀
🌐 Cyberpunk Web UI	Glowing neon interface with real-time control	💀💀💀💀
🖥️ OLED Dashboard	Live status, signal strength, mode info	💀💀💀💀
💡 4 Status LEDs	Visual feedback for every operation state	💀💀💀
🎮 Physical Controls	On-device buttons for field operations	💀💀💀
🔌 Standalone Operation	No PC needed after initial setup	💀💀💀💀
📦 Tactical Design	Compact, durable, battery-ready	💀💀💀💀

🛠️ Hardware Requirements

Component	Specification	Quantity	⭐ Priority
Microcontroller	ESP32-WROOM-32 (38-pin)	1	🔴 Essential
RF Modules	NRF24L01+ PA+LNA (w/ external antenna)	3	🔴 Essential
Display	OLED 0.96" I2C (SSD1306, 128x64)	1	🟡 Recommended
Voltage Regulator	AMS1117-3.3 (1A+)	1	🔴 Essential
Capacitors	10µF - 100µF (electrolytic)	3+	🟢 Nice-to-have
Push Buttons	Tactile switch (4-pin)	3	🟡 Recommended
LEDs	Green, Red, Blue, Yellow	4	🟡 Recommended
Resistors	220Ω - 330Ω	4	🟡 Recommended
Power Supply	5V/2A adapter or USB-C	1	🔴 Essential

📋 Bill of Materials (BOM)

Item	Description	Price (USD)	🛒 Where to Buy
ESP32 Dev Board	38-pin ESP32-WROOM-32	$8-15	AliExpress/Amazon
NRF24L01+ PA+LNA	External antenna (x3)	$12-18	AliExpress/Amazon
OLED 0.96" I2C	SSD1306, 128x64	$3-5	AliExpress/Amazon
AMS1117-3.3	Voltage regulator	$1-2	AliExpress/Amazon
Capacitors	10µF, 100µF	$1-2	Local electronics
Push Buttons	Tactile switches (x3)	$1-2	AliExpress/Amazon
LEDs + Resistors	Assorted + 220Ω	$2-3	AliExpress/Amazon
Breadboard	400-point or larger	$3-5	AliExpress/Amazon
Jumper Wires	Various lengths	$5-10	AliExpress/Amazon
Total		~$36-62

🔌 Wiring Diagram

📡 SPI Bus (Shared — Connect to ALL NRF24 Modules)

ESP32 Pin	NRF24 Pin	Description	🔌 Cable Color
GPIO 18	SCK	SPI Clock	🟡 Yellow
GPIO 19	MISO	Master In Slave Out	🟢 Green
GPIO 23	MOSI	Master Out Slave In	🔵 Blue
3.3V	VCC	Power (3.3V)	🔴 Red
GND	GND	Ground	⚫ Black

🎯 Dedicated Pins (CE & CSN — Unique per Module)

Module	CE Pin	CSN Pin	🏷️ Label
NRF1	GPIO 16	GPIO 15	🔴 Module 1
NRF2	GPIO 22	GPIO 21	🔵 Module 2
NRF3	GPIO 4	GPIO 2	🟢 Module 3

🖥️ OLED (I2C)

OLED Pin	ESP32 Pin	🔌 Cable Color
VCC	3.3V	🔴 Red
GND	GND	⚫ Black
SCL	GPIO 22	🟡 Yellow
SDA	GPIO 21	🔵 Blue

💡 LEDs

LED	ESP32 Pin	Resistor	🎨 Color
Green	GPIO 12	220Ω	🟢 Ready
Red	GPIO 13	220Ω	🔴 Active
Blue	GPIO 14	220Ω	🔵 Configured
Yellow	GPIO 27	220Ω	🟡 Warning

🎮 Push Buttons

Button	ESP32 Pin	Action	🎯 Function
Left (L)	GPIO 25	Mode Previous	⬅️ Back
Right (R)	GPIO 26	Mode Next	➡️ Next
Select (S)	GPIO 27	Toggle	🔘 Start/Stop

💻 Software Setup

🔧 1. Install Arduino IDE

Download and install from arduino.cc

🎯 2. Configure ESP32 Board

# Add this URL to Additional Boards Manager URLs:
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

# Then install "esp32 by Espressif Systems" from Boards Manager

📚 3. Install Required Libraries

Library	Author	Purpose	📦 Installation
RF24	TMRh20	NRF24 communication	`arduino-cli lib install RF24`
U8g2	olikraus	OLED display driver	`arduino-cli lib install U8g2`
WiFiManager	tzapu	WiFi management	`arduino-cli lib install WiFiManager`

📡 How It Works

🎯 Jamming Modes

Mode	Target	Channels	💀 Impact
📶 WiFi	2.4GHz WiFi Networks	1, 6, 11	🔥🔥🔥🔥🔥
🔷 BLE	Bluetooth Low Energy	2, 26, 80	🔥🔥🔥🔥
🔷 Bluetooth	Classic Bluetooth	32, 46, 78	🔥🔥🔥🔥
📹 Video TX	Video Transmitters	70, 75, 80	🔥🔥🔥🔥🔥
🎮 RC	RC Controllers	1, 3, 7	🔥🔥🔥🔥
📶 Zigbee	Zigbee/IoT Devices	11, 15, 25	🔥🔥🔥
💻 USB Wireless	USB Peripherals	40, 50, 60	🔥🔥🔥
⚡ NRF24	Generic NRF24	76, 78, 79	🔥🔥🔥🔥
💀 All-in-One	Everything	6, 26, 46	🔥🔥🔥🔥🔥

🎯 Channel Strategy

"Target what matters, when it matters."

WiFi: Channels 1, 6, 11 — the sweet spots
BLE: All 3 advertising channels — no escape
Bluetooth: Strategic spectrum placement

🌐 Web Interface

🎮 Control Dashboard

🚀 Marshall Control Center
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📡 Status: 🟢 ACTIVE
🎯 Mode: WiFi
📶 Signal: ████████░░ 85%
⏱️  Uptime: 00:04:32
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[◄]  [🔄]  [►]  [⏹]

Setting	Value
SSID	`Marshall_Network`
Password	`secure123`
IP	`192.168.4.1`

✨ Web Features

Real-time status updates — Live data streaming
Neon cyberpunk design — Eye-candy interface
Mobile responsive — Control from anywhere
One-click mode switching — Instant changes
Start/Stop control — Total command

🚀 Getting Started

Phase 1: 🛠️ Hardware Assembly

Step 1: Set up the regulator → Connect AMS1117-3.3 to 5V
Step 2: Build the SPI bus → SCK, MOSI, MISO to all modules
Step 3: Add capacitors → 10µF-100µF near each NRF24
Step 4: Connect dedicated pins → CE and CSN for each
Step 5: Add OLED & LEDs → Display and indicators
Step 6: Add buttons → Three tactile switches

Phase 2: 💻 Software Upload

git clone https://github.com/here-is-leo/Marshall.git
cd Marshall
# Open in Arduino IDE
# Select: Tools → Board → ESP32 Dev Module
# Click: Upload 🚀

Phase 3: 🌐 Web Control

1. Power on → Device boots with LED sequence
2. Connect → WiFi: Marshall_Network
3. Open → http://192.168.4.1
4. Control → Start jamming! 🔥

🔧 Troubleshooting

🚨 Issue	💡 Solution
NRF24 not detected	Check capacitors on VCC/GND. Verify 3.3V power. Check CE/CSN pins.
OLED not working	Verify I2C (SDA=21, SCL=22). Try address 0x3D instead of 0x3C.
Web interface not loading	Connect to Marshall_Network. Use 192.168.4.1. Disable firewall.
Board keeps resetting	Use 2A power supply. Add 1000µF capacitor to input.
Upload fails	Hold BOOT, press EN, release BOOT for download mode.

📚 Learning Resources

📖 Official Documentation

🎓 Tutorials

📕 Books

"Wireless Communications & Networks" — William Stallings
"Practical RF Handbook" — Ian Hickman

🛡️ Legal & Ethical Disclaimer

⚠️ WARNING: With Great Power Comes Great Responsibility

IMPORTANT: This project is intended SOLELY for educational purposes and authorized security testing in controlled environments.

✅ Legal uses: Learning, research, security testing with explicit permission
❌ Illegal uses: Unauthorized jamming, disrupting public communications, interfering with emergency services

You are solely responsible for how you use this tool. The developer assumes no liability for any misuse or damages caused by this project.

🤝 Contributing

We welcome contributions! Join the revolution:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/AmazingFeature
3. Commit: git commit -m 'Add some AmazingFeature'
4. Push: git push origin feature/AmazingFeature
5. Open a Pull Request

💡 Contribution Ideas

🔥 New jamming modes
🎨 Improved web interface
🛠️ More hardware support
📹 Video tutorials
🌍 Documentation translations

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

👤 Developer

🧑‍💻 Ilya Farahani (Leo)

⭐ Support the Project

If Marshall helped you, consider giving back:

💻 Made with Passion | ☕ Fueled by Coffee | 🔒 For Security Research

"The best way to predict the future is to create it."

Version 1.0.0 | Last Updated: August 2026

🌍 Connect & Share

📢 Spread the word
🐛 Report issues
💡 Suggest features
🤝 Collaborate

🇮🇷 نسخه فارسی

⚡ "هوا از آنِ ماست" ⚡

تسلط بر طیف ۲.۴ گیگاهرتز

⚡ درباره مارشال

"در دنیای بی‌سیم، سکوت بلندترین پیام است."

مارشال فقط یک ابزار RF دیگر نیست — این یک ابزار تست امنیت RF انقلابی و منبع‌باز است که قدرت طیف ۲.۴ گیگاهرتز را در دستان شما قرار می‌دهد. ساخته شده بر پایه ESP32 و مسلح به سه ماژول NRF24L01+ PA+LNA، این هیولا برای آشکارسازی آسیب‌پذیری‌ها و آموزش نسل بعدی محققان امنیتی طراحی شده است.


🎯 دقت	🔥 قدرت	🧠 هوش
حملات فرکانسی هدفمند	تقویت سه‌ماژوله	انتخاب هوشمند کانال

"امنیت یک محصول نیست، بلکه یک فرآیند است." — بروس شنایر

مارشال تکامل پروژه‌های افسانه‌ای مانند RF-Clown و VOID است که نقاط قوت آنها را در یک ابزار واحد و توقف‌ناپذیر ترکیب کرده است. چه دانشجوی امنیت سایبری باشید، چه هکر سخت‌افزار، چه متخصص تست نفوذ — مارشال تئوری را به جنگ بی‌سیم واقعی تبدیل می‌کند.

🎯 ویژگی‌های کلیدی

ویژگی	توضیح	🔥 سطح قدرت
🔴 ۹ حالت جمینگ	WiFi، BLE، بلوتوث، Video TX، RC، Zigbee، USB Wireless، NRF24، All-in-One	💀💀💀💀💀
📡 سه ماژول NRF24	۳ ماژول همزمان برای حداکثر پوشش	💀💀💀💀💀
🌐 رابط کاربری سایبرپانکی	رابط نئونی با کنترل لحظه‌ای	💀💀💀💀
🖥️ داشبورد OLED	وضعیت زنده، قدرت سیگنال، اطلاعات مود	💀💀💀💀
💡 ۴ LED وضعیت	بازخورد بصری برای هر حالت عملیاتی	💀💀💀
🎮 کنترل فیزیکی	دکمه‌های روی دستگاه برای عملیات میدانی	💀💀💀
🔌 عملکرد مستقل	بعد از راه‌اندازی اولیه نیازی به کامپیوتر نیست	💀💀💀💀
📦 طراحی تاکتیکی	جمع‌وجور، مقاوم، آماده برای باتری	💀💀💀💀

🛠️ نیازمندی‌های سخت‌افزاری

قطعه	مشخصات	تعداد	⭐ اولویت
میکروکنترلر	ESP32-WROOM-32 (۳۸ پین)	۱	🔴 ضروری
ماژول‌های RF	NRF24L01+ PA+LNA (با آنتن خارجی)	۳	🔴 ضروری
نمایشگر	OLED 0.96 اینچی I2C (SSD1306، ۱۲۸×۶۴)	۱	🟡 توصیه‌شده
رگولاتور ولتاژ	AMS1117-3.3 (۱ آمپر+)	۱	🔴 ضروری
خازن‌ها	۱۰µF - ۱۰۰µF (الکترولیتی)	۳+	🟢 اختیاری
دکمه‌ها	تاکت سویچ (۴ پایه)	۳	🟡 توصیه‌شده
LEDها	سبز، قرمز، آبی، زرد	۴	🟡 توصیه‌شده
مقاومت‌ها	۲۲۰Ω - ۳۳۰Ω	۴	🟡 توصیه‌شده
منبع تغذیه	آداپتور ۵ ولت/۲ آمپر یا USB-C	۱	🔴 ضروری

📋 لیست قطعات (BOM)

قطعه	توضیح	قیمت (تومان)	🛒 محل خرید
برد ESP32	۳۸ پین ESP32-WROOM-32	۱۵۰-۳۰۰ هزار	علی‌اکسپرس/دیجی‌کالا
NRF24L01+ PA+LNA	با آنتن خارجی (×۳)	۲۴۰-۴۵۰ هزار	علی‌اکسپرس/دیجی‌کالا
OLED 0.96 اینچی	SSD1306، ۱۲۸×۶۴	۵۰-۱۵۰ هزار	علی‌اکسپرس/دیجی‌کالا
AMS1117-3.3	رگولاتور ولتاژ	۲۰-۵۰ هزار	علی‌اکسپرس/دیجی‌کالا
خازن‌ها	۱۰µF، ۱۰۰µF	۱۰-۳۰ هزار	فروشگاه الکترونیک
دکمه‌ها	تاکت سویچ (×۳)	۲۰-۵۰ هزار	علی‌اکسپرس/دیجی‌کالا
LED + مقاومت	رنگ‌های متنوع + ۲۲۰Ω	۲۰-۵۰ هزار	علی‌اکسپرس/دیجی‌کالا
بردبورد	۴۰۰ نقطه یا بزرگتر	۵۰-۱۰۰ هزار	علی‌اکسپرس/دیجی‌کالا
سیم جامپر	طول‌های مختلف	۵۰-۱۵۰ هزار	علی‌اکسپرس/دیجی‌کالا
جمع کل		~۶۰۰-۱.۲۰۰ هزار

🔌 نقشه اتصال

📡 باس SPI (مشترک — به همه ماژول‌های NRF24 متصل شود)

پین ESP32	پین NRF24	توضیح	🔌 رنگ کابل
GPIO 18	SCK	کلاک SPI	🟡 زرد
GPIO 19	MISO	Master In Slave Out	🟢 سبز
GPIO 23	MOSI	Master Out Slave In	🔵 آبی
۳.۳V	VCC	تغذیه (۳.۳ ولت)	🔴 قرمز
GND	GND	زمین	⚫ مشکی

🎯 پین‌های اختصاصی (CE و CSN — منحصر به هر ماژول)

ماژول	CE	CSN	🏷️ برچسب
NRF1	GPIO 16	GPIO 15	🔴 ماژول ۱
NRF2	GPIO 22	GPIO 21	🔵 ماژول ۲
NRF3	GPIO 4	GPIO 2	🟢 ماژول ۳

🖥️ OLED (I2C)

پین OLED	پین ESP32	🔌 رنگ کابل
VCC	۳.۳V	🔴 قرمز
GND	GND	⚫ مشکی
SCL	GPIO 22	🟡 زرد
SDA	GPIO 21	🔵 آبی

💡 LEDها

LED	پین ESP32	مقاومت	🎨 رنگ
سبز	GPIO 12	۲۲۰Ω	🟢 آماده
قرمز	GPIO 13	۲۲۰Ω	🔴 فعال
آبی	GPIO 14	۲۲۰Ω	🔵 پیکربندی
زرد	GPIO 27	۲۲۰Ω	🟡 هشدار

🎮 دکمه‌ها

دکمه	پین ESP32	عمل	🎯 عملکرد
چپ (L)	GPIO 25	مود قبلی	⬅️ بازگشت
راست (R)	GPIO 26	مود بعدی	➡️ بعدی
انتخاب (S)	GPIO 27	تغییر وضعیت	🔘 شروع/توقف

💻 راه‌اندازی نرم‌افزار

🔧 ۱. نصب Arduino IDE

از arduino.cc دانلود و نصب کنید

🎯 ۲. پیکربندی برد ESP32

# این آدرس را به Additional Boards Manager URLs اضافه کنید:
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

# سپس "esp32 by Espressif Systems" را از Boards Manager نصب کنید

📚 ۳. نصب کتابخانه‌های مورد نیاز

کتابخانه	نویسنده	کاربرد	📦 نصب
RF24	TMRh20	ارتباط با NRF24	`arduino-cli lib install RF24`
U8g2	olikraus	درایور OLED	`arduino-cli lib install U8g2`
WiFiManager	tzapu	مدیریت WiFi	`arduino-cli lib install WiFiManager`

📡 نحوه عملکرد

🎯 حالت‌های جمینگ

حالت	هدف	کانال‌ها	💀 تأثیر
📶 WiFi	شبکه‌های WiFi ۲.۴ گیگاهرتز	۱, ۶, ۱۱	🔥🔥🔥🔥🔥
🔷 BLE	بلوتوث کم‌مصرف	۲, ۲۶, ۸۰	🔥🔥🔥🔥
🔷 بلوتوث	بلوتوث کلاسیک	۳۲, ۴۶, ۷۸	🔥🔥🔥🔥
📹 Video TX	فرستنده‌های ویدئویی	۷۰, ۷۵, ۸۰	🔥🔥🔥🔥🔥
🎮 RC	کنترلرهای RC	۱, ۳, ۷	🔥🔥🔥🔥
📶 Zigbee	دستگاه‌های Zigbee/IoT	۱۱, ۱۵, ۲۵	🔥🔥🔥
💻 USB Wireless	لوازم جانبی USB	۴۰, ۵۰, ۶۰	🔥🔥🔥
⚡ NRF24	NRF24 عمومی	۷۶, ۷۸, ۷۹	🔥🔥🔥🔥
💀 All-in-One	همه چیز	۶, ۲۶, ۴۶	🔥🔥🔥🔥🔥

🌐 وب‌اینترفیس

🎮 داشبورد کنترل

🚀 مرکز کنترل مارشال
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📡 وضعیت: 🟢 فعال
🎯 مود: WiFi
📶 سیگنال: ████████░░ ۸۵%
⏱️  زمان فعالیت: ۰۰:۰۴:۳۲
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[◄]  [🔄]  [►]  [⏹]

تنظیمات	مقدار
SSID	`Marshall_Network`
رمز عبور	`secure123`
IP	`192.168.4.1`

🚀 شروع کار

فاز ۱: 🛠️ مونتاژ سخت‌افزار

مرحله ۱: رگولاتور را تنظیم کنید → AMS1117-3.3 را به ۵ ولت وصل کنید
مرحله ۲: باس SPI را بسازید → SCK، MOSI، MISO به همه ماژول‌ها
مرحله ۳: خازن‌ها را اضافه کنید → ۱۰µF-۱۰۰µF نزدیک هر NRF24
مرحله ۴: پین‌های اختصاصی را وصل کنید → CE و CSN برای هر کدام
مرحله ۵: OLED و LEDها را اضافه کنید → نمایشگر و نشانگرها
مرحله ۶: دکمه‌ها را اضافه کنید → سه تاکت سویچ

فاز ۲: 💻 آپلود نرم‌افزار

git clone https://github.com/here-is-leo/Marshall.git
cd Marshall
# در Arduino IDE باز کنید
# انتخاب: Tools → Board → ESP32 Dev Module
# کلیک: Upload 🚀

فاز ۳: 🌐 کنترل از طریق وب

۱. دستگاه را روشن کنید → بوت با توالی LED
۲. اتصال → WiFi: Marshall_Network
۳. باز کنید → http://192.168.4.1
۴. کنترل کنید → شروع جمینگ! 🔥

🔧 عیب‌یابی

🚨 مشکل	💡 راه‌حل
NRF24 شناسایی نمی‌شود	خازن‌های VCC/GND را بررسی کنید. تغذیه ۳.۳ ولت را چک کنید. پین‌های CE/CSN را بررسی کنید.
OLED کار نمی‌کند	اتصالات I2C را بررسی کنید (SDA=21, SCL=22). آدرس 0x3D را به جای 0x3C امتحان کنید.
وب‌اینترفیس باز نمی‌شود	به Marshall_Network متصل شوید. از 192.168.4.1 استفاده کنید. فایروال را غیرفعال کنید.
برد مدام ریست می‌شود	از منبع تغذیه ۲ آمپر استفاده کنید. خازن ۱۰۰۰µF به ورودی اضافه کنید.
آپلود انجام نمی‌شود	دکمه BOOT را نگه دارید، EN را بزنید، BOOT را رها کنید.

🛡️ سلب مسئولیت قانونی و اخلاقی

⚠️ هشدار: قدرت بزرگ، مسئولیت بزرگ به همراه دارد

مهم: این پروژه صرفاً برای اهداف آموزشی و تست امنیتی مجاز در محیط‌های کنترل‌شده طراحی شده است.

✅ مصارف قانونی: یادگیری، تحقیق، تست امنیتی با اجازه صریح
❌ مصارف غیرقانونی: جمینگ غیرمجاز، اختلال در ارتباطات عمومی، تداخل با خدمات اضطراری

شما شخصاً مسئول نحوه استفاده از این ابزار هستید. توسعه‌دهنده هیچ مسئولیتی در قبال سوءاستفاده یا خسارات ناشی از این پروژه ندارد.

🤝 مشارکت

از مشارکت شما استقبال می‌کنیم! به انقلاب بپیوندید:

۱. مخزن را Fork کنید
۲. شاخه ویژگی ایجاد کنید: git checkout -b feature/AmazingFeature
۳. Commit کنید: git commit -m 'Add some AmazingFeature'
۴. Push کنید: git push origin feature/AmazingFeature
۵. Pull Request باز کنید

💡 ایده‌های مشارکت

🔥 حالت‌های جدید جمینگ
🎨 بهبود وب‌اینترفیس
🛠️ پشتیبانی از سخت‌افزارهای بیشتر
📹 آموزش‌های ویدئویی
🌍 ترجمه مستندات

👤 توسعه‌دهنده

🧑‍💻 ایلیا فراهانی (لئو)

⭐ حمایت از پروژه

اگر مارشال به شما کمک کرد، لطفاً حمایت کنید:

💻 ساخته شده با عشق | ☕ سوخته با قهوه | 🔒 برای تحقیقات امنیتی

"بهترین راه برای پیش‌بینی آینده، ساختن آن است."

نسخه ۱.۰.۰ | آخرین به‌روزرسانی: آگوست ۲۰۲۶

Name		Name	Last commit message	Last commit date
docs		docs
.gitignore		.gitignore
LICENSE		LICENSE
Marshall.html		Marshall.html
Marshall.ino		Marshall.ino
README.md		README.md
config.h		config.h
setting.h		setting.h

Latest commit

History

Folders and files

Repository files navigation

🚀 MARSHALL — Ultimate RF Security Toolkit

⚡ "The Air is Ours" ⚡

Master the 2.4GHz Spectrum

📖 Table of Contents

⚡ About Marshall

🎯 Key Features

🛠️ Hardware Requirements

📋 Bill of Materials (BOM)

🔌 Wiring Diagram

📡 SPI Bus (Shared — Connect to ALL NRF24 Modules)

🎯 Dedicated Pins (CE & CSN — Unique per Module)

🖥️ OLED (I2C)

💡 LEDs

🎮 Push Buttons

💻 Software Setup

🔧 1. Install Arduino IDE

🎯 2. Configure ESP32 Board

📚 3. Install Required Libraries

📡 How It Works

🎯 Jamming Modes

🎯 Channel Strategy

🌐 Web Interface

🎮 Control Dashboard

✨ Web Features

🚀 Getting Started

Phase 1: 🛠️ Hardware Assembly

Phase 2: 💻 Software Upload

Phase 3: 🌐 Web Control

🔧 Troubleshooting

📚 Learning Resources

📖 Official Documentation

🎓 Tutorials

📕 Books

🛡️ Legal & Ethical Disclaimer

🤝 Contributing

💡 Contribution Ideas

📄 License

👤 Developer

🧑‍💻 Ilya Farahani (Leo)

⭐ Support the Project

💻 Made with Passion | ☕ Fueled by Coffee | 🔒 For Security Research

🌍 Connect & Share

🇮🇷 نسخه فارسی

⚡ "هوا از آنِ ماست" ⚡

تسلط بر طیف ۲.۴ گیگاهرتز

⚡ درباره مارشال

🎯 ویژگی‌های کلیدی

🛠️ نیازمندی‌های سخت‌افزاری

📋 لیست قطعات (BOM)

🔌 نقشه اتصال

📡 باس SPI (مشترک — به همه ماژول‌های NRF24 متصل شود)

🎯 پین‌های اختصاصی (CE و CSN — منحصر به هر ماژول)

🖥️ OLED (I2C)

💡 LEDها

🎮 دکمه‌ها

💻 راه‌اندازی نرم‌افزار

🔧 ۱. نصب Arduino IDE

🎯 ۲. پیکربندی برد ESP32

📚 ۳. نصب کتابخانه‌های مورد نیاز

📡 نحوه عملکرد

🎯 حالت‌های جمینگ

🌐 وب‌اینترفیس

🎮 داشبورد کنترل

🚀 شروع کار

فاز ۱: 🛠️ مونتاژ سخت‌افزار

فاز ۲: 💻 آپلود نرم‌افزار

فاز ۳: 🌐 کنترل از طریق وب

🔧 عیب‌یابی

🛡️ سلب مسئولیت قانونی و اخلاقی

🤝 مشارکت

💡 ایده‌های مشارکت

👤 توسعه‌دهنده

🧑‍💻 ایلیا فراهانی (لئو)

⭐ حمایت از پروژه

💻 ساخته شده با عشق | ☕ سوخته با قهوه | 🔒 برای تحقیقات امنیتی

📚 منابع اضافی