Skip to content

ANG13T/ESP8266-WiCon-Kit

Repository files navigation

WiCon logo

A compact and portable WiFi reconnaissance suite based on the ESP8266

Features

  • Packet Monitor with 11 filter types
  • Deauthentication and Disassociation Detector (HAXX)
  • FTP Honeypot with Canary Tokens
  • Web Server (WIP)
  • CSV Data logging (WIP)

Components

Component Purpose
ESP8266 Monitor WiFi data & initialize honeypot
128x64 OLED Give a visual display of WiFi data
2x Push Buttons Gather user input
LED Indicate HAXX attacks

Hardware Setup

128x64 OLED

OLED Pin ESP8266 GPIO Node MCU Pin
SCK GPIO5 D1
SDA GPIO4 D2

Left Push Button

ESP8266 GPIO Node MCU Pin
GPIO2 D4

Right Push Button

ESP8266 GPIO Node MCU Pin
GPIO0 D3

LED

ESP8266 GPIO Node MCU Pin
GPIO13 D7

Schematic

WiCon logo

Image

WiCon preview

Set up

  • Arduino IDE with the following URL added under Preferences -> Additional board manager URL's: http://arduino.esp8266.com/stable/package_esp8266com_index.json

  • ESP8266 boards added in Arduino IDE by going to Tools -> Boards -> Boards Manager, and installing ESP8266 by ESP8266 Community

  • ESPcanary library installed in Arduino IDE by going to Sketch -> Include Library -> Manage Libraries and installing "ESPcanary" by Dan Hoover

  • Install Zip file from https://github.com/wonho-maker/Adafruit_SH1106 and unzip the file inside Arduino -> libraries

  • Adafruit GFX library installed in Arduino IDE by going to Sketch -> Include Library -> Manage Libraries and installing "Adafruit GFX Library" by Adafruit

  • Optional: Depending on which type of OLED screen you use, you might have to install this library esp8266-oled-ssd1306

Special Thanks and Resources

The WiCon kit is a derivation of previous ESP8266 WiFi recon features developed by Spacehuhn, Alex Lynd, and Kody Kinzie. Check out the resources below!