esp-idf/examples/peripherals/camera/camera_dsi/README.md
2024-05-17 12:39:15 +08:00

10 KiB

Supported Targets ESP32-P4

Camera display via DSI example

Overview

This example demonstrates how to use the esp_driver_cam component to capture camera sensor signals and display it via DSI interface.

Usage

The subsections below give only absolutely necessary information. For full steps to configure ESP-IDF and use it to build and run projects, see ESP-IDF Getting Started.

Hardware Required

This example requires:

  • OV5647 camera sensor

  • ILI9881C LCD screen

  • ESP32P4 devkit

                                 GND                                                                   GND
              ┌────────────────────────────────────────────────┐             ┌─────────────────────────────────────────────────────────┐
              │                                                │             │                                                         │
              │                                                │             │                                                         │
              │                                                │             │                                                         │
              │                                                │             │                                                         │
              │                                                │             │                                                         │
              │                                                │             │                                                         │
              │                                                │             │                                                         │
              │                                                │             │                                                         │
              │                                ┌───────────────┴─────────────┴──────────────────┐                                      │
              │                                │                                                │                           ┌──────────┴───────────┐
              │                                │                                                │      DSI DATA 1P          │                      │
              │                                │                                                ├───────────────────────────┤                      │
    

    ┌───────────┴─────────┐ CSI DATA 1P │ │ │ │ │ ├──────────────────────┤ │ DSI DATA 1N │ │ │ │ │ ├───────────────────────────┤ │ │ │ CSI DATA 1N │ ESP32-P4 │ │ │ │ OV5647 ├──────────────────────┤ │ DSI CLK N │ ILI9881C │ │ │ │ ├───────────────────────────┤ │ │ │ CSI CLK N │ │ │ │ │ ├──────────────────────┤ │ DSI CLK P │ │ │ │ │ ├───────────────────────────┤ │ │ │ CSI CLK P │ │ │ │ │ ├──────────────────────┤ │ DSI DATA 0P │ │ │ │ │ ├───────────────────────────┤ │ │ │ CSI DATA 0P │ │ │ │ │ ├──────────────────────┤ │ DSI DATA 0N │ │ │ │ │ ├───────────────────────────┤ │ │ │ CSI DATA 0N │ │ │ │ │ ├──────────────────────┤ │ └──────────────────────┘ │ │ │ │ └───────┬──┬──────────┘ │ │ │ │ I2C SCL │ │ │ └─────────────────────────────────┤ │ │ I2C SDA │ │ └────────────────────────────────────┤ │ └────────────────────────────────────────────────┘

Set Chip Target

First of all, your target must be supported by both:

  • By your ESP-IDF version: For the full list of supported targets, run:
    idf.py --list-targets
    
  • By this example: For the full list of supported targets, refer to the supported targets table at the top of this README.

After you make sure that your target is supported, go to your example project directory and set the chip target:

idf.py set-target <target>

For example, to set esp32-P4 as the chip target, run:

idf.py set-target esp32p4

Configure the Project

For information about Kconfig options, see Project Configuration > Name of relevant section(s).

To conveniently check or modify Kconfig options for this example in a project configuration menu, run:

idf.py menuconfig
Set CONFIG_CAMERA_OV5647 to y

Build and Flash

Execute the following command to build the project, flash it to your development board, and run the monitor tool to view the serial output:

idf.py build flash monitor

This command can be reduced to idf.py flash monitor.

If the above command fails, check the log on the serial monitor which usually provides information on the possible cause of the issue.

To exit the serial monitor, use Ctrl + ].

Example Output

If you see the following console output, your example should be running correctly:

I (1085) main_task: Calling app_main()
I (1095) ili9881c: ID1: 0x98, ID2: 0x81, ID3: 0x5c
I (1125) gpio: GPIO[31]| InputEn: 1| OutputEn: 1| OpenDrain: 1| Pullup: 1| Pulldown: 0| Intr:0
I (1125) gpio: GPIO[34]| InputEn: 1| OutputEn: 1| OpenDrain: 1| Pullup: 1| Pulldown: 0| Intr:0
I (1295) ov5647: Detected Camera sensor PID=0x5647 with index 0
I (1305) cam_dsi: fmt[0].name:MIPI_2lane_24Minput_RAW8_800x1280_50fps
I (1305) cam_dsi: fmt[1].name:MIPI_2lane_24Minput_RAW8_800x640_50fps
I (1315) cam_dsi: fmt[2].name:MIPI_2lane_24Minput_RAW8_800x800_50fps
I (1355) cam_dsi: Format in use:MIPI_2lane_24Minput_RAW8_800x640_50fps

Reference