.. zephyr:board:: m5stack_stamps3 Overview ******** M5Stack StampS3 is an ESP32-based development board from M5Stack. It features the following integrated components: - ESP32-S3FN8 chip (240MHz dual core) - 512KB SRAM - 384KB ROM - 8MB Flash - Wi-Fi - Bluetooth - User-Button Functional Description ********************** The following table below describes the key components, interfaces, and controls of the M5Stack StampS3 module. +---------------+-----------------------------------------------------------------+-----------+ | Key Component | Description | Status | +===============+=================================================================+===========+ | ESP32-S3FN8 | This MPU-ESP32S3 module provides complete Wi-Fi and Bluetooth | supported | | module | functionalities and integrates a 8MB flash. | | +---------------+-----------------------------------------------------------------+-----------+ | Status LED | One user LED connected via :dtcompatible:`worldsemi,ws2812-spi` | supported | | | interface (``led-strip``). | | +---------------+-----------------------------------------------------------------+-----------+ | USB Port | USB interface. Power supply for the board as well as the | supported | | | communication interface between a computer and the board. | | +---------------+-----------------------------------------------------------------+-----------+ | User button | User button (``sw0``) | supported | +---------------+-----------------------------------------------------------------+-----------+ Main connector header ===================== The Zephyr m5stack_stamps3 board can be used on various applications. It therefore publishes a header definition to be used in different shields: :dtcompatible:`m5stack,stamps3-header`. .. figure:: img/m5stack_stamps3_header.webp :align: center :alt: M5Stack StampS3 Header :width: 400 px M5Stack StampS3 connector header Following interfaces are being exported for this header: - ``m5stack_stamps3_clkout0``: PWM output with 2 channels (0 and 2). - ``m5stack_stamps3_spilcd``: SPI interface for interfacing LCDs. Consists of a CLK, MOSI and CS signal. - ``m5stack_stamps3_i2c0`` and ``m5stack_stamps3_i2c1``: I2C interfaces (SDA, SCL). - ``m5stack_stamps3_uart0``: UART interface (RXD, TXD). - ``m5stack_stamps3_header``: All GPIOs are of course accessible via main header definition. +-----+-----------------------------------------+-----+---------------------------------+ | Pin | Functions | Pin | Functions | +=====+=========================================+=====+=================================+ | 1 | | | | +-----+-----------------------------------------+-----+---------------------------------+ | 2 | | | | +-----+-----------------------------------------+-----+---------------------------------+ | 3 | ``m5stack_stamps3_clkout0`` - Channel 0 | | | +-----+-----------------------------------------+-----+---------------------------------+ | 4 | | | | +-----+-----------------------------------------+-----+---------------------------------+ | 5 | ``m5stack_stamps3_spilcd`` - MOSI | | | +-----+-----------------------------------------+-----+---------------------------------+ | 6 | ``m5stack_stamps3_spilcd`` - CLK | | | +-----+-----------------------------------------+-----+---------------------------------+ | 7 | ``m5stack_stamps3_spilcd`` - CS | 28 | **3V3** | +-----+-----------------------------------------+-----+---------------------------------+ | 8 | | 27 | ``m5stack_stamps3_uart0`` - TXD | +-----+-----------------------------------------+-----+---------------------------------+ | 9 | ``m5stack_stamps3_clkout0`` - Channel 2 | 26 | | +-----+-----------------------------------------+-----+---------------------------------+ | 10 | | 25 | ``m5stack_stamps3_uart0`` - RXD | +-----+-----------------------------------------+-----+---------------------------------+ | 11 | **GND** | 24 | | +-----+-----------------------------------------+-----+---------------------------------+ | 12 | ``m5stack_stamps3_i2c1`` - SDA | 23 | | +-----+-----------------------------------------+-----+---------------------------------+ | 13 | **5V** | 22 | **EN** | +-----+-----------------------------------------+-----+---------------------------------+ | 14 | ``m5stack_stamps3_i2c1`` - SCL | 21 | | +-----+-----------------------------------------+-----+---------------------------------+ | 15 | ``m5stack_stamps3_i2c0`` - SDA | 20 | | +-----+-----------------------------------------+-----+---------------------------------+ | 16 | | 19 | | +-----+-----------------------------------------+-----+---------------------------------+ | 17 | ``m5stack_stamps3_i2c0`` - SCL | 18 | **GND** | +-----+-----------------------------------------+-----+---------------------------------+ Power supply ============ M5Stack StampS3 requires a single 5V input power supply. The module internally features a DCDC (MUN3CAD01-SC) to generate the 3.3V needed for the MCU. The **EN** signal (Pin 22) is an active low signal to enable the **3V3** power supply. If this pin is pulled low this main 3.3V power supply for the MCU will be deactivated. It is internally equipped with a pull-up and can hence be left open if unused. Start Application Development ***************************** Before powering up your M5Stack StampS3, please make sure that the board is in good condition with no obvious signs of damage. System requirements =================== 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 ------------------- 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: m5stack_stamps3/esp32s3/procpu :goals: build The usual ``flash`` target will work with the ``m5stack_stamps3`` board configuration. Here is an example for the :zephyr:code-sample:`hello_world` application. .. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: m5stack_stamps3/esp32s3/procpu :goals: flash The baud rate of 921600bps is set by default. If experiencing issues when flashing, try using different values by using ``--esp-baud-rate `` 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_stamps3 Debugging --------- M5Stack StampS3 exports a JTAG-interface via Pins 19 (MTCK), 21 (MTDO), 23 (MTDI), 25 (MTMS). .. note:: Please note that additional JTAG equipment is needed to utilize JTAG. Refer to the ESP32S3 datasheet and the M5Stack StampS3 documentation for details. Related Documents ***************** - `M5Stack StampS3 schematic `_ - `M5Stack StampS3 `_ - `ESP32 Datasheet `_ (PDF) - `ESP32 Hardware Reference `_