From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753861AbdJICQk (ORCPT ); Sun, 8 Oct 2017 22:16:40 -0400 Received: from mailgw02.mediatek.com ([218.249.47.111]:38477 "EHLO mailgw02.mediatek.com" rhost-flags-OK-FAIL-OK-FAIL) by vger.kernel.org with ESMTP id S1753812AbdJICQj (ORCPT ); Sun, 8 Oct 2017 22:16:39 -0400 X-UUID: 866ebcfeb5c24d47a15aa6cde7c19f6b-20171009 Message-ID: <1507515389.19789.0.camel@mhfsdcap03> Subject: Re: [PATCH 01/12] mmc: dt-bindings: update Mediatek MMC bindings From: Chaotian Jing To: Ulf Hansson CC: Rob Herring , Mark Rutland , Matthias Brugger , Catalin Marinas , Will Deacon , yong mao , Linus Walleij , "Javier Martinez Canillas" , Heiner Kallweit , Phong LE , "linux-mmc@vger.kernel.org" , "devicetree@vger.kernel.org" , "linux-arm-kernel@lists.infradead.org" , , "linux-kernel@vger.kernel.org" , srv_heupstream Date: Mon, 9 Oct 2017 10:16:29 +0800 In-Reply-To: References: <1505207272-16983-1-git-send-email-chaotian.jing@mediatek.com> <1505207272-16983-2-git-send-email-chaotian.jing@mediatek.com> <20170913141026.43oh4n4foipmahsk@rob-hp-laptop> <1505355021.8308.4.camel@mhfsdcap03> <1506475100.19851.9.camel@mhfsdcap03> <1506650162.19851.12.camel@mhfsdcap03> Content-Type: text/plain; charset="UTF-8" X-Mailer: Evolution 3.2.3-0ubuntu6 Content-Transfer-Encoding: 7bit MIME-Version: 1.0 X-MTK: N Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, 2017-10-02 at 08:53 +0200, Ulf Hansson wrote: > [...] > > >> > >> > Required properties: > >> > >> > -- compatible: Should be "mediatek,mt8173-mmc","mediatek,mt8135-mmc" > >> > >> > +- compatible: value should be either of the following. > >> > >> > + "mediatek,mt8135-mmc": for mmc host ip compatible with mt8135 > >> > >> > + "mediatek,mt8173-mmc": for mmc host ip compatible with mt8173 > >> > >> > + "mediatek,mt2701-mmc": for mmc host ip compatible with mt2701 > >> > >> > + "mediatek,mt2712-mmc": for mmc host ip compatible with mt2712 > >> > >> > +- reg: physical base address of the controller and length > >> > >> > - interrupts: Should contain MSDC interrupt number > >> > >> > -- clocks: MSDC source clock, HCLK > >> > >> > -- clock-names: "source", "hclk" > >> > >> > +- clocks: MSDC source clock, HCLK, source_cg > >> > >> > +- clock-names: "source", "hclk", "source_cg" > >> > >> > >> > >> All chips support source_cg? That's not backwards compatible for > >> > >> existing compatible strings if the driver requires it. > >> > > Not all chips support source_cg, for chips which do not support > >> > > source_cg, no need source_cg here, and the driver will parse it > >> > > to know if current chip support it. > >> > > >> > In such case you must not add add a required binding for it. I think > >> > that is what Rob is trying to point out for you. > >> > > >> > [...] > >> > > >> > Kind regards > >> > Uffe > >> The source_cg is required(MUST) at MT2712 and future SoCs, but not > >> required(do not have it) at previous SoCs, so that put it at required > >> properties, let the driver to handle it. > > Then you must explain that in the binding... > > On 29 September 2017 at 03:56, Chaotian Jing wrote: > > On Wed, 2017-09-27 at 09:18 +0800, Chaotian Jing wrote: > >> On Wed, 2017-09-27 at 00:33 +0200, Ulf Hansson wrote: > >> > On 14 September 2017 at 04:10, Chaotian Jing wrote: > >> > > On Wed, 2017-09-13 at 09:10 -0500, Rob Herring wrote: > >> > >> On Tue, Sep 12, 2017 at 05:07:41PM +0800, Chaotian Jing wrote: > >> > >> > Change the comptiable for support of multi-platform > >> > >> > Add description for reg > >> > >> > Add description for source_cg > >> > >> > Add description for mediatek,latch-ck > >> > >> > >> > >> This is at least the 3rd patch with exactly the same vague subject. > >> > >> Please make the subject somewhat unique. > >> > >> > >> > > Thx, will change the subject at next version > >> > >> > > >> > >> > Signed-off-by: Chaotian Jing > >> > >> > --- > >> > >> > Documentation/devicetree/bindings/mmc/mtk-sd.txt | 13 ++++++++++--- > >> > >> > 1 file changed, 10 insertions(+), 3 deletions(-) > >> > >> > > >> > >> > diff --git a/Documentation/devicetree/bindings/mmc/mtk-sd.txt b/Documentation/devicetree/bindings/mmc/mtk-sd.txt > >> > >> > index 4182ea3..405cd06 100644 > >> > >> > --- a/Documentation/devicetree/bindings/mmc/mtk-sd.txt > >> > >> > +++ b/Documentation/devicetree/bindings/mmc/mtk-sd.txt > >> > >> > @@ -7,10 +7,15 @@ This file documents differences between the core properties in mmc.txt > >> > >> > and the properties used by the msdc driver. > >> > >> > > > > > Any other comments about it ? still must not add a required binding for > > it ? if add a optional binding for it, how to add it ? as cannot > > duplicate "clocks" & "clock-names" in one node. > > > > > > I suggest you keep the description of the new clock name part of the > "Required properties:" header. However, after each clock name, > explicit state when the clock is required/optional. Something along > the lines as sdhci-msm does it. > Documentation/devicetree/bindings/mmc/sdhci-msm.txt > > Kind regards > Uffe Thx, I will send a new series of patch v2 to review.