feat(board): add new board M5CORES3

MacChu0315-Espressif · MacChu0315-Espressif · commit bfd5c11342d4 · 2024-06-11T11:53:40.000+08:00
diff --git a/ESP_Panel_Board_Supported.h b/ESP_Panel_Board_Supported.h
@@ -51,10 +51,11 @@
  *
  *  - M5STACK_M5CORE2: https://docs.m5stack.com/zh_CN/core/core2
  *  - M5STACK_M5DIAL: https://docs.m5stack.com/zh_CN/core/M5Dial
- *
+ *  - M5STACK_M5CORES3: https://docs.m5stack.com/zh_CN/core/CoreS3
  */
 // #define BOARD_M5STACK_M5CORE2
 // #define BOARD_M5STACK_M5DIAL
+// #define BOARD_M5STACK_M5CORES3
 
 /*
  * Shenzhen Jingcai Intelligent Supported Boards (https://www.displaysmodule.com/):
@@ -79,6 +80,6 @@
  */
 #define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_MAJOR 0
 #define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_MINOR 1
-#define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_PATCH 2
+#define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_PATCH 3
 
 #endif
diff --git a/README.md b/README.md
@@ -59,7 +59,7 @@ Below is a list of [supported development boards](src/board/README.md):
 | **Manufacturer** | **Board Model** |
 | --------------- | --------------- |
 | [Espressif](src/board/README.md#espressif) | ESP32-C3-LCDkit, ESP32-S3-Box, ESP32-S3-Box-3, ESP32-S3-Box-3(beta), ESP32-S3-Box-Lite, ESP32-S3-EYE, ESP32-S3-Korvo-2, ESP32-S3-LCD-EV-Board, ESP32-S3-LCD-EV-Board-2, ESP32-S3-USB-OTG |
-| [M5Stack](https://m5stack.com/) | M5STACK-M5CORE2, M5STACK-M5DIAL |
+| [M5Stack](https://m5stack.com/) | M5STACK-M5CORE2, M5STACK-M5DIAL, M5STACK-M5CORES3 |
 | [Jingcai](src/board/README.md#shenzhen-jingcai-intelligent) | ESP32-4848S040C_I_Y_3 |
 
 Developers and manufacturers are welcome to submit PRs to add more development boards.
diff --git a/README_CN.md b/README_CN.md
@@ -59,7 +59,7 @@ ESP32_Display_Panel 的功能框图如下所示，主要包含以下特性：
 | **厂商** | **开发板型号** |
 | -------- | -------------- |
 | [Espressif](src/board/README.md#espressif) | ESP32-C3-LCDkit, ESP32-S3-Box, ESP32-S3-Box-3, ESP32-S3-Box-3(beta), ESP32-S3-Box-Lite, ESP32-S3-EYE, ESP32-S3-Korvo-2, ESP32-S3-LCD-EV-Board, ESP32-S3-LCD-EV-Board-2, ESP32-S3-USB-OTG |
-| [M5Stack](https://m5stack.com/) | M5STACK-M5CORE2, M5STACK-M5DIAL |
+| [M5Stack](https://m5stack.com/) | M5STACK-M5CORE2, M5STACK-M5DIAL, M5STACK-M5CORES3 |
 | [Jingcai](src/board/README.md#shenzhen-jingcai-intelligent) | ESP32-4848S040C_I_Y_3 |
 
 欢迎开发者和厂商提交 PR 来添加更多的开发板。
diff --git a/examples/LVGL/v8/Porting/ESP_Panel_Board_Supported.h b/examples/LVGL/v8/Porting/ESP_Panel_Board_Supported.h
@@ -51,10 +51,11 @@
  *
  *  - M5STACK_M5CORE2: https://docs.m5stack.com/zh_CN/core/core2
  *  - M5STACK_M5DIAL: https://docs.m5stack.com/zh_CN/core/M5Dial
- *
+ *  - M5STACK_M5CORES3: https://docs.m5stack.com/zh_CN/core/CoreS3
  */
 // #define BOARD_M5STACK_M5CORE2
 // #define BOARD_M5STACK_M5DIAL
+// #define BOARD_M5STACK_M5CORES3
 
 /*
  * Shenzhen Jingcai Intelligent Supported Boards (https://www.displaysmodule.com/):
@@ -79,6 +80,6 @@
  */
 #define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_MAJOR 0
 #define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_MINOR 1
-#define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_PATCH 2
+#define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_PATCH 3
 
 #endif
diff --git a/examples/LVGL/v8/Rotation/ESP_Panel_Board_Supported.h b/examples/LVGL/v8/Rotation/ESP_Panel_Board_Supported.h
@@ -51,10 +51,11 @@
  *
  *  - M5STACK_M5CORE2: https://docs.m5stack.com/zh_CN/core/core2
  *  - M5STACK_M5DIAL: https://docs.m5stack.com/zh_CN/core/M5Dial
- *
+ *  - M5STACK_M5CORES3: https://docs.m5stack.com/zh_CN/core/CoreS3
  */
 // #define BOARD_M5STACK_M5CORE2
 // #define BOARD_M5STACK_M5DIAL
+// #define BOARD_M5STACK_M5CORES3
 
 /*
  * Shenzhen Jingcai Intelligent Supported Boards (https://www.displaysmodule.com/):
@@ -79,6 +80,6 @@
  */
 #define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_MAJOR 0
 #define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_MINOR 1
-#define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_PATCH 2
+#define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_PATCH 3
 
 #endif
diff --git a/examples/Panel/PanelTest/ESP_Panel_Board_Supported.h b/examples/Panel/PanelTest/ESP_Panel_Board_Supported.h
@@ -51,10 +51,11 @@
  *
  *  - M5STACK_M5CORE2: https://docs.m5stack.com/zh_CN/core/core2
  *  - M5STACK_M5DIAL: https://docs.m5stack.com/zh_CN/core/M5Dial
- *
+ *  - M5STACK_M5CORES3: https://docs.m5stack.com/zh_CN/core/CoreS3
  */
 // #define BOARD_M5STACK_M5CORE2
 // #define BOARD_M5STACK_M5DIAL
+// #define BOARD_M5STACK_M5CORES3
 
 /*
  * Shenzhen Jingcai Intelligent Supported Boards (https://www.displaysmodule.com/):
@@ -79,6 +80,6 @@
  */
 #define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_MAJOR 0
 #define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_MINOR 1
-#define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_PATCH 2
+#define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_PATCH 3
 
 #endif
diff --git a/examples/SquareLine/v8/Porting/ESP_Panel_Board_Supported.h b/examples/SquareLine/v8/Porting/ESP_Panel_Board_Supported.h
@@ -51,10 +51,11 @@
  *
  *  - M5STACK_M5CORE2: https://docs.m5stack.com/zh_CN/core/core2
  *  - M5STACK_M5DIAL: https://docs.m5stack.com/zh_CN/core/M5Dial
- *
+ *  - M5STACK_M5CORES3: https://docs.m5stack.com/zh_CN/core/CoreS3
  */
 // #define BOARD_M5STACK_M5CORE2
 // #define BOARD_M5STACK_M5DIAL
+// #define BOARD_M5STACK_M5CORES3
 
 /*
  * Shenzhen Jingcai Intelligent Supported Boards (https://www.displaysmodule.com/):
@@ -79,6 +80,6 @@
  */
 #define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_MAJOR 0
 #define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_MINOR 1
-#define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_PATCH 2
+#define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_PATCH 3
 
 #endif
diff --git a/examples/SquareLine/v8/WiFiClock/ESP_Panel_Board_Supported.h b/examples/SquareLine/v8/WiFiClock/ESP_Panel_Board_Supported.h
@@ -51,10 +51,11 @@
  *
  *  - M5STACK_M5CORE2: https://docs.m5stack.com/zh_CN/core/core2
  *  - M5STACK_M5DIAL: https://docs.m5stack.com/zh_CN/core/M5Dial
- *
+ *  - M5STACK_M5CORES3: https://docs.m5stack.com/zh_CN/core/CoreS3
  */
 // #define BOARD_M5STACK_M5CORE2
 // #define BOARD_M5STACK_M5DIAL
+// #define BOARD_M5STACK_M5CORES3
 
 /*
  * Shenzhen Jingcai Intelligent Supported Boards (https://www.displaysmodule.com/):
@@ -79,6 +80,6 @@
  */
 #define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_MAJOR 0
 #define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_MINOR 1
-#define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_PATCH 2
+#define ESP_PANEL_BOARD_SUPPORTED_FILE_VERSION_PATCH 3
 
 #endif
diff --git a/library.properties b/library.properties
@@ -3,7 +3,7 @@ version=0.1.3
 author=espressif
 maintainer=espressif
 sentence=ESP32_Display_Panel is an Arduino library designed for ESP SoCs to drive display panels and facilitate rapid GUI development.
-paragraph=Currently supported boards:ESP32-C3-LCDkit,ESP32-S3-Box,ESP32-S3-Box-3,ESP32-S3-Box-3(beta),ESP32-S3-Box-Lite,ESP32-S3-EYE,ESP32-S3-Korvo-2,ESP32-S3-LCD-EV-Board,ESP32-S3-LCD-EV-Board-2,ESP32-S3-USB-OTG,M5STACK-M5CORE2,M5STACK-M5DIAL,ESP32-4848S040C_I_Y_3. Currently supported devices: Bus,LCD,Touch,Backlight,IO expander. Currently supported Bus: I2C,SPI,QSPI,3-wire SPI + RGB. Currently supported LCD controllers: GC9A01,GC9B71,GC9503,ILI9341,NV3022B,ST7262,ST7701,ST7789,ST7796,ST77916,ST77922. Currently supported Touch controllers: CST816S,FT5x06,GT1151,GT911,ST7123,TT21100,XPT2046.
+paragraph=Currently supported boards:ESP32-C3-LCDkit,ESP32-S3-Box,ESP32-S3-Box-3,ESP32-S3-Box-3(beta),ESP32-S3-Box-Lite,ESP32-S3-EYE,ESP32-S3-Korvo-2,ESP32-S3-LCD-EV-Board,ESP32-S3-LCD-EV-Board-2,ESP32-S3-USB-OTG,M5STACK-M5CORE2,M5STACK-M5DIAL,M5STACK-M5CORES3,ESP32-4848S040C_I_Y_3. Currently supported devices: Bus,LCD,Touch,Backlight,IO expander. Currently supported Bus: I2C,SPI,QSPI,3-wire SPI + RGB. Currently supported LCD controllers: GC9A01,GC9B71,GC9503,ILI9341,NV3022B,ST7262,ST7701,ST7789,ST7796,ST77916,ST77922. Currently supported Touch controllers: CST816S,FT5x06,GT1151,GT911,ST7123,TT21100,XPT2046.
 category=Other
 architectures=esp32
 url=https://github.com/esp-arduino-libs/ESP32_Display_Panel
diff --git a/src/ESP_Panel.cpp b/src/ESP_Panel.cpp
@@ -10,6 +10,8 @@
 #include <iostream>
 #include <memory>
 #include "driver/gpio.h"
+#include <Arduino.h>
+#include <ESP_Panel_Library.h>
 
 using namespace std;
 
diff --git a/src/ESP_PanelVersions.h b/src/ESP_PanelVersions.h
@@ -26,7 +26,7 @@
 /* File `ESP_Panel_Board_Supported.h` */
 #define ESP_PANEL_BOARD_SUPPORTED_VERSION_MAJOR 0
 #define ESP_PANEL_BOARD_SUPPORTED_VERSION_MINOR 1
-#define ESP_PANEL_BOARD_SUPPORTED_VERSION_PATCH 2
+#define ESP_PANEL_BOARD_SUPPORTED_VERSION_PATCH 3
 
 /* Check if the current configuration file version is compatible with the library version */
 // File `ESP_Panel_Conf.h`
diff --git a/src/board/ESP_PanelBoard.h b/src/board/ESP_PanelBoard.h
@@ -14,7 +14,8 @@
     defined(BOARD_ESP32_S3_KORVO_2) + defined(BOARD_ESP32_S3_LCD_EV_BOARD) + \
     defined(BOARD_ESP32_S3_LCD_EV_BOARD_V1_5) +  defined(BOARD_ESP32_S3_LCD_EV_BOARD_2) + \
     defined(BOARD_ESP32_S3_LCD_EV_BOARD_2_V1_5) + defined(BOARD_ESP32_S3_USB_OTG) + \
-    defined(BOARD_M5STACK_M5CORE2) + defined(BOARD_M5STACK_M5DIAL) + defined(BOARD_ESP32_4848S040C_I_Y_3) \
+    defined(BOARD_M5STACK_M5CORE2) + defined(BOARD_M5STACK_M5DIAL) + defined(BOARD_M5STACK_M5CORES3) + \
+    defined(BOARD_ESP32_4848S040C_I_Y_3) \
     > 1
     #error "Multiple boards enabled! Please check file `ESP_Panel_Board_Supported.h` and make sure only one board is enabled."
 #endif
@@ -50,6 +51,8 @@
     #include "board/m5stack/M5CORE2.h"
 #elif defined(BOARD_M5STACK_M5DIAL) || CONFIG_BOARD_M5STACK_M5DIAL
     #include "board/m5stack/M5DIAL.h"
+#elif defined(BOARD_M5STACK_M5CORES3) || CONFIG_BOARD_M5STACK_M5CORES3
+    #include "board/m5stack/M5CORES3.h"
 /* Jingcai */
 #elif defined(BOARD_ESP32_4848S040C_I_Y_3) || CONFIG_BOARD_ESP32_4848S040C_I_Y_3
     #include "board/jingcai/ESP32_4848S040C_I_Y_3.h"
diff --git a/src/board/README.md b/src/board/README.md
@@ -21,8 +21,10 @@
 
 |                                                                                                                                       **Picture**                                                                                                                                       |                                                **Name**                                                 |   **LCD Bus**    | **LCD Controller** | **Touch Bus** | **Touch Controller** |
 | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------: | :--------------: | :----------------: | :-----------: | :------------------: |
-| [<img src="https://static-cdn.m5stack.com/resource/docs/products/core/core2/core2_01.webp" width="150">](https://www.displaysmodule.com/sale-41828962-experience-the-power-of-the-esp32-display-module-sku-esp32-4848s040c-i-y-3.html) | [M5STACK_M5CORE2](https://docs.m5stack.com/zh_CN/core/core2) | SPI |       ILI9342C       |      I2C      |        FT6336U         |
-| [<img src="https://static-cdn.m5stack.com/resource/docs/products/core/M5Dial/img-2afd549e-8af8-47b4-823a-e90e063a0139.webp" width="150">](https://www.displaysmodule.com/sale-41828962-experience-the-power-of-the-esp32-display-module-sku-esp32-4848s040c-i-y-3.html) | [M5STACK_M5DIAL](https://docs.m5stack.com/zh_CN/core/M5Dial) | SPI |       GC9A01       |      I2C      |        FT5x06         |
+| <img src="https://static-cdn.m5stack.com/resource/docs/products/core/core2/core2_01.webp" width="150"> | [M5STACK_M5CORE2](https://docs.m5stack.com/zh_CN/core/core2) | SPI |       ILI9342C       |      I2C      |        FT6336U         |
+| <img src="https://static-cdn.m5stack.com/resource/docs/products/core/M5Dial/img-2afd549e-8af8-47b4-823a-e90e063a0139.webp" width="150"> | [M5STACK_M5DIAL](https://docs.m5stack.com/zh_CN/core/M5Dial) | SPI |       GC9A01       |      I2C      |        FT5x06         |
+| <img src="https://static-cdn.m5stack.com/resource/docs/products/core/CoreS3/img-96063e2a-637a-4d11-ac47-1ce4f1cdfd3e.webp" width="150"> | [M5STACK_M5CORES3](https://docs.m5stack.com/zh_CN/core/CoreS3) | SPI |       ILI9342C       |      I2C      |        FT6336U         |
+
 
 ### [Shenzhen Jingcai Intelligent](https://www.displaysmodule.com/)
 
@@ -48,6 +50,7 @@ Below are recommended configurations for developing GUI applications on differen
 |    ESP32-S3-USB-OTG     |  ESP32-S3-USB-OTG  |    -     |     -      |     -      |        -        |     8M with spiffs      |
 |     M5STACK-M5CORE2     |    M5Stack-Core2   | Enabled  |     -      |     -      |        -        |         Default         |
 |     M5STACK-M5DIAL      | ESP32S3 Dev Module |   OPI    | QIO 80MHz  |    8MB     |    Disabled     |         Default         |
+|    M5STACK-M5CORES3     | ESP32S3 Dev Module |   OPI    | QIO 80MHz  |    16MB    |     Enabled     | Default 4MB with spiffs |
 |  ESP32-4848S040C_I_Y_3  | ESP32S3 Dev Module |   OPI    | QIO 80MHz  |    16MB    |    Disabled     |     16M Flash (3MB)     |
 
 **Notes:**
diff --git a/src/board/m5stack/M5CORES3.h b/src/board/m5stack/M5CORES3.h
