Method createPanelHandle

Drivers/SSD1306/Source/Ssd1306Display.cpp:71–188

}

bool Ssd1306Display::createPanelHandle(esp_lcd_panel_io_handle_t ioHandle, esp_lcd_panel_handle_t& panelHandle) {
    // Manual hardware reset with proper timing for Heltec V3
    if (configuration->resetPin != GPIO_NUM_NC) {
        gpio_config_t reset_gpio_config = {
            .pin_bit_mask = 1ULL << configuration->resetPin,
            .mode = GPIO_MODE_OUTPUT,
            .pull_up_en = GPIO_PULLUP_DISABLE,
            .pull_down_en = GPIO_PULLDOWN_DISABLE,
            .intr_type = GPIO_INTR_DISABLE,
        };
        gpio_config(&reset_gpio_config);
        
        gpio_set_level(configuration->resetPin, 0);
        vTaskDelay(pdMS_TO_TICKS(10));
        gpio_set_level(configuration->resetPin, 1);
        vTaskDelay(pdMS_TO_TICKS(100));
    }

    // Create ESP-IDF panel (but don't call init - we'll do custom init)
    esp_lcd_panel_dev_config_t panel_config = {
        .reset_gpio_num = GPIO_NUM_NC, // Already handled above
        .color_space = ESP_LCD_COLOR_SPACE_MONOCHROME,
        .data_endian = LCD_RGB_DATA_ENDIAN_BIG,
        .bits_per_pixel = 1, // Must be 1 for monochrome
        .flags = {
            .reset_active_high = false,
        },
        .vendor_config = nullptr,
    };

#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 3, 0)
    esp_lcd_panel_ssd1306_config_t ssd1306_config = {
        .height = static_cast<uint8_t>(configuration->verticalResolution),
    };
    panel_config.vendor_config = &ssd1306_config;
#endif

    if (esp_lcd_new_panel_ssd1306(ioHandle, &panel_config, &panelHandle) != ESP_OK) {
        LOGGER.error("Failed to create panel");
        return false;
    }

    // Don't call esp_lcd_panel_init() - it doesn't configure correctly for Heltec V3!
    // Instead, send our custom initialization sequence directly via I2C
    
    auto port = configuration->port;
    auto addr = configuration->deviceAddress;
    
    LOGGER.info("Sending Heltec V3 custom init sequence");

    // Display off while configuring
    ssd1306_i2c_send_cmd(port, addr, SSD1306_CMD_DISPLAY_OFF);

    // Set oscillator frequency (MUST come early in sequence)
    ssd1306_i2c_send_cmd(port, addr, SSD1306_CMD_SET_CLOCK);
    ssd1306_i2c_send_cmd(port, addr, 0xF0); // ~96 Hz

    // Set multiplex ratio