This user guide will help you get started with ESP32-S3-EYE v2.2 and will also provide more in-depth information.
> **Notice**
>
> If you use ESP32-S3-EYE v2.1, please follow this guide. The differences between v2.2 and v2.1 are described in Section [Hardware Revision Details](#4-hardware-revision-details).
The ESP32-S3-EYE is a small-sized AI development board produced by [Espressif](https://espressif.com). It is based on the [ESP32-S3](https://www.espressif.com/en/products/socs/esp32-s3) SoC and [ESP-WHO](https://github.com/espressif/esp-who), Espressif’s AI development framework. 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. It also supports image transmission via Wi-Fi and debugging through a Micro-USB port. With ESP-WHO, you can develop a variety of AIoT applications, such as smart doorbell, surveillance systems, facial recognition time clock, etc.
The document consists of the following major sections:
- [Getting started](#1-getting-started): Introduction of the board, block diagram, description of key components, contents and packaging, as well as quick guide to use the board.
- [Start Application Development](#2-start-application-development): Hardware and software setup instructions to flash firmware onto the board.
- [Hardware Reference](#3-hardware-reference): More detailed information about the board's hardware.
- [Hardware Revision Details](#4-hardware-revision-details): Hardware revision history, known issues, and links to user guides for previous versions (if any) of the board.
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.
The ESP32-S3-EYE has some additional functions comparing to [ESP-EYE](https://github.com/espressif/esp-who/blob/master/docs/en/get-started/ESP-EYE_Getting_Started_Guide.md), an ESP32-based development board. The comparison below covers key differences between the two boards:
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.
The key components of the board are described from front view to back view, starting from the camera, in an anti-clockwise direction.
| No. | Key Component | Description |
|-----|----|--|
| 1 | Camera | The camera [OV2640](https://github.com/espressif/esp32-camera) 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. |
| 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. |
Each ESP32-S3-EYE board comes with pre-built [default firmware](https://github.com/espressif/esp-who/tree/master/default_bin/esp32-s3-eye) that allows you to test its functions including voice wake-up, voice command recognition, face detection and recognition.
To test the board's functions, you need the following hardware:
- 1 x ESP32-S3-EYE
- 1 x USB 2.0 cable (Standard-A to Micro-B), for USB power supply
Before powering up your board, please make sure that it is in good condition with no obvious signs of damage. Both the main board and the sub board should be firmly connected together. Then, follow the instructions described below:
1. Connect the board to a power supply through the **USB Port** using a USB cable. While the board is powered up, you will notice the following responses:
* The **Module Power LED** turns on for a few seconds, indicating that the default firmware is being loaded.
At this point, the board is ready for further instructions. You can control the board with either function buttons or voice commands. Function button control is described first:
2. Face the camera so whole human face is visible on the screen for the board to detect. Once a human face is detected, the board displays a blue rectangle.
3. Press **MENU** so that the board enters an ID (starting from 1) for a detected human face.
4. Press **UP+** so that the board starts face recognition. Once a face is recognized, the board displays the entered face ID. If it doesn’t know the face, it displays “WHO?”.
5. Press **PLAY** to delete the latest face ID. The board displays "XXX ID(S) LEFT".
To control the board with voice commands, follow the instructions below:
2. Activate the board with the default English wake word “Hi ESP”. When the wake word is detected, the **Module Power LED** will turn on, indicating that the board is ready for a speech command.
3. Say an English speech command to control the board. Once a speech command is recognized, the **Module Power LED** will blink. The supported English speech commands in face recognition mode are listed below:
4. After waking up the board as described in step 2, you can also switch the board's working mode with speech commands. Once a speech command is recognized, the **Module Power LED** will blink.
Now you get the first experience with the board. The following sections provide further information about how to flash firmware onto the board, configuration options, related resources, and more.
# 2. Start Application Development
This section provides instructions on how to do hardware/software setup and flash firmware onto the board for application development.
## 2.1. Required Hardware
- 1 x ESP32-S3-EYE
- 1 x USB 2.0 cable (Standard-A to Micro-B), for USB power supply and flashing firmware on to the board
> Be sure to use a Li-ion battery that has built-in protection circuit.
## 2.3. Hardware Setup
Prepare the board for loading of the first sample application:
Connect the board with the computer through the **USB Port** using a USB cable. The **Module Power LED** should turn on. Assuming that a battery is not connected, the **Battery Red LED** will blink.
After hardware setup, you can proceed with preparation of development tools. Go to the [guide to ESP-WHO](https://github.com/espressif/esp-who), which will walk you through the following steps:
1. [Get ESP-IDF](https://github.com/espressif/esp-who/#get-esp-idf) which provides a common framework to develop applications for ESP32-S3 in C language.
2. [Get ESP-WHO](https://github.com/espressif/esp-who/#get-esp-who) which is an image processing platform that runs on ESP-IDF.
3. [Run Examples](https://github.com/espressif/esp-who/#run-examples) that are provided by ESP-WHO.
# 3. Hardware Reference
This section provides more detailed information about the board's hardware.
Except for GPIO3 that can be used to configure LED statuses, all GPIOs of the **ESP32-S3-WROOM-1** module have already been used to control specific components or functions of the board. If you would like to configure any pins yourself, please refer to the schematics provided in Section [Related Documents](#5-related-documents).
The ESP32-S3-EYE board features independent power supplies to the camera and the remaining components. This should reduce noise in the audio signal from module components and improve overall performance of the components.
<center>
||
|:--:|
|ESP32-S3-EYE - Module Power Supply|
</center>
<center>
||
Compared to ESP32-S3-EYE v2.1, ESP32-S3-EYE v2.2 has two changes in hardware: 1) marking on the main board，2) additional current limiting resistor on the main board; and one change in firmware: additional support for English wake-up word and commands.
Changes in hardware are described in detail below:
1. Marking on the (back of) main board: ESP32-S3-EYE v2.2 has marking "ESP32-S3-EYE-MB_V2.2" on the main board, while ESP32-S3-EYE v2.1 has marking "ESP32-S3-EYE-MB_V2.1" on the main board.
2. The current limiting resistor R83 is added to the ESP32-S3-EYE v2.2 main board to protect the **Module Power LED** from burning in case GPIO3 is pulled up.
| ESP32-S3-EYE v2.2 with R83 | ESP32-S3-EYE v2.1 Without R83 |
|  | |
3. The **main board schematics**, **main board PCB layout diagrams**, **main board dimension diagrams**, **main board dimension source files** are updated because of the two hardware changes. (See [Related Documents](#5-related-documents)).
## 4.2. known Issues
ESP32-S3-EYE does not have a USB-to-UART bridge, which may cause a problem: If the program flashed onto the board keeps the chip rebooting, you cannot flash more programs onto the board.
In case this issue occurs, you need to:
- Hold down BOOT button and press RST button, then release RST button first, and BOOT button next. In this way, the board enters Firmware Download mode and you can start flashing program onto the board.
- After flashing the program, press RST button to start the program.
- [ESP32-S3-EYE-MB v2.2 Main Board Front Dimensions](https://dl.espressif.com/dl/schematics/DXF_ESP32-S3-EYE_MB_top_V2.2_20211207.pdf) (PDF)
- [ESP32-S3-EYE-MB v2.1 Main Board Front Dimensions](https://dl.espressif.com/dl/schematics/DXF_ESP32-S3-EYE_MB_top_V2.1_20211111.pdf) (PDF)
- [ESP32-S3-EYE-MB v2.2 Main Board Back Dimensions](https://dl.espressif.com/dl/schematics/DXF_ESP32-S3-EYE_MB_Bottom_V2.2_20211207.pdf) (PDF)
- [ESP32-S3-EYE-MB v2.1 Main Board Back Dimensions](https://dl.espressif.com/dl/schematics/DXF_ESP32-S3-EYE_MB_Bottom_V2.1_20211111.pdf) (PDF)
- [ESP32-S3-EYE-SUB Sub Board Dimensions](https://dl.espressif.com/dl/schematics/DXF_ESP32-S3-EYE_SUB_V1.1_20211111.pdf) (PDF)
- [ESP32-S3-EYE-MB v2.2 Main Board Front Dimensions Source File](https://dl.espressif.com/dl/schematics/DXF_ESP32-S3-EYE_MB_top_V2.2_20211207.dxf) (DXF) - You can view it with [Autodesk Viewer](https://viewer.autodesk.com/) online
- [ESP32-S3-EYE-MB v2.1 Main Board Front Dimensions Source File](https://dl.espressif.com/dl/schematics/DXF_ESP32-S3-EYE_MB_top_V2.1_20211111.dxf) (DXF) - You can view it with [Autodesk Viewer](https://viewer.autodesk.com/) online
- [ESP32-S3-EYE-MB v2.2 Main Board Back Dimensions Source File](https://dl.espressif.com/dl/schematics/DXF_ESP32-S3-EYE_MB_Bottom_V2.2_20211207.dxf) (DXF) - You can view it with [Autodesk Viewer](https://viewer.autodesk.com/) online
- [ESP32-S3-EYE-MB v2.1 Main Board Back Dimensions Source File](https://dl.espressif.com/dl/schematics/DXF_ESP32-S3-EYE_MB_Bottom_V2.1_20211111.dxf) (DXF) - You can view it with [Autodesk Viewer](https://viewer.autodesk.com/) online
- [ESP32-S3-EYE-SUB Sub Board Dimensions Source File](https://dl.espressif.com/dl/schematics/DXF_ESP32-S3-EYE_SUB_V1.1_20211111.dxf) (DXF) - You can view it with [Autodesk Viewer](https://viewer.autodesk.com/) online
