feat: Add M5Stack PaperS3 support

Author: fonix232

.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

Boards/M5StackPaperS3/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
+)

Boards/M5StackPaperS3/Source/Configuration.cpp

@@ -0,0 +1,86 @@
+#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
+        }
+    },
+};

Boards/M5StackPaperS3/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;
+}

Boards/M5StackPaperS3/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);
+}

Boards/M5StackPaperS3/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();