Skip to content

Commit 51c13a4

Browse files
authored
Update README.md
1 parent de426ff commit 51c13a4

File tree

1 file changed

+24
-15
lines changed

1 file changed

+24
-15
lines changed

README.md

Lines changed: 24 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,20 @@
22
Build your own WiFi jammer for under $10 with an ESP8266.
33

44
# Introduction
5+
6+
<a href="http://www.youtube.com/watch?feature=player_embedded&v=6TXVeEDK42Y
7+
" target="_blank"><img src="http://img.youtube.com/vi/6TXVeEDK42Y/0.jpg"
8+
alt="WiFi Deauther ESP8266 Video" width="420" height="320" border="10" /></a>
9+
510
## What it is:
611

7-
Basically it’s a device which performs a deauth attack.
12+
Basically it’s a device which performs a [deauth attack](https://en.wikipedia.org/wiki/Wi-Fi_deauthentication_attack).
813
You select the clients you want to disconnect from their network and start the attack. As long as the attack is running, the
9-
selected clients are not able to connect to the network.
14+
selected devices are not able to connect to the network.
1015

1116
## How it works:
1217

13-
The 802.11 WiFi protocol contains a so called deauthentication frame. It is used to disconnect clients safely from a wireless
18+
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
1419
network.
1520

1621
For example your smartphone will send such a frame to its connected network when you turn the WiFi off. The router then knows that
@@ -25,21 +30,22 @@ disconnect from the network. You don’t even have to be in the network or know
2530

2631
## What an ESP8266 is:
2732

28-
The ESP8266 a very cheap micro controller with build in WiFi. It contains a powerfull 160 MHz processor and you can program it
29-
with the Arduino IDE. This makes it perfect for this project.
33+
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
34+
with the [Arduino IDE](https://www.arduino.cc/en/Main/Software). This makes it perfect for this project.
3035

3136
You can buy these chips for under $2 from China. But I recommend you to buy one of the USB breakout/developer boards.
3237
It doesn’t matter which board you use, as long as it has an ESP8266 on it.
3338

3439
## How to protect yourself:
3540

36-
With 802.11w-2009 WiFi got an update to encrypt management frames.
41+
With [802.11w-2009](https://en.wikipedia.org/wiki/IEEE_802.11w-2009) WiFi got an update to encrypt management frames.
3742
So make sure your router is up to date and has management frame protection enabled. But be sure that your client device
3843
supports it too, both ends need to have it enabled!
3944

4045
The only problem is that most devices don’t use it. I tested it with different WiFi networks and client devices now
4146
and it worked every time. It seems that even newer devices which support frame protection, don’t use it by default.
42-
Disclaimer
47+
48+
# Disclaimer
4349

4450
Use it only for testing purposes on your own devices!
4551

@@ -48,7 +54,7 @@ and this device can fall into the same category (even if it’s technically not
4854

4955
My intention with this project is to draw attention to this issue.
5056
This attack shows how vulnerable the 802.11 WiFi standard is and that we need to fix it.
51-
A solution is already there, why don’t we use it?
57+
**A solution is already there, why don’t we use it?**
5258

5359
# Tutorial
5460

@@ -60,14 +66,17 @@ deauth attack: https://en.wikipedia.org/wiki/Wi-Fi_deauthentication_attack
6066

6167
deauth frame: https://mrncciew.com/2014/10/11/802-11-mgmt-deauth-disassociation-frames/
6268

63-
ESP8266: https://de.wikipedia.org/wiki/ESP8266
69+
ESP8266:
70+
* https://de.wikipedia.org/wiki/ESP8266
71+
* https://espressif.com/en/products/hardware/esp8266ex/overview
6472

65-
https://espressif.com/en/products/hardware/esp8266ex/overview
73+
packet injection with ESP8266:
74+
* http://hackaday.com/2016/01/14/inject-packets-with-an-esp8266/
75+
* http://bbs.espressif.com/viewtopic.php?f=7&t=1357&p=10205&hilit=wifi_pkt_freedom#p10205
76+
* https://github.com/pulkin/esp8266-injection-example
6677

67-
packet injection with ESP8266: http://hackaday.com/2016/01/14/inject-packets-with-an-esp8266/
68-
69-
http://bbs.espressif.com/viewtopic.php?f=7&t=1357&p=10205&hilit=wifi_pkt_freedom#p10205
78+
802.11w-2009: https://en.wikipedia.org/wiki/IEEE_802.11w-2009
7079

71-
https://github.com/pulkin/esp8266-injection-example
80+
wifi_send_pkt_freedom function limitations: http://esp32.com/viewtopic.php?f=13&t=586&p=2648&hilit=wifi_send_pkt_freedom#p2648
7281

73-
802.11w-2009: https://en.wikipedia.org/wiki/IEEE_802.11w-2009
82+
esp32 esp_wifi_internal function limitations: http://esp32.com/viewtopic.php?f=13&t=586&p=2648&hilit=wifi_send_pkt_freedom#p2648

0 commit comments

Comments
 (0)