boards: dptechnics: Add support for Walter board

Add board definitions for the DPTechnics Walter board.

Signed-off-by: Thibo Verheyde <thibo@dptechnics.com>

boards/dptechnics/index.rst

@@ -0,0 +1,10 @@
+.. _boards-dptechnics:
+
+DPTechnics
+##########
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   **/*

boards/dptechnics/walter/Kconfig.defconfig

@@ -0,0 +1,20 @@
+# Copyright (c) 2024 DPTechnics bv
+# SPDX-License-Identifier: Apache-2.0
+
+if BOARD_WALTER_ESP32S3_PROCPU
+
+config HEAP_MEM_POOL_ADD_SIZE_BOARD
+	int
+	default 65535 if WIFI && BT
+	default 51200 if WIFI
+	default 40960 if BT
+	default 4096
+
+endif # BOARD_WALTER_ESP32S3_PROCPU
+
+if BOARD_WALTER_ESP32S3_APPCPU
+
+config HEAP_MEM_POOL_ADD_SIZE_BOARD
+	default 256
+
+endif # BOARD_WALTER_ESP32S3_APPCPU

boards/dptechnics/walter/Kconfig.sysbuild

@@ -0,0 +1,10 @@
+# Copyright (c) 2024 DPTechnics bv
+# SPDX-License-Identifier: Apache-2.0
+
+choice BOOTLOADER
+	default BOOTLOADER_MCUBOOT
+endchoice
+
+choice BOOT_SIGNATURE_TYPE
+	default BOOT_SIGNATURE_TYPE_NONE
+endchoice

boards/dptechnics/walter/Kconfig.walter

@@ -0,0 +1,7 @@
+# Copyright (c) 2024 DPTechnics bv
+# SPDX-License-Identifier: Apache-2.0
+
+config BOARD_WALTER
+	select SOC_ESP32S3_WROOM_N16R2
+	select SOC_ESP32S3_PROCPU if BOARD_WALTER_ESP32S3_PROCPU
+	select SOC_ESP32S3_APPCPU if BOARD_WALTER_ESP32S3_APPCPU

boards/dptechnics/walter/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)

boards/dptechnics/walter/board.yml

@@ -0,0 +1,5 @@
+board:
+  name: walter
+  vendor: dptechnics
+  socs:
+  - name: esp32s3

boards/dptechnics/walter/doc/index.rst

@@ -0,0 +1,276 @@
+.. _walter:
+
+DPTechnics Walter
+#################
+
+Overview
+********
+
+Walter is a compact IoT development board that combines an Espressif ESP32-S3 SoC
+with a Sequans Monarch 2 GM02SP LTE-M/NB-IoT/GNSS modem.
+More information about Walter can be found on the `QuickSpot Website`_ and on the
+`QuickSpot GitHub page`_.
+
+.. figure:: img/walter.webp
+   :align: center
+   :alt: DPTechnics Walter board
+
+   DPTechnics Walter board (Credit: DPTechnics bv)
+
+Hardware
+********
+
+ESP32-S3-WROOM-1-N16R2 microcontroller:
+
+- Xtensa dual-core 32-bit LX7 CPU
+- 16 MiB quad SPI flash memory
+- 2 MiB quad SPI PSRAM
+- 150 Mbps 802.11 b/g/n Wi-Fi 4 with on-board PCB antenna
+- 2 Mbps Bluetooth 5 Low Energy with on-board PCB antenna
+
+Sequans Monarch 2 GM02SP modem:
+
+- Dual-mode LTE-M / NB-IoT (NB1, NB2)
+- 3GPP LTE release 14 (Upgradable up to release 17)
+- Ultra-low, deep-sleep mode in eDRX and PSM
+- Adaptive +23 dBm, +20 dBm and +14 dBm output power
+- Integrated LNA and SAW filter for GNSS reception
+- Assisted and non-assisted GNSS with GPS and Galileo constellations
+- Integrated SIM card
+- Nano-SIM card slot
+- u.FL RF connectors for GNSS and 5G antennas
+
+Inputs & outputs:
+
+- 24 GPIO pins for application use
+- UART, SPI, I²C, CAN, I²S, and SD available on any of the GPIO pins
+- ADC, DAC, and PWM integrated in ESP32-S3
+- 3.3 V software-controllable output
+- USB Type-C connector for flashing and debugging
+- 22 test points for production programming and testing
+- On-board reset button
+
+Power supply
+
+- 5.0 V via USB Type-C
+- 3.0 - 5.5 V via Vin pin
+- Not allowed to use both power inputs simultaneously
+- Designed for extremely low quiescent current
+
+Form factor
+
+- Easy to integrate via 2.54 mm headers
+- 55 mm x 24.8 mm board dimensions
+- Pin and footprint compatible with EOL Pycom GPy
+- Breadboard friendly
+
+Supported Features
+==================
+
+Current Zephyr's Walter board supports the following features:
+
++------------+------------+-------------------------------------+
+| Interface  | Controller | Driver/Component                    |
++============+============+=====================================+
+| UART       | on-chip    | serial port                         |
++------------+------------+-------------------------------------+
+| GPIO       | on-chip    | gpio                                |
++------------+------------+-------------------------------------+
+| PINMUX     | on-chip    | pinmux                              |
++------------+------------+-------------------------------------+
+| USB-JTAG   | on-chip    | hardware interface                  |
++------------+------------+-------------------------------------+
+| SPI Master | on-chip    | spi                                 |
++------------+------------+-------------------------------------+
+| TWAI/CAN   | on-chip    | can                                 |
++------------+------------+-------------------------------------+
+| ADC        | on-chip    | adc                                 |
++------------+------------+-------------------------------------+
+| Timers     | on-chip    | counter                             |
++------------+------------+-------------------------------------+
+| Watchdog   | on-chip    | watchdog                            |
++------------+------------+-------------------------------------+
+| TRNG       | on-chip    | entropy                             |
++------------+------------+-------------------------------------+
+| LEDC       | on-chip    | pwm                                 |
++------------+------------+-------------------------------------+
+| MCPWM      | on-chip    | pwm                                 |
++------------+------------+-------------------------------------+
+| PCNT       | on-chip    | qdec                                |
++------------+------------+-------------------------------------+
+| GDMA       | on-chip    | dma                                 |
++------------+------------+-------------------------------------+
+| USB-CDC    | on-chip    | serial                              |
++------------+------------+-------------------------------------+
+| Wi-Fi      | on-chip    |                                     |
++------------+------------+-------------------------------------+
+| Bluetooth  | on-chip    |                                     |
++------------+------------+-------------------------------------+
+| Cellular   | on-board   | modem_cellular                      |
++------------+------------+-------------------------------------+
+
+Prerequisites
+-------------
+
+Espressif HAL requires WiFi and Bluetooth binary blobs in order work. Run the command
+below to retrieve those files.
+
+.. code-block:: console
+
+   west blobs fetch hal_espressif
+
+.. note::
+
+   It is recommended running the command above after :file:`west update`.
+
+Building & Flashing
+*******************
+
+Simple boot
+===========
+
+The board could be loaded using the single binary image, without 2nd stage bootloader.
+It is the default option when building the application without additional configuration.
+
+.. note::
+
+   Simple boot does not provide any security features nor OTA updates.
+
+MCUboot bootloader
+==================
+
+User may choose to use MCUboot bootloader instead. In that case the bootloader
+must be build (and flash) at least once.
+
+There are two options to be used when building an application:
+
+1. Sysbuild
+2. Manual build
+
+.. note::
+
+   User can select the MCUboot bootloader by adding the following line
+   to the board default configuration file.
+
+   .. code:: cfg
+
+      CONFIG_BOOTLOADER_MCUBOOT=y
+
+Sysbuild
+========
+
+The sysbuild makes possible to build and flash all necessary images needed to
+bootstrap the board with the ESP32-S3 SoC.
+
+To build the sample application using sysbuild use the command:
+
+.. zephyr-app-commands::
+   :tool: west
+   :app: samples/hello_world
+   :board: walter/esp32s3/procpu
+   :goals: build
+   :west-args: --sysbuild
+   :compact:
+
+By default, the ESP32 sysbuild creates bootloader (MCUboot) and application
+images. But it can be configured to create other kind of images.
+
+Build directory structure created by sysbuild is different from traditional
+Zephyr build. Output is structured by the domain subdirectories:
+
+.. code-block::
+
+  build/
+  ├── hello_world
+  │   └── zephyr
+  │       ├── zephyr.elf
+  │       └── zephyr.bin
+  ├── mcuboot
+  │    └── zephyr
+  │       ├── zephyr.elf
+  │       └── zephyr.bin
+  └── domains.yaml
+
+.. note::
+
+   With ``--sysbuild`` option the bootloader will be re-build and re-flash
+   every time the pristine build is used.
+
+For more information about the system build please read the :ref:`sysbuild` documentation.
+
+Manual build
+============
+
+During the development cycle, it is intended to build & flash as quickly possible.
+For that reason, images can be build one at a time using traditional build.
+
+The instructions following are relevant for both manual build and sysbuild.
+The only difference is the structure of the build directory.
+
+.. note::
+
+   Remember that bootloader (MCUboot) needs to be flash at least once.
+
+Build and flash applications as usual (see :ref:`build_an_application` and
+:ref:`application_run` for more details).
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/hello_world
+   :board: walter/esp32s3/procpu
+   :goals: build
+
+The usual ``flash`` target will work with the ``walter`` board
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
+application.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/hello_world
+   :board: walter/esp32s3/procpu
+   :goals: flash
+
+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! walter/esp32s3/procpu
+
+Debugging
+*********
+
+ESP32-S3 support on OpenOCD is available at `OpenOCD ESP32`_.
+
+ESP32-S3 has a built-in JTAG circuitry and can be debugged without any additional chip. Only an USB cable connected to the D+/D- pins is necessary.
+
+Further documentation can be obtained from the SoC vendor in `JTAG debugging for ESP32-S3`_.
+
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/hello_world
+   :board: walter/esp32s3/procpu
+   :goals: build flash
+
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/hello_world
+   :board: walter/esp32s3/procpu
+   :goals: debug
+
+References
+**********
+
+.. target-notes::
+
+.. _`QuickSpot Website`: https://www.quickspot.io/
+.. _`QuickSpot GitHub page`: https://github.com/QuickSpot
+.. _`JTAG debugging for ESP32-S3`: https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/api-guides/jtag-debugging/
+.. _`OpenOCD ESP32`: https://github.com/openocd-org/openocd

boards/dptechnics/walter/support/openocd.cfg

@@ -0,0 +1,7 @@
+set ESP_RTOS none
+set ESP32_ONLYCPU 1
+
+# Source the JTAG interface configuration file
+source [find interface/esp_usb_jtag.cfg]
+# Source the ESP32-S3 configuration file
+source [find target/esp32s3.cfg]

boards/dptechnics/walter/walter-pinctrl.dtsi

@@ -0,0 +1,91 @@
+/*
+ * Copyright (c) 2024 DPTechnics bv
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/dt-bindings/pinctrl/esp-pinctrl-common.h>
+#include <dt-bindings/pinctrl/esp32s3-pinctrl.h>
+#include <zephyr/dt-bindings/pinctrl/esp32s3-gpio-sigmap.h>
+
+&pinctrl {
+	uart0_default: uart0_default {
+		group1 {
+			pinmux = <UART0_TX_GPIO43>;
+			output-high;
+		};
+		group2 {
+			pinmux = <UART0_RX_GPIO44>;
+			bias-pull-up;
+		};
+	};
+
+	uart1_default: uart1_default {
+		group1 {
+			pinmux = <UART1_TX_GPIO48>;
+			output-high;
+		};
+		group2 {
+			pinmux = <UART1_RX_GPIO14>;
+			bias-pull-up;
+		};
+		group3 {
+			pinmux = <UART1_RTS_GPIO21>;
+			output-high;
+		};
+		group4 {
+			pinmux = <UART1_CTS_GPIO47>;
+		};
+	};
+
+	i2c0_default: i2c0_default {
+		group1 {
+			pinmux = <I2C0_SDA_GPIO1>,
+				 <I2C0_SCL_GPIO2>;
+			bias-pull-up;
+			drive-open-drain;
+			output-high;
+		};
+	};
+
+	i2c1_default: i2c1_default {
+		group1 {
+			pinmux = <I2C1_SDA_GPIO4>,
+				 <I2C1_SCL_GPIO5>;
+			bias-pull-up;
+			drive-open-drain;
+			output-high;
+		};
+	};
+
+	spim2_default: spim2_default {
+		group1 {
+			pinmux = <SPIM2_MISO_GPIO13>,
+				 <SPIM2_SCLK_GPIO12>,
+				 <SPIM2_CSEL_GPIO10>;
+		};
+		group2 {
+			pinmux = <SPIM2_MOSI_GPIO11>;
+			output-low;
+		};
+	};
+
+	spim3_default: spim3_default {
+		group1 {
+			pinmux = <SPIM3_MISO_GPIO37>,
+				 <SPIM3_SCLK_GPIO36>,
+				 <SPIM3_CSEL_GPIO38>;
+		};
+		group2 {
+			pinmux = <SPIM3_MOSI_GPIO39>;
+			output-low;
+		};
+	};
+
+	twai_default: twai_default {
+		group1 {
+			pinmux = <TWAI_TX_GPIO5>,
+				 <TWAI_RX_GPIO6>;
+		};
+	};
+};

boards/dptechnics/walter/walter_esp32s3_appcpu.dts

@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2024 DPTechnics bv
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/dts-v1/;
+
+#include <espressif/esp32s3/esp32s3_appcpu.dtsi>
+#include <espressif/partitions_0x0_amp.dtsi>
+
+/ {
+	model = "DPTechnics Walter APPCPU";
+	compatible = "espressif,esp32s3";
+
+	chosen {
+		zephyr,sram = &sram0;
+		zephyr,ipc_shm = &shm0;
+		zephyr,ipc = &ipm0;
+	};
+};
+
+&trng0 {
+	status = "okay";
+};
+
+&ipm0 {
+	status = "okay";
+};

boards/dptechnics/walter/walter_esp32s3_appcpu.yaml

@@ -0,0 +1,27 @@
+identifier: walter/esp32s3/appcpu
+name: Walter APPCPU
+type: mcu
+arch: xtensa
+toolchain:
+  - zephyr
+supported:
+  - uart
+testing:
+  ignore_tags:
+    - net
+    - bluetooth
+    - flash
+    - cpp
+    - posix
+    - watchdog
+    - logging
+    - kernel
+    - pm
+    - gpio
+    - crypto
+    - eeprom
+    - heap
+    - cmsis_rtos
+    - jwt
+    - zdsp
+vendor: dptechnics

boards/dptechnics/walter/walter_esp32s3_appcpu_defconfig

@@ -0,0 +1,4 @@
+# SPDX-License-Identifier: Apache-2.0
+
+CONFIG_MAIN_STACK_SIZE=2048
+CONFIG_CLOCK_CONTROL=y

boards/dptechnics/walter/walter_esp32s3_procpu.dts

@@ -0,0 +1,122 @@
+/*
+ * Copyright (c) 2024 DPTechnics bv
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/dts-v1/;
+
+#include "espressif/esp32s3/esp32s3_wroom_n16r2.dtsi"
+#include "walter-pinctrl.dtsi"
+#include <espressif/partitions_0x0_amp_8M.dtsi>
+
+/ {
+	model = "DPTechnics Walter PROCPU";
+	compatible = "espressif,esp32s3";
+
+	aliases {
+		modem = &modem;
+		modem-uart = &uart1;
+		i2c-0 = &i2c0;
+		watchdog0 = &wdt0;
+		uart-0 = &usb_serial;
+	};
+
+	chosen {
+		zephyr,sram = &sram0;
+		zephyr,console = &usb_serial;
+		zephyr,shell-uart = &usb_serial;
+		zephyr,flash = &flash0;
+		zephyr,code-partition = &slot0_partition;
+		zephyr,bt-hci = &esp32_bt_hci;
+	};
+};
+
+&usb_serial {
+	status = "okay";
+};
+
+&uart0 {
+	status = "disabled";
+};
+
+&uart1 {
+	status = "okay";
+	current-speed = <115200>;
+	hw-flow-control;
+	pinctrl-0 = <&uart1_default>;
+	pinctrl-names = "default";
+	modem: modem {
+		status = "okay";
+		compatible = "sqn,gm02s";
+		mdm-reset-gpios = <&gpio1 13 (GPIO_OPEN_DRAIN | GPIO_ACTIVE_LOW)>;
+	};
+};
+
+&gpio0 {
+	status = "okay";
+};
+
+&gpio1 {
+	status = "okay";
+};
+
+&i2c0 {
+	clock-frequency = <I2C_BITRATE_STANDARD>;
+	pinctrl-0 = <&i2c0_default>;
+	pinctrl-names = "default";
+};
+
+&i2c1 {
+	clock-frequency = <I2C_BITRATE_STANDARD>;
+	pinctrl-0 = <&i2c1_default>;
+	pinctrl-names = "default";
+};
+
+&spi2 {
+	#address-cells = <1>;
+	#size-cells = <0>;
+	status = "okay";
+	pinctrl-0 = <&spim2_default>;
+	pinctrl-names = "default";
+};
+
+&spi3 {
+	#address-cells = <1>;
+	#size-cells = <0>;
+	status = "okay";
+	pinctrl-0 = <&spim3_default>;
+	pinctrl-names = "default";
+};
+
+&twai {
+	pinctrl-0 = <&twai_default>;
+	pinctrl-names = "default";
+};
+
+&timer0 {
+	status = "disabled";
+};
+
+&timer1 {
+	status = "disabled";
+};
+
+&timer2 {
+	status = "disabled";
+};
+
+&timer3 {
+	status = "disabled";
+};
+
+&wdt0 {
+	status = "okay";
+};
+
+&trng0 {
+	status = "okay";
+};
+
+&esp32_bt_hci {
+	status = "okay";
+};

boards/dptechnics/walter/walter_esp32s3_procpu.yaml

@@ -0,0 +1,23 @@
+identifier: walter/esp32s3/procpu
+name: Walter PROCPU
+type: mcu
+arch: xtensa
+toolchain:
+  - zephyr
+supported:
+  - gpio
+  - uart
+  - i2c
+  - spi
+  - can
+  - counter
+  - watchdog
+  - entropy
+  - pwm
+  - dma
+  - input
+testing:
+  ignore_tags:
+    - net
+    - bluetooth
+vendor: dptechnics

boards/dptechnics/walter/walter_esp32s3_procpu_defconfig

@@ -0,0 +1,10 @@
+# SPDX-License-Identifier: Apache-2.0
+
+CONFIG_MAIN_STACK_SIZE=2048
+
+CONFIG_CONSOLE=y
+CONFIG_SERIAL=y
+CONFIG_UART_CONSOLE=y
+CONFIG_UART_INTERRUPT_DRIVEN=y
+CONFIG_GPIO=y
+CONFIG_CLOCK_CONTROL=y