feat(lcd): add LCD controller ILI9881C

Author: Lzw655

examples/LCD/MIPI_DSI/MIPI_DSI.ino

@@ -2,8 +2,8 @@
  * | Supported ESP SoCs | ESP32-P4 |
  * | ------------------ | -------- |
  *
- * | Supported LCD Controllers | EK79007 |
- * | ------------------------- | ------- |
+ * | Supported LCD Controllers | EK79007 | ILI9881C |
+ * | ------------------------- | ------- | -------- |
  *
  * # MIPI-DSI LCD Example
  *
@@ -73,7 +73,7 @@
 ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
 /**
  * Currently, the library supports the following MIPI-DSI LCDs:
- *      - EK79007
+ *      - EK79007, ILI9881C
  */
 #define EXAMPLE_LCD_NAME                EK79007
 #define EXAMPLE_LCD_WIDTH               (1024)

examples/LCD/MIPI_DSI/README.md

@@ -1,8 +1,8 @@
 | Supported ESP SoCs | ESP32-P4 |
 | ------------------ | -------- |
 
-| Supported LCD Controllers | EK79007 |
-| ------------------------- | ------- |
+| Supported LCD Controllers | EK79007 | ILI9881C |
+| ------------------------- | ------- | -------- |
 
 # MIPI-DSI LCD Example
 

src/ESP_Panel_Library.h

@@ -31,6 +31,7 @@
 #include "lcd/GC9A01.h"
 #include "lcd/GC9B71.h"
 #include "lcd/ILI9341.h"
+#include "lcd/ILI9881C.h"
 #include "lcd/NV3022B.h"
 #include "lcd/SH8601.h"
 #include "lcd/SPD2010.h"

src/lcd/ILI9881C.cpp

@@ -0,0 +1,56 @@
+/*
+ * SPDX-FileCopyrightText: 2023-2024 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include "soc/soc_caps.h"
+
+#if SOC_MIPI_DSI_SUPPORTED
+#include "ESP_PanelLog.h"
+#include "ILI9881C.h"
+
+static const char *TAG = "ILI9881C_CPP";
+
+ESP_PanelLcd_ILI9881C::ESP_PanelLcd_ILI9881C(ESP_PanelBus *bus, uint8_t color_bits, int rst_io):
+    ESP_PanelLcd(bus, color_bits, rst_io)
+{
+    disabled_functions.set_gap = 1;
+    disabled_functions.swap_xy = 1;
+}
+
+ESP_PanelLcd_ILI9881C::ESP_PanelLcd_ILI9881C(ESP_PanelBus *bus, const esp_lcd_panel_dev_config_t &panel_config):
+    ESP_PanelLcd(bus, panel_config)
+{
+    disabled_functions.set_gap = 1;
+    disabled_functions.swap_xy = 1;
+}
+
+ESP_PanelLcd_ILI9881C::~ESP_PanelLcd_ILI9881C()
+{
+    ESP_PANEL_ENABLE_TAG_DEBUG_LOG();
+
+    if (handle == NULL) {
+        goto end;
+    }
+
+    if (!del()) {
+        ESP_LOGE(TAG, "Delete device failed");
+    }
+
+end:
+    ESP_LOGD(TAG, "Destroyed");
+}
+
+bool ESP_PanelLcd_ILI9881C::init(void)
+{
+    ESP_PANEL_CHECK_NULL_RET(bus, false, "Invalid bus");
+
+    ESP_PANEL_CHECK_ERR_RET(
+        esp_lcd_new_panel_ili9881c(bus->getPanelIO_Handle(), &panel_config, &handle), false, "Create panel failed"
+    );
+
+    return true;
+}
+
+#endif

src/lcd/ILI9881C.h

@@ -0,0 +1,59 @@
+/*
+ * SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+#pragma once
+
+#include "soc/soc_caps.h"
+
+#if SOC_MIPI_DSI_SUPPORTED
+#include "ESP_PanelLcd.h"
+#include "base/esp_lcd_vendor_types.h"
+#include "base/esp_lcd_ili9881c.h"
+
+/**
+ * @brief ILI9881C LCD device object class
+ *
+ * @note  This class is a derived class of `ESP_PanelLcd`, user can use it directly
+ */
+class ESP_PanelLcd_ILI9881C: public ESP_PanelLcd {
+public:
+    /**
+     * @brief Construct a new LCD device in a simple way, the `init()` function should be called after this function
+     *
+     * @note  This function uses some default values to config the LCD device, please use `config*()` functions to
+     *        change them
+     * @note  Vendor specific initialization can be different between manufacturers, should consult the LCD supplier
+     *        for initialization sequence code, and use `configVendorCommands()` to configure
+     *
+     * @param bus           Pointer of panel bus
+     * @param color_bits    Bits per pixel (16/18/24)
+     * @param rst_io        Reset pin, set to -1 if no use
+     */
+    ESP_PanelLcd_ILI9881C(ESP_PanelBus *bus, uint8_t color_bits, int rst_io = -1);
+
+    /**
+     * @brief Construct a new LCD in a complex way, the `init()` function should be called after this function
+     *
+     * @param bus           Pointer of panel bus
+     * @param panel_config  LCD device configuration
+     */
+    ESP_PanelLcd_ILI9881C(ESP_PanelBus *bus, const esp_lcd_panel_dev_config_t &panel_config);
+
+    /**
+     * @brief Destroy the LCD device
+     *
+     */
+    ~ESP_PanelLcd_ILI9881C() override;
+
+    /**
+     * @brief Initialize the LCD device, the `begin()` function should be called after this function
+     *
+     * @note  This function typically calls `esp_lcd_new_panel_*()` to create the LCD panel handle
+     *
+     * @return true if success, otherwise false
+     */
+    bool init(void) override;
+};
+#endif