ESP32-BlueJammer

BlueFlasher software not supported anymore! Flash via webflasher or binary files!

LICENSE

@@ -0,0 +1,188 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may not reproduce, modify, or distribute copies 
+      of the Work or Derivative Works thereof in any medium, with or without 
+      modifications. However, you may use the Work in its unmodified form for  
+      personal or internal purposes, but not for commercial purposes, provided 
+      that you meet the following conditions:
+    
+  (a) You must give proper credit to the original author(s) by including 
+      appropriate attribution notices when using or publicly displaying the 
+      Work or any portions thereof, including any uses or displays of the Work 
+      in its entirety or as part of a larger project.
+    
+  (b) You may not claim ownership of the Work or any portion of it. The Work 
+      must remain unchanged, and you may not alter or modify the Work in any way.
+    
+  (c) You must retain, in the Source form of any copies or distributions, all 
+      copyright, patent, trademark, and attribution notices from the original Work. 
+      These notices should remain visible and unaltered in any distribution or use 
+      of the Work.
+    
+  (d) If the Work includes a "NOTICE" text file as part of its distribution, you 
+      must include a readable copy of the attribution notices contained within such 
+      NOTICE file when using or publicly displaying the Work, excluding those notices 
+      that do not pertain to any part of the Work, in at least one of the following 
+      places: within a NOTICE text file distributed alongside the Work, within the 
+      Source form or documentation, or within a display generated by the Work.
+    
+      You may not sublicense, distribute, or make available any modified version of 
+      the Work. All distributions must be in the original, unmodified form, and 
+      must include all relevant attribution and copyright notices as stated.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

README.md

@@ -1,67 +1,253 @@
 <h1 align="center">ESP32-BlueJammer - by @emensta</h1>
 <div align="center">
   <img src="https://dwdwpld.pages.dev/ESP32-BlueJammerBy@emensta.jpg" alt="ESP32-BlueJammer">
+  <h3 align="center">Jamming is ILLEGAL! Educational purposes only!</h3>
+</div>
+
+<div align="center">
+<a href="https://github.com/EmenstaNougat/ESP32-BlueJammer" title="Go to GitHub repo">
+  <img src="https://img.shields.io/static/v1?label=EmenstaNougat&message=ESP32-BlueJammer&color=purple&logo=github" alt="EmenstaNougat - ESP32-BlueJammer">
+</a>
+<a href="https://github.com/EmenstaNougat/ESP32-BlueJammer">
+  <img src="https://img.shields.io/github/stars/EmenstaNougat/ESP32-BlueJammer?style=social" alt="stars - ESP32-BlueJammer">
+</a>
+<a href="https://github.com/EmenstaNougat/ESP32-BlueJammer">
+  <img src="https://img.shields.io/github/forks/EmenstaNougat/ESP32-BlueJammer?style=social" alt="forks - ESP32-BlueJammer">
+</a>
 </div>
 
 
+<h4 align="center">
+  <a href="https://github.com/EmenstaNougat/ESP32-BlueJammer#hardware---make-your-own-esp32-bluejammer">Make your own</a>
+    <span> | </span>
+  <a href="https://github.com/EmenstaNougat/ESP32-BlueJammer#esp32-nrf24l01-pinout--battery-mod">Schematics</a>
+    <span> | </span>
+  <a href="https://github.com/EmenstaNougat/ESP32-BlueJammer?tab=readme-ov-file#pcb">Hardware layout</a>
+    <span> | </span>
+  <a href="https://github.com/EmenstaNougat/ESP32-BlueJammer?tab=readme-ov-file#pcbs-with-esp32-and-rf-module-capability">PCB's</a>
+    <span> | </span>
+  <a href="https://github.com/EmenstaNougat/ESP32-BlueJammer#video-tutorials-and-demonstrations">Demos</a>
+    <span> | </span>
+  <a href="https://github.com/EmenstaNougat/ESP32-BlueJammer#operation-channels">Channels</a>
+    <span> | </span>
+  <a href="https://github.com/EmenstaNougat/ESP32-BlueJammer?tab=readme-ov-file#flashing-the-firmware">Flashing</a>
+    <span> | </span>
+  <a href="https://github.com/EmenstaNougat/ESP32-BlueJammer#3d-printed-case">3D case</a>
+    <span> | </span>
+  <a href="https://github.com/EmenstaNougat/ESP32-BlueJammer?tab=readme-ov-file#about-the-esp32-bluejammer-and-my-source-code">About</a>
+    <span> | </span>
+  <a href="https://github.com/EmenstaNougat/ESP32-BlueJammer?tab=readme-ov-file#support-me">Support me</a>
+    <span> | </span>
+  <a href="https://emensta.pages.dev">Website</a>
+</h4>
+
 
 ## ESP32-BlueJammer
-The ESP32-BlueJammer disrupts various devices using an ESP32 NodeMCU and nRF modules, causing plenty of noise and sending unnecessary packets (DoS).              
+The ESP32-BlueJammer (Bluetooth jammer, BLE jammer, WiFi jammer, RC jammer) disrupts various devices using an ESP32 and nRF24 modules, causing plenty of noise and sending unnecessary packets (DoS).              
                                                                     
-It interrupts:                                                       
+It interrupts:  
-audio in speakers, smartphone connections, WiFi, RC Drones (etc.), IoT devices, and much more communicating on 2.4GHz!
+**The whole 2.4GHz broadband!** Everything that works on 2.4GHz is being interfered, like:                                                       
+audio in speakers being transmitted over bluetooth, microphones on 2.4GHz, smartphone connections, WiFi, RC Drones (etc.), IoT devices, smart gadgets, wireless keyboard & mouse, just anything on 2.4GHz!
 
-Ideal for controlled disruption and security testing. Based on 2,4GHz communication.
+Ideal for controlled disruption and security testing. Based on 2.4GHz communication.
 
-It has a big range (over 30Meters - may vary on your antenna and hardware setup!) on newest Bluetooth versions with casual 2.4GHz antennas, you can easily increase this aswell by taking some simple "bigger" router antennas.
+It has a big range (over 30Meters+ - may vary on your antenna and hardware setup!) on newest Bluetooth versions with casual 2.4GHz antennas, you can easily increase this as well by taking some simple "bigger" router antennas.
-An amplifier (2.4GHz) may be an good option too!
+An amplifier (2.4GHz) may be a good option too!
+
+Remember that jamming is illegal and should not be used with malicious intent!
 
 
 
+## PCB's with ESP32 and RF-module capability
+**ESP32-RF DIY-PCB:**
+This PCB can fit an ESP32-wroom-32U/E DevKitC and 2 nRF-modules, along with an 0.96" I2C OLED, LEDs and switches.  
+***Remember: It is not intended for illegal use!***  
+For this one, all you need is listed below:  
 
-## TikTok video with a complete tutorial
+**Required:**  
-[Full TikTok DIY tutorial](https://www.tiktok.com/@emensta/video/7389783018002550049)
+- **[ESP32 Dev Module](https://s.click.aliexpress.com/e/_onYIVKr)** (**Recommended: ESP32-32U CP2102**, any ESP32 should work as long as it has the needed pins, 38P required!)  
+- **[nRF24L01+PA+LNA](https://s.click.aliexpress.com/e/_oma5UQx)** (2x)  
+- **[10-100uF Capacitor](https://s.click.aliexpress.com/e/_oFvFeYX)** (2x) (any voltage above 5V)  
+- **[0.96" OLED Display I2C](https://s.click.aliexpress.com/e/_oCdkjPX)**
+- **[Slide Switch](https://s.click.aliexpress.com/e/_c4eQKm5D)** (2x)
+- **[LEDs: 3mm LED box](https://s.click.aliexpress.com/e/_c4dAH9sF)**  
+- **[Resistor kit](https://s.click.aliexpress.com/e/_oCoJ7LO)**  
+- R1 = 1kOhm  
+- R2, R3, R5, R7 = 47kOhm  
+- R4, R6 = 100kOhm  
+
+**Additional:**  
+- **[TP4056 Charging Module (Micro-USB/Type-C)](https://s.click.aliexpress.com/e/_oCqORHE)**  
+- **[JST PH 2.0 Connector](https://s.click.aliexpress.com/e/_ooSOhDd)**  
+- **[3.7V Li-Ion Battery](https://s.click.aliexpress.com/e/_on04mQ7)**  
+- **[3rd Antenna: **IPEX to SMA-F pigtail](https://s.click.aliexpress.com/e/_oFDpn1V)**  
+![image](https://github.com/user-attachments/assets/601b72e8-587a-43e0-8d2a-c99cbdce4a21)  
+[Shop](https://www.elecrow.com/esp32-rf-diy-pcb.html)
+
+---
+
+**PRE-SOLDERED:**  "The Blue ESP"  
+This is an ESP32 with RF-module breakouts (nRF24/CC1101 etc.) for experimenting.  
+***Remember: It is not intended for illegal use, neither for my project!***  
+
+**Required:**  
+- **[nRF24L01+PA+LNA](https://s.click.aliexpress.com/e/_oma5UQx)** (2x)  
+Why do you need to get the nRF24's? -> the pinout can be used to connect either nRF24 or CC1101 modules for further experiments with an ESP32 chip.
+![TheBlueESP](https://dwdwpld.pages.dev/theblueespwavychat.png)
+[Shop](https://datechlabs.com/products/the-blue-esp-pre-order)
 
 
 
-## operation channels
+## Video tutorials and demonstrations
-- Bluetooth = 80CH
+[Full DIY assembling video tutorial](https://www.tiktok.com/@emensta/video/7389783018002550049)
-- BLE = 40CH
+
-- WiFi = 14CH
+[Full DIY assembling video tutorial (if the TikTok is not available for you)](https://www.mediafire.com/file/mgb3wicdifkq1ce/ESP32-BlueJammerByEmensta-DIYTutorial.mp4/file)
-- RC drones, etc. = 1-125CH
+
+---
+
+[Demonstration](https://vm.tiktok.com/ZGec5Mqg7/)
+
+[Demonstration (if the TikTok is not available for you)](https://www.mediafire.com/file/xgru01ihbw26mfu/ESP32-BlueJammerByEmensta-Demonstration.mp4/file)
+
+---
+
+[Flashing process](https://www.tiktok.com/@emensta/video/7413509704401292577)
+
+[Flashing process (if the TikTok is not available for you)](https://www.mediafire.com/file/2aj4hmf9zt7w6sw/ESP32-BlueJammerByEmensta-FlashingProcess.mp4/file)
+
+---
+
+ESP32-BlueJammer tutorial by @ElMackflay  
+[![ESP32-BlueJammer tutorial by @ElMackflay](https://img.youtube.com/vi/1kjkWU25_qo/0.jpg)](https://www.youtube.com/watch?v=1kjkWU25_qo)  
+---
+
+
+## Operation Channels
+- **Bluetooth** = 79CH  
+  Frequency Range: 2.402 GHz to 2.480 GHz  
+  Channel Width: 1 MHz
+
+- **BLE** = 40CH  
+  Frequency Range: 2.400 GHz to 2.4835 GHz  
+  Channel Width: 2 MHz
+
+- **WiFi** = 14CH  
+  Frequency Range: 2.400 GHz to 2.4835 GHz  
+  Channel Width: Typically 20 MHz, but can be 22 MHz or 40 MHz in some cases
+
+- **RC drones, etc.** = 1-125CH  
+  Frequency Range: 2.400 GHz to 2.525 GHz  
+  Channel Width: 1 MHz
 
 
 
-## hardware
+## How to use?
-- ESP32 Dev Module (such as ESP32-WROOM-32U)
+To disrupt various channels on the 2.4GHz band, do the following to enable your ESP32-BlueJammer:
-- nRF24L01+PA+LNA (2x)
+- Every mode starts right away after powering on the device! There is no additional button to start the attack!  
-- 10UF capacitor (2x) any voltage above 5V
+- It simply jams right away once powered!
 
-If you're looking to add a battery:
+### Combo-Channel-Select_BT-BLE-WiFi-RC firmware:
-- 3.7V Li-Ion battery
+- use the "Boot" button on the ESP32 to switch between the channel modes on the Combo-Firmware!
-- JST PH 2,0 connector
+- the OLED will display your current operation channel
-- TP4056 Charging Module
+- the status LED lets you know about the current state you're in:  
-- 3mm LED (blue)
+1 blink = BT  
-- 470k Ohm resistor
+2 blinks = BLE  
-- mini slide switch
+3 blinks = WiFi  
+4 blinks = RC  
+- the serial output of your ESP32-BlueJammer will output the following lines when switching mode:  
+State 1: Bluetooth  
+State 2: Bluetooth Low Energy  
+State 3: WiFi  
+State 4: RC  
 
-To screw the 3D printed case together you must have:
+### all other firmware:
-- M3X16 screws (2x)
+- the firmware you choose indicates the operation channel by its name, this means:
-- M3 Nuts (2x)
+
-### THE 3D printed case fits ONLY a PCB size of 7cm x 5.5cm and you'll need to drill out 2 holes according for the M3 screws to fit through the PCB!
+Bluetooth_80_CH - jams classic Bluetooth  
+Frequency Range: 2.402 GHz to 2.480 GHz  
+
+BluetoothLowEnergy_40_CH - jams Bluetooth Low Energy  
+Frequency Range: 2.400 GHz to 2.4835 GHz  
+
+Bluetooth-BluetoothLowEnergy_40-80_CH - jams classic Bluetooth & Bluetooth Low Energy  
+Frequency Range: 2.402 GHz to 2.480 GHz & 2.400 GHz to 2.4835 GHz  
+
+Bluetooth-WiFi_14-80_CH - jams classic Bluetooth & WiFi  
+Frequency Range: 2.402 GHz to 2.480 GHz & 2.400 GHz to 2.4835 GHz  
+
+WiFi_14_CH - jams WiFi  
+Frequency Range: 2.400 GHz to 2.4835 GHz  
+
+2.4GHzRemoteControl(Drones etc.)_1-125_CH - jams RC (Drones etc.)  
+  Frequency Range: 2.400 GHz to 2.525 GHz  
 
 
-## flashing ESP32 via webflasher
+
+## Hardware - Make your own ESP32-BlueJammer
+(Aliexpress affiliate links to support me-linked to the item names)
+### Required:
+
+- **[ESP32 Dev Module](https://s.click.aliexpress.com/e/_onYIVKr)** (**Recommended: ESP32-32U CP2102**, any ESP32 should work as long as it has the needed pins)
+- **[nRF24L01+PA+LNA](https://s.click.aliexpress.com/e/_oma5UQx)** (2x)
+- **[10-100uF Capacitor](https://s.click.aliexpress.com/e/_oFvFeYX)** (2x) (any voltage above 5V)
+- **[Prototype PCB](https://s.click.aliexpress.com/e/_oBtd18j)** (at least 7x9 cm, but you will need to cut it down to fit the 3D-printed case, which fits a size of 7x5,5cm!)
+
+### Additional:
+
+- **[0.96" OLED Display I2C](https://s.click.aliexpress.com/e/_oCdkjPX)**
+- [3rd Antenna: **IPEX to SMA-F pigtail**](https://s.click.aliexpress.com/e/_oFDpn1V)
+- [Status LED: **3mm LED**](https://s.click.aliexpress.com/e/_ooxufHV)
+- **[4.7k Ohm Resistor](https://s.click.aliexpress.com/e/_oBV1Q1Z)**
+
+### If you're looking to add a battery:
+
+- **[3.7V Li-Ion Battery](https://s.click.aliexpress.com/e/_on04mQ7)**
+- **[JST PH 2.0 Connector](https://s.click.aliexpress.com/e/_ooSOhDd)**
+- **[TP4056 Charging Module (Micro-USB/Type-C)](https://s.click.aliexpress.com/e/_oCqORHE)**
+- **[Mini Slide Switch](https://s.click.aliexpress.com/e/_ooC8DXh)**
+
+### To screw the 3D printed case together you must have:
+
+- **M3x16 Screws** (2x)  
+- **M3 Nuts** (2x)  
+Get this M3 kit instead:
+- **[M3 screws&nuts kit](https://s.click.aliexpress.com/e/_oC24YXH)**
+
+
+
+## Antennas
+A frequently asked question is whether the antennas are needed and what the third antenna is for, here is the answer:
+Yes, you need at least both antennas for the nRF24's! Why? To have it working on a decent range!
+The average range with standard known chinese 2.4GHz antennas is about 20-30meters. Upgrading those antennas will help a lot with getting more range!
+
+2 antennas are for the HSPI and VSPI nRF24 modules!
+
+The 3rd antenna is plugged to the ESP32 chip itself, whether via IPEX or soldered onto its own antenna, if your ESP32 does not provide any option to add that one, it obviously won't be possible!
+What is the 3rd antenna used for? The third antenna connected to the ESP32 chip itself helps with reliable long-range interference. It ensures a better intermediate signal and stability when jamming!
+(The third antenna is your own decision and therefore optional!)
+
+
+
+## Flashing the firmware
+### via webflasher (Easy)  
 ![ESP32-BlueJammerFlasher](https://dwdwpld.pages.dev/ESP32BlueJammerFlasher.png)                                                                 
-I've created a webflasher to make it super easy for you to flash your ESP32 chip with the ESP32-BlueJammer firmware of your choice!
+I've created a webflasher to make it super easy for you to flash your ESP32 chip with the ESP32-BlueJammer firmware of your choice!  
 - Visit [ESP32-BlueJammerFlasher](https://esp32-bluejammerflasher.pages.dev)
+- First, choose the firmware type, "Generic" or "0.96" OLED"
+- choose the firmware you want to flash
 - Connect your ESP32 via a data USB cable
-- Choose your firmware, chip and connect
 - Flash the firmware of your choice :D
 
+### Flashing ESP32 via binary files (Advanced)  
+- Download the **.bin files** available on this repository
+- Use any flasher of your choice
+- Flash it :D
+
+If your ESP32 is not showing up in the device list or won't get recognized you will need to have [THESE DRIVERS INSTALLED](https://www.silabs.com/documents/public/software/CP210x_Windows_Drivers.zip) which can be found on my [Discord server](https://discord.gg/yNGhKxzqUE) too!
 
 
-## ESP32-nRF24L01+ pinout
+
+## ESP32-nRF24L01+ pinout + battery mod
 Here are both pinouts for HSPI and VSPI. You need both nRF24L01 modules connected in order to achieve full capability of the device.                
 [nRF24L01+ pinout](https://dwdwpld.pages.dev/nRF24L01pinout.png)
 ### HSPI
@@ -74,7 +260,7 @@ Here are both pinouts for HSPI and VSPI. You need both nRF24L01 modules connecte
 | SCK           | GPIO 14          |
 | MOSI          | GPIO 13          |
 | MISO          | GPIO 12          |
-| IRQ           |     |
+| IRQ           |                  |
 
 ### VSPI 
 | 2nd nRF24L01 module Pin | VSPI Pin (ESP32) | 10uf capacitor |
@@ -86,22 +272,45 @@ Here are both pinouts for HSPI and VSPI. You need both nRF24L01 modules connecte
 | SCK           | GPIO 18          |
 | MOSI          | GPIO 23          |
 | MISO          | GPIO 19          |
-| IRQ           |     |
+| IRQ           |                  |
+
+### Status LED
+| ESP32 | 4.7k Ohm Resistor | 3mm Status LED (blue)|
+|-------|-------------------|----------------------|
+|  GND  |                   |       (-) LED        |
+|       |      Resistor     |       (+) LED        |
+|GPIO27 |      Resistor     |                      |
+
+### OLED Display I2C (additional - make sure to use the correct firmware!)
+| 0.96" OLED Display I2C | ESP32 |
+|------------------------|-------|
+|          GND           |  GND  |
+|          VCC           | 3.3V  |
+|          SCL           |GPIO 5 |
+|          SDA           |GPIO 4 |
+
+### Battery modification (additional)
+| 3.7V Li-Ion battery | JST-PH2 connector    | TP4056 Charging Module | Mini Slide Switch | ESP32 |
+|---------------------|----------------------|------------------------|-------------------|-------|
+| (+) Battery         | (+) JST-PH2          | Bat +                  |                   |       |
+| (-) Battery         | (-) JST-PH2          | Bat -                  |                   |       |
+|                     |                      | OUT +                  | Switch in         |       |
+|                     |                      | OUT -                  |                   |  GND  |
+|                     |                      |                        | Switch out        |  3V3  |
+
+
+
+## PCB
+
+<h3 align="center">That's how the components are placed (PCB size=7cm x 5.5cm - Larger sizes will NOT fit in the case!)</h3>
+
+![DIYPCB](https://dwdwpld.pages.dev/DIYPCB.jpg)
 
-### Battery mod
-| 3.7V Li-Ion battery | JST PH 2.0 connector | TP4056 Charging Module | Mini Slide Switch | ESP32 | 3mm LED (blue) | 470k Ohm Resistor |
-|---------------------|----------------------|------------------------|-------------------|-------|----------------|--------------------|
-| (+) battery         | (+) JST              | B+                     |                   |       |                |                    |
-| (-) battery         | (-) JST              | B-                     |                   |       |                |                    |
-|                     |                      | OUT +                  | switch (+) input  |       |                |                    |
-|                     |                      | OUT -                  |                   | GND   |                | resistor output    |
-|                     |                      |                        | switch (+) output | 3V3   | (+) LED        |                    |
-|                     |                      |                        |                   |       | (-) LED        | resistor input     |
 
 
 ## 3D printed case
-
+#### The 3D printed case fits ONLY a PCB size of 7cm x 5.5cm and you'll need to drill out 2 holes according for the M3 screws to fit through the PCB!
-<h3 align="center">Access to the ESP32 micro-USB port, aswell as to both EN & Boot buttons</h3>
+<h3 align="center">Access to the ESP32 micro-USB port, as well as to both EN & Boot buttons</h3>
 
 ![ESP32MicroUSB](https://dwdwpld.pages.dev/ESP32-BlueJammerMicroUsb.jpg)
 
@@ -115,30 +324,50 @@ Here are both pinouts for HSPI and VSPI. You need both nRF24L01 modules connecte
 
 
 
-## 3D model view [[download .stl](https://dwdwpld.pages.dev/ESP32-BlueJammerBy@emensta3DCase.stl)]
+## V3-Case 3D model view [[download .stl](https://dwdwpld.pages.dev/V3-ESP32-BlueJammerBy@emensta3DCase.stl)]
 
-<h3 align="center">Here's a look at the model itself</h3>
+<h3 align="center">Here's a look at the V3 2 antenna version itself</h3>
 
-![3DCaseView](https://dwdwpld.pages.dev/ESP32-BlueJammer3DCaseView.png)
+![3DCaseView](https://dwdwpld.pages.dev/V3-ESP32-BlueJammer3DCaseView.png)
 
 
 
-## PCB
+## V4-Case 3D model view [[download .stl](https://dwdwpld.pages.dev/V4-ESP32-BlueJammerBy@emensta3DCase.stl)]
 
-<h3 align="center">That's how the components are placed (PCB size=7cm x 5.5cm - Larger sizes will NOT fit in the case!)</h3>
+<h3 align="center">Here's a look at the V4 3 antenna version itself</h3>
 
-![DIYPCB](https://dwdwpld.pages.dev/DIYPCB.jpg)
+![3DCaseView](https://dwdwpld.pages.dev/V4-ESP32-BlueJammer3DCaseView.png)
+
+
+
+## About the ESP32-BlueJammer and my source code
+- **Is my ESP32-BlueJammer really working?**  
+  Yes! My ESP32 BlueJammer is fully functional, and no one pauses the sound in the demo video. Many people have built their own ESP32-BlueJammer and confirmed that it works! Join my Discord and see for yourself! ;D
+
+- **Why my ESP32-BlueJammer code is NOT open source**  
+  There are several "BLE Jammers" available on GitHub, but they all have limitations in frequency range, channel coverage, and effective distance (around 5 meters). Therefore I decided to develop and code my own firmware for the ESP32-BlueJammer, aiming for superior performance.
+
+  Despite some claims that I might have copied someone else's work, it's important to clarify that extracting source code from a compiled file (.hex, .bin, etc.) is practically impossible. If I had used someone else's work, I wouldn't have been able to create custom console banners, develop multiple firmware versions, or build a web flasher. My code is entirely written from scratch. There is nothing taken from other available codes, sources, codebases or resources as a foundation, if any even exist. My code remains closed source for now, to protect the significant effort and innovation I've invested in this project.
+
+  This isn't my last project. I'm looking forward to implementing the ESP32-BlueJammer in further ongoing projects, so for now, I'd like the code to remain closed source. Maybe someday I'll make it open source!  
+  -no one knows. ;D
+## Source code snippets by @emensta
+- **Here are three snippets of my source code for you to compare with other available sources. This way, you can see that it was written from scratch:** 
+![ESP32-BlueJammerByEmenstaCodeSnippets](https://dwdwpld.pages.dev/ESP32-BlueJammerByEmenstaCodeSnippets.jpg)
 
 
 
 ## Discord
-You can join my Discord server [here](https://discord.gg/yNGhKxzqUE)!
+You can join my Discord server [here](https://discord.gg/emensta)!
 
 
 
-## Donate
+## Portfolio and all my links
-If you enjoy what I do and want to support me in creating more content and sharing new ideas, feel free to support me!                                         
+Here you can visit my Portfolio, you'll find everything that you're looking for [here](https://emensta.pages.dev)!
-[PayPal.me](https://www.paypal.me/emensta)
+
+## Support me
+Via [this link](https://ko-fi.com/emensta), you can leave a tip to keep me motivated developing future projects! Thank you for your support :)
+
 
 <h1 align="center"> DISCLAIMER </h1>