/*############################################################################# ## Author: Shaun Reed ## ## Legal: All Content (c) 2025 Shaun Reed, all rights reserved ## ## ## ## Contact: shaunrd0@gmail.com | URL: www.shaunreed.com ## ############################################################################## */ #ifndef SSD1306_H #define SSD1306_H #include // According to specific display hardware. // https://www.digikey.com/en/products/detail/winstar-display/WEA012864DWPP3N00003/20533255 #define SCREEN_WIDTH 128 // OLED display width, in pixels. #define SCREEN_HEIGHT 64 // OLED display height, in pixels. // According to SSD1306 datasheet. // https://cdn-shop.adafruit.com/datasheets/SSD1306.pdf #define I2C_HW_ADDR 0x3C #define LCD_PIXEL_CLOCK_HZ (400 * 1000) // Bit number used to represent command and parameter #define LCD_CMD_BITS 8 #define LCD_PARAM_BITS 8 /** * Example of implementing the IPanelDevice interface for SSD1306 LCD device. */ struct SSD1306 { /// SSD1306 configuration structure. esp_lcd_panel_ssd1306_config_t ssd1306_config_; }; /// Initializes the ESP LCD panel handle for the SSD1306 device. void SSD1306_init_panel(esp_lcd_panel_dev_config_t &config, esp_lcd_panel_io_handle_t io, esp_lcd_panel_handle_t &panel) override { ESP_ERROR_CHECK(esp_lcd_new_panel_ssd1306(io, &config, &panel)); } /** * Construct a new SSD1306 device. * * @param i2c I2C master bus to manage this device. */ void SSD1306_init(i2c_master_bus_handle_t &i2c) { SSD1306_config_init(i2c, {.height = SCREEN_HEIGHT}, SCREEN_WIDTH, SCREEN_HEIGHT) } /** * Construct a new SSD1306 device given a specific SSD1306 configuration. * * @param i2c I2C master bus to manage this device. * @param vendor_config SSD1306 vendor configuration. * @param width Width of the device screen in pixels. * @param height Height of the device screen in pixels. */ SSD1306_config_init(//TODO: panel_device_t* device, i2c_master_bus_handle_t &i2c, esp_lcd_panel_ssd1306_config_t vendor_config, int width, int height ) { /* TODO: device->init_panel( i2c, vendor_config, (esp_lcd_panel_io_i2c_config_t) { .dev_addr = I2C_HW_ADDR, // User data to pass to the LVGL flush_ready callback. // See IPanelDevice::lvgl_flush_ready_cb .user_ctx = nullptr, .control_phase_bytes = 1, .dc_bit_offset = 6, .lcd_cmd_bits = LCD_CMD_BITS, .lcd_param_bits = LCD_PARAM_BITS, .scl_speed_hz = LCD_PIXEL_CLOCK_HZ, }, width, height ) */ } /** * Provides the SSD1306 vendor configuration to IPanelDevice consumers. * * @return Address of the SSD1306 vendor configuration structure. */ void *SSD1306_vendor_config() override { return &ssd1306_config_; } #endif // SSD1306_H