dts: bindings: gpio: add arducam 20-pin camera connector

Add the 20-pin camera connector used by at least Arducam, Waveshare,
Olimex, Arduino, NXP, ST, Adafruit that connects image sensor module
boards and devkits.

Signed-off-by: Josuah Demangeon <me@josuah.net>

Author: josuah

dts/bindings/gpio/arducam,dvp-20pin-connector.yaml

@@ -0,0 +1,47 @@
+# Copyright 2025 tinyVision.ai Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+description: |
+  GPIO pins exposed on ArduCam 20-pin header camera connector,
+  originally designed to connect Arducam modules to Arduino Giga R1,
+  but further used by other vendors of camera and devkits.
+
+  The connector layout is depicted below:
+
+     1   3V3          2   GND
+     3   SCL          4   SDA
+     5   VS           6   HS
+     7   PCLK         8   XCLK
+     9   D7           10  D6
+     11  D5           12  D4
+     13  D3           14  D2
+     15  D1           16  D0
+     17  PEN          18  PDN
+     19  PEN          20  PDN
+
+  In many variants, the last row containing the pins 19 and 20 is
+  not present, and the pins 17 and 18 are used for the same purpose
+  instead.
+
+  The following node labels can be used for use in shields:
+
+  - dvp_20pin_interface: the video interface that receives the video
+    feed and use with the zephyr,camera chosen node.
+
+  - dvp_20pin_ep_in: video endpoint of the devkit receiving the video
+    feed (see video-interfaces.yaml).
+
+  - dvp_20pin_ep_out: video endpoint of the camera module to interconnect
+    with this endpoint (see video-interfaces.yaml).
+
+  - dvp_20pin_i2c: the I2C device of the devkit on which the camera
+    module is instanciated.
+
+  - dvp_20pin_gpio: the gpio nexus using the arducam,dvp-20pin-connector
+    that defines the camera 'reset' pin, 'power-down' pin, etc.
+
+  See <zephyr/dt-bindings/gpio/dvp-20pin-gpio.h> for pin description.
+
+compatible: "arducam,dvp-20pin-connector"
+
+include: [gpio-nexus.yaml, base.yaml]

include/zephyr/dt-bindings/gpio/dvp-20pin-connector.h

@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2025 tinyVision.ai Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+#ifndef INCLUDE_ZEPHYR_DT_BINDINGS_GPIO_DVP_20PIN_CONNECTOR_H_
+#define INCLUDE_ZEPHYR_DT_BINDINGS_GPIO_DVP_20PIN_CONNECTOR_H_
+
+/** Pin number mask (0..20). */
+#define DVP_20PIN_MASK 0xff
+
+/**
+ * @name Arducam DVP 20-pin or 18-pin connector pinout
+ * @{
+ */
+#define DVP_20PIN_SCL	3	/**< I2C pin */
+#define DVP_20PIN_SDA	4	/**< I2C pin */
+#define DVP_20PIN_VS	5	/**< Vertical sync */
+#define DVP_20PIN_HS	6	/**< Horizontal sync */
+#define DVP_20PIN_PCLK	7	/**< Pixel clock used to transmit the data */
+#define DVP_20PIN_XCLK	8	/**< System clock often needed for I2C communication */
+#define DVP_20PIN_D7	9	/**< Parallel port data */
+#define DVP_20PIN_D6	10	/**< Parallel port data */
+#define DVP_20PIN_D5	11	/**< Parallel port data */
+#define DVP_20PIN_D4	12	/**< Parallel port data */
+#define DVP_20PIN_D3	13	/**< Parallel port data */
+#define DVP_20PIN_D2	14	/**< Parallel port data */
+#define DVP_20PIN_D1	15	/**< Parallel port data */
+#define DVP_20PIN_D0	16	/**< Parallel port data */
+#define DVP_20PIN_PEN	17	/**< Power Enable, typicaly shorted with pin 19 */
+#define DVP_20PIN_PDN	18	/**< Power Down, typicaly shorted with pin 20 */
+/** @} */
+
+#endif /* INCLUDE_ZEPHYR_DT_BINDINGS_GPIO_DVP_20PIN_CONNECTOR_H_ */