1.. zephyr:code-sample:: video-capture-to-lvgl
2   :name: Video capture to LVGL
3   :relevant-api: video_interface
4
5   Capture video frames and display them on an LCD using LVGL.
6
7Description
8***********
9
10The application uses the :ref:`Video API <video_api>` to retrieve video frames from
11a video capture device, write a frame count message to the console, and then send
12the frame to an LCD display.
13
14Requirements
15************
16
17This sample requires a supported :ref:`video capture device <video_api>` (e.g., a camera)
18and a :ref:`display <display_api>`.
19
20Wiring
21******
22
23On the `WeAct Studio STM32H743`_, connect the OV2640 camera module and the 0.96" ST7735
24TFT LCD display. Connect a USB cable from a host to the micro USB-C connector on the
25board to receive console output messages.
26
27Building and Running
28********************
29
30For :zephyr:board:`mini_stm32h743`, build this sample application with the following commands:
31
32.. zephyr-app-commands::
33   :zephyr-app: samples/drivers/video/capture_to_lvgl/
34   :board: mini_stm32h743
35   :shield: weact_ov2640_cam_module
36   :goals: build flash
37   :gen-args: -DCONFIG_BOOT_DELAY=2000
38   :compact:
39
40Sample Output
41=============
42
43.. code-block:: console
44
45    [00:00:02.779,000] <inf> main: - Device name: dcmi@48020000
46    [00:00:02.779,000] <inf> main: - Capabilities:
47    [00:00:02.779,000] <inf> main:   RGBP width [160; 160; 0] height [120; 120; 0]
48    [00:00:02.779,000] <inf> main:   RGBP width [176; 176; 0] height [144; 144; 0]
49    [00:00:02.780,000] <inf> main:   RGBP width [240; 240; 0] height [160; 160; 0]
50    [00:00:02.780,000] <inf> main:   RGBP width [320; 320; 0] height [240; 240; 0]
51    [00:00:02.780,000] <inf> main:   RGBP width [352; 352; 0] height [288; 288; 0]
52    [00:00:02.780,000] <inf> main:   RGBP width [640; 640; 0] height [480; 480; 0]
53    [00:00:02.780,000] <inf> main:   RGBP width [800; 800; 0] height [600; 600; 0]
54    [00:00:02.780,000] <inf> main:   RGBP width [1024; 1024; 0] height [768; 768; 0]
55    [00:00:02.780,000] <inf> main:   RGBP width [1280; 1280; 0] height [1024; 1024; 0]
56    [00:00:02.780,000] <inf> main:   RGBP width [1600; 1600; 0] height [1200; 1200; 0]
57    [00:00:02.780,000] <inf> main:   JPEG width [160; 160; 0] height [120; 120; 0]
58    [00:00:02.780,000] <inf> main:   JPEG width [176; 176; 0] height [144; 144; 0]
59    [00:00:02.780,000] <inf> main:   JPEG width [240; 240; 0] height [160; 160; 0]
60    [00:00:02.780,000] <inf> main:   JPEG width [320; 320; 0] height [240; 240; 0]
61    [00:00:02.780,000] <inf> main:   JPEG width [352; 352; 0] height [288; 288; 0]
62    [00:00:02.780,000] <inf> main:   JPEG width [640; 640; 0] height [480; 480; 0]
63    [00:00:02.780,000] <inf> main:   JPEG width [800; 800; 0] height [600; 600; 0]
64    [00:00:02.780,000] <inf> main:   JPEG width [1024; 1024; 0] height [768; 768; 0]
65    [00:00:02.780,000] <inf> main:   JPEG width [1280; 1280; 0] height [1024; 1024; 0]
66    [00:00:02.780,000] <inf> main:   JPEG width [1600; 1600; 0] height [1200; 1200; 0]
67    [00:00:02.852,000] <inf> main: - Format: RGBP 160x120 320
68    [00:00:02.854,000] <inf> main: - Capture started
69
70References
71**********
72
73.. target-notes::
74
75.. _WeAct Studio STM32H743: https://github.com/WeActStudio/MiniSTM32H7xx
76