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;
MIME-Version: 1.0
References: <20220524134840.1.I80072b8815ac08c12af8f379a33cc2d83693dc51@changeid>
 <311a23c9-e31d-e20d-8ba9-80d3197e8d1d@somainline.org> <CAD=FV=WKgPWxEL+mhb9cCGOLObJEPtX_sHLQ1z3rz3usDG1m+Q@mail.gmail.com>
 <1d602bb6-d3a4-2ec0-e3e7-d9395edec416@somainline.org>
In-Reply-To: <1d602bb6-d3a4-2ec0-e3e7-d9395edec416@somainline.org>
From:   Doug Anderson <dianders@chromium.org>
Date:   Tue, 24 May 2022 15:55:05 -0700
Message-ID: <CAD=FV=U2C1W+JHWyGRfyRB=WiPKLYvtjO90UDoJ9p+Xwe09+ow@mail.gmail.com>
Subject: Re: [PATCH] arm64: dts: qcom: sc7280: Add touchscreen to villager
To:     Konrad Dybcio <konrad.dybcio@somainline.org>
Cc:     Bjorn Andersson <bjorn.andersson@linaro.org>,
        Stephen Boyd <swboyd@chromium.org>,
        Matthias Kaehlcke <mka@chromium.org>,
        Andy Gross <agross@kernel.org>,
        Krzysztof Kozlowski <krzk+dt@kernel.org>,
        Rob Herring <robh+dt@kernel.org>,
        "open list:OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS" 
        <devicetree@vger.kernel.org>,
        linux-arm-msm <linux-arm-msm@vger.kernel.org>,
        LKML <linux-kernel@vger.kernel.org>
Content-Type: text/plain; charset="UTF-8"
Precedence: bulk

Hi,

On Tue, May 24, 2022 at 3:41 PM Konrad Dybcio
<konrad.dybcio@somainline.org> wrote:
>
>
> On 25/05/2022 00:14, Doug Anderson wrote:
> > Hi,
> >
> > On Tue, May 24, 2022 at 2:13 PM Konrad Dybcio
> > <konrad.dybcio@somainline.org> wrote:
> >>
> >> On 24/05/2022 22:48, Douglas Anderson wrote:
> >>> This adds the touchscreen to the sc7280-herobrine-villager device
> >>> tree. Note that the touchscreen on villager actually uses the reset
> >>> line and thus we use the more specific "elan,ekth6915" compatible
> >>> which allows us to specify the reset.
> >>>
> >>> The fact that villager's touchscreen uses the reset line can be
> >>> contrasted against the touchscreen for CRD/herobrine-r1. On those
> >>> boards, even though the touchscreen goes to the display, it's not
> >>> hooked up to anything there.
> >>>
> >>> In order to keep the line parked on herobrine/CRD, we'll move the
> >>> pullup from the qcard.dtsi file to the specific boards. This allows us
> >>> to disable the pullup in the villager device tree since the pin is an
> >>> output.
> >>>
> >>> Signed-off-by: Douglas Anderson <dianders@chromium.org>
> >>> ---
> >>> This uses bindings introduced in the patch ("dt-bindings: HID:
> >>> i2c-hid: elan: Introduce bindings for Elan eKTH6915") [1].
> >>>
> >>> [1] https://lore.kernel.org/r/20220523142257.v2.1.Iedc61f9ef220a89af6a031200a7850a27a440134@changeid
> >>>
> >>>    .../boot/dts/qcom/sc7280-herobrine-crd.dts    | 11 ++++++++
> >>>    .../qcom/sc7280-herobrine-herobrine-r1.dts    | 11 ++++++++
> >>>    .../dts/qcom/sc7280-herobrine-villager-r0.dts | 25 +++++++++++++++++++
> >>>    arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi    |  1 -
> >>>    4 files changed, 47 insertions(+), 1 deletion(-)
> >>>
> >>> diff --git a/arch/arm64/boot/dts/qcom/sc7280-herobrine-crd.dts b/arch/arm64/boot/dts/qcom/sc7280-herobrine-crd.dts
> >>> index a4ac33c4fd59..b79d84d7870a 100644
> >>> --- a/arch/arm64/boot/dts/qcom/sc7280-herobrine-crd.dts
> >>> +++ b/arch/arm64/boot/dts/qcom/sc7280-herobrine-crd.dts
> >>> @@ -134,6 +134,17 @@ &sdhc_2 {
> >>>        status = "okay";
> >>>    };
> >>>
> >>> +/* PINCTRL - ADDITIONS TO NODES IN PARENT DEVICE TREE FILES */
> >> Please drop this line, this isn't msm-3.4. It's immediately obvious that
> >> if a pin is referenced by a label and it is not defined in this file
> >> (because otherwise it wouldn't be both defined and referenced here..),
> >> it comes from a previously included device tree.
> > In general these headings specify a change in sort ordering. Without
> > them then either we intersperse pinctrl overrides with other stuff,
> > which IMO is overall worse or people have no idea why the sort
> > ordering changes.
>
> I get what you mean, but at the end of the day, the entire machine DT
> specifies all machine-specific changes and only machine-specific
> changes. They all are a part of a bigger picture, sometimes being
> downstream from the SoC, sometimes downstream from a common board. I
> don't think it brings much benefit if at all to separate them into
> sections like these, if in the end they all correspond to modifications
> present in the hardware. In its current form, the sorting is all over
> the place, and ideally we could have labels sorted alphabetically.

I think overall DT just made it hard. In my mind the root of the
problem is actually that we're trying to avoid replicating hierarchy
from the dtsi files that we include. In other words, we try very hard
to do:

&qup_i2c2_data_clk {
  bias-disable;
};

Instead of replicating the hierarchy in the board dts files, like this:

/ {
  soc@0 {
    pinctrl@f100000 {
      qup-i2c2-data-clk {
        bias-disable;;
      };
    };
  };
};

(and, of course, you could replicate parts of the hierarchy too).

When you avoid replicating things then it really causes everything to
become scattered / disorganized and I think there's a benefit to
trying to enforce some type of ordering.


> The present solution, in my opinion, causes more disarray as you first
> have to think about what is the change against and then find it in the
> corresponding subsection instead of thinking of it as a complete
> quote-on-quote diff against the parent DTSIs.

It's a fair opinion. I'd be interested to know if others feel the same
way. In general it feels like a style decision for the people working
on these boards, subject to the approval of the Qualcomm tree
maintainer(s).


> Plus, most DTs don't split
> it like that.

I will say that it's hard to compare the trogdor (and now herobrine)
situation with most other ARM boards out there. There are _a lot_ of
different variants and revisions and it's, IMO, more art than science
in trying to balance all of the tradeoffs between duplicating code and
ending up with unreadable spaghetti. I won't claim that we made the
right tradeoff in every case, but so far experience on trogdor has
been that things ended up being fairly understandable I think?

-Doug