Skip to content

Installation

Jump to bottom Edit New page
Sam Denty edited this page Jul 15, 2017 · 10 revisions

Installation

Requirements:

  • ESP8266 module (any board)
  • Micro-USB cable
  • Computer

I would recommend getting a USB breakout/developer board, mainly due to the 4Mb of flash and simplicity.

In order to upload the Wi-PWN firmware, you can use one of two methods. The first method is easier overall but using Arduino is better for debugging. YOU ONLY NEED TO DO ONE OF THE INSTALLATION METHODS!

Method 1: Flashing with NodeMCU-Flasher

  1. Download the current release of Wi-PWN

  2. Upload the .bin file using the nodemcu-flasher. Alternatively you can use the official esptool from espressif.

  3. Connect your ESP8266 (making sure the drivers are installed) and open up the NodeMCU Flasher

  4. Go to the Advanced tab and select the correct values for your board.

  5. Navigate to the config tab and click the gear icon for the first entry.

  6. Browse for the .bin file you just downloaded and click open.

  7. Switch back to the Operation tab and click Flash(F).

Method 2: Compiling with Arduino

  1. Download the source code of this project.

  2. Install Arduino and open it.

  3. Go to File > Preferences

  4. Add http://arduino.esp8266.com/stable/package_esp8266com_index.json to the Additional Boards Manager URLs. (refer to https://github.com/esp8266/Arduino)

  5. Go to Tools > Board > Boards Manager

  6. Type in esp8266

  7. Select version 2.0.0 and click on Install (must be version 2.0.0!)

    screenshot of arduino, selecting the right version

  8. Go to File > Preferences

  9. Open the folder path under More preferences can be edited directly in the file

    screenshot of arduino, opening folder path

  10. Go to packages > esp8266 > hardware > esp8266 > 2.0.0 > tools > sdk > include

  11. Open user_interface.h with a text editor

  12. Just before the last line #endif, add the following:

typedef void (*freedom_outside_cb_t)(uint8 status);
int wifi_register_send_pkt_freedom_cb(freedom_outside_cb_t cb);
void wifi_unregister_send_pkt_freedom_cb(void);
int wifi_send_pkt_freedom(uint8 *buf, int len, bool sys_seq);

screenshot of notepad, copy paste the right code

  1. Go to the arduino/SDK_fix folder of this project

  2. Copy ESP8266Wi-Fi.cpp and ESP8266Wi-Fi.h to C:\Users\%username%\AppData\Local\Arduino15\packages\esp8266\hardware\esp8266\2.0.0\libraries\ESP8266WiFi\src

  3. Open arduino/Wi-PWN/esp8266_deauther.ino in Arduino

  4. Select your ESP8266 board at Tools > Board and the right port at Tools > Port
    If no port shows up you need to reinstall the drivers, search online for chip part number + 'driver Windows'

  5. Depending on your board you may have to adjust the Tools > Board > Flash Frequency and the Tools > Board > Flash Size. I used the 80MHz Flash Frequency, and the 4M (1M SPIFFS) Flash Size

  6. Upload! CTRL-U

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

Add a custom footer
Add a custom sidebar
Clone this wiki locally