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.
- 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
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
- 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.
| 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.
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.
Install the following through:
Arduino IDE → Library Manager
Search for:
Adafruit SSD1306
Install the library by Adafruit.
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.
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.
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";Find:
Device devices[] = {Each entry contains:
- The name shown on the OLED
- The device's IPv4 address
- Internal online status
- 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.
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.
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 0x3CPROJECT_SHORT_NAME controls the name displayed at the top of the network status page.
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 5000DEVICES_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.
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.
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 |
Additional pages show the reachability of the configured devices.
Example:
DEVICE STATUS
----------------
Audio Console OK
Lighting Node OK
WLED 1 OFF
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.
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.
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.
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.
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.
Verify the SSID and password in the USER SETTINGS section.
Also confirm that the Wi-Fi network is compatible with the ESP32.
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.
The device may not respond to ICMP ping.
This does not necessarily indicate a device failure.
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.
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
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
This project is released under the MIT License.
See LICENSE for details.