boards: shields: add suport for weact_ov2640_cam_module
Add support for WeAct Studio MiniSTM32H7xx OV2640 camera sensor. Signed-off-by: Charles Dias <charlesdias.cd@outlook.com>
This commit is contained in:
Charles Dias
David Leach
parent
c76b984aae
commit
31093d24a7
8 changed files with 257 additions and 0 deletions
5
boards/shields/weact_ov2640_cam_module/Kconfig.shield
Normal file
5
boards/shields/weact_ov2640_cam_module/Kconfig.shield
Normal file
|
|
@ -0,0 +1,5 @@
|
|||
# Copyright (c) 2024 Charles Dias
|
||||
# SPDX-License-Identifier: Apache-2.0
|
||||
|
||||
config SHIELD_WEACT_OV2640_CAM_MODULE
|
||||
def_bool $(shields_list_contains,weact_ov2640_cam_module)
|
||||
|
|
@ -0,0 +1,8 @@
|
|||
#
|
||||
# Copyright (c) 2024 Charles Dias <charlesdias.cd@outlook.com>
|
||||
#
|
||||
# SPDX-License-Identifier: Apache-2.0
|
||||
#
|
||||
|
||||
CONFIG_VIDEO_HFLIP=y
|
||||
CONFIG_VIDEO_VFLIP=y
|
||||
|
|
@ -0,0 +1,59 @@
|
|||
/*
|
||||
* Copyright (c) 2024 Charles Dias
|
||||
*
|
||||
* SPDX-License-Identifier: Apache-2.0
|
||||
*/
|
||||
|
||||
/* AHB clocks must respect the minimum ratio AHB / DCMI_PIXCLK of 2.5 (AN5020 - Rev 3).
|
||||
* The OV2640 PCLK is around 72 MHz for QQVGA resolution (160x120) with MCO1_SEL_HSI48
|
||||
* and MCO1_PRE_DIV_4.
|
||||
*/
|
||||
&rcc {
|
||||
clocks = <&pll>;
|
||||
clock-frequency = <DT_FREQ_M(240)>;
|
||||
d1cpre = <1>;
|
||||
hpre = <1>;
|
||||
d1ppre = <2>;
|
||||
d2ppre1 = <2>;
|
||||
d2ppre2 = <2>;
|
||||
d3ppre = <2>;
|
||||
};
|
||||
|
||||
/* See reference manual (RM0433 Rev 8) page 390:
|
||||
* 100: HSI48 clock selected (hsi48_ck)
|
||||
*/
|
||||
#define MCO1_SEL_HSI48 4
|
||||
|
||||
/* See reference manual (RM0433 Rev 8) page 391:
|
||||
* 0100: division by 4
|
||||
*/
|
||||
#define MCO1_PRE_DIV_4 4
|
||||
|
||||
&mco1 {
|
||||
status = "okay";
|
||||
clocks = <&rcc STM32_SRC_HSI48 MCO1_SEL(MCO1_SEL_HSI48)>;
|
||||
prescaler = <MCO1_PRE(MCO1_PRE_DIV_4)>;
|
||||
pinctrl-0 = <&rcc_mco_1_pa8>;
|
||||
pinctrl-names = "default";
|
||||
};
|
||||
|
||||
&zephyr_camera_i2c {
|
||||
ov2640: ov2640@30 {
|
||||
supply-gpios = <&dcmi_camera_connector 8 GPIO_ACTIVE_HIGH>;
|
||||
clock-rate-control = <0x80>;
|
||||
};
|
||||
};
|
||||
|
||||
&zephyr_camera_dvp {
|
||||
dmas = <&dma1 0 75 (STM32_DMA_PERIPH_TO_MEMORY | STM32_DMA_PERIPH_NO_INC |
|
||||
STM32_DMA_MEM_INC | STM32_DMA_PERIPH_8BITS | STM32_DMA_MEM_32BITS |
|
||||
STM32_DMA_PRIORITY_HIGH) STM32_DMA_FIFO_1_4>;
|
||||
};
|
||||
|
||||
&dma1 {
|
||||
status = "okay";
|
||||
};
|
||||
|
||||
&dmamux1 {
|
||||
status = "okay";
|
||||
};
|
||||
82
boards/shields/weact_ov2640_cam_module/doc/index.rst
Normal file
82
boards/shields/weact_ov2640_cam_module/doc/index.rst
Normal file
|
|
@ -0,0 +1,82 @@
|
|||
.. _weact_ov2640_cam_module:
|
||||
|
||||
WeAct Studio MiniSTM32H7xx OV2640 Camera Sensor
|
||||
###############################################
|
||||
|
||||
Overview
|
||||
********
|
||||
|
||||
The OV2640 camera sensor is designed to interface with the WeAct Studio
|
||||
MiniSTM32H7xx boards, providing camera sensor capabilities. This shield
|
||||
integrates the OV2640 camera module, which is capable of capturing images
|
||||
and video with a resolution of up to 2 megapixels.
|
||||
|
||||
.. figure:: ov2640.webp
|
||||
:align: center
|
||||
:alt: OV2640 Camera Sensor
|
||||
|
||||
More information about the OV2640 camera sensor can be found on the
|
||||
`MiniSTM32H7xx GitHub`_ and in the `OV2640 datasheet`_.
|
||||
|
||||
Requirements
|
||||
************
|
||||
|
||||
Your board needs to have a ``zephyr_camera_dvp`` device tree label to work with this shield.
|
||||
|
||||
Pin Assignments
|
||||
===============
|
||||
|
||||
The shield connects to the WeAct Studio MiniSTM32H7xx board via the
|
||||
following pins:
|
||||
|
||||
+--------------+-----------+-----------------------------+
|
||||
| Shield Pin | Board Pin | Function |
|
||||
+==============+===========+=============================+
|
||||
| DCMI_D0 | PC6 | DCMI Data Line 0 |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| DCMI_D1 | PC7 | DCMI Data Line 1 |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| DCMI_D2 | PE0 | DCMI Data Line 2 |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| DCMI_D3 | PE1 | DCMI Data Line 3 |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| DCMI_D4 | PE4 | DCMI Data Line 4 |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| DCMI_D5 | PD3 | DCMI Data Line 5 |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| DCMI_D6 | PE5 | DCMI Data Line 6 |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| DCMI_D7 | PE6 | DCMI Data Line 7 |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| DCMI_HSYNC | PA4 | DCMI HSYNC |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| DCMI_VSYNC | PB7 | DCMI VSYNC |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| DCMI_PIXCLK | PA6 | DCMI Pixel Clock |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| I2C_SDA | PB9 | I2C Data Line |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| I2C_SCL | PB8 | I2C Clock Line |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| RCC_MCO1 | PA8 | Clock Output |
|
||||
+--------------+-----------+-----------------------------+
|
||||
| SUPPLY | PA7 | Power Supply Control (GPIO) |
|
||||
+--------------+-----------+-----------------------------+
|
||||
|
||||
Programming
|
||||
***********
|
||||
|
||||
Set ``--shield weact_ov2640_cam_module`` when you invoke ``west build``. For example:
|
||||
|
||||
.. zephyr-app-commands::
|
||||
:zephyr-app: samples/drivers/video/capture_to_lvgl/
|
||||
:board: mini_stm32h743
|
||||
:shield: weact_ov2640_cam_module
|
||||
:gen-args: -DCONFIG_BOOT_DELAY=2000
|
||||
:goals: build
|
||||
|
||||
.. _MiniSTM32H7xx GitHub:
|
||||
https://github.com/WeActStudio/MiniSTM32H7xx
|
||||
|
||||
.. _OV2640 datasheet:
|
||||
https://www.uctronics.com/download/cam_module/OV2640DS.pdf
|
||||
BIN
boards/shields/weact_ov2640_cam_module/doc/ov2640.webp
Normal file
BIN
boards/shields/weact_ov2640_cam_module/doc/ov2640.webp
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 37 KiB |
|
|
@ -0,0 +1,44 @@
|
|||
/*
|
||||
* Copyright (c) 2024 Charles Dias
|
||||
*
|
||||
* SPDX-License-Identifier: Apache-2.0
|
||||
*/
|
||||
|
||||
/ {
|
||||
chosen {
|
||||
zephyr,camera = &zephyr_camera_dvp;
|
||||
};
|
||||
};
|
||||
|
||||
&zephyr_camera_i2c {
|
||||
status = "okay";
|
||||
clock-frequency = <I2C_BITRATE_FAST>;
|
||||
|
||||
ov2640: ov2640@30 {
|
||||
compatible = "ovti,ov2640";
|
||||
reg = <0x30>;
|
||||
status = "okay";
|
||||
|
||||
port {
|
||||
ov2640_ep_out: endpoint {
|
||||
remote-endpoint = <&zephyr_camera_dvp_in>;
|
||||
};
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
&zephyr_camera_dvp {
|
||||
status = "okay";
|
||||
sensor = <&ov2640>;
|
||||
bus-width = <8>;
|
||||
hsync-active = <0>;
|
||||
vsync-active = <0>;
|
||||
pixelclk-active = <1>;
|
||||
capture-rate = <1>;
|
||||
|
||||
port {
|
||||
zephyr_camera_dvp_in: endpoint {
|
||||
remote-endpoint = <&ov2640_ep_out>;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
|
@ -83,6 +83,29 @@
|
|||
watchdog0 = &iwdg;
|
||||
sdhc0 = &sdmmc1;
|
||||
};
|
||||
|
||||
dcmi_camera_connector: connector_dcmi_camera {
|
||||
compatible = "weact,dcmi-camera-connector";
|
||||
#gpio-cells = <2>;
|
||||
gpio-map-mask = <0xffffffff 0xffffffc0>;
|
||||
gpio-map-pass-thru = <0 0x3f>;
|
||||
|
||||
gpio-map = <3 0 &gpiob 9 0>, /* DVP_SDA (I2C1_SDA) */
|
||||
<5 0 &gpiob 8 0>, /* DVP_SCL (I2C1_SCL) */
|
||||
<7 0 &gpiob 7 0>, /* DVP_VSYNC */
|
||||
<8 0 &gpioa 7 0>, /* DVP_PWDN */
|
||||
<9 0 &gpioa 4 0>, /* DVP_HSYNC */
|
||||
<12 0 &gpioe 6 0>, /* DVP_D7 */
|
||||
<13 0 &gpioa 8 0>, /* DVP_XCLK (RCC_MCO1) */
|
||||
<14 0 &gpioe 5 0>, /* DVP_D6 */
|
||||
<16 0 &gpiod 3 0>, /* DVP_D5 */
|
||||
<17 0 &gpioa 6 0>, /* DVP_PCLK */
|
||||
<18 0 &gpioe 4 0>, /* DVP_D4 */
|
||||
<19 0 &gpioc 6 0>, /* DVP_D0 */
|
||||
<20 0 &gpioe 1 0>, /* DVP_D3 */
|
||||
<21 0 &gpioc 7 0>, /* DVP_D1 */
|
||||
<22 0 &gpioe 0 0>; /* DVP_D2 */
|
||||
};
|
||||
};
|
||||
|
||||
&clk_lsi {
|
||||
|
|
@ -220,3 +243,15 @@ zephyr_udc0: &usbotg_fs {
|
|||
&iwdg1 {
|
||||
status = "okay";
|
||||
};
|
||||
|
||||
zephyr_camera_i2c: &i2c1 {
|
||||
pinctrl-0 = <&i2c1_scl_pb8 &i2c1_sda_pb9>;
|
||||
pinctrl-names = "default";
|
||||
};
|
||||
|
||||
zephyr_camera_dvp: &dcmi {
|
||||
pinctrl-0 = <&dcmi_hsync_pa4 &dcmi_pixclk_pa6 &dcmi_vsync_pb7
|
||||
&dcmi_d0_pc6 &dcmi_d1_pc7 &dcmi_d2_pe0 &dcmi_d3_pe1
|
||||
&dcmi_d4_pe4 &dcmi_d5_pd3 &dcmi_d6_pe5 &dcmi_d7_pe6>;
|
||||
pinctrl-names = "default";
|
||||
};
|
||||
|
|
|
|||
24
dts/bindings/gpio/weact,dcmi-camera-connector.yaml
Normal file
24
dts/bindings/gpio/weact,dcmi-camera-connector.yaml
Normal file
|
|
@ -0,0 +1,24 @@
|
|||
# SPDX-License-Identifier: Apache-2.0
|
||||
|
||||
description: |
|
||||
GPIO pins exposed on the DCMI camera connector used for interfacing
|
||||
with the OV2640, OV7670, and OV5640 camera sensors.
|
||||
|
||||
Connector layout (not mapped GPIOs in parentheses):
|
||||
|
||||
(1) OV_STROBE (Unused) (2) AGND
|
||||
3 DVP_SDA (4) AVDD-2V8
|
||||
5 DVP_SCL (6) DVP_RST
|
||||
7 DVP_VSYNC 8 DVP_PWDN
|
||||
9 DVP_HSYNC (10) DVDD-1V5
|
||||
(11) 2V8 12 DVP_D7
|
||||
13 DVP_XCLK 14 DVP_D6
|
||||
(15) GND 16 DVP_D5
|
||||
17 DVP_PCLK 18 DVP_D4
|
||||
19 DVP_D0 20 DVP_D3
|
||||
21 DVP_D1 22 DVP_D2
|
||||
(23) AF-2V8 (24) GND
|
||||
|
||||
compatible: "weact,dcmi-camera-connector"
|
||||
|
||||
include: [gpio-nexus.yaml, base.yaml]
|
||||
Loading…
Reference in a new issue