boards/esp32s3-seeedstudio: seeedstudio xiao esp32s3 board support. m…

…ostly copied from esp32s3-pros3 board files.

boards/esp32s3-seeedstudio/Kconfig

@@ -0,0 +1,17 @@
+# Copyright (c) 2024 TUDresden
+#               2024 Isikcan 'Jon' Yilmaz - TUDresden
+#
+# This file is subject to the terms and conditions of the GNU Lesser
+# General Public License v2.1. See the file LICENSE in the top level
+# directory for more details.
+
+config BOARD
+    default "esp32s3-seeedstudio" if BOARD_ESP32S3_SEEEDSTUDIO
+
+config BOARD_ESP32S3_SEEEDSTUDIO
+    bool
+    default y
+    select BOARD_COMMON_ESP32S3
+    select CPU_MODEL_ESP32S3
+
+source "$(RIOTBOARD)/common/esp32s3/Kconfig"

boards/esp32s3-seeedstudio/Makefile

@@ -0,0 +1,5 @@
+MODULE = board
+
+DIRS = $(RIOTBOARD)/common/esp32s3
+
+include $(RIOTBASE)/Makefile.base

boards/esp32s3-seeedstudio/Makefile.dep

@@ -0,0 +1,18 @@
+ifeq (,$(filter stdio_% slipdev_stdio usbus usbus% tinyusb_device,$(USEMODULE)))
+  # Use stdio_usb_serial_jtag if no other stdio is requested explicitly
+  # and neither USBUS nor tinyusb_device are used
+  USEMODULE += stdio_usb_serial_jtag
+  # Even if only stdio_usb_serial_jtag is enabled, usb_board_reset is enabled
+  # since there should be a CDC ACM interface in any case. This is necessary,
+  # for example, to reset the board if stdio_cdc_acm or stdio_tinyusb_cdc_acm
+  # was previously used.
+  USEMODULE += usb_board_reset
+  include $(RIOTMAKE)/tools/usb_board_reset.mk
+endif
+
+ifneq (,$(filter saul_default,$(USEMODULE)))
+  USEMODULE += saul_gpio
+endif
+
+include $(RIOTBOARD)/common/esp32s3/Makefile.dep
+include $(RIOTBOARD)/common/makefiles/stdio_cdc_acm.dep.mk

boards/esp32s3-seeedstudio/Makefile.features

@@ -0,0 +1,18 @@
+# the board uses a ESP32-S3 with a 16MB QSPI Flash and a 8MB QSPI PSRAM
+CPU_MODEL = esp32s3
+FEATURES_PROVIDED += esp_spi_ram
+
+# common board and CPU features
+include $(RIOTBOARD)/common/esp32s3/Makefile.features
+
+# peripherals provided by the board
+FEATURES_PROVIDED += periph_adc
+FEATURES_PROVIDED += periph_i2c
+FEATURES_PROVIDED += periph_pwm
+FEATURES_PROVIDED += periph_spi
+FEATURES_PROVIDED += periph_usbdev
+
+# other features provided by the board
+FEATURES_PROVIDED += esp_jtag
+FEATURES_PROVIDED += highlevel_stdio
+FEATURES_PROVIDED += tinyusb_device

boards/esp32s3-seeedstudio/Makefile.include

@@ -0,0 +1,8 @@
+# The board uses a ESP32-S3 with a 16MB QSPI Flash and a 8MB QSPI PSRAM
+FLASH_SIZE ?= 16
+
+PORT_LINUX ?= /dev/ttyACM0
+
+OPENOCD_CONFIG ?= board/esp32s3-builtin.cfg
+
+include $(RIOTBOARD)/common/esp32s3/Makefile.include

boards/esp32s3-seeedstudio/doc.txt

@@ -0,0 +1,136 @@
+/*
+ * Copyright (C) 2024 Isikcan 'Jon' Yilmaz
+ *
+ * This file is subject to the terms and conditions of the GNU Lesser
+ * General Public License v2.1. See the file LICENSE in the top level
+ * directory for more details.
+ */
+
+/**
+ * @defgroup    boards_esp32s3_seeedstudio ESP32 Seeed Studio XIAO Board
+ * @ingroup     boards_esp32s3
+ * @brief       Support for the Seeed Studio Xiao ESP32S3
+ * @author      Isikcan 'Jon' Yilmaz <[email protected]>
+
+\section esp32s3_seeedstudio Seeed Studio Xiao ESP32
+
+## Table of Contents {#esp32s3_seeedstudio_toc}
+
+1. [Overview](#esp32s3_seeedstudio_overview)
+2. [Hardware](#esp32s3_seeedstudio_hardware)
+    1. [MCU](#esp32s3_seeedstudio_mcu)
+    2. [Board Configuration](#esp32s3_seeedstudio_board_configuration)
+    3. [Board Pinout](#esp32s3_seeedstudio_pinout)
+3. [Flashing the Device](#esp32s3_seeedstudio_flashing)
+4. [Using STDIO](#esp32s3_seeedstudio_stdio)
+
+## Overview {#esp32s3_seeedstudio_overview}
+
+The Seeed Studio ESP32S3 is one of the ESP32-S3 boards from Seeed Studio.
+\image html https://files.seeedstudio.com/wiki/SeeedStudio-XIAO-ESP32S3/img/xiaoesp32s3.jpg "Seeed Studio ESP32S3" width=800px
+
+Vendor's info page for the board [here](https://wiki.seeedstudio.com/xiao_esp32s3_getting_started/)
+
+The main features of the board are:
+
+- ESP32-S3 SoC with 2.4 GHz WiFi 802.11b/g/n and Bluetooth5, BLE
+- 8 MByte Flash
+- 8 MByte QSPI RAM
+- Native USB and USB Serial JTAG
+- 21 x 17.8 mm footprint
+
+[Back to table of contents](#esp32s3_seeedstudio_toc)
+
+## Hardware {#esp32s3_seeedstudio_hardware}
+
+This section describes
+
+- the [MCU](#esp32s3_seeedstudio_mcu),
+- the default [board configuration](#esp32s3_seeedstudio_board_configuration),
+- the [board pinout](#esp32s3_seeedstudio_pinout).
+
+[Back to table of contents](#esp32s3_seeedstudio_toc)
+
+### MCU {#esp32s3_seeedstudio_mcu}
+
+Most features of the board are provided by the ESP32-S3 SoC. For detailed
+information about the ESP32-S3 SoC variant (family) and ESP32x SoCs,
+see section \ref esp32_mcu_esp32 "ESP32 SoC Series".
+
+[Back to table of contents](#esp32s3_seeedstudio_toc)
+
+### Board Configuration {#esp32s3_seeedstudio_board_configuration}
+
+Seeed Studio Xiao ESP32S3 boards have no special hardware on board, besides a yellow LED connected to GPIO21.
+
+The default board configuration provides:
+
+- 9 x ADC
+- 1 x SPI
+- 1 x I2C
+- 1 x UART
+- 10 x PWM, 4 channels each
+
+For detailed information about the peripheral configurations of ESP32-S3
+boards, see section \ref esp32_peripherals "Common Peripherals".
+
+[Back to table of contents](#esp32s3_seeedstudio_toc)
+
+### Board Pinout {#esp32s3_seeedstudio_pinout}
+
+The following figure shows the pinout as configured by board definition (excluding the camera module).
+
+@image html https://files.seeedstudio.com/wiki/SeeedStudio-XIAO-ESP32S3/img/2.jpg "Seeed Studio Xiao ESP32S3 Pinout" width=900px
+
+The corresponding board schematic can be found
+[here](https://files.seeedstudio.com/wiki/SeeedStudio-XIAO-ESP32S3/res/XIAO_ESP32S3_SCH_v1.2.pdf)
+
+[Back to table of contents](#esp32s3_seeedstudio_toc)
+
+## Flashing the Device {#esp32s3_seeedstudio_flashing}
+
+Since the board does not have a USB-to-Serial chip, the easiest way to flash
+the board is using the USB Serial/JTAG interface. Just connect the board to
+your host computer and use the following command:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+BOARD=esp32s3-seeedstudio make flash ...
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+@note Usually the make system resets the board before flashing to enable the
+USB Serial/JTAG interface. In some special cases this reset does not work so
+that the programmer cannot connect to the board and the flashing is aborted
+with a timeout:
+```
+Serial port /dev/ttyACM0
+Connecting...
+...
+serial.serialutil.SerialTimeoutException: Write timeout
+```
+This can happen for example if the board is not yet flashed with RIOT or the
+USB interface is used for another purpose. In this case, restart the board
+manually in download mode by pressing and releasing the RESET button while
+holding down the BOOT button. In download mode, the USB Serial/JTAG interface is
+always available.
+
+For detailed information about ESP32-S3 as well as configuring and compiling
+RIOT for ESP32-S3 boards, see \ref esp32_riot.
+
+[Back to table of contents](#esp32s3_seeedstudio_toc)
+
+## Using STDIO {#esp32s3_seeedstudio_stdio}
+
+Since the board does not have a USB-to-Serial chip, the USB Serial/JTAG
+interface is used by default for the STDIO (module `stdio_usb_serial_jtag`)
+which provides an USB CDC ACM interface.
+
+If the USB port is used by the USBUS stack or the tinyUSB stack, implicitly
+the module `stdio_cdc_acm` or `stdio_tinyusb_cdc_acm` is used for the STDIO
+via the USB CDC ACM interface.
+
+Alternatively, the UART interface could be used with an external USB-to-Serial
+adapter. Simply add `stdio_uart` to the list of used modules for this purpose:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+BOARD=esp32s3-seeedstudio USEMODULE=stdio_uart make flash ...
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+ */

boards/esp32s3-seeedstudio/include/board.h

@@ -0,0 +1,90 @@
+/*
+ * Copyright (C) 2024 Isikcan 'Jon' Yilmaz
+ *
+ * This file is subject to the terms and conditions of the GNU Lesser
+ * General Public License v2.1. See the file LICENSE in the top level
+ * directory for more details.
+ */
+
+/**
+ * @ingroup     boards_esp32s3_seeedstudio
+ * @brief       Board definitions for Seeed Studio Xiao ESP32S3 board
+ * @{
+ *
+ * The board definitions in this file are valid for the Seeed Studio Xiao ESP32S3 board.
+ *
+ * Any modifications required for specific applications
+ * can be overridden by \ref esp32_application_specific_configurations
+ * "application-specific board configuration".
+ *
+ * @file
+ * @author      Isikcan 'Jon' Yilmaz <[email protected]>
+ */
+
+#ifndef BOARD_H
+#define BOARD_H
+
+#include <stdint.h>
+
+/**
+ * @name    Button pin definitions
+ * @{
+ */
+
+/**
+ * @brief   Default button GPIO pin definition
+ *
+ * Seeed Studio Xiao ESP32S3 boards have a BOOT button connected to GPIO0, which can be
+ * used as button during normal operation. Since the GPIO0 pin is pulled up,
+ * the button signal is inverted, i.e., pressing the button will give a
+ * low signal.
+ */
+#define BTN0_PIN        GPIO0
+
+/**
+ * @brief   Default button GPIO mode definition
+ *
+ * Since the GPIO of the button is pulled up with an external resistor, the
+ * mode for the GPIO pin has to be GPIO_IN.
+ */
+#define BTN0_MODE       GPIO_IN_PU
+
+/**
+ * @brief   Default interrupt flank definition for the button GPIO
+ */
+#ifndef BTN0_INT_FLANK
+#define BTN0_INT_FLANK  GPIO_FALLING
+#endif
+
+/**
+ * @brief   Definition for compatibility with previous versions
+ */
+#define BUTTON0_PIN     BTN0_PIN
+
+/** @} */
+
+/**
+ * @name    LED (on-board) configuration
+ *
+ * The Seeed Studio Xiao ESP32S3 board has one red LED connected to GPIO21.
+ * @{
+ */
+/** @} */
+#ifndef LED0_PIN
+#define LED0_PIN        GPIO21
+#define LED0_ACTIVE     (0)
+#endif
+
+/* include common board definitions as last step */
+#include "board_common.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#ifdef __cplusplus
+} /* end extern "C" */
+#endif
+
+#endif /* BOARD_H */
+/** @} */

boards/esp32s3-seeedstudio/include/gpio_params.h

@@ -0,0 +1,51 @@
+/*
+ * Copyright (C) 2024 Isikcan 'Jon' Yilmaz
+ *
+ * This file is subject to the terms and conditions of the GNU Lesser
+ * General Public License v2.1. See the file LICENSE in the top level
+ * directory for more details.
+ */
+
+#ifndef GPIO_PARAMS_H
+#define GPIO_PARAMS_H
+
+/**
+ * @ingroup     boards_esp32s3_seeedstudio
+ * @brief       Board specific configuration of direct mapped GPIOs
+ * @file
+ * @author      Isikcan 'Jon' Yilmaz <[email protected]>
+ * @{
+ */
+
+#include "board.h"
+#include "saul/periph.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief   LED and Button configuration
+ */
+static const  saul_gpio_params_t saul_gpio_params[] =
+{
+    {
+        .name = "BOOT",
+        .pin = BTN0_PIN,
+        .mode = BTN0_MODE,
+        .flags = SAUL_GPIO_INVERTED
+    },
+    {
+        .name = "LED",
+        .pin = LED0_PIN,
+        .mode = GPIO_OUT,
+        .flags = SAUL_GPIO_INIT_CLEAR
+    },
+};
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* GPIO_PARAMS_H */
+/** @} */