You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+7-16Lines changed: 7 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,8 +12,8 @@ Build your own WiFi jammer with an ESP8266.
12
12
-[Disclaimer](#disclaimer)
13
13
-[Installation](#installation)
14
14
-[How to use it](#how-to-use-it)
15
-
-[Sources and additional links](#sources-and-additional-links)
16
15
-[License](#license)
16
+
-[Sources and additional links](#sources-and-additional-links)
17
17
18
18
## Introduction ##
19
19
@@ -28,19 +28,12 @@ selected devices are not able to connect to the network.
28
28
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
29
29
network.
30
30
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
-
38
31
Because they are unencrypted, you just need the mac address of the WiFi router and of the client device which you want to
39
32
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.
40
33
41
34
### What an ESP8266 is
42
35
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
44
37
with the [Arduino IDE](https://www.arduino.cc/en/Main/Software). This makes it perfect for this project.
45
38
46
39
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
51
44
So make sure your router is up to date and has management frame protection enabled. But be sure that your client device
52
45
supports it too, both ends need to have it enabled!
53
46
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.
56
48
57
49
## Disclaimer
58
50
@@ -71,7 +63,7 @@ The only thing you will need is a computer and an ESP8266.
71
63
72
64
I recommend you to buy one of the USB breakout/developer boards with 4mb flash size.
73
65
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.)
75
67
76
68
**1** Install [Arduino](https://www.arduino.cc/en/Main/Software) and open it.
77
69
@@ -141,6 +133,9 @@ Note: While scanning the ESP8266 will shut down its access point, so you may hav
141
133
142
134
Happy hacking :)
143
135
136
+
## License
137
+
138
+
This project is licensed under the MIT License - see the [license file](LICENSE) file for details
144
139
145
140
## Sources and additional links
146
141
@@ -162,7 +157,3 @@ packet injection with ESP8266:
162
157
wifi_send_pkt_freedom function limitations: http://esp32.com/viewtopic.php?f=13&t=586&p=2648&hilit=wifi_send_pkt_freedom#p2648
163
158
164
159
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