shields: st_mb1897_cam: addition of MB1897 camera board

Addition of a shield st_mb1897_cam embedding a GC2145 CSI
sensor which can be connected to the STM32MP135F-DK via a 15pins FFC.

Signed-off-by: Alain Volmat <alain.volmat@foss.st.com>

Author: Alain Volmat

boards/shields/st_mb1897_cam/Kconfig.shield

@@ -0,0 +1,6 @@
+# Copyright (c) 2025 STMicroelectronics
+
+# SPDX-License-Identifier: Apache-2.0
+
+config SHIELD_ST_MB1897_CAM
+	def_bool $(shields_list_contains,st_mb1897_cam)

boards/shields/st_mb1897_cam/boards/stm32mp135f_dk.conf

@@ -0,0 +1,3 @@
+CONFIG_VIDEO_STM32_DCMIPP_SENSOR_PIXEL_FORMAT="RGBP"
+CONFIG_VIDEO_STM32_DCMIPP_SENSOR_WIDTH=640
+CONFIG_VIDEO_STM32_DCMIPP_SENSOR_HEIGHT=480

boards/shields/st_mb1897_cam/boards/stm32mp135f_dk.overlay

@@ -0,0 +1,13 @@
+/*
+ * Copyright (c) 2025 STMicroelectronics
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&mipid02 {
+	status = "okay";
+};
+
+&mco1 {
+	status = "okay";
+};

boards/shields/st_mb1897_cam/doc/index.rst

@@ -0,0 +1,38 @@
+.. _st_mb1897_cam:
+
+ST_MB1897_CAM
+#############
+
+Overview
+********
+
+The STM32MP135F discovery board is delivered with a CSI camera module
+connected to the STM32MP135F-DK board via a 15pins FFC connector.
+The camera module board (MB1897) embeds a Galaxycore GC2145 CSI sensor.
+
+.. figure:: st_mb1897_cam.webp
+     :align: center
+     :alt: ST-MB1897-CAM
+
+     MB1897 Image (Credit: STMicroelectronics.)
+
+Requirements
+************
+
+The camera module bundle is compatible with STM32 Discovery kits and
+Evaluation boards featuring a 15 pins FFC connector, such as the STM32MP13
+Discovery kit.
+
+Usage
+*****
+
+The shield can be used in any application by setting ``SHIELD`` to
+``st_mb1897_cam`` for boards with the necessary device tree node labels.
+
+Set ``--shield "st_mb1897_cam"`` when you invoke ``west build``. For example:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/drivers/video/capture
+   :board: stm32mp135f_dk
+   :shield: st_mb1897_cam
+   :goals: build

boards/shields/st_mb1897_cam/doc/st_mb1897_cam.webp

@@ -0,0 +1,6 @@
+shield:
+  name: st_mb1897_cam
+  full_name: ST MB1897 camera module
+  vendor: st
+  supported_features:
+    - video

boards/shields/st_mb1897_cam/shield.yml

@@ -0,0 +1,43 @@
+/*
+ * Copyright (c) 2025 STMicroelectronics
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/dt-bindings/gpio/raspberrypi-csi-connector.h>
+#include <zephyr/dt-bindings/video/video-interfaces.h>
+
+/ {
+	chosen {
+		zephyr,camera = &csi_capture_port;
+	};
+};
+
+&csi_interface {
+	status = "okay";
+};
+
+&csi_ep_in {
+	remote-endpoint-label = "gc2145_ep_out";
+	bus-type = <VIDEO_BUS_TYPE_CSI2_DPHY>;
+	data-lanes = <1 2>;
+};
+
+&csi_i2c {
+	status = "okay";
+
+	gc2145: camera@3c {
+		compatible = "galaxycore,gc2145";
+		reg = <0x3c>;
+		pwdn-gpios = <&csi_connector CSI_IO1 GPIO_ACTIVE_LOW>;
+		reset-gpios = <&csi_connector CSI_IO0 GPIO_ACTIVE_LOW>;
+
+		port {
+			gc2145_ep_out: endpoint {
+				remote-endpoint-label = "csi_ep_in";
+				data-lanes = <1 2>;
+				bus-type = <VIDEO_BUS_TYPE_CSI2_DPHY>;
+			};
+		};
+	};
+};