| Message ID | 20250417151934.3570681-1-Frank.Li@nxp.com (mailing list archive) |
|---|---|
| State | New |
| Headers | show |
| Series | [1/1] dt-bindings: display: imx: convert fsl, dcu.txt to yaml format | expand |
On 2025-04-17 17:19, Frank Li wrote: > Convert fsl,dcu.txt to yaml format. > > Additional changes: > - remove label in example. > - change node to display-controller in example. > - use 32bit address in example. > > Signed-off-by: Frank Li <Frank.Li@nxp.com> Reviewed-by: Stefan Agner <stefan@agner.ch> > --- > .../devicetree/bindings/display/fsl,dcu.txt | 34 ---------- > .../bindings/display/fsl,ls1021a-dcu.yaml | 68 +++++++++++++++++++ > MAINTAINERS | 2 +- > 3 files changed, 69 insertions(+), 35 deletions(-) > delete mode 100644 Documentation/devicetree/bindings/display/fsl,dcu.txt > create mode 100644 Documentation/devicetree/bindings/display/fsl,ls1021a-dcu.yaml > > diff --git a/Documentation/devicetree/bindings/display/fsl,dcu.txt b/Documentation/devicetree/bindings/display/fsl,dcu.txt > deleted file mode 100644 > index 63ec2a624aa94..0000000000000 > --- a/Documentation/devicetree/bindings/display/fsl,dcu.txt > +++ /dev/null > @@ -1,34 +0,0 @@ > -Device Tree bindings for Freescale DCU DRM Driver > - > -Required properties: > -- compatible: Should be one of > - * "fsl,ls1021a-dcu". > - * "fsl,vf610-dcu". > - > -- reg: Address and length of the register set for dcu. > -- clocks: Handle to "dcu" and "pix" clock (in the order below) > - This can be the same clock (e.g. LS1021a) > - See ../clocks/clock-bindings.txt for details. > -- clock-names: Should be "dcu" and "pix" > - See ../clocks/clock-bindings.txt for details. > -- big-endian Boolean property, LS1021A DCU registers are big-endian. > -- port Video port for the panel output > - > -Optional properties: > -- fsl,tcon: The phandle to the timing controller node. > - > -Examples: > -dcu: dcu@2ce0000 { > - compatible = "fsl,ls1021a-dcu"; > - reg = <0x0 0x2ce0000 0x0 0x10000>; > - clocks = <&platform_clk 0>, <&platform_clk 0>; > - clock-names = "dcu", "pix"; > - big-endian; > - fsl,tcon = <&tcon>; > - > - port { > - dcu_out: endpoint { > - remote-endpoint = <&panel_out>; > - }; > - }; > -}; > diff --git a/Documentation/devicetree/bindings/display/fsl,ls1021a-dcu.yaml b/Documentation/devicetree/bindings/display/fsl,ls1021a-dcu.yaml > new file mode 100644 > index 0000000000000..7246c89271a8d > --- /dev/null > +++ b/Documentation/devicetree/bindings/display/fsl,ls1021a-dcu.yaml > @@ -0,0 +1,68 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/display/fsl,ls1021a-dcu.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Freescale DCU DRM Driver > + > +maintainers: > + - Frank Li <Frank.Li@nxp.com> > + > +properties: > + compatible: > + enum: > + - fsl,ls1021a-dcu > + - fsl,vf610-dcu > + > + reg: > + maxItems: 1 > + > + clocks: > + maxItems: 2 > + > + clock-names: > + items: > + - const: dcu > + - const: pix > + > + big-endian: true > + > + port: > + $ref: /schemas/graph.yaml#/$defs/port-base > + unevaluatedProperties: false > + description: Video port for the panel output > + > + properties: > + endpoint: > + $ref: /schemas/media/video-interfaces.yaml# > + unevaluatedProperties: false > + > + fsl,tcon: > + $ref: /schemas/types.yaml#/definitions/phandle > + description: The phandle to the timing controller node. > + > +required: > + - compatible > + - reg > + - clocks > + - clock-names > + > +additionalProperties: false > + > +examples: > + - | > + display-controller@2ce0000 { > + compatible = "fsl,ls1021a-dcu"; > + reg = <0x2ce0000 0x10000>; > + clocks = <&platform_clk 0>, <&platform_clk 0>; > + clock-names = "dcu", "pix"; > + big-endian; > + fsl,tcon = <&tcon>; > + > + port { > + endpoint { > + remote-endpoint = <&panel_out>; > + }; > + }; > + }; > diff --git a/MAINTAINERS b/MAINTAINERS > index 65e0716554203..02504134e1f5d 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -7894,7 +7894,7 @@ M: Alison Wang <alison.wang@nxp.com> > L: dri-devel@lists.freedesktop.org > S: Supported > T: git https://gitlab.freedesktop.org/drm/misc/kernel.git > -F: Documentation/devicetree/bindings/display/fsl,dcu.txt > +F: Documentation/devicetree/bindings/display/fsl,ls1021a-dcu.yaml > F: Documentation/devicetree/bindings/display/fsl,tcon.txt > F: drivers/gpu/drm/fsl-dcu/
diff --git a/Documentation/devicetree/bindings/display/fsl,dcu.txt b/Documentation/devicetree/bindings/display/fsl,dcu.txt deleted file mode 100644 index 63ec2a624aa94..0000000000000 --- a/Documentation/devicetree/bindings/display/fsl,dcu.txt +++ /dev/null @@ -1,34 +0,0 @@ -Device Tree bindings for Freescale DCU DRM Driver - -Required properties: -- compatible: Should be one of - * "fsl,ls1021a-dcu". - * "fsl,vf610-dcu". - -- reg: Address and length of the register set for dcu. -- clocks: Handle to "dcu" and "pix" clock (in the order below) - This can be the same clock (e.g. LS1021a) - See ../clocks/clock-bindings.txt for details. -- clock-names: Should be "dcu" and "pix" - See ../clocks/clock-bindings.txt for details. -- big-endian Boolean property, LS1021A DCU registers are big-endian. -- port Video port for the panel output - -Optional properties: -- fsl,tcon: The phandle to the timing controller node. - -Examples: -dcu: dcu@2ce0000 { - compatible = "fsl,ls1021a-dcu"; - reg = <0x0 0x2ce0000 0x0 0x10000>; - clocks = <&platform_clk 0>, <&platform_clk 0>; - clock-names = "dcu", "pix"; - big-endian; - fsl,tcon = <&tcon>; - - port { - dcu_out: endpoint { - remote-endpoint = <&panel_out>; - }; - }; -}; diff --git a/Documentation/devicetree/bindings/display/fsl,ls1021a-dcu.yaml b/Documentation/devicetree/bindings/display/fsl,ls1021a-dcu.yaml new file mode 100644 index 0000000000000..7246c89271a8d --- /dev/null +++ b/Documentation/devicetree/bindings/display/fsl,ls1021a-dcu.yaml @@ -0,0 +1,68 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/display/fsl,ls1021a-dcu.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale DCU DRM Driver + +maintainers: + - Frank Li <Frank.Li@nxp.com> + +properties: + compatible: + enum: + - fsl,ls1021a-dcu + - fsl,vf610-dcu + + reg: + maxItems: 1 + + clocks: + maxItems: 2 + + clock-names: + items: + - const: dcu + - const: pix + + big-endian: true + + port: + $ref: /schemas/graph.yaml#/$defs/port-base + unevaluatedProperties: false + description: Video port for the panel output + + properties: + endpoint: + $ref: /schemas/media/video-interfaces.yaml# + unevaluatedProperties: false + + fsl,tcon: + $ref: /schemas/types.yaml#/definitions/phandle + description: The phandle to the timing controller node. + +required: + - compatible + - reg + - clocks + - clock-names + +additionalProperties: false + +examples: + - | + display-controller@2ce0000 { + compatible = "fsl,ls1021a-dcu"; + reg = <0x2ce0000 0x10000>; + clocks = <&platform_clk 0>, <&platform_clk 0>; + clock-names = "dcu", "pix"; + big-endian; + fsl,tcon = <&tcon>; + + port { + endpoint { + remote-endpoint = <&panel_out>; + }; + }; + }; diff --git a/MAINTAINERS b/MAINTAINERS index 65e0716554203..02504134e1f5d 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -7894,7 +7894,7 @@ M: Alison Wang <alison.wang@nxp.com> L: dri-devel@lists.freedesktop.org S: Supported T: git https://gitlab.freedesktop.org/drm/misc/kernel.git -F: Documentation/devicetree/bindings/display/fsl,dcu.txt +F: Documentation/devicetree/bindings/display/fsl,ls1021a-dcu.yaml F: Documentation/devicetree/bindings/display/fsl,tcon.txt F: drivers/gpu/drm/fsl-dcu/
Convert fsl,dcu.txt to yaml format. Additional changes: - remove label in example. - change node to display-controller in example. - use 32bit address in example. Signed-off-by: Frank Li <Frank.Li@nxp.com> --- .../devicetree/bindings/display/fsl,dcu.txt | 34 ---------- .../bindings/display/fsl,ls1021a-dcu.yaml | 68 +++++++++++++++++++ MAINTAINERS | 2 +- 3 files changed, 69 insertions(+), 35 deletions(-) delete mode 100644 Documentation/devicetree/bindings/display/fsl,dcu.txt create mode 100644 Documentation/devicetree/bindings/display/fsl,ls1021a-dcu.yaml