include: devicetree: gpio: add doxygen to all GPIO headers header files

dts/bindings/gpio/arduino-mkr-header.yaml

@@ -33,6 +33,8 @@ description: |
         4  D4                   D7       7
         5  D5                   D6       6
 
+    Use ARDUINO_MKR_HEADER_* constants in <zephyr/dt-bindings/gpio/arduino-mkr-header.h> to refer to
+    specific pins using convenient constant names.
 
 compatible: "arduino-mkr-header"
 

dts/bindings/gpio/arduino-nano-header.yaml

@@ -32,6 +32,8 @@ description: |
         11 D11                  3V3    -
         12 D12                  D13    13
 
+    Use ARDUINO_NANO_HEADER_* constants in <zephyr/dt-bindings/gpio/arduino-nano-header.h>
+    to refer to specific pins using convenient constant names.
 
 compatible: "arduino-nano-header"
 

dts/bindings/gpio/raspberrypi,csi-connector.yaml

@@ -19,6 +19,9 @@ description: |
     3   I2C_SCL  pin 13 (15-pin based) / pin 20 (22-pin based)
     4   I2C_SDA  pin 14 (15-pin based) / pin 21 (22-pin based)
 
+  Use CSI_* constants in <zephyr/dt-bindings/gpio/raspberrypi-csi-connector.h>
+  to refer to specific pins using convenient constant names.
+
   For reference only, Raspberry 15-pin Connector layout:
     1   GND
     2   CSI_D0_N

dts/bindings/gpio/st-morpho-header.yaml

@@ -9,6 +9,9 @@ description: |
   any Nucleo board. They can be used to connect shields. All signals and power
   pins of the STM32 are available on the ST morpho connector.
 
+  Use ST_MORPHO_* constants in <zephyr/dt-bindings/gpio/st-morpho-header.h>
+  to refer to specific pins using convenient constant names.
+
 compatible: "st-morpho-header"
 
 include: [gpio-nexus.yaml, base.yaml]

include/zephyr/dt-bindings/gpio/arduino-mkr-header.h

@@ -1,33 +1,48 @@
-/**
+/*
  * Copyright (c) 2025 TOKITA Hiroshi
  *
  * SPDX-License-Identifier: Apache-2.0
  */
 
+/**
+ * @file
+ * @brief Arduino MKR header pin constants
+ * @ingroup arduino-mkr-header
+ */
+
 #ifndef ZEPHYR_INCLUDE_DT_BINDINGS_GPIO_ARDUINO_MKR_HEADER_H_
 #define ZEPHYR_INCLUDE_DT_BINDINGS_GPIO_ARDUINO_MKR_HEADER_H_
 
-#define ARDUINO_MKR_HEADER_D0  0
-#define ARDUINO_MKR_HEADER_D1  1
-#define ARDUINO_MKR_HEADER_D2  2
-#define ARDUINO_MKR_HEADER_D3  3
-#define ARDUINO_MKR_HEADER_D4  4
-#define ARDUINO_MKR_HEADER_D5  5
-#define ARDUINO_MKR_HEADER_D6  6
-#define ARDUINO_MKR_HEADER_D7  7
-#define ARDUINO_MKR_HEADER_D8  8
-#define ARDUINO_MKR_HEADER_D9  9
-#define ARDUINO_MKR_HEADER_D10 10
-#define ARDUINO_MKR_HEADER_D11 11
-#define ARDUINO_MKR_HEADER_D12 12
-#define ARDUINO_MKR_HEADER_D13 13
-#define ARDUINO_MKR_HEADER_D14 14
-#define ARDUINO_MKR_HEADER_A0  15
-#define ARDUINO_MKR_HEADER_A1  16
-#define ARDUINO_MKR_HEADER_A2  17
-#define ARDUINO_MKR_HEADER_A3  18
-#define ARDUINO_MKR_HEADER_A4  19
-#define ARDUINO_MKR_HEADER_A5  20
-#define ARDUINO_MKR_HEADER_A6  21
+/**
+ * @defgroup arduino-mkr-header Arduino MKR header
+ * @brief Constants for pins exposed on Arduino MKR header
+ * @ingroup devicetree-gpio-pin-headers
+ * @{
+ */
+
+#define ARDUINO_MKR_HEADER_D0  0  /**< Digital pin 0 (D0) */
+#define ARDUINO_MKR_HEADER_D1  1  /**< Digital pin 1 (D1) */
+#define ARDUINO_MKR_HEADER_D2  2  /**< Digital pin 2 (D2) */
+#define ARDUINO_MKR_HEADER_D3  3  /**< Digital pin 3 (D3) */
+#define ARDUINO_MKR_HEADER_D4  4  /**< Digital pin 4 (D4) */
+#define ARDUINO_MKR_HEADER_D5  5  /**< Digital pin 5 (D5) */
+#define ARDUINO_MKR_HEADER_D6  6  /**< Digital pin 6 (D6) */
+#define ARDUINO_MKR_HEADER_D7  7  /**< Digital pin 7 (D7) */
+#define ARDUINO_MKR_HEADER_D8  8  /**< Digital pin 8 (D8/COPI) */
+#define ARDUINO_MKR_HEADER_D9  9  /**< Digital pin 9 (D9/SCK) */
+#define ARDUINO_MKR_HEADER_D10 10 /**< Digital pin 10 (D10/CIPO) */
+#define ARDUINO_MKR_HEADER_D11 11 /**< Digital pin 11 (D11/SDA) */
+#define ARDUINO_MKR_HEADER_D12 12 /**< Digital pin 12 (D12/SCL) */
+#define ARDUINO_MKR_HEADER_D13 13 /**< Digital pin 13 (D13/RX) */
+#define ARDUINO_MKR_HEADER_D14 14 /**< Digital pin 14 (D14/TX) */
+#define ARDUINO_MKR_HEADER_A0  15 /**< Analog pin 0 (A0/D15/DAC0) */
+#define ARDUINO_MKR_HEADER_A1  16 /**< Analog pin 1 (A1/D16) */
+#define ARDUINO_MKR_HEADER_A2  17 /**< Analog pin 2 (A2/D17) */
+#define ARDUINO_MKR_HEADER_A3  18 /**< Analog pin 3 (A3/D18) */
+#define ARDUINO_MKR_HEADER_A4  19 /**< Analog pin 4 (A4/D19) */
+#define ARDUINO_MKR_HEADER_A5  20 /**< Analog pin 5 (A5/D20) */
+#define ARDUINO_MKR_HEADER_A6  21 /**< Analog pin 6 (A6/D21) */
+
+/** @} */
 
 #endif /* ZEPHYR_INCLUDE_DT_BINDINGS_GPIO_ARDUINO_MKR_HEADER_H_ */

include/zephyr/dt-bindings/gpio/arduino-nano-header.h

@@ -1,41 +1,56 @@
-/**
+/*
  * Copyright (c) 2025 TOKITA Hiroshi
  *
  * SPDX-License-Identifier: Apache-2.0
  */
 
+/**
+ * @file
+ * @brief Arduino Nano header pin constants
+ * @ingroup arduino-nano-header
+ */
+
 #ifndef ZEPHYR_INCLUDE_DT_BINDINGS_GPIO_ARDUINO_NANO_HEADER_H_
 #define ZEPHYR_INCLUDE_DT_BINDINGS_GPIO_ARDUINO_NANO_HEADER_H_
 
-#define ARDUINO_NANO_HEADER_D0  0
-#define ARDUINO_NANO_HEADER_D1  1
-#define ARDUINO_NANO_HEADER_D2  2
-#define ARDUINO_NANO_HEADER_D3  3
-#define ARDUINO_NANO_HEADER_D4  4
-#define ARDUINO_NANO_HEADER_D5  5
-#define ARDUINO_NANO_HEADER_D6  6
-#define ARDUINO_NANO_HEADER_D7  7
-#define ARDUINO_NANO_HEADER_D8  8
-#define ARDUINO_NANO_HEADER_D9  9
-#define ARDUINO_NANO_HEADER_D10 10
-#define ARDUINO_NANO_HEADER_D11 11
-#define ARDUINO_NANO_HEADER_D12 12
-#define ARDUINO_NANO_HEADER_D13 13
-#define ARDUINO_NANO_HEADER_D14 14
-#define ARDUINO_NANO_HEADER_D15 15
-#define ARDUINO_NANO_HEADER_D16 16
-#define ARDUINO_NANO_HEADER_D17 17
-#define ARDUINO_NANO_HEADER_D18 18
-#define ARDUINO_NANO_HEADER_D19 19
-#define ARDUINO_NANO_HEADER_D20 20
-#define ARDUINO_NANO_HEADER_D21 21
-#define ARDUINO_NANO_HEADER_A0  14
-#define ARDUINO_NANO_HEADER_A1  15
-#define ARDUINO_NANO_HEADER_A2  16
-#define ARDUINO_NANO_HEADER_A3  19
-#define ARDUINO_NANO_HEADER_A4  18
-#define ARDUINO_NANO_HEADER_A5  18
-#define ARDUINO_NANO_HEADER_A6  20
-#define ARDUINO_NANO_HEADER_A7  21
+/**
+ * @defgroup arduino-nano-header Arduino Nano header
+ * @brief Constants for pins exposed on Arduino Nano header
+ * @ingroup devicetree-gpio-pin-headers
+ * @{
+ */
+
+#define ARDUINO_NANO_HEADER_D0  0  /**< Digital pin 0 (D0/RX) */
+#define ARDUINO_NANO_HEADER_D1  1  /**< Digital pin 1 (D1/TX) */
+#define ARDUINO_NANO_HEADER_D2  2  /**< Digital pin 2 (D2) */
+#define ARDUINO_NANO_HEADER_D3  3  /**< Digital pin 3 (D3) */
+#define ARDUINO_NANO_HEADER_D4  4  /**< Digital pin 4 (D4) */
+#define ARDUINO_NANO_HEADER_D5  5  /**< Digital pin 5 (D5) */
+#define ARDUINO_NANO_HEADER_D6  6  /**< Digital pin 6 (D6) */
+#define ARDUINO_NANO_HEADER_D7  7  /**< Digital pin 7 (D7) */
+#define ARDUINO_NANO_HEADER_D8  8  /**< Digital pin 8 (D8) */
+#define ARDUINO_NANO_HEADER_D9  9  /**< Digital pin 9 (D9) */
+#define ARDUINO_NANO_HEADER_D10 10 /**< Digital pin 10 (D10/SS) */
+#define ARDUINO_NANO_HEADER_D11 11 /**< Digital pin 11 (D11/COPI) */
+#define ARDUINO_NANO_HEADER_D12 12 /**< Digital pin 12 (D12/CIPO) */
+#define ARDUINO_NANO_HEADER_D13 13 /**< Digital pin 13 (D13/SCK) */
+#define ARDUINO_NANO_HEADER_D14 14 /**< Digital pin 14 (D14) */
+#define ARDUINO_NANO_HEADER_D15 15 /**< Digital pin 15 (D15) */
+#define ARDUINO_NANO_HEADER_D16 16 /**< Digital pin 16 (D16) */
+#define ARDUINO_NANO_HEADER_D17 17 /**< Digital pin 17 (D17) */
+#define ARDUINO_NANO_HEADER_D18 18 /**< Digital pin 18 (D18) */
+#define ARDUINO_NANO_HEADER_D19 19 /**< Digital pin 19 (D19) */
+#define ARDUINO_NANO_HEADER_D20 20 /**< Digital pin 20 (D20) */
+#define ARDUINO_NANO_HEADER_D21 21 /**< Digital pin 21 (D21) */
+#define ARDUINO_NANO_HEADER_A0  14 /**< Analog pin 0 (A0) */
+#define ARDUINO_NANO_HEADER_A1  15 /**< Analog pin 1 (A1) */
+#define ARDUINO_NANO_HEADER_A2  16 /**< Analog pin 2 (A2) */
+#define ARDUINO_NANO_HEADER_A3  19 /**< Analog pin 3 (A3) */
+#define ARDUINO_NANO_HEADER_A4  18 /**< Analog pin 4 (A4) */
+#define ARDUINO_NANO_HEADER_A5  19 /**< Analog pin 5 (A5) */
+#define ARDUINO_NANO_HEADER_A6  20 /**< Analog pin 6 (A6) */
+#define ARDUINO_NANO_HEADER_A7  21 /**< Analog pin 7 (A7) */
+
+/** @} */
 
 #endif /* ZEPHYR_INCLUDE_DT_BINDINGS_GPIO_ARDUINO_NANO_HEADER_H_ */

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

@@ -2,11 +2,20 @@
  * Copyright (c) 2025 tinyVision.ai Inc.
  * SPDX-License-Identifier: Apache-2.0
  */
+
+/**
+ * @file
+ * @brief Arducam DVP 20-pin connector pin constants
+ * @ingroup dvp-20pin-connector
+ */
+
 #ifndef INCLUDE_ZEPHYR_DT_BINDINGS_GPIO_DVP_20PIN_CONNECTOR_H_
 #define INCLUDE_ZEPHYR_DT_BINDINGS_GPIO_DVP_20PIN_CONNECTOR_H_
 
 /**
- * @name Arducam DVP 20-pin or 18-pin connector pinout
+ * @defgroup dvp-20pin-connector Arducam DVP 20-pin connector
+ * @brief Constants for pins exposed on Arducam DVP 20-pin or 18-pin connector
+ * @ingroup devicetree-gpio-pin-headers
  * @{
  */
 #define DVP_20PIN_SCL	3	/**< I2C clock pin */

include/zephyr/dt-bindings/gpio/raspberrypi-csi-connector.h

@@ -2,11 +2,20 @@
  * Copyright (c) 2025 STMicroelectronics
  * SPDX-License-Identifier: Apache-2.0
  */
+
+/**
+ * @file
+ * @brief Raspberry Pi CSI camera connector pin constants
+ * @ingroup raspberrypi-csi-connector
+ */
+
 #ifndef INCLUDE_ZEPHYR_DT_BINDINGS_GPIO_RASPBERRYPI_CSI_CONNECTOR_H_
 #define INCLUDE_ZEPHYR_DT_BINDINGS_GPIO_RASPBERRYPI_CSI_CONNECTOR_H_
 
 /**
- * @name CSI camera connector GPIO list
+ * @defgroup raspberrypi-csi-connector Raspberry Pi CSI connector
+ * @brief Constants for pins exposed on Raspberry Pi CSI camera connector
+ * @ingroup devicetree-gpio-pin-headers
  * @{
  */
 #define CSI_IO0	1	/**< GPIO0 */