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