Skip to content

Commit 988835c

Browse files
authored
Update README.md
Added FAQ and Seytonic's videos :)
1 parent b1e011b commit 988835c

File tree

1 file changed

+52
-0
lines changed

1 file changed

+52
-0
lines changed

README.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ Build your own WiFi jammer with an ESP8266.
1212
- [Disclaimer](#disclaimer)
1313
- [Installation](#installation)
1414
- [How to use it](#how-to-use-it)
15+
- [FAQ and Troubleshooting](#faq-and-troubleshooting)
1516
- [License](#license)
1617
- [Sources and additional links](#sources-and-additional-links)
1718

@@ -132,6 +133,54 @@ Note: While scanning the ESP8266 will shut down its access point, so you may hav
132133

133134
Happy hacking :)
134135

136+
## FAQ and Troubleshooting
137+
138+
**`espcomm_sync failed` when uploading**
139+
140+
The ESP upload tool can't communicate with the chip, make sure the right port is selected!
141+
You can also try out different USB ports and cables.
142+
If this doesn't solve it you may have to install USB drivers.
143+
Which drivers you need depends on the board, most boards use a cp2102, cp2104 or ch340.
144+
145+
**AP scan doesn't work**
146+
147+
There is a reported issue with the Internet Explorer: https://github.com/spacehuhn/esp8266_deauther/issues/5
148+
Try out switching the browser or open the website with another device.
149+
150+
**Timeout error**
151+
152+
This can happen if your device (phone, computer... whatever have the website open) looses connection to the pwned WiFi.
153+
When scanning for clients you will lose the connection, this is normal and you have to make sure you reconnect.
154+
After reloading the page everything should be fine.
155+
156+
**No clients found**
157+
158+
The ESP8266 can only find devices which are in its range and sends packets in the selected WiFi network via 2,4 GHz WiFi while the ESP is scanning.
159+
160+
**Deauth attack won't work**
161+
162+
If you see 0 pkts/s on the website you have 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!
163+
If it can send packets but your target don't loose its connection then the WiFi router uses [802.11w](#how-to-protect-against-it) and it's protected against such attacks or they communicate via 5 GHz WiFi, which the ESP8266 doesn't support.
164+
165+
**Could it auto-deauth all APs in the range?**
166+
167+
It definitely could! But I will not implement this 'feature' for ethical and legal reasons.
168+
169+
**Can it sniff handshakes?**
170+
171+
The ESP8266 has a promiscuous mode in which you can sniff nearly all packets, but handshake packets are dropped and there is no other way to get them with the functions provided by the SDK.
172+
Maybe someone will find a way around this barrier but I wasn't able to.
173+
174+
**Could it open a fake AP to grab passwords?**
175+
176+
That's a feature to be implemented as soon as I have time to code it :).
177+
178+
179+
180+
###If you have other questions or problems with the ESP8266 you can also check out the official [community forum](http://www.esp8266.com/).
181+
182+
183+
135184
## License
136185

137186
This project is licensed under the MIT License - see the [license file](LICENSE) file for details
@@ -156,3 +205,6 @@ packet injection with ESP8266:
156205
wifi_send_pkt_freedom function limitations: http://esp32.com/viewtopic.php?f=13&t=586&p=2648&hilit=wifi_send_pkt_freedom#p2648
157206

158207
esp32 esp_wifi_internal function limitations: http://esp32.com/viewtopic.php?f=13&t=586&p=2648&hilit=wifi_send_pkt_freedom#p2648
208+
209+
Videos:
210+
[![Cheap Wifi 'Jammer' Device | NodeMCU](https://img.youtube.com/vi/oQQhBdCQOTM/0.jpg)](https://www.youtube.com/watch?v=oQQhBdCQOTM)

0 commit comments

Comments
 (0)