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 <[email protected]>

Author: josuah

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

@@ -0,0 +1,40 @@
+# 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  GPIO0        20  GPIO1
+
+  In some variants, the last row containing the pins 19 and 20 is
+  not present, and the module is only providing 18 pins out of 20.
+
+  The following node labels can be used in devicetree:
+
+  - dvp_20pin_interface: the video interface that receives the video
+    feed and use with the zephyr,camera chosen node.
+
+  - dvp_20pin_i2c: the I2C device of the devkit on which the camera
+    module is instantiated.
+
+  - dvp_20pin_gpio: the GPIO nexus using the arducam,dvp-20pin-connector
+    that defines the camera pins ('reset' (PEN), 'power-down' (PDN)...)
+
+  See <zephyr/dt-bindings/gpio/dvp-20pin-gpio.h> for pin description.
+
+compatible: "arducam,dvp-20pin-connector"
+
+include: [gpio-nexus.yaml, base.yaml]

dts/bindings/vendor-prefixes.txt

@@ -70,6 +70,7 @@ arc	Synopsys, Inc. (formerly ARC International PLC)
 archermind	ArcherMind Technology (Nanjing) Co., Ltd.
 arctic	Arctic Sand
 arcx	arcx Inc. / Archronix Inc.
+arducam	Arducam
 arduino	Arduino
 aries	Aries Embedded GmbH
 arm	ARM Ltd.

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

@@ -0,0 +1,35 @@
+/*
+ * 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 */
+#define DVP_20PIN_PDN	18	/**< Power Down */
+#define DVP_20PIN_GPIO0	19	/**< Extra GPIO pin present on some modules */
+#define DVP_20PIN_GPIO1	20	/**< Extra GPIO pin present on some modules */
+/** @} */
+
+#endif /* INCLUDE_ZEPHYR_DT_BINDINGS_GPIO_DVP_20PIN_CONNECTOR_H_ */