From patchwork Fri Feb 21 17:50:29 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vincenzo Frascino X-Patchwork-Id: 13986111 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 3A0DA1FAC3D; Fri, 21 Feb 2025 17:50:42 +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=1740160244; cv=none; b=H0duklGBfwAf6VcM0KXywxj5R39KuOyL4k6+OGQYjdc2K7+LaCKm08z88SdMPakrcO4VwHSG1WJ0bq/ZwfY4nb/PDvmLT5tPx05coBisKF8u84kmTSVBGos+ZbyTEK6ZeicZc9GY9LqLNKNApO349zoXPpInjEFNN2J8YVnjeZU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1740160244; c=relaxed/simple; bh=wOubAz0sDuuNRzuYN6R/Ee5gKWQWVEt4uVgZS424IWU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=jGEI7sxDppzN3i5uZQxB98zG4DFg1oYiHMugJgThE1IKETrbEsEdtZ3VnOZCXwF4Y5ZMZZslgqVjyybm6jcr6cYbvpBQrFwAAabSl45qtR7xRoyywFyhN+8Ht92xk8S3ypKqM8/uHdEoMuWU3ZIcbc2Px+ecvOycYmHMYUAH1q0= 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 41A23169C; Fri, 21 Feb 2025 09:51:00 -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 E7AE13F59E; Fri, 21 Feb 2025 09:50:40 -0800 (PST) From: Vincenzo Frascino To: linux-sound@vger.kernel.org Cc: Vincenzo Frascino , Maruthi Srinivas Bayyavarapu , Sudeep Holla , Liam Girdwood , Mark Brown , Rob Herring , Krzysztof Kozlowski , Conor Dooley , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v2 3/4] ASoC: dt-bindings: xlnx,spdif: Convert to json-schema Date: Fri, 21 Feb 2025 17:50:29 +0000 Message-ID: <20250221175030.1395815-4-vincenzo.frascino@arm.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20250221175030.1395815-1-vincenzo.frascino@arm.com> References: <20250221175030.1395815-1-vincenzo.frascino@arm.com> Precedence: bulk X-Mailing-List: linux-sound@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 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 | 92 +++++++++++++++++++ 2 files changed, 92 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/Documentation/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 = "aud_clk_i", "s_axi_aclk"; - clocks = <&misc_clk_0>, <&clk 71>; - compatible = "xlnx,spdif-2.0"; - interrupt-names = "spdif_interrupt"; - interrupt-parent = <&gic>; - interrupts = <0 91 4>; - reg = <0x0 0x80010000 0x0 0x10000>; - xlnx,spdif-mode = <1>; - xlnx,aud_clk_i = <49152913>; - }; diff --git a/Documentation/devicetree/bindings/sound/xlnx,spdif.yaml b/Documentation/devicetree/bindings/sound/xlnx,spdif.yaml new file mode 100644 index 000000000000..ef89fe05d745 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/xlnx,spdif.yaml @@ -0,0 +1,92 @@ +# 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: Xilinx SPDIF IP + +description: | + The IP supports playback and capture of SPDIF audio. + +maintainers: + - Vincenzo Frascino + +allOf: + - $ref: dai-common.yaml# + +properties: + compatible: + enum: + - xlnx,spdif-2.0 + + reg: + minItems: 1 + maxItems: 4 + description: | + Base address and size of the IP core instance. + + interrupt-names: + minItems: 1 + maxItems: 3 + description: | + Names specified to list of interrupts in same order mentioned under + "interrupts". + + 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 + enum: + - 0 + - 1 + description: | + 0 - receiver + 1 - transmitter + + xlnx,aud_clk_i: + $ref: /schemas/types.yaml#/definitions/uint32 + description: | + Input audio clock value. + +required: + - compatible + - reg + - interrupt-names + - interrupts + - clock-names + - clocks + +additionalProperties: true + +examples: + - | + spdif_0: spdif@80010000 { + clock-names = "aud_clk_i", "s_axi_aclk"; + clocks = <&misc_clk_0>, <&clk 71>; + compatible = "xlnx,spdif-2.0"; + interrupt-names = "spdif_interrupt"; + interrupt-parent = <&gic>; + interrupts = <0 91 4>; + reg = <0x0 0x80010000 0x0 0x10000>; + xlnx,spdif-mode = <1>; + xlnx,aud_clk_i = <49152913>; + }; + +...