From nobody Mon Feb 9 08:05:32 2026 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 0CF4217DFFD; Fri, 13 Dec 2024 16:52:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.140.110.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734108769; cv=none; b=t7xRwhDhxx9lErd77sfJPrbi+AvQ5p91nGw1P6zEXlHcyoWFKwLfiUhAziV3hts6HT+DD3H/20WVVsCWb7ypelQHPEyc2Ecez1HLFzXalGD8GK1CJGp+1Uoz5gZNkN642uhkKUWqqSP7CE/em1kYF1vby1hoUeDotWL/NrxSci0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734108769; c=relaxed/simple; bh=YYHhfT6PC0hkp+ZcJ5fgrBYpO9f+zu3Zck/Y69m4S1o=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=hg51G0Nb5xM/m7NERcIisMIRlqF0CI4/zRCLRA7fIIv2GKDg/WQgxcI3NAU/x35nul6ZfaWplGFqTjJsG8Tk5MK/m4GV0BEZ010dC50eklA0vf5gyS502V6cW7OTYz40bUAnQRos3gJazo+HpBz1Y9xq191A7iF3n0Pt16NB7aE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com; spf=pass smtp.mailfrom=arm.com; arc=none smtp.client-ip=217.140.110.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=arm.com Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 82ACB1595; Fri, 13 Dec 2024 08:53:14 -0800 (PST) Received: from e119884-lin.cambridge.arm.com (e119884-lin.cambridge.arm.com [10.1.196.72]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 72ACF3F5A1; Fri, 13 Dec 2024 08:52:45 -0800 (PST) From: Vincenzo Frascino To: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, vincenzo.frascino@arm.com Cc: Maruthi Srinivas Bayyavarapu , Sudeep Holla , Rob Herring Subject: [PATCH 1/3] xlnx: dt-bindings: xlnx,i2s: Convert to json-schema Date: Fri, 13 Dec 2024 16:52:38 +0000 Message-ID: <20241213165240.3652961-2-vincenzo.frascino@arm.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20241213165240.3652961-1-vincenzo.frascino@arm.com> References: <20241213165240.3652961-1-vincenzo.frascino@arm.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Convert the Xilinx I2S device tree binding documentation to json-schema. Signed-off-by: Vincenzo Frascino --- .../devicetree/bindings/sound/xlnx,i2s.txt | 28 ------- .../devicetree/bindings/sound/xlnx,i2s.yaml | 79 +++++++++++++++++++ 2 files changed, 79 insertions(+), 28 deletions(-) delete mode 100644 Documentation/devicetree/bindings/sound/xlnx,i2s.txt create mode 100644 Documentation/devicetree/bindings/sound/xlnx,i2s.yaml diff --git a/Documentation/devicetree/bindings/sound/xlnx,i2s.txt b/Documen= tation/devicetree/bindings/sound/xlnx,i2s.txt deleted file mode 100644 index 5e7c7d5bb60a..000000000000 --- a/Documentation/devicetree/bindings/sound/xlnx,i2s.txt +++ /dev/null @@ -1,28 +0,0 @@ -Device-Tree bindings for Xilinx I2S PL block - -The IP supports I2S based playback/capture audio - -Required property: - - compatible: "xlnx,i2s-transmitter-1.0" for playback and - "xlnx,i2s-receiver-1.0" for capture - -Required property common to both I2S playback and capture: - - reg: Base address and size of the IP core instance. - - xlnx,dwidth: sample data width. Can be any of 16, 24. - - xlnx,num-channels: Number of I2S streams. Can be any of 1, 2, 3, 4. - supported channels =3D 2 * xlnx,num-channels - -Example: - - i2s_receiver@a0080000 { - compatible =3D "xlnx,i2s-receiver-1.0"; - reg =3D <0x0 0xa0080000 0x0 0x10000>; - xlnx,dwidth =3D <0x18>; - xlnx,num-channels =3D <1>; - }; - i2s_transmitter@a0090000 { - compatible =3D "xlnx,i2s-transmitter-1.0"; - reg =3D <0x0 0xa0090000 0x0 0x10000>; - xlnx,dwidth =3D <0x18>; - xlnx,num-channels =3D <1>; - }; diff --git a/Documentation/devicetree/bindings/sound/xlnx,i2s.yaml b/Docume= ntation/devicetree/bindings/sound/xlnx,i2s.yaml new file mode 100644 index 000000000000..b8bda7c28d37 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/xlnx,i2s.yaml @@ -0,0 +1,79 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/xlnx,i2s.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Device-Tree bindings for Xilinx I2S PL block + +description: | + The IP supports I2S based playback/capture audio. + +maintainers: + - Vincenzo Frascino + - Maruthi Srinivas Bayyavarapu + +allOf: + - $ref: dai-common.yaml# + +properties: + compatible: + oneOf: + - const: xlnx,i2s-receiver-1.0 + - const: xlnx,i2s-transmitter-1.0 + + reg: + maxItems: 1 + description: | + Base address and size of the IP core instance. + + "#sound-dai-cells": + const: 0 + + "#address-cells": + maxItems: 1 + + "#size-cells": + maxItems: 1 + + xlnx,dwidth: + $ref: /schemas/types.yaml#/definitions/uint32 + maxItems: 1 + oneOf: + - const: 16 + - const: 24 + description: | + Sample data width. Can be any of 16, 24. + + xlnx,num-channels: + $ref: /schemas/types.yaml#/definitions/uint32 + maxItems: 1 + description: | + Number of I2S streams. + minimum: 1 + maximum: 4 + +required: + - compatible + - reg + - xlnx,dwidth + - xlnx,num-channels + +additionalProperties: false + +examples: + - | + i2s_receiver@a0080000 { + compatible =3D "xlnx,i2s-receiver-1.0"; + reg =3D <0x0 0xa0080000 0x0 0x10000>; + xlnx,dwidth =3D <0x18>; + xlnx,num-channels =3D <1>; + }; + i2s_transmitter@a0090000 { + compatible =3D "xlnx,i2s-transmitter-1.0"; + reg =3D <0x0 0xa0090000 0x0 0x10000>; + xlnx,dwidth =3D <0x18>; + xlnx,num-channels =3D <1>; + }; + +... --=20 2.43.0 From nobody Mon Feb 9 08:05:32 2026 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 1C9361E4113; Fri, 13 Dec 2024 16:52:48 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.140.110.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734108769; cv=none; b=f5v6ijXasDSIJuuTyhZb6ijXsWtpe6WMRwnhmeeNo08uiJ5ruGY4j4Qk3B/t+MGwHTu6iH87PCzAdvgTJJf0uJ0p/qpGWMJWfHDSedsXpgV5YzsiUx57ED1nAVdtgbm9PQlXimd1DRE+L9pD3fc4k5WNV23yFXoWX+cRQcBUKG0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734108769; c=relaxed/simple; bh=sr/4CoG4xSadFidIeha+kzz8Ys4Iaepr17VZ5u1nADI=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=rOpK7HmhcGnR2UpePqDqVMcLq98TZcLcsA8oZFQZTVSR4o83lIRsxDiCkOkEHgwP8Oxd+FJE2ffQcYZ+8fELQKwhEi9rpk5hMc7t4YDl55PlwThZ76FpNG2AJpow53g0YWnAyekuFgUlw1aDL+nxjV7dRwKr5TQPSaQH8vK/F6Q= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com; spf=pass smtp.mailfrom=arm.com; arc=none smtp.client-ip=217.140.110.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=arm.com Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id C5A921480; Fri, 13 Dec 2024 08:53:15 -0800 (PST) Received: from e119884-lin.cambridge.arm.com (e119884-lin.cambridge.arm.com [10.1.196.72]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id B5B743F5A1; Fri, 13 Dec 2024 08:52:46 -0800 (PST) From: Vincenzo Frascino To: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, vincenzo.frascino@arm.com Cc: Maruthi Srinivas Bayyavarapu , Sudeep Holla , Rob Herring Subject: [PATCH 2/3] xlnx: dt-bindings: xlnx,audio-formatter: Convert to json-schema Date: Fri, 13 Dec 2024 16:52:39 +0000 Message-ID: <20241213165240.3652961-3-vincenzo.frascino@arm.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20241213165240.3652961-1-vincenzo.frascino@arm.com> References: <20241213165240.3652961-1-vincenzo.frascino@arm.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Convert the Xilinx Audio Formatter 1.0 device tree binding documentation to json-schema. Signed-off-by: Vincenzo Frascino --- .../bindings/sound/xlnx,audio-formatter.txt | 29 ------- .../bindings/sound/xlnx,audio-formatter.yaml | 84 +++++++++++++++++++ 2 files changed, 84 insertions(+), 29 deletions(-) delete mode 100644 Documentation/devicetree/bindings/sound/xlnx,audio-form= atter.txt create mode 100644 Documentation/devicetree/bindings/sound/xlnx,audio-form= atter.yaml diff --git a/Documentation/devicetree/bindings/sound/xlnx,audio-formatter.t= xt b/Documentation/devicetree/bindings/sound/xlnx,audio-formatter.txt deleted file mode 100644 index cbc93c8f4963..000000000000 --- a/Documentation/devicetree/bindings/sound/xlnx,audio-formatter.txt +++ /dev/null @@ -1,29 +0,0 @@ -Device-Tree bindings for Xilinx PL audio formatter - -The IP core supports DMA, data formatting(AES<->PCM conversion) -of audio samples. - -Required properties: - - compatible: "xlnx,audio-formatter-1.0" - - interrupt-names: Names specified to list of interrupts in same - order mentioned under "interrupts". - List of supported interrupt names are: - "irq_mm2s" : interrupt from MM2S block - "irq_s2mm" : interrupt from S2MM block - - interrupts-parent: Phandle for interrupt controller. - - interrupts: List of Interrupt numbers. - - reg: Base address and size of the IP core instance. - - clock-names: List of input clocks. - Required elements: "s_axi_lite_aclk", "aud_mclk" - - clocks: Input clock specifier. Refer to common clock bindings. - -Example: - audio_ss_0_audio_formatter_0: audio_formatter@80010000 { - compatible =3D "xlnx,audio-formatter-1.0"; - interrupt-names =3D "irq_mm2s", "irq_s2mm"; - interrupt-parent =3D <&gic>; - interrupts =3D <0 104 4>, <0 105 4>; - reg =3D <0x0 0x80010000 0x0 0x1000>; - clock-names =3D "s_axi_lite_aclk", "aud_mclk"; - clocks =3D <&clk 71>, <&clk_wiz_1 0>; - }; diff --git a/Documentation/devicetree/bindings/sound/xlnx,audio-formatter.y= aml b/Documentation/devicetree/bindings/sound/xlnx,audio-formatter.yaml new file mode 100644 index 000000000000..d599ee34c8b7 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/xlnx,audio-formatter.yaml @@ -0,0 +1,84 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/xlnx,audio-formatter.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Device-Tree bindings for Xilinx PL audio formatter + +description: | + The IP core supports DMA, data formatting(AES<->PCM conversion) + of audio samples. + +maintainers: + - Vincenzo Frascino + - Maruthi Srinivas Bayyavarapu + +allOf: + - $ref: dai-common.yaml# + +properties: + compatible: + const: xlnx,audio-formatter-1.0 + + reg: + maxItems: 1 + description: | + Base address and size of the IP core instance. + + "#sound-dai-cells": + const: 0 + + interrupt-names: + minItems: 1 + maxItems: 3 + description: | + Names specified to list of interrupts in same order mentioned under + "interrupts". + + interrupts-parent: + $ref: /schemas/types.yaml#/definitions/string + maxItems: 1 + description: | + Phandle for interrupt controller. + + interrupts: + minItems: 1 + maxItems: 3 + description: | + List of Interrupt numbers. + + clock-names: + minItems: 2 + maxItems: 3 + description: | + List of input clocks. + + clocks: + minItems: 2 + maxItems: 3 + description: | + Input clock specifier. Refer to common clock bindings. + +required: + - compatible + - reg + - interrupt-names + - interrupts + - clock-names + - clocks + +additionalProperties: false + +examples: + - | + audio_ss_0_audio_formatter_0: audio_formatter@80010000 { + compatible =3D "xlnx,audio-formatter-1.0"; + interrupt-names =3D "irq_mm2s", "irq_s2mm"; + interrupts-parent =3D <&gic>; + interrupts =3D <0 104 4>, <0 105 4>; + reg =3D <0x0 0x80010000 0x0 0x1000>; + clock-names =3D "s_axi_lite_aclk", "aud_mclk"; + clocks =3D <&clk 71>, <&clk_wiz_1 0>; + }; +... --=20 2.43.0 From nobody Mon Feb 9 08:05:32 2026 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 94C351E5713; Fri, 13 Dec 2024 16:52:49 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.140.110.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734108771; cv=none; b=B+aQJgYbwTURsV1DDtpF2MtTcmZplCOlNLofYL6cKE38wBUJMB7O0AOxtZz0kMpeQf+hTrY/cdYHppAlJLMI8hKVD2hfC20ZPdI301cjv99JToFFUZa8aPNaVdb//8+iqYu0FD0M9EQWLxQ8lS2/6B1nwtzZu4XSrw3TXh5AtV0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734108771; c=relaxed/simple; bh=XjGUg2mToV3fsdsTDeK9Na4L62RaTJHD8gQFQBfM2kw=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=CqCOnDmxq3l45PFS9SLCinHueIPZLk8x3/eM7J78NmERBqghhn+5JVf0f+mVBkhRjVdYSQB+oHRxHDfwN167OPLBQEj403FRBOmvipauk3ok8WAahso71sZefRxEYPBWiSYchKVa//kdKP8IUOeuOUOMaJR4Qdkd8E3gPyxWXgY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com; spf=pass smtp.mailfrom=arm.com; arc=none smtp.client-ip=217.140.110.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=arm.com Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 149C0169C; Fri, 13 Dec 2024 08:53:17 -0800 (PST) Received: from e119884-lin.cambridge.arm.com (e119884-lin.cambridge.arm.com [10.1.196.72]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 049203F5A1; Fri, 13 Dec 2024 08:52:47 -0800 (PST) From: Vincenzo Frascino To: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, vincenzo.frascino@arm.com Cc: Maruthi Srinivas Bayyavarapu , Sudeep Holla , Rob Herring Subject: [PATCH 3/3] xlnx: dt-bindings: xlnx,spdif: Convert to json-schema Date: Fri, 13 Dec 2024 16:52:40 +0000 Message-ID: <20241213165240.3652961-4-vincenzo.frascino@arm.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20241213165240.3652961-1-vincenzo.frascino@arm.com> References: <20241213165240.3652961-1-vincenzo.frascino@arm.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Convert the Xilinx SPDIF 2.0 device tree binding documentation to json-schema. Signed-off-by: Vincenzo Frascino --- .../devicetree/bindings/sound/xlnx,spdif.txt | 28 ----- .../devicetree/bindings/sound/xlnx,spdif.yaml | 100 ++++++++++++++++++ 2 files changed, 100 insertions(+), 28 deletions(-) delete mode 100644 Documentation/devicetree/bindings/sound/xlnx,spdif.txt create mode 100644 Documentation/devicetree/bindings/sound/xlnx,spdif.yaml diff --git a/Documentation/devicetree/bindings/sound/xlnx,spdif.txt b/Docum= entation/devicetree/bindings/sound/xlnx,spdif.txt deleted file mode 100644 index 15c2d64d247c..000000000000 --- a/Documentation/devicetree/bindings/sound/xlnx,spdif.txt +++ /dev/null @@ -1,28 +0,0 @@ -Device-Tree bindings for Xilinx SPDIF IP - -The IP supports playback and capture of SPDIF audio - -Required properties: - - compatible: "xlnx,spdif-2.0" - - clock-names: List of input clocks. - Required elements: "s_axi_aclk", "aud_clk_i" - - clocks: Input clock specifier. Refer to common clock bindings. - - reg: Base address and address length of the IP core instance. - - interrupts-parent: Phandle for interrupt controller. - - interrupts: List of Interrupt numbers. - - xlnx,spdif-mode: 0 :- receiver mode - 1 :- transmitter mode - - xlnx,aud_clk_i: input audio clock value. - -Example: - spdif_0: spdif@80010000 { - clock-names =3D "aud_clk_i", "s_axi_aclk"; - clocks =3D <&misc_clk_0>, <&clk 71>; - compatible =3D "xlnx,spdif-2.0"; - interrupt-names =3D "spdif_interrupt"; - interrupt-parent =3D <&gic>; - interrupts =3D <0 91 4>; - reg =3D <0x0 0x80010000 0x0 0x10000>; - xlnx,spdif-mode =3D <1>; - xlnx,aud_clk_i =3D <49152913>; - }; diff --git a/Documentation/devicetree/bindings/sound/xlnx,spdif.yaml b/Docu= mentation/devicetree/bindings/sound/xlnx,spdif.yaml new file mode 100644 index 000000000000..5f585157c0d2 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/xlnx,spdif.yaml @@ -0,0 +1,100 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/xlnx,spdif.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Device-Tree bindings for Xilinx SPDIF IP + +description: | + The IP supports playback and capture of SPDIF audio. + +maintainers: + - Vincenzo Frascino + - Maruthi Srinivas Bayyavarapu + +allOf: + - $ref: dai-common.yaml# + +properties: + compatible: + const: xlnx,spdif-2.0 + + reg: + maxItems: 1 + description: | + Base address and size of the IP core instance. + + "#sound-dai-cells": + const: 0 + + interrupt-names: + minItems: 1 + maxItems: 3 + description: | + Names specified to list of interrupts in same order mentioned under + "interrupts". + + interrupts-parent: + $ref: /schemas/types.yaml#/definitions/string + maxItems: 1 + description: | + Phandle for interrupt controller. + + interrupts: + minItems: 1 + maxItems: 3 + description: | + List of Interrupt numbers. + + clock-names: + minItems: 2 + maxItems: 3 + description: | + List of input clocks. + + clocks: + minItems: 2 + maxItems: 3 + description: | + Input clock specifier. Refer to common clock bindings. + + xlnx,spdif-mode: + $ref: /schemas/types.yaml#/definitions/uint32 + maxItems: 1 + minimum: 0 + maximum: 1 + description: | + 0 - receiver + 1 - transmitter + =20 + xlnx,aud_clk_i: + maxItems: 1 + description: | + Input audio clock value. + +required: + - compatible + - reg + - interrupt-names + - interrupts + - clock-names + - clocks + +additionalProperties: false + +examples: + - | + spdif_0: spdif@80010000 { + clock-names =3D "aud_clk_i", "s_axi_aclk"; + clocks =3D <&misc_clk_0>, <&clk 71>; + compatible =3D "xlnx,spdif-2.0"; + interrupt-names =3D "spdif_interrupt"; + interrupt-parent =3D <&gic>; + interrupts =3D <0 91 4>; + reg =3D <0x0 0x80010000 0x0 0x10000>; + xlnx,spdif-mode =3D <1>; + xlnx,aud_clk_i =3D <49152913>; + }; + +... --=20 2.43.0