.. zephyr:board:: esp32s3_eye

Overview
********

The ESP32-S3-EYE is a small-sized AI development board produced by Espressif and based on the
ESP32-S3 SoC.
It features a 2-Megapixel camera, an LCD display, and a microphone, which are used for image
recognition and audio processing. ESP32-S3-EYE offers plenty of storage, with an 8 MB Octal PSRAM
and a 8 MB flash.

Hardware
********

The ESP32-S3-EYE board consists of two parts: the main board (ESP32-S3-EYE-MB) that integrates the
ESP32-S3-WROOM-1 module, camera, SD card slot, digital microphone, USB port, and function buttons;
and the sub board (ESP32-S3-EYE-SUB) that contains an LCD display.
The main board and sub board are connected through pin headers.

.. include:: ../../../espressif/common/soc-esp32s3-features.rst
   :start-after: espressif-soc-esp32s3-features

Supported Features
==================

.. zephyr:board-supported-hw::

Block Diagram
=============

The block diagram below presents main components of the ESP32-S3-EYE-MB main board (on the left)
and the ESP32-S3-EYE-SUB sub board (on the right), as well as the interconnections between
components.

.. figure:: img/ESP32-S3-EYE_20210913_V03_SystemBlock.webp
    :align: center
    :alt: ESP32-S3-EYE Block Diagram

Components on the ESP32-S3-EYE-MB Main Board
============================================

.. figure:: img/ESP32-S3-EYE_MB-annotated-photo.webp
    :align: center
    :alt: ESP32-S3-EYE_MB

.. list-table:: Key Components MB
   :header-rows: 1

   * - No.
     - Key Component
     - Description
   * - 1
     - Camera
     - The camera OV2640 with 2 million pixels has a 66.5° field of view and a maximum resolution of 1600x1200. You can change the resolution when developing applications.
   * - 2
     - Module Power LED
     - The LED (green) turns on when USB power is connected to the board. If it is not turned on, it indicates either the USB power is not supplied, or the 5 V to 3.3 V LDO is broken. Software can configure GPIO3 to set different LED statuses (turned on/off, flashing) for different statuses of the board. Note that GPIO3 must be set up in open-drain mode. Pulling GPIO3 up may burn the LED.
   * - 3
     - Pin Headers
     - Connect the female headers on the sub board.
   * - 4
     - 5 V to 3.3 V LDO
     - Power regulator that converts a 5 V supply into a 3.3 V output for the module.
   * - 5
     - Digital Microphone
     - The digital I2S MEMS microphone features 61 dB SNR and –26 dBFS sensitivity, working at 3.3 V.
   * - 6
     - FPC Connector
     - Connects the main board and the sub board.
   * - 7
     - Function Button
     - There are six function buttons on the board. Users can configure any functions as needed except for the RST button.
   * - 8
     - ESP32-S3-WROOM-1
     - The ESP32-S3-WROOM-1 module embeds the ESP32-S3R8 chip variant that provides Wi-Fi and Bluetooth 5 (LE) connectivity, as well as dedicated vector instructions for accelerating neural network computing and signal processing. On top of the integrated 8 MB Octal SPI PSRAM offered by the SoC, the module also comes with 8 MB flash, allowing for fast data access. ESP32-S3-WROOM-1U module is also supported.
   * - 9
     - MicroSD Card Slot
     - Used for inserting a MicroSD card to expand memory capacity.
   * - 10
     - 3.3 V to 1.5 V LDO
     - Power regulator that converts a 3.3 V supply into a 1.5 V output for the camera.
   * - 11
     - 3.3 V to 2.8 V LDO
     - Power regulator that converts a 3.3 V supply into a 2.8 V output for the camera.
   * - 12
     - USB Port
     - A Micro-USB port used for 5 V power supply to the board, as well as for communication with the chip via GPIO19 and GPIO20.
   * - 13
     - Battery Soldering Points
     - Used for soldering a battery socket to connect an external Li-ion battery that can serve as an alternative power supply to the board. If you use an external battery, make sure it has built-in protection circuit and fuse. The recommended specifications of the battery: capacity > 1000 mAh, output voltage 3.7 V, input voltage 4.2 V – 5 V.
   * - 14
     - Battery Charger Chip
     - 1 A linear Li-ion battery charger (ME4054BM5G-N) in ThinSOT package. The power source for charging is the **USB Port**.
   * - 15
     - Battery Red LED
     - When the USB power is connected to the board and a battery is not connected, the red LED blinks. If a battery is connected and being charged, the red LED turns on. When the battery is fully charged, it turns off.
   * - 16
     - Accelerometer
     - Three-axis accelerometer (QMA7981) for screen rotation, etc.

Components on the ESP32-S3-EYE-SUB Sub Board
============================================

.. figure:: img/ESP32-S3-EYE_SUB-annotated-photo.webp
    :align: center
    :alt: ESP32-S3-EYE_SUB

.. list-table:: Key Components SUB
   :header-rows: 1

   * - Key Component
     - Description
   * - LCD Display
     - 1.3” LCD display, connected to ESP32-S3 over the SPI bus.
   * - Strapping Pins
     - Four strapping pins led out from the main board. They can be used as testing points.
   * - Female Headers
     - Used for mounting onto the pin headers on the main board.
   * - LCD FPC Connector
     - Connects the sub board and the LCD display.
   * - LCD_RST
     - LCD_RST testing point. You can use it to reset the LCD display with control signals.

System Requirements
*******************

.. include:: ../../../espressif/common/system-requirements.rst
   :start-after: espressif-system-requirements

Programming and Debugging
*************************

.. zephyr:board-supported-runners::

.. include:: ../../../espressif/common/building-flashing.rst
   :start-after: espressif-building-flashing

.. include:: ../../../espressif/common/board-variants.rst
   :start-after: espressif-board-variants

Debugging
=========

.. include:: ../../../espressif/common/openocd-debugging.rst
   :start-after: espressif-openocd-debugging

References
**********

.. target-notes::
