From 9712dbeadf41514babe923c6deb45802e7ae38d0 Mon Sep 17 00:00:00 2001 From: Martin Kiepfer Date: Thu, 24 Aug 2023 06:55:29 +0200 Subject: [PATCH] board: M5Stack Core2 module suppport This Pull-Request features support for the M5Stack Core2 hardware. The module features a LCD display, touchscreen, battery, USB-Port, 8MB RAM and 18GB Flash. Basic features are working. See board documentation for details. Signed-off-by: Martin Kiepfer --- boards/xtensa/m5stack_core2/Kconfig.board | 8 + boards/xtensa/m5stack_core2/Kconfig.defconfig | 55 ++++ boards/xtensa/m5stack_core2/board.cmake | 9 + .../m5stack_core2/doc/img/m5stack_core2.webp | Bin 0 -> 88824 bytes boards/xtensa/m5stack_core2/doc/index.rst | 194 ++++++++++++++ .../m5stack_core2/m5stack_core2-pinctrl.dtsi | 58 +++++ boards/xtensa/m5stack_core2/m5stack_core2.dts | 241 ++++++++++++++++++ .../xtensa/m5stack_core2/m5stack_core2.yaml | 20 ++ .../m5stack_core2/m5stack_core2_defconfig | 24 ++ .../xtensa/m5stack_core2/support/openocd.cfg | 5 + tests/lib/devicetree/devices/testcase.yaml | 1 + 11 files changed, 615 insertions(+) create mode 100644 boards/xtensa/m5stack_core2/Kconfig.board create mode 100644 boards/xtensa/m5stack_core2/Kconfig.defconfig create mode 100644 boards/xtensa/m5stack_core2/board.cmake create mode 100644 boards/xtensa/m5stack_core2/doc/img/m5stack_core2.webp create mode 100644 boards/xtensa/m5stack_core2/doc/index.rst create mode 100644 boards/xtensa/m5stack_core2/m5stack_core2-pinctrl.dtsi create mode 100644 boards/xtensa/m5stack_core2/m5stack_core2.dts create mode 100644 boards/xtensa/m5stack_core2/m5stack_core2.yaml create mode 100644 boards/xtensa/m5stack_core2/m5stack_core2_defconfig create mode 100644 boards/xtensa/m5stack_core2/support/openocd.cfg diff --git a/boards/xtensa/m5stack_core2/Kconfig.board b/boards/xtensa/m5stack_core2/Kconfig.board new file mode 100644 index 000000000000000..c6286b8c169a886 --- /dev/null +++ b/boards/xtensa/m5stack_core2/Kconfig.board @@ -0,0 +1,8 @@ +# M5Stack Core2 board configuration + +# Copyright (c) 2023 Martin Kiepfer +# SPDX-License-Identifier: Apache-2.0 + +config BOARD_M5STACK_CORE2 + bool "M5Stack Core2 Development Board" + depends on SOC_SERIES_ESP32 diff --git a/boards/xtensa/m5stack_core2/Kconfig.defconfig b/boards/xtensa/m5stack_core2/Kconfig.defconfig new file mode 100644 index 000000000000000..1171fe01da77f91 --- /dev/null +++ b/boards/xtensa/m5stack_core2/Kconfig.defconfig @@ -0,0 +1,55 @@ +# M5Stack Core2 board configuration +# Copyright (c) 2022 AVSystem Sławomir Wolf Sp.j. (AVSystem) +# Copyright (c) 2023 Martin Kiepfer +# SPDX-License-Identifier: Apache-2.0 + +if BOARD_M5STACK_CORE2 + +config BOARD + default "m5stack_core2" + depends on BOARD_M5STACK_CORE2 + +config ENTROPY_GENERATOR + default y + +config HEAP_MEM_POOL_SIZE + default 98304 if WIFI + default 65536 if BT + default 4096 + +config KERNEL_MEM_POOL + default y + +choice BT_HCI_BUS_TYPE + default BT_ESP32 if BT +endchoice + +config I2C + default y + +config ESP_SPIRAM + default n + +choice SPIRAM_TYPE + default SPIRAM_TYPE_ESPPSRAM64 +endchoice + +config FLASH + default y + +config MFD_INIT_PRIORITY + default 60 + +config REGULATOR_AXP192_INIT_PRIORITY + default 76 + +config GPIO_AXP192_INIT_PRIORITY + default 80 + +config GPIO_HOGS_INIT_PRIORITY + default 81 + +config INPUT_FT5336_INTERRUPT + default y if INPUT + +endif # BOARD_M5STACK_CORE2 diff --git a/boards/xtensa/m5stack_core2/board.cmake b/boards/xtensa/m5stack_core2/board.cmake new file mode 100644 index 000000000000000..2f04d1fe8861ea6 --- /dev/null +++ b/boards/xtensa/m5stack_core2/board.cmake @@ -0,0 +1,9 @@ +# SPDX-License-Identifier: Apache-2.0 + +if(NOT "${OPENOCD}" MATCHES "^${ESPRESSIF_TOOLCHAIN_PATH}/.*") + set(OPENOCD OPENOCD-NOTFOUND) +endif() +find_program(OPENOCD openocd PATHS ${ESPRESSIF_TOOLCHAIN_PATH}/openocd-esp32/bin NO_DEFAULT_PATH) + +include(${ZEPHYR_BASE}/boards/common/esp32.board.cmake) +include(${ZEPHYR_BASE}/boards/common/openocd.board.cmake) diff --git a/boards/xtensa/m5stack_core2/doc/img/m5stack_core2.webp b/boards/xtensa/m5stack_core2/doc/img/m5stack_core2.webp new file mode 100644 index 0000000000000000000000000000000000000000..794c8e4c9cbe5944ac90334e7e8b8dab7e93e135 GIT binary patch literal 88824 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 Se|fnkwm+_|+m8`` option during +``west flash`` (e.g. ``west flash --esp-baud-rate 115200``). + +You can also open the serial monitor using the following command: + +.. code-block:: shell + + west espressif monitor + +After the board has automatically reset and booted, you should see the following +message in the monitor: + +.. code-block:: console + + ***** Booting Zephyr OS vx.x.x-xxx-gxxxxxxxxxxxx ***** + Hello World! m5stack_core2 + +Debugging +--------- + +M5Stack Core2 debugging is not supported due to pinout limitations. + +Related Documents +***************** + +- `M5StickC PLUS schematic `_ (WEBP) +- `ESP32-PICO-D4 Datasheet `_ (PDF) +- `M5StickC PLUS docs `_ +- `ESP32 Datasheet `_ (PDF) +- `ESP32 Hardware Reference `_ diff --git a/boards/xtensa/m5stack_core2/m5stack_core2-pinctrl.dtsi b/boards/xtensa/m5stack_core2/m5stack_core2-pinctrl.dtsi new file mode 100644 index 000000000000000..5588a45ca266528 --- /dev/null +++ b/boards/xtensa/m5stack_core2/m5stack_core2-pinctrl.dtsi @@ -0,0 +1,58 @@ +/* + * Copyright (c) 2022 AVSystem Sławomir Wolf Sp.j. (AVSystem) + * Copyright (c) 2023 Martin Kiepfer + * + * SPDX-License-Identifier: Apache-2.0 + */ + +#include +#include +#include + +&pinctrl { + + uart0_tx_gpio1: uart0_tx_gpio1 { + pinmux = ; + }; + + uart0_rx_gpio3: uart0_rx_gpio3 { + pinmux = ; + bias-pull-up; + }; + + spim3_default: spim3_default { + group1 { + pinmux = , + , + ; + }; + group2 { + pinmux = ; + output-low; + }; + }; + + spim2_default: spim2_default { + group1 { + pinmux = , + , + ; + }; + group2 { + pinmux = ; + output-low; + }; + }; + + + i2c0_default: i2c0_default { + group1 { + pinmux = , + ; + bias-pull-up; + drive-open-drain; + output-high; + }; + }; + +}; diff --git a/boards/xtensa/m5stack_core2/m5stack_core2.dts b/boards/xtensa/m5stack_core2/m5stack_core2.dts new file mode 100644 index 000000000000000..2fa9fa4ef0bd0d1 --- /dev/null +++ b/boards/xtensa/m5stack_core2/m5stack_core2.dts @@ -0,0 +1,241 @@ +/* + * Copyright (c) 2023 Martin Kiepfer + * + * SPDX-License-Identifier: Apache-2.0 + */ +/dts-v1/; + +#include +#include "m5stack_core2-pinctrl.dtsi" +#include +#include + +/ { + model = "esp32"; + compatible = "espressif,esp32"; + + aliases { + pwr-led = &pwr_led; + uart-0 = &uart0; + i2c-0 = &i2c0; + watchdog0 = &wdt0; + rtc = &pfc8563_rtc; + }; + + chosen { + zephyr,sram = &sram0; + zephyr,console = &uart0; + zephyr,shell-uart = &uart0; + zephyr,flash = &flash0; + zephyr,display = &ili9342c; + zephyr,keyboard-scan = &kscan_input; + zephyr,code-partition = &slot0_partition; + zephyr,rtc = &pfc8563_rtc; + }; +}; + +&cpu0 { + clock-frequency = ; +}; + +&cpu1 { + clock-frequency = ; +}; + +&psram0 { + reg = <0x3f800000 DT_SIZE_M(8)>; + status = "okay"; +}; + +&uart0 { + status = "okay"; + current-speed = <115200>; + pinctrl-0 = <&uart0_tx_gpio1 &uart0_rx_gpio3>; + pinctrl-names = "default"; +}; + +&gpio0 { + status = "okay"; +}; + +&gpio1 { + status = "okay"; +}; + +&gpio0 { + gpio-reserved-ranges = <6 11>, // PSRAM + <20>,<24>,<28 31>; // NC +}; + +&i2c0 { + status = "okay"; + clock-frequency = ; + sda-gpios = <&gpio0 21 GPIO_OPEN_DRAIN>; + scl-gpios = <&gpio0 22 GPIO_OPEN_DRAIN>; + pinctrl-0 = <&i2c0_default>; + scl-timeout-us = <0>; + pinctrl-names = "default"; + + pfc8563_rtc: pfc8563@51 { + compatible = "nxp,pcf8523"; + reg = <0x51>; + status = "okay"; + battery-switch-over = "disabled"; + }; + + axp192_pmic: axp192@34 { + compatible = "x-powers,axp192"; + reg = <0x34>; + status = "okay"; + + axp192_regulator: axp192_regulator { + compatible = "x-powers,axp192-regulator"; + status = "okay"; + + vdd_mcu: DCDC1 { + regulator-init-microvolt = <3350000>; + regulator-min-microvolt = <3200000>; + regulator-max-microvolt = <3400000>; + regulator-initial-mode = ; + regulator-boot-on; + regulator-always-on; + }; + + lcd_bg: DCDC3 { + regulator-init-microvolt = <2800000>; + regulator-min-microvolt = <0>; + regulator-max-microvolt = <2800000>; + regulator-boot-on; + }; + + v_peri: LDO2 { + regulator-init-microvolt = <3300000>; + regulator-min-microvolt = <3200000>; + regulator-max-microvolt = <3300000>; + regulator-boot-on; + }; + + vib_motor: LDO3 { + regulator-init-microvolt = <2800000>; + }; + }; + + axp192_gpio: axp192_gpio { + compatible = "x-powers,axp192-gpio"; + gpio-controller; + #gpio-cells = <2>; + ngpios = <5>; + status = "okay"; + + pwr_led: axp192_gpio1 { + gpio-hog; + gpios = <1 (GPIO_OPEN_DRAIN | GPIO_ACTIVE_LOW)>; + output-high; + line-name = "pwr-led"; + }; + + bus_pwr_en: axp192_gpio0 { + gpio-hog; + gpios = <0 0>; + input; + }; + }; + }; + + ft5336@38 { + compatible = "focaltech,ft5336"; + reg = <0x38>; + int-gpios = <&gpio1 7 0>; + + kscan_input: kscan-input { + compatible = "zephyr,kscan-input"; + }; + }; +}; + +&spi3 { + #address-cells = <1>; + #size-cells = <0>; + status = "okay"; + pinctrl-0 = <&spim3_default>; + pinctrl-names = "default"; + dma-enabled; + clock-frequency = <20000000>; + cs-gpios = <&gpio0 5 GPIO_ACTIVE_LOW>; + + ili9342c: ili9342c@0 { + compatible = "ilitek,ili9342c"; + spi-max-frequency = <20000000>; + reg = <0>; + cmd-data-gpios = <&gpio0 15 GPIO_ACTIVE_LOW>; + reset-gpios = <&axp192_gpio 4 (GPIO_OPEN_DRAIN | GPIO_ACTIVE_LOW)>; + pixel-format = ; + display-inversion; + width = <320>; + height = <240>; + rotation = <0>; + }; +}; + + +&timer0 { + status = "okay"; +}; + +&timer1 { + status = "okay"; +}; + +&timer2 { + status = "okay"; +}; + +&timer3 { + status = "okay"; +}; + +&trng0 { + status = "okay"; +}; + +&flash0 { + status = "okay"; + reg = <0 0x400000>; + + partitions { + compatible = "fixed-partitions"; + #address-cells = <1>; + #size-cells = <1>; + + /* Reserve 60kB for the bootloader */ + boot_partition: partition@1000 { + label = "mcuboot"; + reg = <0x00001000 0x0000F000>; + read-only; + }; + + /* Reserve 1024kB for the application in slot 0 */ + slot0_partition: partition@10000 { + label = "image-0"; + reg = <0x00010000 0x00100000>; + }; + + /* Reserve 1024kB for the application in slot 1 */ + slot1_partition: partition@110000 { + label = "image-1"; + reg = <0x00110000 0x00100000>; + }; + + /* Reserve 256kB for the scratch partition */ + scratch_partition: partition@210000 { + label = "image-scratch"; + reg = <0x00210000 0x00040000>; + }; + + /* 14MB storage */ + storage_partition: partition@250000 { + label = "storage"; + reg = <0x00250000 0x00db0000>; + }; + }; +}; diff --git a/boards/xtensa/m5stack_core2/m5stack_core2.yaml b/boards/xtensa/m5stack_core2/m5stack_core2.yaml new file mode 100644 index 000000000000000..1ee36021b39bcd0 --- /dev/null +++ b/boards/xtensa/m5stack_core2/m5stack_core2.yaml @@ -0,0 +1,20 @@ +identifier: m5stack_core2 +name: M5Stack Core2 +type: mcu +arch: xtensa +toolchain: + - zephyr +supported: + - gpio + - i2c + - spi + - watchdog + - regulator + - uart + - pinmux + - nvs +testing: + default: true + ignore_tags: + - net + - bluetooth diff --git a/boards/xtensa/m5stack_core2/m5stack_core2_defconfig b/boards/xtensa/m5stack_core2/m5stack_core2_defconfig new file mode 100644 index 000000000000000..73ccddc6973e636 --- /dev/null +++ b/boards/xtensa/m5stack_core2/m5stack_core2_defconfig @@ -0,0 +1,24 @@ +# SPDX-License-Identifier: Apache-2.0 + +CONFIG_BOARD_M5STACK_CORE2=y + +CONFIG_SOC_SERIES_ESP32=y +CONFIG_GEN_ISR_TABLES=y +CONFIG_XTENSA_USE_CORE_CRT1=n +CONFIG_XTENSA_RESET_VECTOR=n +CONFIG_GEN_IRQ_VECTOR_TABLE=n + +CONFIG_MAIN_STACK_SIZE=4096 +CONFIG_HEAP_MEM_POOL_SIZE=4096 +CONFIG_ESP_HEAP_MEM_POOL_REGION_1_SIZE=0 + +CONFIG_GPIO=y + +CONFIG_REGULATOR=y + +CONFIG_CONSOLE=y +CONFIG_SERIAL=y +CONFIG_UART_CONSOLE=y + +# for debugging +CONFIG_SHELL=y diff --git a/boards/xtensa/m5stack_core2/support/openocd.cfg b/boards/xtensa/m5stack_core2/support/openocd.cfg new file mode 100644 index 000000000000000..338e6e4e6eae9a2 --- /dev/null +++ b/boards/xtensa/m5stack_core2/support/openocd.cfg @@ -0,0 +1,5 @@ +set ESP_RTOS none +set ESP32_ONLYCPU 1 + +source [find interface/ftdi/esp32_devkitj_v1.cfg] +source [find target/esp32.cfg] diff --git a/tests/lib/devicetree/devices/testcase.yaml b/tests/lib/devicetree/devices/testcase.yaml index b57489b9a11936a..d7695220b8bdcb0 100644 --- a/tests/lib/devicetree/devices/testcase.yaml +++ b/tests/lib/devicetree/devices/testcase.yaml @@ -14,4 +14,5 @@ tests: - bt610 - bl5340_dvk_cpuapp - bl5340_dvk_cpuapp_ns + - m5stack_core2 - mimxrt595_evk_cm33