Installation
Online interactive step by step tutorial by @jLynx:
🎓 http://deauth.me
$3 WiFi Jammer/Deauther using ESP8266 | Deauther 2.0 Flashing/Installation by @PwnKitteh:
🎬 https://youtu.be/wKhSlIYQ5jA
You can find precompiled .bin files on the release page. Be sure to download the latest version. The 1 MB file should be good for most devices. If you have a NodeMCU with an ESP-12 you can also use the 4MB file. But all in all, it shouldn't matter that much.
Use one of the following software to flash your ESP8266 with the .bin file.
Using the NodeMCU (or any similar development board), the flash location is 0x0000 and the mode is qio.
esptool.py -p /dev/ttyUSB0 write_flash -fm qio 0x0000 esp8266_deauther.ino.nodemcu.bin
Where /dev/ttyUSB0 is the COM port of your device, write_flash is telling the program to write to flash memory, -fm qio is mode qio, which is the mode for chips with 4MB or more, and esp8266_deather.ino.nodemcu.bin is the name of your .bin file.
An easy to use GUI flasher for Windows and Mac: esptool-gui.
Select the COM Port and the .bin file (firmware), then just press upload.
Another easy to use GUI flasher, but this time only for Windows: nodemcu-flasher.
Select the COM port, go to config and select your .bin file at 0x000000.
Go back to Operation and click Flash.
-
First you have to install and open the Arduino IDE.
-
In Arduino go to File -> Preferences add both URLs in Additional Boards Manager URLs
http://arduino.esp8266.com/stable/package_esp8266com_index.jsonhttp://phpsecu.re/esp8266/package_deauther_index.json
-
Go to Tools -> Board -> Boards Manager, search "esp8266" and install
esp8266first, thenarduino-esp8266-deauther
-
Select your board at Tools -> Board and be sure it is at
ESP8266 Deauther Modules(and not atESP8266 Modules)!
-
Download the source code for this project from the releases page. You can also clone the project to get the latest changes, but you will also get the latest bugs ;)
-
Extract the whole .zip file, navigate to esp8266_deauther and open esp8266_deauther.ino with Arduino.
-
Check your upload settings and press upload!
-
You might want to adjust the display, LED and button configurations. You can do that in the
A_config.hfile (second tab in Arduino). You can also find predefined config files for certain boards in the configs folder.
These are some small tips that are beneficial for first time users of this software, and hopefully will make it more accessible and cause less headache when flashing the board.
We recommend the esptool for flashing .bin files, because it works on all platforms. You can read more about how esptool works on their github page, linked above.
For customized versions, we highly recommend using Arduino and our Deauther SDK (see Compiling using Arduino IDE).
💥❗️❓❗️❗️💢 Sometimes everything is right but it won't upload and you maybe get an error like error: espcomm_open failed.
What you have to do is hold the flash button down, start uploading and only release it when you see that it's started uploading.
Most development boards feature a auto-reset method and sometimes it doesn't work properly and it fails to go into flashing mode automatically. To manully force it into the flashing mode, you have to hold down the button.
To upload you always have to select the correct COM port. You can think of it as the address with that your computer accesses the ESP8266.
The best way to find the correct port is to open the Arduino IDE and see what ports are listed there. This looks the same for every OS, including Linux. On Windows, COM1 is usually never the correct port.
On Windows you can also have a look at your device manager, there you can also see if a device is not recognized.
If non of the COM ports work correctly or you can't find any COM Port, you might need to install the drivers.
The driver you need depends on the UART (USB to Serial) chip that is used on your development board.
Those are the drivers of the most used chips:
If you're not sure which chip your board is using, just try both.
When this also doesn't help, try out different cables (some USB cables are only for charging and don't have data lines).
Those are the recommended upload/compile settings for Arduino:
Board: Generic ESP8266 Module
Flash Mode: DIO
Flash Frequency: 80 MHZ
CPU Frequency: 160 MHz
Flash Size: 1M (256K SPIFFS)
Reset Method: nodemcu
Upload Speed: 115200
Port: <com port of your device>
Most NodeMCUs and other development boards have 4MB Flash so you can set the Flash Size to 4M (3M SPIFFS) or select NodeMCU 1.0 as the board.
A bigger Flash size can give you more memory in the SPIFFS for saving data, scripts or other files. Increasing the SPIFFS can also make it a bit slower, as the ESP8266 has to maintain a bigger file system.
If you have a board with the ESP-07 (the one with the connector for an external antenna) it probably only has 1MB of flash, so keep the recommended settings above.
Putting the Upload Speed to 921600 (or other baud rates) gives you a higher upload speed but doesn't always work.
DIO should always work. It means Dual In-/Output.
QIO (quad I/O) uses 4 instead of 2 pins and will make the flash faster. However, you won't be able to use GPIO 9 and 10 (SD2, SD3)! If you flash it with QIO and use those pins, it will crash without a warning.
More details on the different modes are descripted here: https://github.com/espressif/esptool/wiki/SPI-Flash-Modes
A higher flash frequency should increase the speed, but it doesn't always work with every module.
Try out what works the best.
We strongly recommend to use 160MHz to get the extra performance out of the chip.
Again, try out what works and use that.
The recommended baud rate for uploading is 115200. You can try higher baud rates for faster uploading or slower ones if 115200 isn't working very reliable.
The flash size is an important factor!
The ESP-12 (which is used on most development boards like the NodeMCU) has 4MB of flash memory.
Other Modules like the ESP-01 and ESP-07 (the one with the antenna connector) come with only 1MB of memory.
You have to change your upload settings depending on the module you're using.
For compiling we recomment to use either 1M (256K SPIFFS) or 4M (3M SPIFFS).
It is also very important to note, that you must give the SPIFFS some memory. This software will only work with the SPIFFS enabled, otherwise you will see something like Initializing SPIFFS...ERROR on startup.