1.. zephyr:board:: m5stack_atoms3
2
3Overview
4********
5
6M5Stack AtomS3 is an ESP32-based development board from M5Stack.
7
8It features the following integrated components:
9
10- ESP32-S3FN8 chip (240MHz dual core, Wi-Fi/BLE 5.0)
11- 512KB of SRAM
12- 384KB of ROM
13- 8MB of Flash
14- LCD IPS TFT 0.85", 128x128 px screen (ST7789 compatible)
15- 6-axis IMU MPU6886
16- Infrared emitter
17
18Supported Features
19==================
20
21The Zephyr m5stack_atoms3 board configuration supports the following hardware features:
22
23+-----------+------------+-------------------------------------+
24| Interface | Controller | Driver/Component                    |
25+===========+============+=====================================+
26| NVIC      | on-chip    | nested vector interrupt controller  |
27+-----------+------------+-------------------------------------+
28| UART      | on-chip    | serial port-polling;                |
29|           |            | serial port-interrupt               |
30+-----------+------------+-------------------------------------+
31| PINMUX    | on-chip    | pinmux                              |
32+-----------+------------+-------------------------------------+
33| GPIO      | on-chip    | gpio                                |
34+-----------+------------+-------------------------------------+
35| I2C       | on-chip    | i2c                                 |
36+-----------+------------+-------------------------------------+
37| SPI       | on-chip    | spi                                 |
38+-----------+------------+-------------------------------------+
39| CLOCK     | on-chip    | reset and clock control             |
40+-----------+------------+-------------------------------------+
41| COUNTER   | on-chip    | rtc                                 |
42+-----------+------------+-------------------------------------+
43| WATCHDOG  | on-chip    | independent watchdog                |
44+-----------+------------+-------------------------------------+
45| PWM       | on-chip    | pwm                                 |
46+-----------+------------+-------------------------------------+
47| ADC       | on-chip    | adc                                 |
48+-----------+------------+-------------------------------------+
49| DAC       | on-chip    | dac                                 |
50+-----------+------------+-------------------------------------+
51| die-temp  | on-chip    | die temperature sensor              |
52+-----------+------------+-------------------------------------+
53
54
55Start Application Development
56*****************************
57
58Before powering up your M5Stack AtomS3, please make sure that the board is in good
59condition with no obvious signs of damage.
60
61System requirements
62===================
63
64Prerequisites
65-------------
66
67Espressif HAL requires WiFi and Bluetooth binary blobs in order work. Run the command
68below to retrieve those files.
69
70.. code-block:: shell
71
72   west blobs fetch hal_espressif
73
74.. note::
75
76   It is recommended running the command above after :file:`west update`.
77
78Building & Flashing
79-------------------
80
81Build and flash applications as usual (see :ref:`build_an_application` and
82:ref:`application_run` for more details).
83
84.. zephyr-app-commands::
85   :zephyr-app: samples/hello_world
86   :board: m5stack_atoms3/esp32s3/procpu
87   :goals: build
88
89The usual ``flash`` target will work with the ``m5stack_atoms3`` board
90configuration. Here is an example for the :zephyr:code-sample:`hello_world`
91application.
92
93.. zephyr-app-commands::
94   :zephyr-app: samples/hello_world
95   :board: m5stack_atoms3/esp32s3/procpu
96   :goals: flash
97
98The baud rate of 921600bps is set by default. If experiencing issues when flashing,
99try using different values by using ``--esp-baud-rate <BAUD>`` option during
100``west flash`` (e.g. ``west flash --esp-baud-rate 115200``).
101
102You can also open the serial monitor using the following command:
103
104.. code-block:: shell
105
106   west espressif monitor
107
108After the board has automatically reset and booted, you should see the following
109message in the monitor:
110
111.. code-block:: console
112
113   ***** Booting Zephyr OS vx.x.x-xxx-gxxxxxxxxxxxx *****
114   Hello World! m5stack_atoms3
115
116Debugging
117---------
118
119M5Stack AtomS3 debugging is not supported due to pinout limitations.
120
121Related Documents
122*****************
123
124- `M5Stack AtomS3 schematic <https://static-cdn.m5stack.com/resource/docs/products/core/AtomS3/img-b85e925c-adff-445d-994c-45987dc97a44.jpg>`_
125- `ESP32S3 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_en.pdf>`_
126