Skip to content

Commit 219229a

Browse files
authored
Update README.md
1 parent f9400a0 commit 219229a

File tree

1 file changed

+7
-16
lines changed

1 file changed

+7
-16
lines changed

README.md

Lines changed: 7 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@ Build your own WiFi jammer with an ESP8266.
1212
- [Disclaimer](#disclaimer)
1313
- [Installation](#installation)
1414
- [How to use it](#how-to-use-it)
15-
- [Sources and additional links](#sources-and-additional-links)
1615
- [License](#license)
16+
- [Sources and additional links](#sources-and-additional-links)
1717

1818
## Introduction ##
1919

@@ -28,19 +28,12 @@ selected devices are not able to connect to the network.
2828
The 802.11 WiFi protocol contains a so called [deauthentication frame](https://mrncciew.com/2014/10/11/802-11-mgmt-deauth-disassociation-frames/). It is used to disconnect clients safely from a wireless
2929
network.
3030

31-
For example your smartphone will send such a frame to its connected network when you turn the WiFi off. The router then knows that
32-
you are no longer a part of the network and stops sending you packets.
33-
34-
When you just get out of the range of your WiFi network, the router wouldn’t notice it and would send you data and wait for your
35-
answer. After some time you get a timeout and the router kicks you off the network anyway. But for the sake of resources and to
36-
prevent errors, these packets were invented.
37-
3831
Because they are unencrypted, you just need the mac address of the WiFi router and of the client device which you want to
3932
disconnect from the network. You don’t even have to be in the network or know the password, it’s enough to be in its range.
4033

4134
### What an ESP8266 is
4235

43-
The [ESP8266](https://de.wikipedia.org/wiki/ESP8266) a very cheap micro controller with build in WiFi. It contains a powerfull 160 MHz processor and you can program it
36+
The [ESP8266](https://de.wikipedia.org/wiki/ESP8266) is a very cheap micro controller with build in WiFi. It contains a powerfull 160 MHz processor and you can program it
4437
with the [Arduino IDE](https://www.arduino.cc/en/Main/Software). This makes it perfect for this project.
4538

4639
You can buy these chips for under $2 from China!
@@ -51,8 +44,7 @@ With [802.11w-2009](https://en.wikipedia.org/wiki/IEEE_802.11w-2009) WiFi got an
5144
So make sure your router is up to date and has management frame protection enabled. But be sure that your client device
5245
supports it too, both ends need to have it enabled!
5346

54-
The only problem is that most devices don’t use it. I tested it with different WiFi networks and client devices now
55-
and it worked every time. It seems that even newer devices which support frame protection, don’t use it by default.
47+
The only problem is that most devices don’t use it. I tested it with different WiFi networks and devices, it worked every time! It seems that even newer devices which support frame protection don’t use it by default.
5648

5749
## Disclaimer
5850

@@ -71,7 +63,7 @@ The only thing you will need is a computer and an ESP8266.
7163

7264
I recommend you to buy one of the USB breakout/developer boards with 4mb flash size.
7365
It doesn’t matter which board you use, as long as it has an ESP8266 on it.
74-
If you using an ESP-01 or other chips with just 1mb, you can comment out the mac vendor list in data.h.
66+
(If you using an ESP-01 or other chips with just 1mb, you can comment out the mac vendor list in data.h.)
7567

7668
**1** Install [Arduino](https://www.arduino.cc/en/Main/Software) and open it.
7769

@@ -141,6 +133,9 @@ Note: While scanning the ESP8266 will shut down its access point, so you may hav
141133

142134
Happy hacking :)
143135

136+
## License
137+
138+
This project is licensed under the MIT License - see the [license file](LICENSE) file for details
144139

145140
## Sources and additional links
146141

@@ -162,7 +157,3 @@ packet injection with ESP8266:
162157
wifi_send_pkt_freedom function limitations: http://esp32.com/viewtopic.php?f=13&t=586&p=2648&hilit=wifi_send_pkt_freedom#p2648
163158

164159
esp32 esp_wifi_internal function limitations: http://esp32.com/viewtopic.php?f=13&t=586&p=2648&hilit=wifi_send_pkt_freedom#p2648
165-
166-
## License
167-
168-
This project is licensed under the MIT License - see the [license file](LICENSE) file for details

0 commit comments

Comments
 (0)