Skip to content

Installation

Stefan Kremser edited this page Mar 8, 2021 · 25 revisions

Installation

Tutorials

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

Flashing the firmware bin file

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.
If you're beginner, have a look at Node2Deauther.

Esptool

Using the NodeMCU (or any similar development board), the flash location is 0x0000 and the mode is dout.
esptool.py -p /dev/ttyUSB0 write_flash -fm dout 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 dout is the flash mode and esp8266_deather.ino.nodemcu.bin is the name of your .bin file.

Flash Download Tools

Espressif has an official GUI tool for Windows.
It has a lot of options and can be used for the ESP8266, ESP8285 and ESP32.
You can find it on Espressif's download page here: https://www.espressif.com/en/support/download/other-tools
(if the link changed, just search for esp flash download tool)

Node2Deauther

Node2Deauther Screenshot
realmrvodka created this user friendly all-in-one flasher tool.
It helps you go through the process step by step and also provides the drivers you'll need.
https://github.com/realmrvodka/n2d/

Esptool-gui

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.

NodeMCU-flasher

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.
Recommended Flash settings NodeMCU Flasher

⚠️ The NodeMCU Flasher is outdated and can be buggy. If it doesn't work, just try flashing it again and see the Installation tips and tricks.

Compiling using Arduino IDE

  1. First you have to install and open the Arduino IDE.

  2. Download the source code for this project.

  3. Extract the whole .zip file, navigate to esp8266_deauther and open esp8266_deauther.ino with Arduino.

  4. In Arduino go to File > Preferences add this URL to the Additional Boards Manager URLs: https://raw.githubusercontent.com/SpacehuhnTech/arduino/main/package_spacehuhn_index.json

  5. Go to Tools > Board > Boards Manager, search deauther and install Deauther ESP8266 Boards

  6. Select your board at Tools > Board and be sure it is at Deauther ESP8266 Boards (and not at ESP8266 Modules)!

  7. Depending on your board, you might have to select a configuration setting at Tools > Deauther Config

  8. If you need to reset the settings from a prior installation, make sure to select Tools > Erase Flash > All Flash Contents

  9. If you like to add a display, LED or buttons, follow the Setup Display & Buttons guide.

  10. Check your upload settings and press upload!

Installation tips and tricks

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.
For customized versions, we highly recommend using Arduino IDE and our Deauther SDK (see Compiling using Arduino IDE).

Flash Button and espcomm_open error

💥❗️❓❗️❗️💢 Sometimes everything is right but it won't upload and you may 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.
PICTURE nodemcu flash button

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.

Drivers and COM Port

In order to upload successfully, you must 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 none 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:

PICTURE serial chips

If you're not sure which chip your board is using, just try both.

If this doesn't help, try out different cables (some USB cables are only for charging and don't have data lines) or plug it to a different USB port.

Upload Settings

Those are the recommended upload/compile settings for Arduino:

Board: Generic ESP8266 Module  
Flash Mode: DOUT
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 has only 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.

Flash Mode

DOUT should always work. It means Dual 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

Flash Frequency

A higher flash frequency should increase the speed, but it doesn't always work with every module.
Try out what works the best.

CPU Frequency

We strongly recommend to use 160MHz to get the extra performance out of the chip.

Reset Method

Again, try out what works and use that.

Baud Rate

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.

Flash Size

The flash size is an important factor!
PICTURE different esp8266 modules
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 recommend 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.

Clone this wiki locally