[PATCH v10 1/3] dt-binding: mt8183: add Mediatek MDP3 dt-bindings

[moudy ho]

On Fri, 2021-12-10 at 12:17 -0600, Rob Herring wrote:
> On Thu, Dec 02, 2021 at 02:27:31PM +0800, Moudy Ho wrote:
> > This patch adds DT binding document for Media Data Path 3 (MDP3)
> > a unit in multimedia system used for scaling and color format
> > convert.
> > 
> > Signed-off-by: Moudy Ho <moudy.ho at mediatek.com>
> > ---
> >  .../bindings/media/mediatek,mdp3-rsz.yaml     |  65 ++++++
> >  .../bindings/media/mediatek,mdp3-wrot.yaml    |  67 ++++++
> >  .../bindings/soc/mediatek/mediatek,ccorr.yaml |  57 +++++
> >  .../bindings/soc/mediatek/mediatek,rdma.yaml  | 216
> > ++++++++++++++++++
> >  .../bindings/soc/mediatek/mediatek,wdma.yaml  |  68 ++++++
> >  5 files changed, 473 insertions(+)
> >  create mode 100644
> > Documentation/devicetree/bindings/media/mediatek,mdp3-rsz.yaml
> >  create mode 100644
> > Documentation/devicetree/bindings/media/mediatek,mdp3-wrot.yaml
> >  create mode 100644
> > Documentation/devicetree/bindings/soc/mediatek/mediatek,ccorr.yaml
> >  create mode 100644
> > Documentation/devicetree/bindings/soc/mediatek/mediatek,rdma.yaml
> >  create mode 100644
> > Documentation/devicetree/bindings/soc/mediatek/mediatek,wdma.yaml
> 
> I'm not a fan of bindings/soc/ either. Put everything in 
> bindings/media/. What's the difference between these blocks here and 
> the version used for display? If they are the same h/w, then the
> binding 
> needs to be the same. How they get used is the kernel's problem. 
> 
> It looks like the display ccorr, rdma, and wdma aren't documented.
> Fix 
> that before you add new stuff.
> 
> 

Hi Rob,

The bindings about display components were introduced by the other
patch listed below:

https://patchwork.kernel.org/project/linux-mediatek/patch/20211129184439.16892-4-jason-jh.lin@mediatek.com/
I'll add the bindings shared with display in the commit message, such
as ccorr and wdma but rdma has slight different.

> > diff --git a/Documentation/devicetree/bindings/media/mediatek,mdp3-
> > rsz.yaml b/Documentation/devicetree/bindings/media/mediatek,mdp3-
> > rsz.yaml
> > new file mode 100644
> > index 000000000000..d7f104a0f165
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/media/mediatek,mdp3-
> > rsz.yaml
> > @@ -0,0 +1,65 @@
> > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> > +%YAML 1.2
> > +---
> > +$id: 
> > https://urldefense.com/v3/__http://devicetree.org/schemas/media/mediatek,mdp3-rsz.yaml*__;Iw!!CTRNKA9wMg0ARbw!2EXFPaNlBbwXl4J4iyU18dX2N2UFR-c1E8Eo_tPF-FSoFNwhTh0bJynYCcta3KDP$
> >  
> > +$schema: 
> > https://urldefense.com/v3/__http://devicetree.org/meta-schemas/core.yaml*__;Iw!!CTRNKA9wMg0ARbw!2EXFPaNlBbwXl4J4iyU18dX2N2UFR-c1E8Eo_tPF-FSoFNwhTh0bJynYCTPZYiHy$
> >  
> > +
> > +title: Mediatek Resizer
> > +
> > +maintainers:
> > +  - Matthias Brugger <matthias.bgg at gmail.com>
> > +
> > +description: |
> > +  One of Media Data Path 3 (MDP3) components used to do frame
> > resizing.
> > +
> > +properties:
> > +  compatible:
> > +    items:
> > +      - enum:
> > +          - mediatek,mt8183-mdp3-rsz
> > +
> > +  mediatek,mdp3-id:
> > +    description: There may be multiple components with the same
> > function but
> > +      different addresses in MDP3. The MDP3 driver can select one
> > or zero of
> > +      them and connect other components in series according to the
> > current
> > +      application to form one or more data paths. This property
> > indicate the
> > +      selection order of the same components.
> > +    $ref: /schemas/types.yaml#/definitions/uint32
> > +    enum: [0, 1, 2, 3]
> 
> Again, an index nor an alias is the right approach for this. Use DT 
> graph like others do. 'It's too complicated' is not a reason unless
> you 
> show how and why it won't work.
> 
> Rob

Perhaps, I can rename the compatible, for example from
"mediatek,mt8183-mdp3-rsz" to "mediatek,mdp3-rsz0" & "mediatek,mdp3-
rsz1", and handle this in driver, so another similar attribute
"mediatek,mdp3-comp-ids" can be removed too.
On the other hand, it can maintain flexibility when adding other chip
settings.

Thanks & Regards,
Moudy Ho