Skip to content

syphr0/wifi32

Repository files navigation

WiFi32

A WiFi Security tool using the esp32

cifertech - ESP32-DIV stars - wifi32 forks - wifi32

Fork of ESP32-DIV by CiferTech
Table of Contents
  1. About
  2. Requirements
  3. Setup
    1. Install the Arduino IDE
    2. esp32 + Arduino
    3. Hardware Connections (schematic)
    4. Flashing Software
  4. Library Help*
  5. Credits

About

The wifi32 is a handytool for monitoring wifi networks.


Requirements

Software

  • Latest Arduino IDE (2.3.2 at the time of writing)

Hardware

  • ESP32 DevKitc v4 (other esp32 boards will have a different pin layout and won't work with the diagram)
  • 1.8" TFT LCD with the ST7735x chip family using SPI
  • 4 momentary buttons (see here for information about buttons)
  • (Optional) Breadboard
  • (Optional) Jumper wires

Setup

This will be a step-by-step guide to getting started with the wifi32 (ESP32-DIV).

1. Install the Arduino IDE

  • Windows 7 - 10 (64bit)

Get the latest latest Arduino IDE at https://www.arduino.cc/en/software.

  • Windows 11 (22000 and up)

Run:

winget install 9NBLGGH4RSD8

This will install the Arduino IDE using Windows'build in package manager from the Microsoft Store.

  • Linux

Use your favorite package manager to install the arduino IDE. If you don't know how, look it uo on Google.

2. ESP32 + Arduino

In order to program the esp32 using the Arduino IDE, it needs to be detected by the computer and by the IDE.

  1. Head over to File > Preferences > Additional boards manager URLs and add this line:
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

Click OK and wait for the list of boards to be indexed.

  1. Tools > Boards > Boards Manager.... Search for ESP32 and click Install.

  2. Your board needs drivers in order to communicate with the computer.

Chip Link
CP210X click
CH340 click

After installing the driver restart your PC.

3. Hardware Connections

Until I create a schematic for the hardware connections you can use this simple diagram.

The pinout is unchanged from CiferTech's design.
esp32 Pin Display Pin Function
14 CS Chip Select
33 RST Reset
27 DC Data/Command
23 DIN Data out
18 CLK Clock out
5V VCC 5v Power
3v3 LED Backlight
GND GND Ground
esp32 Pin Function
21 Up
22 Down
25 Select
26 Back
I'll add more information about wiring later
The original code seems to have a bug with the back button

4. Flashing Software

  1. Clone the repo
git clone https://github.com/syphr0/wifi32
  1. Open the repo in Arduino and install all needed libraries.
List of required libraries
  • Adafruit_GFX
  • Adafruit_ST7735
  • Adafruit_NeoPixel
  • FS*
  • SD*
  • SPI.h

  1. Connect the esp32 to the computer and select the right COM port along with the board. For this project it should be the ESP32 Dev Module.

  2. You can now flash the board.

If there are issues you can't fix, Create a new issue here, if you can, create an issue with the tag Bugfix detailing what's broken and how we can fix it.

Library Help

You can find the libraries marked with a * in the required-libs folder. I'll keep them updated. Copy them into your library folder (Arduino/libraries/).

Credits

User

cifertech
Original work