A lightweight hardware debug console built around an ESP32-C3 SuperMini and a 128×64 SSD1306 OLED.

The idea is to expose useful runtime state directly on the device instead of requiring a serial terminal for every quick check.

Debug demo

Features

  • custom SSD1306 driver using the ESP-IDF I²C master API
  • framebuffer-based rendering
  • Minimal LVGL integration
  • lightweight display abstraction
  • Simple display_printf() function for emebedded status output
  • Example rendering (checkerboard test pattern)
  • minimal hardware setup

Hardware

OLED ESP32-C3
SDA GPIO4
SCL GPIO5
VCC 3V3
GND GND

The default SSD1306 address is 0x3C.

Architecture

ESP32-C3
│
├── LVGL
│
└── Display module
     │
     ├── SSD1306 driver
     │    └── I²C communication
     │
     └── Debug console API
          └── display_printf()

Example:

display_printf("Hello world");
display_printf("Tick %d", counter);

The result is a tiny rolling log/status display that can be useful for bring-up, diagnostics, or standalone demonstrations.

View the source on GitHub