[nrf noup] dts: bindings: i2s: Add the I2S instance property

Add the I2S instance property to bindings. This is used to identify
the peripheral instance in the Nordic driver.

Signed-off-by: Jakub Zymelka <[email protected]>

Author: jaz1-nordic

boards/nordic/nrf5340_audio_dk/nrf5340_audio_dk_nrf5340_cpuapp_common.dtsi

@@ -138,6 +138,7 @@
 	pinctrl-0 = <&i2s0_default>;
 	pinctrl-1 = <&i2s0_sleep>;
 	pinctrl-names = "default", "sleep";
+	instance = <0>;
 };
 
 &uart0 {

dts/arm/nordic/nrf52832.dtsi

@@ -483,6 +483,7 @@
 			#size-cells = <0>;
 			reg = <0x40025000 0x1000>;
 			interrupts = <37 NRF_DEFAULT_IRQ_PRIORITY>;
+			instance = <0>;
 			status = "disabled";
 		};
 

dts/arm/nordic/nrf52833.dtsi

@@ -505,6 +505,7 @@
 			#size-cells = <0>;
 			reg = <0x40025000 0x1000>;
 			interrupts = <37 NRF_DEFAULT_IRQ_PRIORITY>;
+			instance = <0>;
 			status = "disabled";
 		};
 

dts/arm/nordic/nrf5340_cpuapp_peripherals.dtsi

@@ -459,6 +459,7 @@ i2s0: i2s@28000 {
 	#size-cells = <0>;
 	reg = <0x28000 0x1000>;
 	interrupts = <40 NRF_DEFAULT_IRQ_PRIORITY>;
+	instance = <0>;
 	status = "disabled";
 };
 

dts/arm/nordic/nrf91_peripherals.dtsi

@@ -90,6 +90,7 @@ i2s0: i2s@28000 {
 	#size-cells = <0>;
 	reg = <0x28000 0x1000>;
 	interrupts = <40 NRF_DEFAULT_IRQ_PRIORITY>;
+	instance = <0>;
 	status = "disabled";
 };
 

dts/bindings/i2s/nordic,nrf-i2s.yaml

@@ -38,3 +38,15 @@ properties:
       - "PCLK32M"
       - "PCLK32M_HFXO"
       - "ACLK"
+
+  instance:
+    type: int
+    required: true
+    description: |
+      The I2S instance number. I2S instance I2S0 has:
+
+        instance = <0>;
+
+      And I2S20 has:
+
+        instance = <20>;

dts/vendor/nordic/nrf54l_05_10_15.dtsi

@@ -555,6 +555,7 @@
 				#size-cells = <0>;
 				reg = <0xdd000 0x1000>;
 				interrupts = <221 NRF_DEFAULT_IRQ_PRIORITY>;
+				instance = <20>;
 				status = "disabled";
 			};