How chfly2024/esp-idf-ssd1306 works
This repository is an ESP-IDF SSD1306/SH1106 display driver with many firmware demos. The usual workflow is an ESP32 demo initializes a configured I2C or SPI interface and panel, then draws text, images, animation, or scrolling content through the driver to an OLED. The driver also provides a framebuffer and drawing operations, with a bundled basic font; BDF fonts and richer graphics are demonstrated separately. Demo-to-driver links are supported by the source index’s include references. Transport implementation details are unsampled, so their dispatch links are shown as unverified.
Main entry points: ssd1306.h Display API · ssd1306.c Drawing and framebuffer · main/main.c BDF fonts · main/main.c Image drawing
Components 23
Display demos
- Text and layout
TextDemo/main/main.c - BDF fonts
BdfFontDemo/main/main.c - FreeType rendering
FreeTypeDemo/main/main.c - Image drawing
ImageDemo/main/main.c - Image motion
ImageMoveDemo/main/main.c - Image rotation
ImageRotationDemo/main/main.c - Image scrolling
ImageScrollDemo/main/main.c - Animation
AnimationDemo/main/main.c - Game graphics
CarRaceDemo/main/main.c - Highway graphics
HighwayDemo/main/main.c - Rotary input demo
RotaryEncoderDemo2/main/main.c - Mouse interaction
MouseIconDemo/main/main.c - Scrolling counters
ScrollCounterDemo/main/main.c
Driver core
- Display API
components/ssd1306/ssd1306.h - Drawing and framebuffer
components/ssd1306/ssd1306.c
Bus transports
- Legacy I2C
components/ssd1306/ssd1306_i2c_legacy.c - New I2C
components/ssd1306/ssd1306_i2c_new.c - SPI transport
components/ssd1306/ssd1306_spi.c
Fonts and assets
- Basic 8x8 font
components/ssd1306/font8x8_basic.h - BDF font assets
BdfFontDemo/main/ncenR12.h - Sprite assets
BdfFontDemo/main/Scroll-o-Sprites.h
Other components
- ESP32 firmware
- SSD1306 / SH1106
Connections 23
- ESP32 firmware → Text and layout: runs example
- Text and layout → Display API: uses API
TextDemo/main/main.c - BDF fonts → Display API: uses API
BdfFontDemo/main/main.c - FreeType rendering → Display API: uses API
FreeTypeDemo/main/main.c - Image drawing → Display API: uses API
ImageDemo/main/main.c - Image motion → Display API: uses API
ImageMoveDemo/main/main.c - Image rotation → Display API: uses API
ImageRotationDemo/main/main.c - Image scrolling → Display API: uses API
ImageScrollDemo/main/main.c - Animation → Display API: uses API
AnimationDemo/main/main.c - Game graphics → Display API: uses API
CarRaceDemo/main/main.c - Highway graphics → Display API: uses API
HighwayDemo/main/main.c - Rotary input demo → Display API: uses API
RotaryEncoderDemo2/main/main.c - Mouse interaction → Display API: uses API
MouseIconDemo/main/main.c - Scrolling counters → Display API: uses API
ScrollCounterDemo/main/main.c - Display API → Drawing and framebuffer: exposes operations
components/ssd1306/ssd1306.c - Drawing and framebuffer → Basic 8x8 font: uses font data
components/ssd1306/ssd1306.c - Drawing and framebuffer → SSD1306 / SH1106: updates display
- Drawing and framebuffer → Legacy I2C: dispatches I2C
- Drawing and framebuffer → New I2C: dispatches I2C
- Drawing and framebuffer → SPI transport: dispatches SPI
- BDF fonts → BDF font assets: loads font data
BdfFontDemo/main/main.c - BDF fonts → Sprite assets: uses sprites
BdfFontDemo/main/main.c - Image drawing → Basic 8x8 font: uses font data
ImageDemo/main/main.c