From d24518ef881e868ae6d0c674131132c8ea57ad7d Mon Sep 17 00:00:00 2001
From: Martin Kiepfer <mrmarteng@teleschirm.org>
Date: Thu, 4 Jan 2024 13:56:15 +0100
Subject: [PATCH 1/2] shield: m5stack_m5dial: Add support for m5dial shield

M5Dial is an IoT development board based on m5stack_stamps3.
It features an LCD screen, touch interface, a rotary button,
an RTC and a piezo beeper.

Signed-off-by: Martin Kiepfer <mrmarteng@teleschirm.org>
---
 .../shields/m5stack_m5dial/Kconfig.defconfig  |  22 ++
 boards/shields/m5stack_m5dial/Kconfig.shield  |   7 +
 .../doc/img/m5stack_m5dial.webp               | Bin 0 -> 54522 bytes
 boards/shields/m5stack_m5dial/doc/index.rst   | 206 ++++++++++++++++++
 .../m5stack_m5dial/m5stack_m5dial.overlay     | 139 ++++++++++++
 5 files changed, 374 insertions(+)
 create mode 100644 boards/shields/m5stack_m5dial/Kconfig.defconfig
 create mode 100644 boards/shields/m5stack_m5dial/Kconfig.shield
 create mode 100644 boards/shields/m5stack_m5dial/doc/img/m5stack_m5dial.webp
 create mode 100644 boards/shields/m5stack_m5dial/doc/index.rst
 create mode 100644 boards/shields/m5stack_m5dial/m5stack_m5dial.overlay

diff --git a/boards/shields/m5stack_m5dial/Kconfig.defconfig b/boards/shields/m5stack_m5dial/Kconfig.defconfig
new file mode 100644
index 0000000000000..c573e57a6d04b
--- /dev/null
+++ b/boards/shields/m5stack_m5dial/Kconfig.defconfig
@@ -0,0 +1,22 @@
+# M5Stack M5Dial shield configuration
+# Copyright (c) 2023 Martin Kiepfer <mrmarteng@teleschirm.org>
+# SPDX-License-Identifier: Apache-2.0
+
+if SHIELD_M5STACK_M5DIAL
+
+config INPUT
+	default y
+
+config INPUT_FT5336_INTERRUPT
+	default y if INPUT
+
+config LV_COLOR_16_SWAP
+	default y if LVGL
+
+config PWM
+	default y
+
+config REGULATOR
+	default y
+
+endif # SHIELD_M5STACK_M5DIAL
diff --git a/boards/shields/m5stack_m5dial/Kconfig.shield b/boards/shields/m5stack_m5dial/Kconfig.shield
new file mode 100644
index 0000000000000..c3bd37610b975
--- /dev/null
+++ b/boards/shields/m5stack_m5dial/Kconfig.shield
@@ -0,0 +1,7 @@
+# M5Stack M5Dial board configuration
+
+# Copyright (c) 2023 Martin Kiepfer <mrmarteng@teleschirm.org>
+# SPDX-License-Identifier: Apache-2.0
+
+config SHIELD_M5STACK_M5DIAL
+	def_bool $(shields_list_contains,m5stack_m5dial)
diff --git a/boards/shields/m5stack_m5dial/doc/img/m5stack_m5dial.webp b/boards/shields/m5stack_m5dial/doc/img/m5stack_m5dial.webp
new file mode 100644
index 0000000000000000000000000000000000000000..2c40f5c6f97801dc6d8492a3c1c8eec7a1c13e80
GIT binary patch
literal 54522
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

literal 0
HcmV?d00001

diff --git a/boards/shields/m5stack_m5dial/doc/index.rst b/boards/shields/m5stack_m5dial/doc/index.rst
new file mode 100644
index 0000000000000..5af0991ca4292
--- /dev/null
+++ b/boards/shields/m5stack_m5dial/doc/index.rst
@@ -0,0 +1,206 @@
+.. _m5stack_m5dial:
+
+M5Stack M5Dial
+##############
+
+Overview
+********
+
+M5Dial is an ESP32-based development board from M5Stack.
+The device features an embedded ``m5stack_stamps3`` module that runs
+the ESP32-S3 microcontroller.
+
+.. figure:: img/m5stack_m5dial.webp
+        :align: center
+        :alt: M5Stack M5Dial
+
+        M5Stack M5Dial
+
+Key components
+==============
+
+The Zephyr ``m5stack_m5dial`` shield configuration supports the following key components:
+
++------------------------+-----------------------------------------------------------------------+------------+
+| Key Component          | Description                                                           | Status     |
++========================+=======================================================================+============+
+| LCD IPS round display  | 240x240 pixel display features GC9A01A display controller interfaced  | supported  |
+| (240x240 pixel)        | via SPI                                                               |            |
++------------------------+-----------------------------------------------------------------------+------------+
+| WS1850S NFC            | Wisesun NFC reader IC interfaced via I2C.                             | todo       |
++------------------------+-----------------------------------------------------------------------+------------+
+| RTC8563 RTC            | Real-Time clock interfaced via I2C.                                   | supported  |
++------------------------+-----------------------------------------------------------------------+------------+
+| Rotary encoder         | Round rotary button (``INPUT_KEY_LEFT`` and ``INPUT_KEY_RIGHT``       | supported  |
+|                        | events).                                                              |            |
++------------------------+-----------------------------------------------------------------------+------------+
+| Reset button           | Directly interconnected to EN signal of StampS3 module.               | supported  |
++------------------------+-----------------------------------------------------------------------+------------+
+| User-button            | Custom user button.                                                   | supported  |
++------------------------+-----------------------------------------------------------------------+------------+
+| Builtin Beeper/Buzzer  | PWM controller beeper, properly operating between 200Hz and 2kHz      | supported  |
++------------------------+-----------------------------------------------------------------------+------------+
+
+M5Stack M5Dial features 2 external grove ports (A and B)
+
+Grove header A
+---------------
+
+Functionality is accessible via ``grove_headerA``
+
++-----+----------------------------+---------------------------+
+| Pin | ``m5stack_stamps3_header`` | Function                  |
++=====+============================+===========================+
+| 1   | 16                         | I2C-SCL (``groveA_i2c```) |
++-----+----------------------------+---------------------------+
+| 2   | 14                         | I2C-SDL (``groveA_i2c``)  |
++-----+----------------------------+---------------------------+
+| 3   |                            | 5V-Output                 |
++-----+----------------------------+---------------------------+
+| 4   |                            | GND                       |
++-----+----------------------------+---------------------------+
+
+
+Grove header B
+---------------
+
+Functionality is accessible via ``grove_headerB``
+
++-----+----------------------------+-----------+
+| Pin | ``m5stack_stamps3_header`` | Function  |
++=====+============================+===========+
+| 1   | 0                          | In        |
++-----+----------------------------+-----------+
+| 2   | 1                          | Out       |
++-----+----------------------------+-----------+
+| 3   |                            | 5V-Output |
++-----+----------------------------+-----------+
+| 4   |                            | GND       |
++-----+----------------------------+-----------+
+
+
+Battery-Support
+---------------
+
+Although ``m5stack_m5dial`` does not natively come with a battery, it features
+support for connecting a battery to it. The battery connector is underneath the
+StampS3 module.
+
+To keep the module running on the battery only, without an external supply, an
+internal power-hold signal must be activated. This can be controlled via regulator
+``battery_hold``, which is activated by default.
+
+Pin Mapping
+===========
+
+M5Dial is utilizing the :dtcompatible:`m5stack,stamps3-header` header.
+Following table shows the pin mapping, the interconnection to the
+M5Stack-StampS3 module and its according function.
+
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| StampS3  | stamps3-header                 | M5Dial  | M5Dial    | Description                       |
+| pin      |                                | pin     | signal    |                                   |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-1     | ``m5stack_stamps3_header:0``   | J2.1    | GI        | Grove-B In                        |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-2     | ``m5stack_stamps3_header:1``   | J2-2    | GO        | Grove-B Out                       |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-3     | ``m5stack_stamps3_clkout0:2``  |         | Beep      | Beeper                            |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-4     | ``m5stack_stamps3_header:3``   |         | LCD_RS    | LCD Cmd/Data                      |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-5     | ``m5stack_stamps3_spilcd``     |         | LCD_MOSI  | LCD SPI-MOSI                      |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-6     | ``m5stack_stamps3_spilcd``     |         | LCD_SCK   | LCD SPI-CLK                       |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-7     | ``m5stack_stamps3_spilcd``     |         | LCD_CS    | LCD SPI-CS                        |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-8     | ``m5stack_stamps3_header:7``   |         | LCD_RESET | LCD Reset (active-low)            |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-9     | ``m5stack_stamps3_clkout0:0``  |         | LCD_BL    | LCD Backlight                     |
+|          |                                |         |           | (PWM controlled MOSFET)           |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-10    | ``m5stack_stamps3_header:9``   |         | RC522_INT | NFC Interrupt                     |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-11    | **GND**                                              | Ground                            |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-12    | ``m5stack_stamps3_i2c1``       |         | TP_SDA    | Internal I2C-SDA                  |
+|          |                                |         |           | (Touch, NFC and RTC)              |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-13    | **VIN_5V**                                           | 5V Input voltage                  |
+|          |                                                      | (via USB-C connector of StampS3)  |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-14    | ``m5stack_stamps3_i2c1``       |         | TP_SCL    | Internal I2C-SCL                  |
+|          |                                |         |           | (Touch, NFC and RTC)              |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-15    | ``m5stack_stamps3_i2c0``       | J3-2    | SDA       | Grove-A I2C-SDA                   |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-16    | ``m5stack_stamps3_header:15``  |         | TP_INT    | Touch Interrupt                   |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-17    | ``m5stack_stamps3_i2c0``       | J3-1    | SCL       | Grove-A I2C-SCL                   |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-18    | **GND**                                              | Ground                            |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-19    |                                |         | MTCK      |                                   |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-20    |                                |         | Boot      |                                   |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-21    | ``m5stack_stamps3_header:20``  |         | B         | Rotary left key                   |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-22    |                                |         | EN        | Enable signal for 3V3             |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-23    | ``m5stack_stamps3_header:22``  |         | A         | Rotary right key                  |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-24    |                                |         | RX        |                                   |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-25    | ``m5stack_stamps3_header:24``  |         | WAKE      | User-Button                       |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-26    |                                |         | TX        |                                   |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-27    | ``m5stack_stamps3_header:26``  |         | HOLD      | Battery-hold signal               |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+| M1-28    | **3_3V**                                             | 3.3V main output                  |
+|          |                                                      | (via StampS3 DCDC)                |
++----------+--------------------------------+---------+-----------+-----------------------------------+
+
+Start Application Development
+*****************************
+
+Before powering up your M5Stack M5Dial, please make sure that the board is in good
+condition with no obvious signs of damage.
+
+Building & Flashing
+===================
+
+M5Dial is based on ``m5stack_stamps3``.
+You may build and flash applications for M5Stack StampS3 as usual (see
+:ref:`build_an_application` and :ref:`application_run` for more details), and
+include this shield as an overlay.
+
+A good first example to test is :zephyr:code-sample:`lvgl`:
+.. zephyr-app-commands::
+   :zephyr-app: samples/subsys/display/lvgl
+   :board: m5stack_stamps3
+   :shield: m5stack_m5dial
+   :goals: build flash
+
+The baud rate of 921600bps is set by default. If experiencing issues when flashing,
+try using different values by using ``--esp-baud-rate <BAUD>`` option during
+``west flash`` (e.g. ``west flash --esp-baud-rate 115200``).
+
+.. note::
+   Because there currently is missing automatic PWM control or an external backlight
+   driver, the display backlight be default is disabled. You may need to enable it
+   in your application or by using the PWM shell.
+
+Debugging
+---------
+
+M5Stack M5Dial debugging is not supported due to pinout limitations.
+
+Related Documents
+*****************
+
+- `M5Stack M5Dial schematic <https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/products/core/M5Dial/Sch_M5Dial.pdf>`_
+- `M5Stack M5Dial documentation <https://docs.m5stack.com/en/core/M5Dial>`_
+- `ESP32S3 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_en.pdf>`_
diff --git a/boards/shields/m5stack_m5dial/m5stack_m5dial.overlay b/boards/shields/m5stack_m5dial/m5stack_m5dial.overlay
new file mode 100644
index 0000000000000..25996698c6075
--- /dev/null
+++ b/boards/shields/m5stack_m5dial/m5stack_m5dial.overlay
@@ -0,0 +1,139 @@
+/*
+ * Copyright (c) 2023 Martin Kiepfer <mrmarteng@teleschirm.org>
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+#include <zephyr/dt-bindings/pwm/pwm.h>
+#include <zephyr/dt-bindings/display/panel.h>
+#include <zephyr/dt-bindings/input/input-event-codes.h>
+#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>
+
+/ {
+	chosen {
+		zephyr,display = &gc9x01x_lcd;
+		zephyr,display-backlight = &backlight_pwm;
+		zephyr,rtc = &pfc8563_rtc;
+	};
+
+	aliases {
+		sw0 = &user_button_1; /* overwrite StampS3 user button */
+	};
+
+	gpio_keys {
+		compatible = "gpio-keys";
+
+		user_button_1: button_1 {
+			label = "User button 1";
+			gpios = <&m5stack_stamps3_header 24 GPIO_ACTIVE_LOW>;
+			zephyr,code = <INPUT_KEY_0>;
+		};
+
+		rotary_left: rotary_left {
+			label = "rotary left";
+			gpios = <&m5stack_stamps3_header 20 GPIO_ACTIVE_LOW>;
+			zephyr,code = <INPUT_KEY_LEFT>;
+		};
+
+		rotary_right: rotary_right {
+			label = "rotary right";
+			gpios = <&m5stack_stamps3_header 22 GPIO_ACTIVE_LOW>;
+			zephyr,code = <INPUT_KEY_RIGHT>;
+		};
+	};
+
+	mipi_dbi_gc9x01x_240x240 {
+		compatible = "zephyr,mipi-dbi-spi";
+		spi-dev = <&m5stack_stamps3_spilcd>;
+		dc-gpios = <&m5stack_stamps3_header 3 GPIO_ACTIVE_HIGH>;
+		reset-gpios = <&m5stack_stamps3_header 7 GPIO_ACTIVE_LOW>;
+		write-only;
+		#address-cells = <1>;
+		#size-cells = <0>;
+
+		gc9x01x_lcd: gc9x01x_lcd@0 {
+			compatible = "galaxycore,gc9x01x";
+			reg = <0>;
+			mipi-max-frequency = <100000000>;
+			display-inversion;
+			pixel-format = <PANEL_PIXEL_FORMAT_RGB_565>;
+
+			width = <240>;
+			height = <240>;
+
+			mipi-mode = <MIPI_DBI_MODE_SPI_4WIRE>;
+		};
+	};
+
+	backlight_pwm: backlight_pwm {
+		status = "okay";
+		compatible = "pwm-clock";
+		#clock-cells = <1>;
+		pwms = <&m5stack_stamps3_clkout0 0 PWM_MSEC(5) PWM_POLARITY_NORMAL>;
+	};
+
+	beeper_pwm: beeper_pwm {
+		status = "okay";
+		compatible = "pwm-clock";
+		#clock-cells = <1>;
+		pwms = <&m5stack_stamps3_clkout0 2 PWM_USEC(1500) PWM_POLARITY_NORMAL>;
+	};
+
+	battery_hold {
+		compatible = "regulator-fixed";
+		regulator-name = "battery_hold";
+		enable-gpios = <&m5stack_stamps3_header 26 GPIO_ACTIVE_HIGH>;
+		regulator-boot-on;
+	};
+
+	grove_headerA: grove_headerA {
+		compatible = "grove-header";
+		#gpio-cells = <2>;
+		gpio-map-mask = <0xffffffff 0xffffffc0>;
+		gpio-map-pass-thru = <0 0x3f>;
+		gpio-map = <0 0 &m5stack_stamps3_header 16 0>,
+			   <1 0 &m5stack_stamps3_header 14 0>;
+	};
+
+	grove_headerB: grove_headerB {
+		compatible = "grove-header";
+		#gpio-cells = <2>;
+		gpio-map-mask = <0xffffffff 0xffffffc0>;
+		gpio-map-pass-thru = <0 0x3f>;
+		gpio-map = <0 0 &m5stack_stamps3_header 0 0>,
+			   <1 0 &m5stack_stamps3_header 1 0>;
+	};
+
+	lvgl_pointer {
+		compatible = "zephyr,lvgl-pointer-input";
+		input = <&ft5267_touch>;
+		swap-xy;
+	};
+
+};
+&m5stack_stamps3_clkout0 {
+	status = "okay";
+
+};
+
+&m5stack_stamps3_i2c1 {
+	status = "okay";
+
+	ft5267_touch: ft3267@38 {
+		compatible = "focaltech,ft5336";
+		reg = <0x38>;
+		int-gpios = <&m5stack_stamps3_header 15 0>;
+	};
+
+	pfc8563_rtc: pfc8563@51 {
+		compatible = "nxp,pcf8563";
+		reg = <0x51>;
+		status = "okay";
+	};
+};
+
+&m5stack_stamps3_spilcd {
+	status = "okay";
+	dma-enabled;
+};
+
+groveA_i2c: &m5stack_stamps3_i2c0 {};

From 759ff448347981c8782180ca4387dd5a4182da8e Mon Sep 17 00:00:00 2001
From: Martin Kiepfer <mrmarteng@teleschirm.org>
Date: Thu, 4 Jan 2024 13:59:59 +0100
Subject: [PATCH 2/2] demo: lvgl: Increase main stack size for m5stack_stamps3
 board

Default main-stack size of m5stack_stamps3 is not sufficient.

Signed-off-by: Martin Kiepfer <mrmarteng@teleschirm.org>
---
 boards/shields/m5stack_m5dial/doc/index.rst                    | 1 +
 samples/subsys/display/lvgl/boards/m5stack_stamps3_procpu.conf | 3 +++
 2 files changed, 4 insertions(+)
 create mode 100644 samples/subsys/display/lvgl/boards/m5stack_stamps3_procpu.conf

diff --git a/boards/shields/m5stack_m5dial/doc/index.rst b/boards/shields/m5stack_m5dial/doc/index.rst
index 5af0991ca4292..37ab70612573b 100644
--- a/boards/shields/m5stack_m5dial/doc/index.rst
+++ b/boards/shields/m5stack_m5dial/doc/index.rst
@@ -178,6 +178,7 @@ You may build and flash applications for M5Stack StampS3 as usual (see
 include this shield as an overlay.
 
 A good first example to test is :zephyr:code-sample:`lvgl`:
+
 .. zephyr-app-commands::
    :zephyr-app: samples/subsys/display/lvgl
    :board: m5stack_stamps3
diff --git a/samples/subsys/display/lvgl/boards/m5stack_stamps3_procpu.conf b/samples/subsys/display/lvgl/boards/m5stack_stamps3_procpu.conf
new file mode 100644
index 0000000000000..1ac2b1c55c9b7
--- /dev/null
+++ b/samples/subsys/display/lvgl/boards/m5stack_stamps3_procpu.conf
@@ -0,0 +1,3 @@
+# SPDX-License-Identifier: Apache-2.0
+
+CONFIG_MAIN_STACK_SIZE=4096