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
+52Lines changed: 52 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,6 +12,7 @@ Build your own WiFi jammer with an ESP8266.
12
12
-[Disclaimer](#disclaimer)
13
13
-[Installation](#installation)
14
14
-[How to use it](#how-to-use-it)
15
+
-[FAQ and Troubleshooting](#faq-and-troubleshooting)
15
16
-[License](#license)
16
17
-[Sources and additional links](#sources-and-additional-links)
17
18
@@ -132,6 +133,54 @@ Note: While scanning the ESP8266 will shut down its access point, so you may hav
132
133
133
134
Happy hacking :)
134
135
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
+
135
184
## License
136
185
137
186
This project is licensed under the MIT License - see the [license file](LICENSE) file for details
@@ -156,3 +205,6 @@ packet injection with ESP8266:
156
205
wifi_send_pkt_freedom function limitations: http://esp32.com/viewtopic.php?f=13&t=586&p=2648&hilit=wifi_send_pkt_freedom#p2648
157
206
158
207
esp32 esp_wifi_internal function limitations: http://esp32.com/viewtopic.php?f=13&t=586&p=2648&hilit=wifi_send_pkt_freedom#p2648
0 commit comments