feat: Add basic M5Stack PaperS3 support

.gitmodules

@@ -16,3 +16,6 @@
 [submodule "Libraries/cJSON/cJSON"]
 	path = Libraries/cJSON/cJSON
 	url = https://github.com/DaveGamble/cJSON.git
+[submodule "Libraries/epdiy"]
+	path = Libraries/epdiy
+	url = https://github.com/fonix232/epdiy

CMakeLists.txt

@@ -39,6 +39,7 @@ if (DEFINED ENV{ESP_IDF_VERSION})
         "TactilityCore"
         "Libraries/esp_lvgl_port"
         "Libraries/elf_loader"
+        "Libraries/epdiy"
         "Libraries/lvgl"
         "Libraries/lv_screenshot"
         "Libraries/minitar"

Devices/m5stack-papers3/CMakeLists.txt

@@ -0,0 +1,7 @@
+file(GLOB_RECURSE SOURCE_FILES Source/*.c*)
+
+idf_component_register(
+    SRCS ${SOURCE_FILES}
+    INCLUDE_DIRS "Source"
+    REQUIRES Tactility esp_lvgl_port EPDiyDisplay GT911 driver esp_adc EstimatedPower vfs fatfs
+)

Devices/m5stack-papers3/Source/Configuration.cpp

@@ -0,0 +1,111 @@
+#include <vector>
+#include <memory>
+#include <Tactility/hal/Configuration.h>
+#include <Tactility/lvgl/LvglSync.h>
+
+#include "devices/Display.hpp"
+#include "devices/Power.hpp"
+#include "devices/SdCard.hpp"
+
+bool initBoot();
+
+using namespace tt::hal;
+
+static std::vector<std::shared_ptr<Device>> createDevices() {
+    return {
+        createPower(),
+        createDisplay(),
+        createSdCard()
+    };
+}
+
+extern const Configuration hardwareConfiguration = {
+    .initBoot = initBoot,
+    .createDevices = createDevices,
+    .i2c = {
+        i2c::Configuration {
+            .name = "Internal",
+            .port = I2C_NUM_0,
+            .initMode = i2c::InitMode::ByTactility,
+            .isMutable = false,
+            .config = (i2c_config_t) {
+                .mode = I2C_MODE_MASTER,
+                .sda_io_num = GPIO_NUM_41,
+                .scl_io_num = GPIO_NUM_42,
+                .sda_pullup_en = true,
+                .scl_pullup_en = true,
+                .master = {
+                    .clk_speed = 400000
+                },
+                .clk_flags = 0
+            }
+        },
+        i2c::Configuration {
+            .name = "External",
+            .port = I2C_NUM_1,
+            .initMode = i2c::InitMode::Disabled,
+            .isMutable = true,
+            .config = (i2c_config_t) {
+                .mode = I2C_MODE_MASTER,
+                .sda_io_num = GPIO_NUM_2,
+                .scl_io_num = GPIO_NUM_1,
+                .sda_pullup_en = false,
+                .scl_pullup_en = false,
+                .master = {
+                    .clk_speed = 400000
+                },
+                .clk_flags = 0
+            }
+        }
+    },
+    .spi = {
+        spi::Configuration {
+            .device = SPI2_HOST,
+            .dma = SPI_DMA_CH_AUTO,
+            .config = {
+                .mosi_io_num = GPIO_NUM_38,
+                .miso_io_num = GPIO_NUM_40,
+                .sclk_io_num = GPIO_NUM_39,
+                .quadwp_io_num = GPIO_NUM_NC, // Quad SPI LCD driver is not yet supported
+                .quadhd_io_num = GPIO_NUM_NC, // Quad SPI LCD driver is not yet supported
+                .data4_io_num = GPIO_NUM_NC,
+                .data5_io_num = GPIO_NUM_NC,
+                .data6_io_num = GPIO_NUM_NC,
+                .data7_io_num = GPIO_NUM_NC,
+                .data_io_default_level = false,
+                .max_transfer_sz = 0,
+                .flags = 0,
+                .isr_cpu_id = ESP_INTR_CPU_AFFINITY_AUTO,
+                .intr_flags = 0
+            },
+            .initMode = spi::InitMode::ByTactility,
+            .isMutable = false,
+            .lock = nullptr
+        }
+    },
+    .uart = {
+        uart::Configuration {
+            .name = "External",
+            .port = UART_NUM_1,
+            .rxPin = GPIO_NUM_2,
+            .txPin = GPIO_NUM_1,
+            .rtsPin = GPIO_NUM_NC,
+            .ctsPin = GPIO_NUM_NC,
+            .rxBufferSize = 1024,
+            .txBufferSize = 1024,
+            .config = {
+                .baud_rate = 115200,
+                .data_bits = UART_DATA_8_BITS,
+                .parity    = UART_PARITY_DISABLE,
+                .stop_bits = UART_STOP_BITS_1,
+                .flow_ctrl = UART_HW_FLOWCTRL_DISABLE,
+                .rx_flow_ctrl_thresh = 0,
+                .source_clk = UART_SCLK_DEFAULT,
+                .flags = {
+                    .allow_pd = 0,
+                    .backup_before_sleep = 0,
+                }
+            }
+        }
+    }
+};

Devices/m5stack-papers3/Source/Init.cpp

@@ -0,0 +1,20 @@
+#include "Tactility/kernel/SystemEvents.h"
+
+#include <Tactility/TactilityCore.h>
+
+#define TAG "papers3"
+
+static bool powerOn() {
+    // No power on sequence needed for M5Stack PaperS3
+    return true;
+}
+
+bool initBoot() {
+    ESP_LOGI(TAG, LOG_MESSAGE_POWER_ON_START);
+    if (!powerOn()) {
+        TT_LOG_E(TAG, LOG_MESSAGE_POWER_ON_FAILED);
+        return false;
+    }
+
+    return true;
+}

Devices/m5stack-papers3/Source/devices/Display.cpp

@@ -0,0 +1,26 @@
+#include "Display.hpp"
+
+#include <Gt911Touch.h>
+#include <EpdiyDisplayHelper.h>
+
+
+static std::shared_ptr<tt::hal::touch::TouchDevice> createTouch() {
+    // Note for future changes: Interrupt pin is 48, reset is NC
+    auto configuration = std::make_unique<Gt911Touch::Configuration>(
+        I2C_NUM_0,
+        PAPERS3_EPD_HORIZONTAL_RESOLUTION,// yMax - PaperS3 is rotated
+        PAPERS3_EPD_VERTICAL_RESOLUTION, // xMax - PaperS3 is rotated
+        true, // swapXY
+        true, // mirrorX
+        false, // mirrorY
+        GPIO_NUM_NC,
+        GPIO_NUM_48
+    );
+
+    return std::make_shared<Gt911Touch>(std::move(configuration));
+}
+
+std::shared_ptr<tt::hal::display::DisplayDevice> createDisplay() {
+    auto touch = createTouch();
+    return EpdiyDisplayHelper::createM5PaperS3Display(touch);
+}

Devices/m5stack-papers3/Source/devices/Display.hpp

@@ -0,0 +1,11 @@
+#pragma once
+
+#include <memory>
+#include <Tactility/hal/display/DisplayDevice.h>
+#include <Tactility/hal/touch/TouchDevice.h>
+
+// Display
+#define PAPERS3_EPD_HORIZONTAL_RESOLUTION 540
+#define PAPERS3_EPD_VERTICAL_RESOLUTION 960
+
+std::shared_ptr<tt::hal::display::DisplayDevice> createDisplay();