Update README.md

README.md

@@ -1,2 +1,69 @@
 # esp8266_deauther
-ESP8266 deauther
+WiFi deauther
+Build your own WiFi jammer for under $10 with an ESP8266.
+
+##### Introduction #####
+#What it is:
+
+Basically it’s a device which performs a deauth attack.
+You select the clients you want to disconnect from their network and start the attack. As long as the attack is running, the
+selected clients are not able to connect to the network.
+
+# How it works:
+
+The 802.11 WiFi protocol contains a so called deauthentication frame. It is used to disconnect clients safely from a wireless
+network.
+
+For example your smartphone will send such a frame to its connected network when you turn the WiFi off. The router then knows that
+you are no longer a part of the network and stops sending you packets.
+
+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
+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
+prevent errors, these packets were invented.
+
+Because they are unencrypted, you just need the mac address of the WiFi router and of the client device which you want to
+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.
+
+# What an ESP8266 is:
+
+The ESP8266 a very cheap micro controller with build in WiFi. It contains a powerfull 160 MHz processor and you can program it
+with the Arduino IDE. This makes it perfect for this project.
+
+You can buy these chips for under $2 from China. But I recommend you to buy one of the USB breakout/developer boards. 
+It doesn’t matter which board you use, as long as it has an ESP8266 on it.
+
+# How to protect yourself:
+
+With 802.11w-2009 WiFi got an update to encrypt management frames.
+So make sure your router is up to date and has management frame protection enabled. But be sure that your client device
+supports it too, both ends need to have it enabled!
+
+The only problem is that most devices don’t use it. I tested it with different WiFi networks and client devices now 
+and it worked every time. It seems that even newer devices which support frame protection, don’t use it by default.
+Disclaimer
+
+Use it only for testing purposes on your own devices!
+
+Please check the legal regulations in your country before using it. Jamming transmitters are illegal in most countries 
+and this device can fall into the same category (even if it’s technically not the same).
+
+My intention with this project is to draw attention to this issue. 
+This attack shows how vulnerable the 802.11 WiFi standard is and that we need to fix it.
+A solution is already there, why don’t we use it?
+
+##### Tutorial #####
+
+coming soon :)
+
+#### Sources and additional links ####
+
+deauth attack: https://en.wikipedia.org/wiki/Wi-Fi_deauthentication_attack
+deauth frame: https://mrncciew.com/2014/10/11/802-11-mgmt-deauth-disassociation-frames/
+ESP8266: https://de.wikipedia.org/wiki/ESP8266
+https://espressif.com/en/products/hardware/esp8266ex/overview
+
+packet injection with ESP8266: http://hackaday.com/2016/01/14/inject-packets-with-an-esp8266/
+http://bbs.espressif.com/viewtopic.php?f=7&t=1357&p=10205&hilit=wifi_pkt_freedom#p10205
+https://github.com/pulkin/esp8266-injection-example
+
+802.11w-2009: https://en.wikipedia.org/wiki/IEEE_802.11w-2009