dts: bindings: gpio: add ArduCam FFC-40 pin connector binding

Add a devicetree binding and corresponding dt-bindings header for
the ArduCam FFC-40 pin GPIO connector used by camera shields.

- Add dts binding schema for arducam,ffc-40pin-connector
- Add dt-bindings header with GPIO pin definitions

Signed-off-by: Khanh Nguyen <[email protected]>

Author: KhanhNguyen-RVC

dts/bindings/gpio/arducam,ffc-40pin-connector.yaml

@@ -0,0 +1,67 @@
+# Copyright (c) 2025 Renesas Electronics Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+title: ArduCam FFC 40-pin camera connector.
+
+description: |
+  GPIO pins and high-speed differential pairs exposed on an ArduCam FFC 40-pin
+  camera connector supporting either DVP or MIPI CSI-2 interfaces.
+
+  The connector layout is depicted below:
+
+    1   GND
+    2   D11
+    3   D10
+    4   GND
+    5   D9 / MIPI_CSI_DL1_P
+    6   D8 / MIPI_CSI_DL1_P
+    7   GND
+    8   D7 / MIPI_CSI_CL_P
+    9   D6 / MIPI_CSI_CL_P
+    10  GND
+    11  D5 / MIPI_CSI_DL0_P
+    12  D4 / MIPI_CSI_DL0_P
+    13  GND
+    14  D3
+    15  D2
+    16  GND
+    17  D1
+    18  D0
+    19  GND
+    20  SCL
+    21  SDA
+    22  GND
+    23  VSYNC
+    24  HSYNC
+    25  RESET
+    26  XCLK
+    27  PCLK
+    28  INT
+    29  GND
+    30  GND
+    31  3V3
+    32  GND
+    33  GND
+    34  3V3
+    35  3V3
+    36  3V3
+    37  GND
+    38  GND
+    39  3V3
+    40  GND
+
+  The following node labels can be used in devicetree:
+
+  - arducam_ffc_40pin_interface: the video interface that receives the video
+    feed and use with the zephyr,camera chosen node.
+
+  - arducam_ffc_40pin_i2c: the I2C device for camera control.
+
+  - arducam_ffc_40pin_connector: the GPIO nexus using the arducam,ffc-40pin-connector
+    that defines the camera pins.
+
+  See <zephyr/dt-bindings/gpio/arducam-ffc-40pin-connector.h> for pin description.
+
+compatible: "arducam,ffc-40pin-connector"
+
+include: [gpio-nexus.yaml, base.yaml]

include/zephyr/dt-bindings/gpio/arducam-ffc-40pin-connector.h

@@ -0,0 +1,69 @@
+/*
+ * Copyright (c) 2025 Renesas Electronics Corporation
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @file
+ * @brief ArduCam FFC 40-pin camera connector constants.
+ * @ingroup arducam-ffc-40pin
+ */
+
+#ifndef INCLUDE_ZEPHYR_DT_BINDINGS_GPIO_ARDUCAM_FFC_40PIN_CONNECTOR_H_
+#define INCLUDE_ZEPHYR_DT_BINDINGS_GPIO_ARDUCAM_FFC_40PIN_CONNECTOR_H_
+
+/**
+ * @defgroup arducam-ffc-40pin ArduCam FFC 40-pin camera connector.
+ * @brief Constants for pins exposed on ArduCam FFC 40-pin camera connector.
+ * @ingroup devicetree-gpio-pin-headers
+ * @{
+ */
+
+/**
+ * @name MIPI-CSI2 interface pins
+ * @{
+ */
+#define ARDUCAM_FFC_40PIN_MIPI_CSI_DL1_P 5  /**< MIPI‑CSI2 data lane 1 positive */
+#define ARDUCAM_FFC_40PIN_MIPI_CSI_DL1_N 6  /**< MIPI‑CSI2 data lane 1 negative */
+#define ARDUCAM_FFC_40PIN_MIPI_CSI_CL_P  8  /**< MIPI‑CSI2 clock lane positive */
+#define ARDUCAM_FFC_40PIN_MIPI_CSI_CL_N  9  /**< MIPI‑CSI2 clock lane negative */
+#define ARDUCAM_FFC_40PIN_MIPI_CSI_DL0_P 11 /**< MIPI‑CSI2 data lane 0 positive */
+#define ARDUCAM_FFC_40PIN_MIPI_CSI_DL0_N 12 /**< MIPI‑CSI2 data lane 0 negative */
+/** @} */
+
+/**
+ * @name DVP interface pins
+ * @{
+ */
+#define ARDUCAM_FFC_40PIN_D11   2  /**< Parallel port data bit 11 */
+#define ARDUCAM_FFC_40PIN_D10   3  /**< Parallel port data bit 10 */
+#define ARDUCAM_FFC_40PIN_D9    5  /**< Parallel port data bit 9 */
+#define ARDUCAM_FFC_40PIN_D8    6  /**< Parallel port data bit 8 */
+#define ARDUCAM_FFC_40PIN_D7    8  /**< Parallel port data bit 7 */
+#define ARDUCAM_FFC_40PIN_D6    9  /**< Parallel port data bit 6 */
+#define ARDUCAM_FFC_40PIN_D5    11 /**< Parallel port data bit 5 */
+#define ARDUCAM_FFC_40PIN_D4    12 /**< Parallel port data bit 4 */
+#define ARDUCAM_FFC_40PIN_D3    14 /**< Parallel port data bit 3 */
+#define ARDUCAM_FFC_40PIN_D2    15 /**< Parallel port data bit 2 */
+#define ARDUCAM_FFC_40PIN_D1    17 /**< Parallel port data bit 1 */
+#define ARDUCAM_FFC_40PIN_D0    18 /**< Parallel port data bit 0 */
+#define ARDUCAM_FFC_40PIN_VSYNC 23 /**< Vertical sync */
+#define ARDUCAM_FFC_40PIN_HSYNC 24 /**< Horizontal sync */
+/** @} */
+
+/**
+ * @name Common pins
+ * @{
+ */
+#define ARDUCAM_FFC_40PIN_SCL   20 /**< I2C clock line */
+#define ARDUCAM_FFC_40PIN_SDA   21 /**< I2C data line */
+#define ARDUCAM_FFC_40PIN_RESET 25 /**< Reset */
+#define ARDUCAM_FFC_40PIN_XCLK  26 /**< External clock */
+#define ARDUCAM_FFC_40PIN_PCLK  27 /**< Pixel clock */
+#define ARDUCAM_FFC_40PIN_INT   28 /**< Interrupt from sensor */
+/** @} */
+
+/** @} */
+
+#endif /* INCLUDE_ZEPHYR_DT_BINDINGS_GPIO_ARDUCAM_FFC_40PIN_CONNECTOR_H_ */