Projects / Wi-Fi status display

Wi-Fi status display

Beginner35 minGuided buildReviewed
ESP32 DevKitGPIO21GPIO223V3GNDHomeWiFi -52 dBm ████192.168.1.42OLED

Tap a part to see what it does.

Tap the parts to see what each one does. A teaching simulation, not a circuit simulator.

Build it step by step

0 of 4 done
  1. ESP3218.0 mASSD1306

    Wire the OLED

    SDA GPIO21, SCL GPIO22.

  2. ESP32

    Enter your Wi-Fi

    Edit SSID and PASS in the sketch.

  3. ESP32

    Upload

    Watch it connect and show the IP.

  4. ESP32

    Walk around

    Power it from a power bank and note the bars in each room.

In short

How do you build a wi-Fi status display?

An ESP32 joins your Wi-Fi and shows the network name, signal bars, IP address and reconnect count on an OLED, so you can check coverage around the house. You need ESP32 DevKit V1, SSD1306 OLED Display and Breadboard 830 Tie Points. It takes 4 steps and about 35 minutes.

Level
Beginner
Time
About 35 min
Parts
3

Parts list

Tick what you already own. It saves to My Garage, so “Build with what I have” knows.

Wiring

FromToWhy
OLED SDA / SCLGPIO21 / GPIO22I2C
OLED VCC / GND3V3 / GNDPower

Code

Library: Adafruit SSD1306. ESP32 Wi-Fi is 2.4 GHz only. Replace your-wifi and your-password; do not share the sketch with them inside.

Runs on a virtual ESP32 Dev Module in your browser, with sliders for the sensors. Happy with it? Verify and upload to your real board from the same page (Chrome or Edge on a computer).

#include <WiFi.h>
#include <Adafruit_SSD1306.h>
Adafruit_SSD1306 oled(128, 64, &Wire, -1);
const char* SSID = "your-wifi";
const char* PASS = "your-password";
int reconnects = 0;

int bars(int rssi) { return rssi > -55 ? 4 : rssi > -65 ? 3 : rssi > -75 ? 2 : rssi > -85 ? 1 : 0; }

void setup() {
  oled.begin(SSD1306_SWITCHCAPVCC, 0x3C); oled.setTextColor(SSD1306_WHITE);
  WiFi.mode(WIFI_STA); WiFi.begin(SSID, PASS);
}

void loop() {
  oled.clearDisplay(); oled.setTextSize(1); oled.setCursor(0, 0);
  if (WiFi.status() == WL_CONNECTED) {
    int r = WiFi.RSSI();
    oled.println(WiFi.SSID());
    oled.printf("%d dBm\n", r);
    oled.println(WiFi.localIP());
    oled.printf("reconnects %d", reconnects);
    for (int i = 0; i < 4; i++) if (i < bars(r)) oled.fillRect(100 + i * 7, 20 - i * 5, 5, 6 + i * 5, SSD1306_WHITE);
  } else {
    oled.println("Connecting...");
    static unsigned long last = 0;
    if (millis() - last > 10000) { last = millis(); WiFi.reconnect(); reconnects++; }
  }
  oled.display();
  delay(500);
}

Test checklist

What you should see at each check. If a reading is far off, stop and use the troubleshooting list.

CheckExpected
Next to the router4 bars, better than −55 dBm
Turn the router off"Connecting..." and the reconnect count rises every 10 s
Router back onReconnects by itself within a minute

If it does not work

Never connects

5 GHz-only network, or a typo in the password.

Connects then drops

Weak signal or a poor USB cable: try another power source.

Display blank

Check the I2C address with a scanner.

Still stuck? Find the fault step by step with your multimeter →

Ask Lark AI

Common questions

What parts do I need for the wi-Fi status display?

ESP32 DevKit V1, SSD1306 OLED Display and Breadboard 830 Tie Points.

How long does the wi-Fi status display take to build?

About 35 minutes for a beginner maker, in 4 steps.

How do I know the wi-Fi status display works?

Next to the router: 4 bars, better than −55 dBm. Turn the router off: "Connecting..." and the reconnect count rises every 10 s. Router back on: Reconnects by itself within a minute.

Never connects: what should I check?

5 GHz-only network, or a typo in the password.

Connects then drops: what should I check?

Weak signal or a poor USB cable: try another power source.

Display blank: what should I check?

Check the I2C address with a scanner.