Skip to content

Commit a0b1cfa

Browse files
author
Stefan Kremser
committed
Added OLED Installation in Readme
1 parent 63314b5 commit a0b1cfa

File tree

2 files changed

+55
-7
lines changed

2 files changed

+55
-7
lines changed

README.md

+55-7
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ Deauthentication attack and other hacks using an ESP8266.
1313
- [Installation](#installation)
1414
- [Uploading the bin files](#uploading-the-bin-files)
1515
- [Compiling the source with Arduino](#compiling-the-source-with-arduino)
16+
- [Adding OLED display](#adding-oled-display)
1617
- [How to use it](#how-to-use-it)
1718
- [FAQ](#faq)
1819
- [License](#license)
@@ -68,6 +69,7 @@ I recommend you to buy a USB breakout/developer board, because they have 4Mb fla
6869
It doesn’t matter which board you use, as long as it has an ESP8266 on it.
6970

7071
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!**
7173

7274
### Uploading the bin files
7375

@@ -82,6 +84,8 @@ The NodeMCU and every other board which uses the ESP-12 has 4mb flash on it.
8284

8385
Make sure you select the right com-port, the right upload size of your ESP8266 and the right bin file.
8486

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+
8589
### Compiling the source with Arduino
8690

8791
**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
125129

126130
**13** Copy ESP8266Wi-Fi.cpp and ESP8266Wi-Fi.h
127131

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`
129133

130134
**15** Open `esp8266_deauther` > `esp8266_deauther.ino` in Arduino
131135

132136
**16** Select your ESP8266 board at `Tools` > `Board` and the right port at `Tools` > `Port`
133137
If no port shows up you may have to reinstall the drivers.
134138

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!
136142

137143
**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.
138144

139145
**Your ESP8266 Deauther is now ready!**
140146

147+
148+
### Adding OLED display
149+
150+
![image of the esp8266 deauther with an OLED and three buttons](https://raw.githubusercontent.com/spacehuhn/esp8266_deauther/master/screenshots/esp8266_with_oled.jpg)
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+
141187
## How to use it
142188

143189
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.
170216
**Can it sniff handshakes?**
171217

172218
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.
174220

175221
**espcomm_sync failed/espcomm_open when uploading**
176222

@@ -182,12 +228,12 @@ Which drivers you need depends on the board, most boards use a cp2102 or ch340.
182228
**AP scan doesn't work**
183229

184230
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.
186232

187233
**Deauth attack won't work**
188234

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.
191237

192238
### If you have other questions or problems with the ESP8266 you can also check out the official [community forum](http://www.esp8266.com/).
193239

@@ -196,6 +242,8 @@ If it can send packets but your target don't loose its connection then the Wi-Fi
196242

197243
This project is licensed under the MIT License - see the [license file](LICENSE) file for details.
198244

245+
**The License file must be included in any redistributed version of this program**
246+
199247
## Sources and additional links
200248

201249
deauth attack: https://en.wikipedia.org/wiki/Wi-Fi_deauthentication_attack
@@ -219,4 +267,4 @@ esp32 esp_Wi-Fi_internal function limitations: http://esp32.com/viewtopic.php?f=
219267

220268
Videos:
221269
[![Cheap Wi-Fi 'Jammer' Device | NodeMCU](https://img.youtube.com/vi/oQQhBdCQOTM/0.jpg)](https://www.youtube.com/watch?v=oQQhBdCQOTM)
222-
[![Wifi 'Jammer' Device V1.1 | Setup Tutorial](https://img.youtube.com/vi/r5aoV5AolNo/0.jpg)](https://www.youtube.com/watch?v=r5aoV5AolNo)
270+
[![Wifi 'Jammer' Device V1.1 | Setup Tutorial](https://img.youtube.com/vi/r5aoV5AolNo/0.jpg)](https://www.youtube.com/watch?v=r5aoV5AolNo)

screenshots/esp8266_with_oled.jpg

209 KB
Loading

0 commit comments

Comments
 (0)