Re: [PATCH] dt-bindings: display: Reorganize legacy eDP panel bindings

From: Rob Herring (Arm)
Date: Tue May 21 2024 - 10:21:24 EST



On Mon, 20 May 2024 15:38:17 -0700, Douglas Anderson wrote:
> Back in the day, we used to need to list the exact panel in dts for
> eDP panels. This led to all sorts of problems including a large number
> of cases where people listed a bogus panel in their device tree
> because of the needs of second sourcing (and third sourcing, and
> fourth sourcing, ...). Back when we needed to add eDP panels to dts
> files we used to list them in "panel-simple.yaml".
>
> These days we have the new way of doing things as documented in
> "panel-edp.yaml". We can just list the compatible "edp-panel", add
> some timing info to the source code, and we're good to go. There's not
> really good reasons not to use this new method.
>
> To try to make it obvious that we shouldn't add new compatible strings
> for eDP panels, let's move them all out of the old "panel-simple.yaml"
> file to their own file: "panel-edp-legacy.yaml". This new file will
> have a description that makes it obvious that we shouldn't use it for
> new panels.
>
> While we're doing this:
> - We can remove eDP-specific properties from panel-simple.yaml since
> there are no more panels there.
> - We don't need to copy non-eDP properties to the
> "panel-edp-legacy.yaml".
> - We'll fork off a separate yaml file for "samsung,atna33xc20.yaml".
> This is an eDP panel which isn't _quite_ handled by the generic
> "edp-panel" compatible since it's not allowed to have an external
> backlight (it has one builtin) and it absolutely requires an
> "enable" GPIO.
> - We'll un-fork the "sharp,ld-d5116z01b.yaml" and put it in
> "panel-edp-legacy.yaml" since there doesn't appear to be any reason
> for it to be separate.
>
> Suggested-by: Dmitry Baryshkov <dmitry.baryshkov@xxxxxxxxxx>
> Signed-off-by: Douglas Anderson <dianders@xxxxxxxxxxxx>
> ---
>
> .../display/panel/panel-edp-legacy.yaml | 127 ++++++++++++++++++
> .../bindings/display/panel/panel-simple.yaml | 58 --------
> .../display/panel/samsung,atna33xc20.yaml | 95 +++++++++++++
> .../display/panel/sharp,ld-d5116z01b.yaml | 30 -----
> 4 files changed, 222 insertions(+), 88 deletions(-)
> create mode 100644 Documentation/devicetree/bindings/display/panel/panel-edp-legacy.yaml
> create mode 100644 Documentation/devicetree/bindings/display/panel/samsung,atna33xc20.yaml
> delete mode 100644 Documentation/devicetree/bindings/display/panel/sharp,ld-d5116z01b.yaml
>

Reviewed-by: Rob Herring (Arm) <robh@xxxxxxxxxx>