Received: by 2002:a05:6358:489b:b0:bb:da1:e618 with SMTP id x27csp7957208rwn; Wed, 14 Sep 2022 07:02:32 -0700 (PDT) X-Google-Smtp-Source: AA6agR514JfM6cyDfsvcRa7HkDDGw88kSbxIgEdUHHFCdzOvhtfSznuOo4NF/4P/dCE9BfhludXY X-Received: by 2002:aa7:da83:0:b0:44e:69ba:81c7 with SMTP id q3-20020aa7da83000000b0044e69ba81c7mr30966722eds.323.1663164151902; Wed, 14 Sep 2022 07:02:31 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1663164151; cv=none; d=google.com; s=arc-20160816; b=m0mQCfLbusndUSAH0qeyScQExSa+GOK5ZG4YK/9RCHP9P0cxGSQO4t3FnOIccWblOY KLExPJggemN6s3ehB4BDXAIAd/xuCehc1hDl+ahxeDLBfTeUTOLHGUadPl4ekdqvkbE/ AE53lmDjWrLWiOp+dLLhKs+ZYAtpQcs1LroTXZ0U63DkcGrQwTGXXtssdIe4N2UeuomK Nh/G7MkOjkzpnOSn+26RRAkRASOC6UedT8M24jk5CtB1iInR76g/Ye9arAS3FdA9LXN7 PN+cn6HCRWfg6uCrlsR9Gls3w4NLOwXXrCttrCSi0MHyDKYVzQCnUucNQsac7hYOwNty LgWA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:in-reply-to:from :references:cc:to:content-language:subject:user-agent:mime-version :date:message-id:dkim-signature; bh=3IDIiUXkoYK6zOtpWLVJa1oiYLqpB2qfJBvU/rbxEAw=; b=KZfTH2HQM7c5hAVqkIQjOzJllSiUhbbC+MFfDe6wrf8HiqO49T5Nc+y/a4n803sAs0 QjdfJKZTOHrUbieamGz0IFLT0ZmSiTI6/zw356dlZLMz6s3aJ8MLoof+CEY8rsXbajb5 U03dEpDEIekJTR/aguAk1OwxYdP0Z3RCZEAUQ4efk2gHQVu2X0TcIJKCbsBnzFRlZ4cg F5rltUQ+yADcu40A3j6ZEvOhbYRLL3LAOpC56pDK0I4dS9U9av2PQ0dIIFi+TiG+S7wK bdRCEup6ziP1AAe3jxRet3KgcsXO/Hj22P39BIQLWu34trkqMQZie7stOT243JWoJlbD Q6SQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=JQ00q7ZR; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=collabora.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id ds18-20020a170907725200b0073d61fab74bsi13876219ejc.249.2022.09.14.07.02.02; Wed, 14 Sep 2022 07:02:31 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=JQ00q7ZR; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=collabora.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229723AbiINNqv (ORCPT + 99 others); Wed, 14 Sep 2022 09:46:51 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34286 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229479AbiINNqu (ORCPT ); Wed, 14 Sep 2022 09:46:50 -0400 Received: from madras.collabora.co.uk (madras.collabora.co.uk [46.235.227.172]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E523173909; Wed, 14 Sep 2022 06:46:45 -0700 (PDT) Received: from [192.168.1.100] (2-237-20-237.ip236.fastwebnet.it [2.237.20.237]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) (Authenticated sender: kholk11) by madras.collabora.co.uk (Postfix) with ESMTPSA id 05F6D6601F88; Wed, 14 Sep 2022 14:46:43 +0100 (BST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=collabora.com; s=mail; t=1663163204; bh=0e5JsYnyFEHqEe70UH7Ck+yOSRtWTcD8JNxi1AtWZcE=; h=Date:Subject:To:Cc:References:From:In-Reply-To:From; b=JQ00q7ZR/U7+dNuQmv5gJo6aaitTeYqkzYTCsRXrsi8LZamLZ2elKsQbDYm/+eRC0 c3Tare/R6nFXlVNCdN/l07OpRjx7+7gtWjh2LF8/Nxg6QqJ4HJHHpBVkSRwXNuE0Cl ifSl57dpOMADZymwbKKwTCyqpjCcuduAdxs7sQ79SDPofDbOPvNxKUHnvladZxjJHT JU9rgiorLB/OGuxAcec1Td81NuhKpwdfa0OsiZxMcZi88Go5FRp9cLENSkxmTYH3WK DGHo+z/dqyhV3zVqWm35h1AiSvJwLUEr2LO2FiHAxLMkt5WEIF1Rp1HZSAXiAgDNNk bSlp3RL/QYBOw== Message-ID: <06eb15ea-56b3-4f18-be18-3fc710cef779@collabora.com> Date: Wed, 14 Sep 2022 15:46:41 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.2.0 Subject: Re: [PATCH v2 2/4] dt-bindings: arm: mediatek: Add new bindings of MediaTek frequency hopping Content-Language: en-US To: Johnson Wang , robh+dt@kernel.org, krzysztof.kozlowski+dt@linaro.org, sboyd@kernel.org Cc: linux-clk@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-mediatek@lists.infradead.org, Project_Global_Chrome_Upstream_Group@mediatek.com, Edward-JW Yang References: <20220914124552.16964-1-johnson.wang@mediatek.com> <20220914124552.16964-3-johnson.wang@mediatek.com> From: AngeloGioacchino Del Regno In-Reply-To: <20220914124552.16964-3-johnson.wang@mediatek.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-3.7 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,NICE_REPLY_A,SPF_HELO_NONE, SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Il 14/09/22 14:45, Johnson Wang ha scritto: > Add the new binding documentation for MediaTek frequency hopping > and spread spectrum clocking control. > > Co-developed-by: Edward-JW Yang > Signed-off-by: Edward-JW Yang > Signed-off-by: Johnson Wang > --- > .../bindings/arm/mediatek/mediatek,fhctl.yaml | 47 +++++++++++++++++++ > 1 file changed, 47 insertions(+) > create mode 100644 Documentation/devicetree/bindings/arm/mediatek/mediatek,fhctl.yaml > > diff --git a/Documentation/devicetree/bindings/arm/mediatek/mediatek,fhctl.yaml b/Documentation/devicetree/bindings/arm/mediatek/mediatek,fhctl.yaml > new file mode 100644 > index 000000000000..7b0fd0889bb6 > --- /dev/null > +++ b/Documentation/devicetree/bindings/arm/mediatek/mediatek,fhctl.yaml > @@ -0,0 +1,47 @@ > +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/arm/mediatek/mediatek,fhctl.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: MediaTek frequency hopping and spread spectrum clocking control > + > +maintainers: > + - Edward-JW Yang > + > +description: | > + Frequency hopping control (FHCTL) is a piece of hardware that control > + some PLLs to adopt "hopping" mechanism to adjust their frequency. > + Spread spectrum clocking (SSC) is another function provided by this hardware. > + > +properties: > + compatible: > + const: mediatek,mt8186-fhctl > + > + reg: > + maxItems: 1 There are still a few issues in this binding that I can immediately see... > + > + clocks: MT8195 has 23 PLLs, MT8186 has 14, but perhaps in the future we may see something more than that on some newer SoC, so... clocks: maxItems: 30 > + description: Phandles of the PLL with FHCTL hardware capability. > + > + mediatek,hopping-ssc-percents: > + description: The percentage of spread spectrum clocking for one PLL. > + $ref: /schemas/types.yaml#/definitions/uint32 This is an array, so... $ref: /schemas/types.yaml#/definitions/uint32-array ...also, maxItems? and you should also specify: default: 0 <- because, by default, SSC is disabled minimum: 0 <- because this is the minimum accepted value Regards, Angelo > + maximum: 8 > + > +required: > + - compatible > + - reg > + - clocks > + > +additionalProperties: false > + > +examples: > + - | > + #include > + fhctl: fhctl@1000ce00 { > + compatible = "mediatek,mt8186-fhctl"; > + reg = <0x1000c000 0xe00>; > + clocks = <&apmixedsys CLK_APMIXED_MSDCPLL>; > + mediatek,hopping-ssc-percents = <3>; > + };