esp-who/examples/single_chip/camera_with_command_line/README.md

# Camera with Command Line in Single Chip

This example demonstrates **Human Face Detection** with a single ESP32 chip (without using any LCD module). ESP32 firstly gets images that are captured by the camera module, then determines if there are any human faces as well as displays its **Detection Results** in the **Serial Terminal**. 

# Preparation

To run this example, you need the following components:

* An ESP32 Module: **ESP32-WROVER**, which we highly recommend for beginners, is used in this example.
* A Camera Module: the **OV2640** image sensor, which we highly recommend for beginners, is used in this example.
* SDKs:
	* [ESP-IDF](https://github.com/espressif/esp-idf)
	* [ESP-WHO](https://github.com/espressif/esp-who)

For the detailed introduction about preparation, please see [here](https://github.com/espressif/esp-who).

# Quick Start

After you've completed the hardware settings, please follow the steps below:

1. **Connect** the camera to ESP32 module;
2. **Flash Applications** to ESP32;
3. **Start Human Face Detection** and **Check Detection Results**.

## Connecting

The table below lists the specific pins used in this example for connecting the ESP32 module and the camera module. 

| Interface | Camera Pin | Pin Mapping for ESP32-WROVER | 
| :--- | :---: | :---: |
| SCCB Clock | SIOC | IO27 |
| SCCB Data | SIOD | IO26 | 
| System Clock | XCLK | IO21 | 
| Vertical Sync | VSYNC | IO25 | 
| Horizontal Reference | HREF | IO23 | 
| Pixel Clock | PCLK | IO22 | 
| Pixel Data Bit 0 | D2 | IO4 | 
| Pixel Data Bit 1 | D3 | IO5 | 
| Pixel Data Bit 2 | D4 | IO18 | 
| Pixel Data Bit 3 | D5 | IO19 | 
| Pixel Data Bit 4 | D6 | IO36 | 
| Pixel Data Bit 5 | D7 | IO39 | 
| Pixel Data Bit 6 | D8 | IO34 | 
| Pixel Data Bit 7 | D9 | IO35 | 
| Camera Reset | RESET | IO2 | 
| Camera Power Down | PWDN | IO0 | 
| Power Supply 3.3V | 3V3 | 3V3 | 
| Ground | GND | GND | 

> The pin mapping will be slightly different if you use other ESP32 modules. 

In particular, if you are using a **ESP-WROVER-KIT** for your development, whose camera connector is already broken out (the one labeled Camera / JP4), please follow the steps below:

1. Plug your camera module, i.e. the OV2640 module in this example, on the board;
2. Connect the 3V3 and GND pins on the camera module to those counterparts on the board. 

The image below shows a **ESP-WROVER-KIT** development board with a **OV2640** camera module installed on it.

![esp_wrover_kit_with_ov2640](../../../img/esp_wrover_kit_with_ov2640.png)  

## Flashing to ESP32

Please see [here](https://github.com/espressif/esp-who).

## Checking Detection Result

1. Put your camera module away from a human face for at least 0.3 meter; 
2. Open a Serial Terminal by using the command line `make monitor`;
3. Check result at your Serial Terminal, and you will be able to see information displayed in the screenshot below:

![detected](../../../img/detected.png) 

The keyword **DETECTED** appears whenever ESP32 detects a human face.