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
+55-7
Original file line number
Diff line number
Diff line change
@@ -13,6 +13,7 @@ Deauthentication attack and other hacks using an ESP8266.
13
13
-[Installation](#installation)
14
14
-[Uploading the bin files](#uploading-the-bin-files)
15
15
-[Compiling the source with Arduino](#compiling-the-source-with-arduino)
16
+
-[Adding OLED display](#adding-oled-display)
16
17
-[How to use it](#how-to-use-it)
17
18
-[FAQ](#faq)
18
19
-[License](#license)
@@ -68,6 +69,7 @@ I recommend you to buy a USB breakout/developer board, because they have 4Mb fla
68
69
It doesn’t matter which board you use, as long as it has an ESP8266 on it.
69
70
70
71
You have 2 choices here. Uploading the bin files is easier but not as good for debugging, so keep that in mind in case you want to open an new issue.
72
+
**YOU ONLY NEED TO DO ONE OF THE INSTALLATION METHODS!**
71
73
72
74
### Uploading the bin files
73
75
@@ -82,6 +84,8 @@ The NodeMCU and every other board which uses the ESP-12 has 4mb flash on it.
82
84
83
85
Make sure you select the right com-port, the right upload size of your ESP8266 and the right bin file.
84
86
87
+
If flashing the bin files with a flash tool is not working, try flashing the esp8266 with the Arduino IDE as shown below.
88
+
85
89
### Compiling the source with Arduino
86
90
87
91
**0** Download the source code of this project.
@@ -125,19 +129,61 @@ Make sure you select the right com-port, the right upload size of your ESP8266 a
125
129
126
130
**13** Copy ESP8266Wi-Fi.cpp and ESP8266Wi-Fi.h
127
131
128
-
**14**Past these files here `packages` > `esp8266` > `hardware` > `esp8266` > `2.0.0` > `libraries` > `ESP8266Wi-Fi` > `src`
132
+
**14**Paste these files here `packages` > `esp8266` > `hardware` > `esp8266` > `2.0.0` > `libraries` > `ESP8266WiFi` > `src`
129
133
130
134
**15** Open `esp8266_deauther` > `esp8266_deauther.ino` in Arduino
131
135
132
136
**16** Select your ESP8266 board at `Tools` > `Board` and the right port at `Tools` > `Port`
133
137
If no port shows up you may have to reinstall the drivers.
134
138
135
-
**17** Upload!
139
+
**17** Depending on your board you may have to adjust the `Tools` > `Board` > `Flash Frequency` and the `Tools` > `Board` > `Flash Size`. In my case i had to use a `80MHz` Flash Frequency, and a `4M (1M SPIFFS)` Flash Size
140
+
141
+
**18** Upload!
136
142
137
143
**Note:** If you use a 512kb version of the ESP8266, you need to comment out a part of the mac vendor list in data.h.
138
144
139
145
**Your ESP8266 Deauther is now ready!**
140
146
147
+
148
+
### Adding OLED display
149
+
150
+

151
+
152
+
**0** Follow the steps [above](#compiling-the-source-with-arduino) to get your Arduino environment ready.
153
+
154
+
**1** Install this OLED driver library: https://github.com/squix78/esp8266-oled-ssd1306
155
+
156
+
**2** Custimize the code for your wiring.
157
+
In `esp8266_deauther.ino` uncomment `#define USE_DISPLAY`.
158
+
Then scroll down and custimize these lines for your setup.
159
+
160
+
#include <Wire.h>
161
+
162
+
//include the library you need
163
+
#include "SSD1306.h"
164
+
//#include "SH1106.h"
165
+
166
+
//button pins
167
+
#define upBtn D6
168
+
#define downBtn D7
169
+
#define selectBtn D5
170
+
171
+
#define buttonDelay 180 //delay in ms
172
+
173
+
//render settings
174
+
#define fontSize 8
175
+
#define rowsPerSite 8
176
+
177
+
//create display(Adr, SDA-pin, SCL-pin)
178
+
SSD1306 display(0x3c, D2, D1);
179
+
//SH1106 display(0x3c, D2, D1);
180
+
181
+
int rows = 3;
182
+
int curRow = 0;
183
+
int sites = 1;
184
+
int curSite = 1;
185
+
int lrow = 0;
186
+
141
187
## How to use it
142
188
143
189
First start your ESP8266 by giving it power.
@@ -170,7 +216,7 @@ Yes, but I will not implement this 'feature' for ethical and legal reasons.
170
216
**Can it sniff handshakes?**
171
217
172
218
The ESP8266 has a promiscuous mode in which you can sniff packets, but handshake packets are dropped and there is no other way to get them with the functions provided by the SDK.
173
-
Maybe someone will find a way around this barrier.
219
+
Maybe someone will find a way around this barrier in the future.
174
220
175
221
**espcomm_sync failed/espcomm_open when uploading**
176
222
@@ -182,12 +228,12 @@ Which drivers you need depends on the board, most boards use a cp2102 or ch340.
182
228
**AP scan doesn't work**
183
229
184
230
There is a reported issue on this: https://github.com/spacehuhn/esp8266_deauther/issues/5
185
-
Try out switching the browser or open the website with another device.
231
+
Try switching the browser or opening the website with another device.
186
232
187
233
**Deauth attack won't work**
188
234
189
-
If you see 0 pkts/s on the website you've made a mistake. Check if you have followed the the installation steps correctly and that the right SDK installed, it must be version 2.0.0!
190
-
If it can send packets but your target don't loose its connection then the Wi-Fi router uses [802.11w](#how-to-protect-against-it) and it's protected against such attacks or they communicate via 5 GHz Wi-Fi, which the ESP8266 doesn't support.
235
+
If you see 0 pkts/s on the website then you've made a mistake. Check that have followed the the installation steps correctly and that the right SDK installed, it must be version 2.0.0!
236
+
If it can send packets but your target doesn't loose its connection, then the Wi-Fi router either uses [802.11w](#how-to-protect-against-it) and it's protected against such attacks, or it communicates on the 5GHz band, which the ESP8266 doesn't support because of its 2.4GHz antenna.
191
237
192
238
### If you have other questions or problems with the ESP8266 you can also check out the official [community forum](http://www.esp8266.com/).
193
239
@@ -196,6 +242,8 @@ If it can send packets but your target don't loose its connection then the Wi-Fi
196
242
197
243
This project is licensed under the MIT License - see the [license file](LICENSE) file for details.
198
244
245
+
**The License file must be included in any redistributed version of this program**
0 commit comments