OLED Device Interface

Module: OLED Display Driver

Device-specific descriptors and configurations for OLED drivers. More...

Files

Name
lib/oled/driver/device/device_interface.h Generic device descriptor used by OLED drivers.
lib/oled/driver/device/ssd1306/ssd1306.h SSD1306 device-specific descriptor and factory.
lib/oled/driver/device/ssd1309/ssd1309.h SSD1309 device-specific descriptor and factory.

Classes

	Name
struct	CFBD_OLED_DeviceSpecific Device-specific configuration for an OLED panel.

Defines

	Name
	SSD1309_DRIVER_ADDRESS Default I2C address for SSD1309 devices.

Detailed Description

Device-specific descriptors and configurations for OLED drivers.

See:

• ssd1306.hfor SSD1306 implementation
• ssd1309.hfor SSD1309 implementation

This module provides the generic device descriptor interface used by all OLED drivers. It abstracts hardware-specific details into a standardized structure that concrete device implementations (SSD1306, SSD1309, etc.) populate with device-specific data.

Device drivers must provide:

• Initialization command tables
• GRAM/frame buffer pointers
• Communication prefixes (for I2C data/command differentiation)

• Display geometry information

• • Hierarchical module organization
• • Cross-references to device implementations
• • Module relationships
• • Structure Documentation:
• • CFBD_OLED_DeviceSpecific: Comprehensive documentation with:
• • Field descriptions
• • Implementation requirements
• • Usage examples

Device Driver Enhancements

• • ssd1306.h:
• • Extended file documentation with SSD1306 capabilities
• • getSSD1306Specific(): Complete factory function documentation
• • Usage examples and cross-references
• • ssd1309.h:
• • Extended file documentation with SSD1309 enhancements
• • SSD1309_DRIVER_ADDRESS: Address constant documentation
• • getSSD1309Specific(): Comprehensive factory documentation
• • Multi-example usage patterns

oled_iic.h Enhancements

• • **New

Macros Documentation

define SSD1309_DRIVER_ADDRESS

#define SSD1309_DRIVER_ADDRESS (0x78)

Default I2C address for SSD1309 devices.

Note: This address is used when initializing I2C communication with the SSD1309 device.

The standard I2C address for SSD1309 OLED controllers is 0x78 (0111 1000). This is the primary address used for single-device configurations. Some modules may support alternative addresses via hardware configuration.

---

Updated on 2026-02-03 at 13:21:55 +0000