feat(examples): show the usage of 'configVendorCommands()' function in esp_idf/lvgl_v8_port @martinroger (#217)

#217

Author: Lzw655

CHANGELOG.md

@@ -1,12 +1,13 @@
 # ChangeLog
 
-## v1.0.3 - 2025-04-27
+## v1.0.3 - 2025-07-07
 
 ### Enhancements:
 
 * feat(docs): provides an example of how to integrate this library into micropython by @tsteinruecken (#190)
 * feat(board): add board Waveshare:ESP32_S3_TOUCH_LCD_1_85_C @hegdi (#208)
 * feat(board & touch):add new supported viewe board and cst820 touch @VIEWESMART (#197)
+* feat(examples): show the usage of 'configVendorCommands()' function in esp_idf/lvgl_v8_port @martinroger (#217)
 
 ### Bugfixes:
 

examples/esp_idf/lvgl_v8_port/main/main.cpp

@@ -11,10 +11,21 @@
 #include "lvgl_v8_port.h"
 #include "lv_demos.h"
 
+#define EXAMPLE_LCD_USE_EXTERNAL_INIT_CMD   (0)
+
 using namespace esp_panel::drivers;
 using namespace esp_panel::board;
 
 static const char *TAG = "example";
+#if EXAMPLE_LCD_USE_EXTERNAL_INIT_CMD
+static const esp_panel_lcd_vendor_init_cmd_t external_init_cmd[] = {
+//  {cmd, { data }, data_size, delay_ms}
+    // {0xFF, (uint8_t []){0x77, 0x01, 0x00, 0x00, 0x13}, 5, 0},
+    // {0xEF, (uint8_t []){0x08}, 1, 0},
+    // {0xFF, (uint8_t []){0x77, 0x01, 0x00, 0x00, 0x10}, 5, 0},
+    // ...
+};
+#endif // EXAMPLE_LCD_USE_EXTERNAL_INIT_CMD
 
 extern "C" void app_main()
 {
@@ -23,22 +34,41 @@ extern "C" void app_main()
 
     ESP_LOGI(TAG, "Initializing board");
     ESP_UTILS_CHECK_FALSE_EXIT(board->init(), "Board init failed");
+
 #if LVGL_PORT_AVOID_TEARING_MODE
-    auto lcd = board->getLCD();
-    // When avoid tearing function is enabled, the frame buffer number should be set in the board driver
-    lcd->configFrameBufferNumber(LVGL_PORT_DISP_BUFFER_NUM);
-#if ESP_PANEL_DRIVERS_BUS_ENABLE_RGB && CONFIG_IDF_TARGET_ESP32S3
-    auto lcd_bus = lcd->getBus();
+    {
+        auto lcd = board->getLCD();
+        // When avoid tearing function is enabled, the frame buffer number should be set in the board driver
+        lcd->configFrameBufferNumber(LVGL_PORT_DISP_BUFFER_NUM);
+#   if ESP_PANEL_DRIVERS_BUS_ENABLE_RGB && CONFIG_IDF_TARGET_ESP32S3
+        auto lcd_bus = lcd->getBus();
+        /**
+         * As the anti-tearing feature typically consumes more PSRAM bandwidth, for the ESP32-S3, we need to utilize the
+         * "bounce buffer" functionality to enhance the RGB data bandwidth.
+         * This feature will consume `bounce_buffer_size * bytes_per_pixel * 2` of SRAM memory.
+         */
+        if (lcd_bus->getBasicAttributes().type == ESP_PANEL_BUS_TYPE_RGB) {
+            static_cast<BusRGB *>(lcd_bus)->configRGB_BounceBufferSize(lcd->getFrameWidth() * 10);
+        }
+#   endif
+    }
+#endif // LVGL_PORT_AVOID_TEARING_MODE
+
+#if EXAMPLE_LCD_USE_EXTERNAL_INIT_CMD
+    ESP_LOGI(TAG, "Using external LCD init command");
+    {
+        auto lcd = board->getLCD();
+        ESP_UTILS_CHECK_FALSE_EXIT(
+            lcd->configVendorCommands(external_init_cmd, sizeof(external_init_cmd) / sizeof(external_init_cmd[0])),
+            "LCD init failed"
+        );
+    }
     /**
-     * As the anti-tearing feature typically consumes more PSRAM bandwidth, for the ESP32-S3, we need to utilize the
-     * "bounce buffer" functionality to enhance the RGB data bandwidth.
-     * This feature will consume `bounce_buffer_size * bytes_per_pixel * 2` of SRAM memory.
+     * In addition, you can also get handles to any other devices (like touch) and use `config*()` functions to
+     * configure or replace default parameters, but this must be completed before `board->begin()`
      */
-    if (lcd_bus->getBasicAttributes().type == ESP_PANEL_BUS_TYPE_RGB) {
-        static_cast<BusRGB *>(lcd_bus)->configRGB_BounceBufferSize(lcd->getFrameWidth() * 10);
-    }
-#endif
-#endif
+#endif // EXAMPLE_LCD_USE_EXTERNAL_INIT_CMD
+
     ESP_UTILS_CHECK_FALSE_EXIT(board->begin(), "Board begin failed");
 
     ESP_LOGI(TAG, "Initializing LVGL");