variants: Introduce the builtin-led-gpios node

Introduce the `builtin-led-gpios` node to make possible to configuring
the builtin-led from dts.
This node uses to determine the value of the `LED_BUILTIN` macro.

Use the `led0` alias to determine the `LED_BUILTIN` if the `builtin-led-gpios`
is not defined.

The behavior can override by defining the `LED_BUILTIN` in pinmap.h.
It uses definitions that are defined in the header preferentially.

Signed-off-by: TOKITA Hiroshi <[email protected]>

Author: soburi

variants/arduino_mkrzero/arduino_mkrzero.overlay

@@ -29,7 +29,8 @@
 				    <&arduino_mkr_header 18 0>, /* D18 / A4 / I2C-SDA */
 				    <&arduino_mkr_header 19 0>, /* D19 / A5 / I2C-SCL */
 				    <&arduino_mkr_header 20 0>,
-				    <&arduino_mkr_header 21 0>;
+				    <&arduino_mkr_header 21 0>,
+				    <&portb 8 0>;
 
 		pwms =	<&tcc0 2 255>,
 			<&tcc0 3 255>;

variants/arduino_mkrzero/arduino_mkrzero_pinmap.h

@@ -9,4 +9,3 @@
 #include <zephyr/kernel.h>
 #include <zephyr/drivers/i2c.h>
 
-#define LED_BUILTIN 22

variants/arduino_nano_33_ble/arduino_nano_33_ble.overlay

@@ -44,6 +44,8 @@
 
 		serials = <&uart0>;
 		i2cs = <&arduino_nano_i2c>;
+
+		builtin-led-gpios = <&arduino_nano_header 13 0>;
 	};
 };
 

variants/arduino_nano_33_ble/arduino_nano_33_ble_pinmap.h

@@ -11,4 +11,3 @@
 #include <zephyr/drivers/i2c.h>
 #include <zephyr/device.h>
 
-#define LED_BUILTIN 13

variants/arduino_nano_33_ble_sense/arduino_nano_33_ble_sense.overlay

@@ -44,6 +44,8 @@
 
 		serials = <&uart0>;
 		i2cs = <&arduino_nano_i2c>;
+
+		builtin-led-gpios = <&arduino_nano_header 13 0>;
 	};
 };
 

variants/arduino_nano_33_ble_sense/arduino_nano_33_ble_sense_pinmap.h

@@ -11,4 +11,3 @@
 #include <zephyr/drivers/i2c.h>
 #include <zephyr/device.h>
 
-#define LED_BUILTIN 13

variants/arduino_nano_33_iot/arduino_nano_33_iot_pinmap.h

@@ -11,4 +11,3 @@
 #include <zephyr/drivers/i2c.h>
 #include <zephyr/device.h>
 
-#define LED_BUILTIN 13

variants/nrf52840dk_nrf52840/nrf52840dk_nrf52840_pinmap.h

@@ -11,6 +11,4 @@
 #include <zephyr/drivers/i2c.h>
 #include <zephyr/kernel.h>
 
-#define LED_BUILTIN 22
-
 #endif

variants/variants.h

@@ -37,6 +37,49 @@
 
 #undef DIGITAL_PIN_CHECK_UNIQUE
 
+#ifndef LED_BUILTIN
+
+/* Return the index of it if matched, oterwise return 0 */
+#define LED_BUILTIN_INDEX_BY_REG_AND_PINNUM(n, p, i, dev, num)                                     \
+	(DIGITAL_PIN_EXISTS(n, p, i, dev, num) ? i : 0)
+
+/* Only matched pin returns non-zero value, so the sum is matched pin's index */
+#define LED_BUILTIN_FIND_DIGITAL_PIN(dev, pin)                                                     \
+	DT_FOREACH_PROP_ELEM_SEP_VARGS(DT_PATH(zephyr_user), digital_pin_gpios,                    \
+				       LED_BUILTIN_INDEX_BY_REG_AND_PINNUM, (+), dev, pin)
+
+#if DT_NODE_HAS_PROP(DT_PATH(zephyr_user), builtin_led_gpios) &&                                   \
+	(DT_PROP_LEN(DT_PATH(zephyr_user), builtin_led_gpios) > 0)
+
+#if !(DT_FOREACH_PROP_ELEM_SEP_VARGS(                                                               \
+	     DT_PATH(zephyr_user), digital_pin_gpios, DIGITAL_PIN_EXISTS, (+),                     \
+	     DT_REG_ADDR(DT_PHANDLE_BY_IDX(DT_PATH(zephyr_user), builtin_led_gpios, 0)),           \
+	     DT_PHA_BY_IDX(DT_PATH(zephyr_user), builtin_led_gpios, 0, pin)) > 0)
+#warning "pin not found in digital_pin_gpios"
+#else
+#define LED_BUILTIN                                                                                \
+	LED_BUILTIN_FIND_DIGITAL_PIN(                                                              \
+		DT_REG_ADDR(DT_PHANDLE_BY_IDX(DT_PATH(zephyr_user), builtin_led_gpios, 0)),        \
+		DT_PHA_BY_IDX(DT_PATH(zephyr_user), builtin_led_gpios, 0, pin))
+#endif
+
+/* If digital-pin-gpios is not defined, tries to use the led0 alias */
+#elif DT_NODE_EXISTS(DT_ALIAS(led0))
+
+#if !(DT_FOREACH_PROP_ELEM_SEP_VARGS(DT_PATH(zephyr_user), digital_pin_gpios, DIGITAL_PIN_EXISTS,   \
+				    (+), DT_REG_ADDR(DT_PHANDLE_BY_IDX(DT_ALIAS(led0), gpios, 0)), \
+				    DT_PHA_BY_IDX(DT_ALIAS(led0), gpios, 0, pin)) > 0)
+#warning "pin not found in digital_pin_gpios"
+#else
+#define LED_BUILTIN                                                                                \
+	LED_BUILTIN_FIND_DIGITAL_PIN(DT_REG_ADDR(DT_PHANDLE_BY_IDX(DT_ALIAS(led0), gpios, 0)),     \
+				     DT_PHA_BY_IDX(DT_ALIAS(led0), gpios, 0, pin))
+#endif
+
+#endif // builtin_led_gpios
+
+#endif // LED_BUILTIN
+
 #define DN_ENUMS(n, p, i) D##i = i
 
 /*