From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-14.4 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,INCLUDES_CR_TRAILER,INCLUDES_PATCH,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 8F7E0C49EA6 for ; Thu, 24 Jun 2021 20:27:00 +0000 (UTC) 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 mail.kernel.org (Postfix) with ESMTPS id 5C271613BA for ; Thu, 24 Jun 2021 20:27:00 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 5C271613BA Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:In-Reply-To:MIME-Version:References: Message-ID:Subject:Cc:To:From:Date:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=Dy3cTugi/W6FrTTzE6c5gPIdCPOSlUQhFIAnB1W22ek=; b=CD1sb16J36Ea5P YNTUj1ri/Gbf3VNOOPpzBR452W88kH7aBjfi8LgY9U22qDxdOQ0IagAh/ACpKCpkLk22dfh2n+vzv edppvf4Y+OGkmDItdQIU+sg2fJchVdkbqpU0nYMQWcLdGNhXo2wGGEfoX9bYcN37gFbB5jKOe3i9R bpLR7DPEQ9S/60zF+xI8JCg1zKUszZ4s5Vt9VPWc3mkqKZWGqDh/06aft7fkhYiBUBXCGSAVdOCHj G0XbA8G1tljYc2YBK05YsWmWBXAhvO0px7sdfvkoCM0v3TbQYDMixg0YetgzJiZju2nCyaJ4A5/mf QKGfJWsnxBDZ6PdrcwXQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1lwVv0-00GA64-0J; Thu, 24 Jun 2021 20:25:46 +0000 Received: from mail-io1-f43.google.com ([209.85.166.43]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1lwVuv-00GA54-Km for linux-arm-kernel@lists.infradead.org; Thu, 24 Jun 2021 20:25:43 +0000 Received: by mail-io1-f43.google.com with SMTP id o5so9900073iob.4 for ; Thu, 24 Jun 2021 13:25:41 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=1srSw9djj3aE0hZl1UwtMCiUfWV+Qd6ksCBqCVsKFrA=; b=k3QXV9MweU+1IdPOycY+hMZqeqK5TcVqf82EV8qKuWSf4bVfK9JHXZDHX8LGkEt3dG zCM8M+NU0EjnWrjDORlBzI/XIHXmz5LocTwf78ndVFJwBYAgPQ47MVLHMVGNro7AuzB0 MwYUcGwO89pHkBqWY7njQeDbgg+ssV1Rd2NjuI3g02c1CWvX+QgFF0hDBhBhZ0kZO/oX qPCZOz67EpJXB198MMg6I5hd8jBR497G/nVhRQhEejJUWNDTlss7eukwUkNio/asOiuy 7ryyIWwi31MidjX+OsqAs2BGsjtm2UJTh0Uwi4th2hBLaxRcHIhovl9/XEoTvxeHyoI8 gUYA== X-Gm-Message-State: AOAM530IC7APfjXmXQ58kYyd1qxvDxbD4QDQA5SFkC9zXrfWqaOIkQBG tmirORoBEw0fMdn/ZCSf/Q== X-Google-Smtp-Source: ABdhPJwe/5Hx7iUneDMwrrXFoJWPvvXETCyKdfaAvHzf8grTRznsTSIUzXqtBcMvErIpbGMY5npQhQ== X-Received: by 2002:a5d:89d0:: with SMTP id a16mr5628232iot.76.1624566340465; Thu, 24 Jun 2021 13:25:40 -0700 (PDT) Received: from robh.at.kernel.org ([64.188.179.248]) by smtp.gmail.com with ESMTPSA id s17sm1873575ioe.32.2021.06.24.13.25.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 24 Jun 2021 13:25:38 -0700 (PDT) Received: (nullmailer pid 1931032 invoked by uid 1000); Thu, 24 Jun 2021 20:25:35 -0000 Date: Thu, 24 Jun 2021 14:25:35 -0600 From: Rob Herring To: Nobuhiro Iwamatsu Cc: michal.simek@xilinx.com, mturquette@baylibre.com, sboyd@kernel.org, devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-clk@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH v3] dt-bindings: clk: zynqmp: convert bindings to YAML Message-ID: <20210624202535.GA1929073@robh.at.kernel.org> References: <20210613204742.292053-1-iwamatsu@nigauri.org> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20210613204742.292053-1-iwamatsu@nigauri.org> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210624_132541_734791_CBFEE7BA X-CRM114-Status: GOOD ( 24.33 ) 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: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org On Mon, Jun 14, 2021 at 05:47:42AM +0900, Nobuhiro Iwamatsu wrote: > Convert common clock for Xilinx Zynq MPSoC SoC bindings documentation > to YAML. > > Signed-off-by: Nobuhiro Iwamatsu > --- > v3: Drop commit for mailbox/xlnx,zynqmp-ipi-mailbox.txt > v2: Fix warning with DT_CHECKER_FLAGS=-m. > > .../bindings/clock/xlnx,zynqmp-clk.txt | 63 ------------------- > .../bindings/clock/xlnx,zynqmp-clk.yaml | 63 +++++++++++++++++++ > 2 files changed, 63 insertions(+), 63 deletions(-) > delete mode 100644 Documentation/devicetree/bindings/clock/xlnx,zynqmp-clk.txt > create mode 100644 Documentation/devicetree/bindings/clock/xlnx,zynqmp-clk.yaml > > diff --git a/Documentation/devicetree/bindings/clock/xlnx,zynqmp-clk.txt b/Documentation/devicetree/bindings/clock/xlnx,zynqmp-clk.txt > deleted file mode 100644 > index 391ee1a60bed4a..00000000000000 > --- a/Documentation/devicetree/bindings/clock/xlnx,zynqmp-clk.txt > +++ /dev/null > @@ -1,63 +0,0 @@ > --------------------------------------------------------------------------- > -Device Tree Clock bindings for the Zynq Ultrascale+ MPSoC controlled using > -Zynq MPSoC firmware interface > --------------------------------------------------------------------------- > -The clock controller is a h/w block of Zynq Ultrascale+ MPSoC clock > -tree. It reads required input clock frequencies from the devicetree and acts > -as clock provider for all clock consumers of PS clocks. > - > -See clock_bindings.txt for more information on the generic clock bindings. > - > -Required properties: > - - #clock-cells: Must be 1 > - - compatible: Must contain: "xlnx,zynqmp-clk" > - - clocks: List of clock specifiers which are external input > - clocks to the given clock controller. Please refer > - the next section to find the input clocks for a > - given controller. > - - clock-names: List of clock names which are exteral input clocks > - to the given clock controller. Please refer to the > - clock bindings for more details. > - > -Input clocks for zynqmp Ultrascale+ clock controller: > - > -The Zynq UltraScale+ MPSoC has one primary and four alternative reference clock > -inputs. These required clock inputs are: > - - pss_ref_clk (PS reference clock) > - - video_clk (reference clock for video system ) > - - pss_alt_ref_clk (alternative PS reference clock) > - - aux_ref_clk > - - gt_crx_ref_clk (transceiver reference clock) > - > -The following strings are optional parameters to the 'clock-names' property in > -order to provide an optional (E)MIO clock source: > - - swdt0_ext_clk > - - swdt1_ext_clk > - - gem0_emio_clk > - - gem1_emio_clk > - - gem2_emio_clk > - - gem3_emio_clk > - - mio_clk_XX # with XX = 00..77 > - - mio_clk_50_or_51 #for the mux clock to gem tsu from 50 or 51 What happened to these with no explanation. > - > - > -Output clocks are registered based on clock information received > -from firmware. Output clocks indexes are mentioned in > -include/dt-bindings/clock/xlnx-zynqmp-clk.h. > - > -------- > -Example > -------- > - > -firmware { > - zynqmp_firmware: zynqmp-firmware { > - compatible = "xlnx,zynqmp-firmware"; > - method = "smc"; > - zynqmp_clk: clock-controller { > - #clock-cells = <1>; > - compatible = "xlnx,zynqmp-clk"; > - clocks = <&pss_ref_clk>, <&video_clk>, <&pss_alt_ref_clk>, <&aux_ref_clk>, <>_crx_ref_clk>; > - clock-names = "pss_ref_clk", "video_clk", "pss_alt_ref_clk","aux_ref_clk", "gt_crx_ref_clk"; > - }; > - }; > -}; > diff --git a/Documentation/devicetree/bindings/clock/xlnx,zynqmp-clk.yaml b/Documentation/devicetree/bindings/clock/xlnx,zynqmp-clk.yaml > new file mode 100644 > index 00000000000000..e7a1384fb646e4 > --- /dev/null > +++ b/Documentation/devicetree/bindings/clock/xlnx,zynqmp-clk.yaml > @@ -0,0 +1,63 @@ > +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/clock/xlnx,zynqmp-clk.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Xilinx Zynq Ultrascale+ MPSoC clock controller Device Tree Bindings > + > +maintainers: > + - Michal Simek > + > +description: | > + The clock controller is a h/w block of Zynq Ultrascale+ MPSoC clock > + tree. It reads required input clock frequencies from the devicetree and acts > + as clock provider for all clock consumers of PS clocks. > + > +properties: > + compatible: > + const: xlnx,zynqmp-clk > + > + "#clock-cells": > + const: 1 > + > + clocks: > + description: | > + List of clock specifiers which are external input > + clocks to the given clock controller. > + items: > + - description: PS reference clock > + - description: reference clock for video system > + - description: alternative PS reference clock > + - description: auxiliary reference clock > + - description: transceiver reference clock > + > + clock-names: > + items: > + - const: pss_ref_clk > + - const: video_clk > + - const: pss_alt_ref_clk > + - const: aux_ref_clk > + - const: gt_crx_ref_clk > + > +required: > + - compatible > + - "#clock-cells" > + - clocks > + - clock-names > + > +additionalProperties: false > + > +examples: > + - | > + firmware { > + zynqmp_firmware: zynqmp-firmware { > + zynqmp_clk: clock-controller { > + #clock-cells = <1>; > + compatible = "xlnx,zynqmp-clk"; > + clocks = <&pss_ref_clk>, <&video_clk>, <&pss_alt_ref_clk>, <&aux_ref_clk>, <>_crx_ref_clk>; > + clock-names = "pss_ref_clk", "video_clk", "pss_alt_ref_clk","aux_ref_clk", "gt_crx_ref_clk"; > + }; > + }; > + }; > +... > -- > 2.32.0 > > _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel