Skip to content

About

The ESP32 connects to a wireless network, periodically checks a list of user-defined IP addresses, and displays device status on a small SSD1306 OLED

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

ESP32 AV Network Monitor

A compact ESP32-based network status monitor designed for live audio, lighting, broadcast, production, and AV networks.

The monitor connects to Wi-Fi, continuously checks user-defined network devices using ICMP ping, and displays their status on a small 128×64 OLED.

It was originally built as a simple way to check critical devices on an AV network without opening a laptop, network scanner, or control application.

Features

  • ESP32-based
  • 128×64 SSD1306 OLED
  • Simple single-file Arduino sketch
  • User-defined Wi-Fi credentials
  • User-defined device names and IP addresses
  • ICMP ping monitoring
  • OK, OFF, and pending device states
  • Automatic page rotation
  • Multiple device pages
  • Wi-Fi RSSI display
  • Wi-Fi signal quality indicator
  • ESP32 local IP display
  • Automatic Wi-Fi reconnection
  • No buttons, encoders, or controls required
  • No third-party ping library required

Example Uses

The monitor can be used to check network reachability for devices such as:

  • Digital audio consoles
  • Dante interfaces
  • DSP processors
  • Art-Net / sACN nodes
  • WLED controllers
  • MIDI interfaces
  • Media servers
  • Show-control computers
  • Wireless access points
  • Network switches
  • Video processors
  • Other IP-based AV equipment

Hardware

Required

  • ESP32 development board
  • 128×64 I2C SSD1306 OLED
  • Four jumper wires
  • USB power supply or USB connection

The original project was developed using a standard ESP32 Dev Module and a 0.96" 128×64 SSD1306 I2C OLED.

Wiring

OLED ESP32
VCC 3.3V
GND GND
SDA GPIO21
SCL GPIO22

The default OLED I2C address used by the sketch is:

0x3C

The SDA pin, SCL pin, and OLED address can all be changed in the USER SETTINGS section of the sketch.

Software

Tested Configuration

The initial release was developed and tested with:

  • Arduino IDE 2.3.6
  • ESP32 Arduino Core 2.0.17
  • Adafruit SSD1306 2.5.17
  • Adafruit GFX Library
  • Board selection: ESP32 Dev Module

Other versions may work, but this is the known-good configuration used during development.

Required Arduino Libraries

Install the following through:

Arduino IDE → Library Manager

Adafruit SSD1306

Search for:

Adafruit SSD1306

Install the library by Adafruit.

Adafruit GFX Library

Search for:

Adafruit GFX Library

Install the library by Adafruit.

The project also uses:

  • WiFi
  • Wire
  • FreeRTOS
  • ESP32 ICMP ping support

These are provided by the ESP32 Arduino board package and do not require a separate ping library.

Setup

All configuration is contained directly inside:

ESP32-AV-Network-Monitor.ino

There is no separate config.h file.

Open the .ino file in Arduino IDE and find:

// ======================================================
// USER SETTINGS
// EDIT THIS SECTION
// ======================================================

You should not normally need to modify anything below the end of the USER SETTINGS section.

1. Configure Wi-Fi

Find:

const char* WIFI_SSID = "YOUR_WIFI_NAME";
const char* WIFI_PASSWORD = "YOUR_WIFI_PASSWORD";

Replace the placeholders with your Wi-Fi network information.

Example:

const char* WIFI_SSID = "Production-WiFi";
const char* WIFI_PASSWORD = "your-password";

2. Configure Devices

Find:

Device devices[] = {

Each entry contains:

  1. The name shown on the OLED
  2. The device's IPv4 address
  3. Internal online status
  4. Internal checked status

For example:

Device devices[] = {

  {
    "Audio Console",
    IPAddress(192, 168, 1, 10),
    false,
    false
  },

  {
    "Lighting Node",
    IPAddress(192, 168, 1, 20),
    false,
    false
  },

  {
    "WLED 1",
    IPAddress(192, 168, 1, 30),
    false,
    false
  }

};

Change the names and IP addresses to match your network.

Adding More Devices

Add another entry before the closing };:

{
  "Video Server",
  IPAddress(192, 168, 1, 40),
  false,
  false
},

The software automatically determines how many devices are configured and creates additional OLED pages as needed.

By default, three devices are displayed per page.

Keep device names relatively short so they fit on the 128-pixel-wide OLED.

3. Optional Display Settings

The following settings can also be changed near the top of the sketch:

#define PROJECT_SHORT_NAME "AV MONITOR"

#define OLED_SDA_PIN 21
#define OLED_SCL_PIN 22
#define OLED_ADDRESS 0x3C

PROJECT_SHORT_NAME controls the name displayed at the top of the network status page.

4. Optional Timing Settings

The default timing values are:

#define DEVICES_PER_PAGE 3
#define PAGE_INTERVAL_MS 4000
#define PING_INTERVAL_MS 1500
#define PING_TIMEOUT_MS 500
#define WIFI_CONNECT_TIMEOUT_MS 15000
#define WIFI_RECONNECT_INTERVAL_MS 5000

What They Do

DEVICES_PER_PAGE

Number of monitored devices displayed on each device-status page.

PAGE_INTERVAL_MS

How long each OLED page remains visible before automatically changing.

PING_INTERVAL_MS

How long the ESP32 waits before checking the next device.

PING_TIMEOUT_MS

How long the ESP32 waits for a ping response before considering the device offline.

WIFI_CONNECT_TIMEOUT_MS

How long the initial Wi-Fi connection attempt is allowed to run.

WIFI_RECONNECT_INTERVAL_MS

How frequently the ESP32 attempts to restore a lost Wi-Fi connection.

Values are in milliseconds.

Uploading

Connect the ESP32 to your computer with USB.

In Arduino IDE select:

Tools → Board → ESP32 Arduino → ESP32 Dev Module

Then select the ESP32's serial port.

Click Verify to compile the sketch.

If compilation succeeds, click Upload.

After booting, the OLED should first display the connection process and then begin rotating through the network and device-status pages.

Network Status Page

The first page displays information about the ESP32's own Wi-Fi connection.

Example:

AV MONITOR
----------------
IP 192.168.1.100
RSSI -49 dBm
SIGNAL EXCELLENT
████████████

The RSSI value represents received Wi-Fi signal strength.

The display categorizes signal strength as:

RSSI Display
-55 dBm or better EXCELLENT
-56 to -65 dBm GOOD
-66 to -75 dBm FAIR
Below -75 dBm WEAK

Device Status Pages

Additional pages show the reachability of the configured devices.

Example:

DEVICE STATUS
----------------
Audio Console     OK
Lighting Node     OK
WLED 1           OFF

Status Indicators

OK

The device responded to the most recent ICMP ping.

OFF

The device did not respond before the configured timeout.

...

The device has not yet been checked since the ESP32 booted.

Serial Monitor

Additional diagnostic information is available through Arduino's Serial Monitor.

Set the baud rate to:

115200

You should see output similar to:

Connecting to Production-WiFi
WiFi connected!
ESP32 IP: 192.168.1.100

Checking Audio Console  192.168.1.10
Result: ONLINE

Checking Lighting Node  192.168.1.20
Result: ONLINE

Checking WLED 1  192.168.1.30
Result: OFFLINE

This can be useful when configuring or troubleshooting the monitor.

Important Note About ICMP Ping

A failed ping does not always mean that a device has failed.

Some devices, operating systems, VLAN configurations, and firewalls intentionally block ICMP ping while allowing other network traffic.

This project should therefore be treated as a simple network reachability monitor, not a complete device-health monitoring system.

For many dedicated local AV networks, ICMP provides a quick and useful indication that equipment is reachable.

Security

Wi-Fi credentials are stored directly inside the Arduino sketch.

Do not commit or publish a modified copy containing your real Wi-Fi password.

Before uploading your own version to a public repository, replace:

const char* WIFI_SSID = "YourRealNetwork";
const char* WIFI_PASSWORD = "YourRealPassword";

with:

const char* WIFI_SSID = "YOUR_WIFI_NAME";
const char* WIFI_PASSWORD = "YOUR_WIFI_PASSWORD";

The default repository version should never contain real network credentials.

Troubleshooting

OLED stays blank

Check:

  • VCC is connected to 3.3V
  • GND is connected to GND
  • SDA is connected to GPIO21
  • SCL is connected to GPIO22
  • The OLED is an SSD1306-compatible 128×64 I2C display

Many SSD1306 displays use address 0x3C.

Some displays may use a different I2C address.

ESP32 will not connect to Wi-Fi

Verify the SSID and password in the USER SETTINGS section.

Also confirm that the Wi-Fi network is compatible with the ESP32.

All devices show OFF

Confirm:

  • The ESP32 received an IP address
  • The configured IP addresses are correct
  • The ESP32 and monitored devices can communicate across the network
  • ICMP is not being blocked

You can also open Serial Monitor at 115200 baud to view each check.

Device works but shows OFF

The device may not respond to ICMP ping.

This does not necessarily indicate a device failure.

Project Philosophy

This project is intentionally simple.

The goal is to provide a small, inexpensive, always-visible status display for AV networks without requiring a computer, browser, or dedicated monitoring platform.

Configure the devices, power the ESP32, and leave it running.

Future Ideas

Potential future additions include:

  • Ping latency in milliseconds
  • Packet-loss statistics
  • Gateway monitoring
  • Internet connectivity status
  • Ethernet support
  • Web-based configuration
  • Rotary encoder navigation
  • Manual page selection
  • Device-specific TCP health checks
  • HTTP health checks
  • mDNS hostname support
  • Battery operation
  • Status LEDs
  • 3D-printable enclosure files

Version

v1.0.0

Initial public release.

Features:

  • Wi-Fi connectivity
  • SSD1306 OLED support
  • Local IP display
  • RSSI monitoring
  • Wi-Fi signal-quality display
  • User-configurable device list
  • ICMP device monitoring
  • Automatic device-page generation
  • Automatic page rotation
  • Automatic Wi-Fi reconnection
  • Serial diagnostic output
  • Single-file configuration

License

This project is released under the MIT License.

See LICENSE for details.

About

The ESP32 connects to a wireless network, periodically checks a list of user-defined IP addresses, and displays device status on a small SSD1306 OLED

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages