From patchwork Thu Aug 29 10:26:25 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lukasz Majewski X-Patchwork-Id: 13783004 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id F014BC83030 for ; Thu, 29 Aug 2024 10:27:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Content-Transfer-Encoding: MIME-Version:Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-Type: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References:List-Owner; bh=wJQPagtdUNlpPJvsfeaRTfYdfhIfa8rXrCNWOietuUw=; b=elvwjKHZ/FDmGNXBB7goiG7iYY QLBNGQp2LP2HktlLokI60LzugvxWmeJAMYvzNawpjeWpwZbtw+1UmA0WIFN5WdS3nxsjwjuxCHmNq JB8mdt86fgd9rB2PQAiqBsWpWu0m6EOgJ6aBz/ePLFK2j0OWChfnEhqX82w8MKAobEiJohw45etn0 bzSuUiFEB7VaDjqWlBCtPaAi/ygX/k9yaN9pGFtquxnALBYnSWCoT5UiUI6wZbq1sCZ3Tk6O7JqEf /vbt3W6nKBRGGrcHfhLYJx2UGsfnaOI96qpa65/jNqSdmjDZ8/hyMiDnRTdF5ObPW7nZrBwO4vLPW eLE3z54Q==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1sjcNS-00000001ZLW-0KNA; Thu, 29 Aug 2024 10:27:42 +0000 Received: from phobos.denx.de ([2a01:238:438b:c500:173d:9f52:ddab:ee01]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1sjcMX-00000001Z63-2lWp for linux-arm-kernel@lists.infradead.org; Thu, 29 Aug 2024 10:26:47 +0000 Received: from localhost.localdomain (85-222-111-42.dynamic.chello.pl [85.222.111.42]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) (No client certificate requested) (Authenticated sender: lukma@denx.de) by phobos.denx.de (Postfix) with ESMTPSA id 0D4FA88A99; Thu, 29 Aug 2024 12:26:42 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=denx.de; s=phobos-20191101; t=1724927203; bh=wJQPagtdUNlpPJvsfeaRTfYdfhIfa8rXrCNWOietuUw=; h=From:To:Cc:Subject:Date:From; b=hb27Kn4dpKKFb0kWrFejnQDmo3fZHro//k8aKdCLNkno+KAhU41jRpAWQhyMVI6Xz 5T5N+BmG3nyzZjFZWWOCbZ9bsuXhwiIMl7e9sGlEAyCzFgbpO0YXr52YaOOLmcgKkc lQCv75QGo8JrfpShbjLceRIPhTnDwJaOy2Iji3tIoQREZPW3mc/lKdL2r4M01/mG9N z/oHEYJUm6BtgZJfrHAvjsahCiovUpfIa/EVyG4oIP/pHgSIi6ZrTpTO5GZPj8Vuia 1pNpEr3o7kIk0r+mx9kM4BJswWvjEX6B+LeCin7bTMVc9fTe1sK0CvnjahacjE6zNr sCr2G6EmpGGBg== From: Lukasz Majewski To: Rob Herring , Krzysztof Kozlowski , Conor Dooley , Shawn Guo , Sascha Hauer , linux-sound@vger.kernel.org Cc: Pengutronix Kernel Team , Fabio Estevam , devicetree@vger.kernel.org, imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, Liam Girdwood , Mark Brown , Lukasz Majewski Subject: [PATCH v4] ASoC: dt-bindings: Convert mxs-saif.txt to fsl,imx28-saif.yaml (imx28 saif) Date: Thu, 29 Aug 2024 12:26:25 +0200 Message-Id: <20240829102625.3128645-1-lukma@denx.de> X-Mailer: git-send-email 2.39.2 MIME-Version: 1.0 X-Virus-Scanned: clamav-milter 0.103.8 at phobos.denx.de X-Virus-Status: Clean X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240829_032646_025204_24A0B074 X-CRM114-Status: GOOD ( 17.83 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org The 'fsl,imx28-saif' compatible has already the mxs-saif.txt description. This patch converts (and removes it) this file to fsl,imx28-saif.yaml. Changes for the mxs-saif.txt: - Adds 'clocks', '#clock-cells' and '#sound-dai-cells' properties - Provide device description Signed-off-by: Lukasz Majewski Reviewed-by: Conor Dooley --- Changes for v4: - Change file name to match compatible (fsl,imx28-saif.yaml) - Remove 'saif0' and 'saif1' labels as those are not needed in the example node Changes for v3: - Add #clock-cells property Changes for v2: - Remove mxs-saif.txt - Add description with information about extensions required for this device's current DTS description --- .../bindings/sound/fsl,imx28-saif.yaml | 82 +++++++++++++++++++ .../devicetree/bindings/sound/mxs-saif.txt | 41 ---------- 2 files changed, 82 insertions(+), 41 deletions(-) create mode 100644 Documentation/devicetree/bindings/sound/fsl,imx28-saif.yaml delete mode 100644 Documentation/devicetree/bindings/sound/mxs-saif.txt diff --git a/Documentation/devicetree/bindings/sound/fsl,imx28-saif.yaml b/Documentation/devicetree/bindings/sound/fsl,imx28-saif.yaml new file mode 100644 index 000000000000..b2c73a9b7a55 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/fsl,imx28-saif.yaml @@ -0,0 +1,82 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/fsl,imx28-saif.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale MXS Serial Audio Interface (SAIF) + +maintainers: + - Lukasz Majewski + +allOf: + - $ref: dai-common.yaml# + +description: + The SAIF is based on I2S module that is used to communicate with audio codecs, + but only with half-duplex manner (i.e. it can either transmit or receive PCM + audio). + +properties: + compatible: + const: fsl,imx28-saif + + reg: + maxItems: 1 + + "#sound-dai-cells": + const: 0 + + interrupts: + maxItems: 1 + + dmas: + maxItems: 1 + + dma-names: + const: rx-tx + + "#clock-cells": + description: Configure the I2S device as MCLK clock provider. + const: 0 + + clocks: + maxItems: 1 + + fsl,saif-master: + description: Indicate that saif is a slave and its phandle points to master + $ref: /schemas/types.yaml#/definitions/phandle + +required: + - compatible + - reg + - "#sound-dai-cells" + - interrupts + - dmas + - dma-names + - clocks + +unevaluatedProperties: false + +examples: + - | + saif@80042000 { + compatible = "fsl,imx28-saif"; + reg = <0x80042000 2000>; + #sound-dai-cells = <0>; + interrupts = <59>; + dmas = <&dma_apbx 4>; + dma-names = "rx-tx"; + #clock-cells = <0>; + clocks = <&clks 53>; + }; + saif@80046000 { + compatible = "fsl,imx28-saif"; + reg = <0x80046000 2000>; + #sound-dai-cells = <0>; + interrupts = <58>; + dmas = <&dma_apbx 5>; + dma-names = "rx-tx"; + clocks = <&clks 53>; + fsl,saif-master = <&saif0>; + }; diff --git a/Documentation/devicetree/bindings/sound/mxs-saif.txt b/Documentation/devicetree/bindings/sound/mxs-saif.txt deleted file mode 100644 index 7ba07a118e37..000000000000 --- a/Documentation/devicetree/bindings/sound/mxs-saif.txt +++ /dev/null @@ -1,41 +0,0 @@ -* Freescale MXS Serial Audio Interface (SAIF) - -Required properties: -- compatible: Should be "fsl,-saif" -- reg: Should contain registers location and length -- interrupts: Should contain ERROR interrupt number -- dmas: DMA specifier, consisting of a phandle to DMA controller node - and SAIF DMA channel ID. - Refer to dma.txt and fsl-mxs-dma.txt for details. -- dma-names: Must be "rx-tx". - -Optional properties: -- fsl,saif-master: phandle to the master SAIF. It's only required for - the slave SAIF. - -Note: Each SAIF controller should have an alias correctly numbered -in "aliases" node. - -Example: - -aliases { - saif0 = &saif0; - saif1 = &saif1; -}; - -saif0: saif@80042000 { - compatible = "fsl,imx28-saif"; - reg = <0x80042000 2000>; - interrupts = <59>; - dmas = <&dma_apbx 4>; - dma-names = "rx-tx"; -}; - -saif1: saif@80046000 { - compatible = "fsl,imx28-saif"; - reg = <0x80046000 2000>; - interrupts = <58>; - dmas = <&dma_apbx 5>; - dma-names = "rx-tx"; - fsl,saif-master = <&saif0>; -};