.. _m5stack_atoms3: M5Stack AtomS3 ############## Overview ******** M5Stack AtomS3 is an ESP32-based development board from M5Stack. It features the following integrated components: - ESP32-S3FN8 chip (240MHz dual core, Wi-Fi/BLE 5.0) - 512KB of SRAM - 384KB of ROM - 8MB of Flash - LCD IPS TFT 0.85", 128x128 px screen (ST7789 compatible) - 6-axis IMU MPU6886 - Infrared emitter .. figure:: img/m5stack_atoms3.webp :align: center :alt: M5Stack AtomS3 M5Stack AtomS3 Supported Features ================== The Zephyr m5stack_atoms3 board configuration supports the following hardware features: +-----------+------------+-------------------------------------+ | Interface | Controller | Driver/Component | +===========+============+=====================================+ | NVIC | on-chip | nested vector interrupt controller | +-----------+------------+-------------------------------------+ | UART | on-chip | serial port-polling; | | | | serial port-interrupt | +-----------+------------+-------------------------------------+ | PINMUX | on-chip | pinmux | +-----------+------------+-------------------------------------+ | GPIO | on-chip | gpio | +-----------+------------+-------------------------------------+ | I2C | on-chip | i2c | +-----------+------------+-------------------------------------+ | SPI | on-chip | spi | +-----------+------------+-------------------------------------+ | CLOCK | on-chip | reset and clock control | +-----------+------------+-------------------------------------+ | COUNTER | on-chip | rtc | +-----------+------------+-------------------------------------+ | WATCHDOG | on-chip | independent watchdog | +-----------+------------+-------------------------------------+ | PWM | on-chip | pwm | +-----------+------------+-------------------------------------+ | ADC | on-chip | adc | +-----------+------------+-------------------------------------+ | DAC | on-chip | dac | +-----------+------------+-------------------------------------+ | die-temp | on-chip | die temperature sensor | +-----------+------------+-------------------------------------+ Start Application Development ***************************** Before powering up your M5Stack AtomS3, 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:: shell 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_atoms3/esp32s3/procpu :goals: build The usual ``flash`` target will work with the ``m5stack_atoms3`` board configuration. Here is an example for the :ref:`hello_world` application. .. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: m5stack_atoms3/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_atoms3 Debugging --------- M5Stack AtomS3 debugging is not supported due to pinout limitations. Related Documents ***************** - `M5Stack AtomS3 schematic `_ - `ESP32S3 Datasheet `_