Skip to content

Commit 0b99512

Browse files
authored
Update README.md
1 parent eb659de commit 0b99512

File tree

1 file changed

+47
-3
lines changed

1 file changed

+47
-3
lines changed

README.md

Lines changed: 47 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,7 @@ disconnect from the network. You don’t even have to be in the network or know
2929
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
3030
with the [Arduino IDE](https://www.arduino.cc/en/Main/Software). This makes it perfect for this project.
3131

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

3534
## How to protect yourself:
3635

@@ -54,7 +53,52 @@ This attack shows how vulnerable the 802.11 WiFi standard is and that it has to
5453

5554
# Tutorial
5655

57-
coming soon :)
56+
The only thing you will need is a computer and an ESP8266.
57+
58+
I recommend you to buy one of the USB breakout/developer boards.
59+
It doesn’t matter which board you use, as long as it has an ESP8266 on it.
60+
61+
**1** Install and open [Arduino](https://www.arduino.cc/en/Main/Software).
62+
63+
**2** Go to `File` > `Preferences`
64+
65+
**3** Add `http://arduino.esp8266.com/stable/package_esp8266com_index.json` to the Additional Boards Manager URLs. (source: https://github.com/esp8266/Arduino)
66+
67+
**4** Go to `Tools` > `Board` > `Boards Manager`
68+
69+
**5** Type in `esp8266`
70+
71+
**6** Select version `2.0.0` and click on `Install`
72+
73+
**7** Go to `File` > `Preferences` again
74+
75+
**8** Open the folder path under `More preferences can be edited directly in the file`
76+
77+
**9** Go to `packages` > `esp8266` > `hardware` > `esp8266` > `2.0.0` > `tools` > `sdk` > `include`
78+
79+
**10** Open `user_interface.h` with a text editor
80+
81+
**11** Scroll down and before `#endif` add following lines:
82+
83+
`typedef void (*freedom_outside_cb_t)(uint8 status);`
84+
`int wifi_register_send_pkt_freedom_cb(freedom_outside_cb_t cb);`
85+
`void wifi_unregister_send_pkt_freedom_cb(void);`
86+
`int wifi_send_pkt_freedom(uint8 *buf, int len, bool sys_seq);`
87+
88+
**12** Download and open `esp8266_deauther` > `esp8266_deauther.ino` with Arduino
89+
90+
**13** Select your ESP8266 board at `Tools` > `Board` and the right port at `Tools` > `Port`
91+
If no port shows up you may have to reinstall the drivers.
92+
93+
**14** Upload!
94+
95+
**Your ESP8266 Deauther is now ready!**
96+
97+
Scan for WiFi networks and connect to `pwned`. The password is `deauther`.
98+
Once connected you can open up your browser and go to `192.168.4.1`.
99+
100+
Happy hacking :)
101+
58102

59103
# Sources and additional links
60104

0 commit comments

Comments
 (0)