feat(test_apps): add lcd mip_dsi

Lzw655 · Lzw655 · commit af6f1e038710 · 2024-11-07T16:42:45.000+08:00
diff --git a/test_apps/lcd/mipi_dsi/CMakeLists.txt b/test_apps/lcd/mipi_dsi/CMakeLists.txt
@@ -0,0 +1,5 @@
+# The following lines of boilerplate have to be in your project's CMakeLists
+# in this exact order for cmake to work correctly
+cmake_minimum_required(VERSION 3.5)
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+project(mipi_dsi_lcd_test)
diff --git a/test_apps/lcd/mipi_dsi/main/CMakeLists.txt b/test_apps/lcd/mipi_dsi/main/CMakeLists.txt
@@ -0,0 +1,5 @@
+idf_component_register(
+    SRCS "test_app_main.c" "test_mipi_dsi_lcd.cpp"
+    PRIV_REQUIRES esp_lcd driver esp_timer
+    WHOLE_ARCHIVE
+)
diff --git a/test_apps/lcd/mipi_dsi/main/idf_component.yml b/test_apps/lcd/mipi_dsi/main/idf_component.yml
@@ -0,0 +1,9 @@
+## IDF Component Manager Manifest File
+dependencies:
+  test_utils:
+    path: ${IDF_PATH}/tools/unit-test-app/components/test_utils
+  test_driver_utils:
+    path: ${IDF_PATH}/components/driver/test_apps/components/test_driver_utils
+  ESP32_Display_Panel:
+    version: "*"
+    override_path: "../../../../../ESP32_Display_Panel"
diff --git a/test_apps/lcd/mipi_dsi/main/test_app_main.c b/test_apps/lcd/mipi_dsi/main/test_app_main.c
@@ -0,0 +1,63 @@
+/*
+ * SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: CC0-1.0
+ */
+#include <inttypes.h>
+#include "freertos/FreeRTOS.h"
+#include "freertos/task.h"
+#include "esp_heap_caps.h"
+#include "unity.h"
+#include "unity_test_runner.h"
+
+// Some resources are lazy allocated in the LCD driver, the threadhold is left for that case
+#define TEST_MEMORY_LEAK_THRESHOLD (-300)
+
+static size_t before_free_8bit;
+static size_t before_free_32bit;
+
+static void check_leak(size_t before_free, size_t after_free, const char *type)
+{
+    ssize_t delta = after_free - before_free;
+    printf("MALLOC_CAP_%s: Before %u bytes free, After %u bytes free (delta %d)\n", type, before_free, after_free, delta);
+    TEST_ASSERT_MESSAGE(delta >= TEST_MEMORY_LEAK_THRESHOLD, "memory leak");
+}
+
+void setUp(void)
+{
+    before_free_8bit = heap_caps_get_free_size(MALLOC_CAP_8BIT);
+    before_free_32bit = heap_caps_get_free_size(MALLOC_CAP_32BIT);
+}
+
+void tearDown(void)
+{
+    size_t after_free_8bit = heap_caps_get_free_size(MALLOC_CAP_8BIT);
+    size_t after_free_32bit = heap_caps_get_free_size(MALLOC_CAP_32BIT);
+    check_leak(before_free_8bit, after_free_8bit, "8BIT");
+    check_leak(before_free_32bit, after_free_32bit, "32BIT");
+}
+
+void app_main(void)
+{
+    /**
+     *  __       __  ______  _______  ______        _______    ______   ______        __        ______   _______
+     * |  \     /  \|      \|       \|      \      |       \  /      \ |      \      |  \      /      \ |       \
+     * | $$\   /  $$ \$$$$$$| $$$$$$$\\$$$$$$      | $$$$$$$\|  $$$$$$\ \$$$$$$      | $$     |  $$$$$$\| $$$$$$$\
+     * | $$$\ /  $$$  | $$  | $$__/ $$ | $$ ______ | $$  | $$| $$___\$$  | $$        | $$     | $$   \$$| $$  | $$
+     * | $$$$\  $$$$  | $$  | $$    $$ | $$|      \| $$  | $$ \$$    \   | $$        | $$     | $$      | $$  | $$
+     * | $$\$$ $$ $$  | $$  | $$$$$$$  | $$ \$$$$$$| $$  | $$ _\$$$$$$\  | $$        | $$     | $$   __ | $$  | $$
+     * | $$ \$$$| $$ _| $$_ | $$      _| $$_       | $$__/ $$|  \__| $$ _| $$_       | $$_____| $$__/  \| $$__/ $$
+     * | $$  \$ | $$|   $$ \| $$     |   $$ \      | $$    $$ \$$    $$|   $$ \      | $$     \\$$    $$| $$    $$
+     *  \$$      \$$ \$$$$$$ \$$      \$$$$$$       \$$$$$$$   \$$$$$$  \$$$$$$       \$$$$$$$$ \$$$$$$  \$$$$$$$
+     */
+    printf("     __       __  ______  _______  ______        _______    ______   ______        __        ______   _______\r\n");
+    printf("|  \\     /  \\|      \\|       \\|      \\      |       \\  /      \\ |      \\      |  \\      /      \\ |       \\\r\n");
+    printf("| $$\\   /  $$ \\$$$$$$| $$$$$$$\\\\$$$$$$      | $$$$$$$\\|  $$$$$$\\ \\$$$$$$      | $$     |  $$$$$$\\| $$$$$$$\\\r\n");
+    printf("| $$$\\ /  $$$  | $$  | $$__/ $$ | $$ ______ | $$  | $$| $$___\\$$  | $$        | $$     | $$   \\$$| $$  | $$\r\n");
+    printf("| $$$$\\  $$$$  | $$  | $$    $$ | $$|      \\| $$  | $$ \\$$    \\   | $$        | $$     | $$      | $$  | $$\r\n");
+    printf("| $$\\$$ $$ $$  | $$  | $$$$$$$  | $$ \\$$$$$$| $$  | $$ _\\$$$$$$\\  | $$        | $$     | $$   __ | $$  | $$\r\n");
+    printf("| $$ \\$$$| $$ _| $$_ | $$      _| $$_       | $$__/ $$|  \\__| $$ _| $$_       | $$_____| $$__/  \\| $$__/ $$\r\n");
+    printf("| $$  \\$ | $$|   $$ \\| $$     |   $$ \\      | $$    $$ \\$$    $$|   $$ \\      | $$     \\\\$$    $$| $$    $$\r\n");
+    printf(" \\$$      \\$$ \\$$$$$$ \\$$      \\$$$$$$       \\$$$$$$$   \\$$$$$$  \\$$$$$$       \\$$$$$$$$ \\$$$$$$  \\$$$$$$$\r\n");
+    unity_run_menu();
+}
diff --git a/test_apps/lcd/mipi_dsi/main/test_mipi_dsi_lcd.cpp b/test_apps/lcd/mipi_dsi/main/test_mipi_dsi_lcd.cpp
@@ -0,0 +1,239 @@
+/*
+ * SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: CC0-1.0
+ */
+#include <memory>
+#include "freertos/FreeRTOS.h"
+#include "freertos/task.h"
+#include "esp_heap_caps.h"
+#include "esp_log.h"
+#include "esp_timer.h"
+#include "unity.h"
+#include "unity_test_runner.h"
+#include "ESP_Panel_Library.h"
+
+using namespace std;
+
+/* The following default configurations are for the board 'Espressif: ESP32-P4-Function-EV-Board, EK79007' */
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+//////////////////// Please update the following configuration according to your LCD spec //////////////////////////////
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#define TEST_LCD_WIDTH                  (1024)
+#define TEST_LCD_HEIGHT                 (600)
+#define TEST_LCD_COLOR_BITS             (ESP_PANEL_LCD_RGB888_COLOR_BITS_24)
+#define TEST_LCD_DSI_PHY_LDO_ID         (3)
+#define TEST_LCD_DSI_LANE_NUM           (2)
+#define TEST_LCD_DSI_LANE_RATE_MBPS     (1000)
+#define TEST_LCD_DPI_CLK_MHZ            (52)
+#define TEST_LCD_DPI_COLOR_BITS         (ESP_PANEL_LCD_RGB888_COLOR_BITS_24)
+#define TEST_LCD_DPI_HPW                (10)
+#define TEST_LCD_DPI_HBP                (160)
+#define TEST_LCD_DPI_HFP                (160)
+#define TEST_LCD_DPI_VPW                (1)
+#define TEST_LCD_DPI_VBP                (23)
+#define TEST_LCD_DPI_VFP                (12)
+#define TEST_LCD_USE_EXTERNAL_CMD       (0)
+#if TEST_LCD_USE_EXTERNAL_CMD
+/**
+ * LCD initialization commands.
+ *
+ * Vendor specific initialization can be different between manufacturers, should consult the LCD supplier for
+ * initialization sequence code.
+ *
+ * Please uncomment and change the following macro definitions, then use `configVendorCommands()` to pass them in the
+ * same format if needed. Otherwise, the LCD driver will use the default initialization sequence code.
+ *
+ * There are two formats for the sequence code:
+ *   1. Raw data: {command, (uint8_t []){ data0, data1, ... }, data_size, delay_ms}
+ *   2. Formatter: ESP_PANEL_LCD_CMD_WITH_8BIT_PARAM(delay_ms, command, { data0, data1, ... }) and
+ *                ESP_PANEL_LCD_CMD_WITH_NONE_PARAM(delay_ms, command)
+ */
+const esp_lcd_panel_vendor_init_cmd_t lcd_init_cmd[] = {
+    // {0xFF, (uint8_t []){0x77, 0x01, 0x00, 0x00, 0x10}, 5, 0},
+    // {0xC0, (uint8_t []){0x3B, 0x00}, 2, 0},
+    // {0xC1, (uint8_t []){0x0D, 0x02}, 2, 0},
+    // {0x29, (uint8_t []){0x00}, 0, 120},
+    // // or
+    ESP_PANEL_LCD_CMD_WITH_8BIT_PARAM(0, 0xFF, {0x77, 0x01, 0x00, 0x00, 0x10}),
+    ESP_PANEL_LCD_CMD_WITH_8BIT_PARAM(0, 0xC0, {0x3B, 0x00}),
+    ESP_PANEL_LCD_CMD_WITH_8BIT_PARAM(0, 0xC1, {0x0D, 0x02}),
+    ESP_PANEL_LCD_CMD_WITH_NONE_PARAM(120, 0x29),
+};
+#endif
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+//////////////////// Please update the following configuration according to your board spec ////////////////////////////
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#define TEST_LCD_PIN_NUM_RST            (27)    // Set to -1 if not used
+#define TEST_LCD_PIN_NUM_BK_LIGHT       (26)    // Set to -1 if not used
+#define TEST_LCD_BK_LIGHT_ON_LEVEL      (1)
+#define TEST_LCD_BK_LIGHT_OFF_LEVEL     !TEST_LCD_BK_LIGHT_ON_LEVEL
+
+/* Enable or disable pattern test */
+#define TEST_ENABLE_PATTERN_TEST        (1)
+/* Enable or disable printing LCD refresh rate */
+#define TEST_ENABLE_PRINT_LCD_FPS       (1)
+#define TEST_PRINT_LCD_FPS_PERIOD_MS    (1000)
+/* Enable or disable the attachment of a callback function that is called after each bitmap drawing is completed */
+#define TEST_ENABLE_ATTACH_CALLBACK     (1)
+#define TEST_COLOR_BAR_SHOW_TIME_MS     (5000)
+
+#define delay(ms)                       vTaskDelay(pdMS_TO_TICKS(ms))
+
+static const char *TAG = "test_spi_lcd";
+
+static shared_ptr<ESP_PanelBacklight> init_backlight(void)
+{
+#if TEST_LCD_PIN_NUM_BK_LIGHT >= 0
+    ESP_LOGI(TAG, "Initialize backlight control pin and turn it on");
+    shared_ptr<ESP_PanelBacklight> backlight = make_shared<ESP_PanelBacklight>(
+                TEST_LCD_PIN_NUM_BK_LIGHT, TEST_LCD_BK_LIGHT_ON_LEVEL, true
+            );
+    TEST_ASSERT_NOT_NULL_MESSAGE(backlight, "Create backlight object failed");
+
+    TEST_ASSERT_TRUE_MESSAGE(backlight->begin(), "Backlight begin failed");
+    TEST_ASSERT_TRUE_MESSAGE(backlight->on(), "Backlight on failed");
+
+    return backlight;
+#else
+    return nullptr;
+#endif
+}
+
+static shared_ptr<ESP_PanelBus_DSI> init_panel_bus(void)
+{
+    ESP_LOGI(TAG, "Create LCD bus");
+    shared_ptr<ESP_PanelBus_DSI> panel_bus = make_shared<ESP_PanelBus_DSI>(
+                TEST_LCD_DSI_LANE_NUM, TEST_LCD_DSI_LANE_RATE_MBPS,
+                TEST_LCD_DPI_CLK_MHZ, TEST_LCD_DPI_COLOR_BITS, TEST_LCD_WIDTH, TEST_LCD_HEIGHT,
+                TEST_LCD_DPI_HPW, TEST_LCD_DPI_HBP, TEST_LCD_DPI_HFP,
+                TEST_LCD_DPI_VPW, TEST_LCD_DPI_VBP, TEST_LCD_DPI_VFP,
+                TEST_LCD_DSI_PHY_LDO_ID
+            );
+    TEST_ASSERT_NOT_NULL_MESSAGE(panel_bus, "Create panel bus object failed");
+
+    TEST_ASSERT_TRUE_MESSAGE(panel_bus->begin(), "Panel bus begin failed");
+
+    return panel_bus;
+}
+
+#if TEST_ENABLE_ATTACH_CALLBACK
+IRAM_ATTR static bool onDrawBitmapFinishCallback(void *user_data)
+{
+    esp_rom_printf("Draw bitmap finish callback\n");
+
+    return false;
+}
+#endif
+
+#if TEST_ENABLE_PRINT_LCD_FPS
+#define TEST_LCD_FPS_COUNT_MAX  (100)
+#ifndef millis
+#define millis()                (esp_timer_get_time() / 1000)
+#endif
+
+DRAM_ATTR int frame_count = 0;
+DRAM_ATTR int fps = 0;
+DRAM_ATTR long start_time = 0;
+
+IRAM_ATTR bool onVsyncEndCallback(void *user_data)
+{
+    long frame_start_time = *(long *)user_data;
+    if (frame_start_time == 0) {
+        (*(long *)user_data) = millis();
+
+        return false;
+    }
+
+    frame_count++;
+    if (frame_count >= TEST_LCD_FPS_COUNT_MAX) {
+        fps = TEST_LCD_FPS_COUNT_MAX * 1000 / (millis() - frame_start_time);
+        frame_count = 0;
+        (*(long *)user_data) = millis();
+    }
+
+    return false;
+}
+#endif
+
+static void run_test(shared_ptr<ESP_PanelLcd> lcd)
+{
+    frame_count = 0;
+    fps = 0;
+    start_time = 0;
+
+#if TEST_LCD_USE_EXTERNAL_CMD
+    // Configure external initialization commands, should called before `init()`
+    lcd->configVendorCommands(lcd_init_cmd, sizeof(lcd_init_cmd) / sizeof(lcd_init_cmd[0]));
+#endif
+    TEST_ASSERT_TRUE_MESSAGE(lcd->init(), "LCD init failed");
+    TEST_ASSERT_TRUE_MESSAGE(lcd->reset(), "LCD reset failed");
+    TEST_ASSERT_TRUE_MESSAGE(lcd->begin(), "LCD begin failed");
+    TEST_ASSERT_TRUE_MESSAGE(lcd->displayOn(), "LCD display on failed");
+
+#if TEST_ENABLE_PATTERN_TEST
+    ESP_LOGI(TAG, "Show MIPI-DSI patterns");
+    TEST_ASSERT_TRUE_MESSAGE(
+        lcd->showDsiPattern(ESP_PanelLcd::DsiPatternType::BAR_HORIZONTAL), "MIPI DPI bar horizontal pattern test failed"
+    );
+    delay(1000);
+    TEST_ASSERT_TRUE_MESSAGE(
+        lcd->showDsiPattern(ESP_PanelLcd::DsiPatternType::BAR_VERTICAL), "MIPI DPI bar vertical pattern test failed"
+    );
+    delay(1000);
+    TEST_ASSERT_TRUE_MESSAGE(
+        lcd->showDsiPattern(ESP_PanelLcd::DsiPatternType::BER_VERTICAL), "MIPI DPI ber vertical pattern test failed"
+    );
+    delay(1000);
+    TEST_ASSERT_TRUE_MESSAGE(
+        lcd->showDsiPattern(ESP_PanelLcd::DsiPatternType::NONE), "MIPI DPI none pattern test failed"
+    );
+#endif
+#if TEST_ENABLE_ATTACH_CALLBACK
+    TEST_ASSERT_TRUE_MESSAGE(
+        lcd->attachDrawBitmapFinishCallback(onDrawBitmapFinishCallback, nullptr), "Attach callback failed"
+    );
+#endif
+#if TEST_ENABLE_PRINT_LCD_FPS
+    TEST_ASSERT_TRUE_MESSAGE(
+        lcd->attachRefreshFinishCallback(onVsyncEndCallback, (void *)&start_time), "Attach refresh callback failed"
+    );
+#endif
+
+    ESP_LOGI(TAG, "Draw color bar from top left to bottom right, the order is B - G - R");
+    TEST_ASSERT_TRUE_MESSAGE(lcd->colorBarTest(TEST_LCD_WIDTH, TEST_LCD_HEIGHT), "LCD color bar test failed");
+
+    ESP_LOGI(TAG, "Wait for %d ms to show the color bar", TEST_COLOR_BAR_SHOW_TIME_MS);
+#if TEST_ENABLE_PRINT_LCD_FPS
+    int i = 0;
+    while (i++ < TEST_COLOR_BAR_SHOW_TIME_MS / TEST_PRINT_LCD_FPS_PERIOD_MS) {
+        ESP_LOGI(TAG, "FPS: %d", fps);
+        vTaskDelay(pdMS_TO_TICKS(TEST_PRINT_LCD_FPS_PERIOD_MS));
+    }
+#else
+    vTaskDelay(pdMS_TO_TICKS(TEST_COLOR_BAR_SHOW_TIME_MS));
+#endif
+}
+
+#define CREATE_LCD(name, panel_bus) \
+    ({ \
+        ESP_LOGI(TAG, "Create LCD device: " #name); \
+        shared_ptr<ESP_PanelLcd> lcd = make_shared<ESP_PanelLcd_##name>(panel_bus, TEST_LCD_COLOR_BITS, TEST_LCD_PIN_NUM_RST); \
+        TEST_ASSERT_NOT_NULL_MESSAGE(lcd, "Create LCD object failed"); \
+        lcd; \
+    })
+#define CREATE_TEST_CASE(name) \
+    TEST_CASE("Test LCD (" #name ") to draw color bar", "[spi_lcd][" #name "]") \
+    { \
+        shared_ptr<ESP_PanelBacklight> backlight = init_backlight(); \
+        shared_ptr<ESP_PanelBus_DSI> panel_bus = init_panel_bus(); \
+        shared_ptr<ESP_PanelLcd> lcd = CREATE_LCD(name, panel_bus.get()); \
+        run_test(lcd); \
+    }
+
+/**
+ * Here to create test cases for different LCDs
+ *
+ */
+CREATE_TEST_CASE(EK79007)
diff --git a/test_apps/lcd/mipi_dsi/sdkconfig.defaults b/test_apps/lcd/mipi_dsi/sdkconfig.defaults
@@ -0,0 +1,2 @@
+CONFIG_ESP_TASK_WDT_INIT=n
+CONFIG_FREERTOS_HZ=1000
diff --git a/test_apps/lcd/mipi_dsi/sdkconfig.defaults.esp32p4 b/test_apps/lcd/mipi_dsi/sdkconfig.defaults.esp32p4
@@ -0,0 +1,5 @@
+CONFIG_SPIRAM=y
+CONFIG_SPIRAM_MODE_HEX=y
+CONFIG_SPIRAM_SPEED_200M=y
+CONFIG_SPIRAM_XIP_FROM_PSRAM=y
+CONFIG_IDF_EXPERIMENTAL_FEATURES=y

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+CONFIG_ESP_TASK_WDT_INIT=n`
	`2`	`+CONFIG_FREERTOS_HZ=1000`