Re: [PATCH v3 4/6] dt-bindings: display: rockchip: dw-hdmi: Convert binding to YAML
Hi Rob, On Mon, Jan 11, 2021 at 05:12:58PM -0600, Rob Herring wrote: > On Tue, Jan 05, 2021 at 08:08:16AM +0200, Laurent Pinchart wrote: > > Convert the Rockchip HDMI TX text binding to YAML. > > > > Signed-off-by: Laurent Pinchart > > --- > > Changes since v2: > > > > - Use Mark's @gmail.com e-mail address as the @rock-chips.com address > > bounces > > > > Changes since v1: > > > > - Drop pinctrl-0 and pinctrl-1 > > - Use unevaluatedProperties instead of additionalProperties > > - Drop reg and interrupts as they're checked in the base schema > > - Rebase on top of OF graph schema, dropped redundant properties > > - Fix identation for enum entries > > - Tidy up clock names > > --- > > .../display/rockchip/dw_hdmi-rockchip.txt | 74 > > .../display/rockchip/rockchip,dw-hdmi.yaml| 158 ++ > > 2 files changed, 158 insertions(+), 74 deletions(-) > > delete mode 100644 > > Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > > create mode 100644 > > Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > > > > diff --git > > a/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > > b/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > > deleted file mode 100644 > > index 3d32ce137e7f.. > > --- > > a/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > > +++ /dev/null > > @@ -1,74 +0,0 @@ > > -Rockchip DWC HDMI TX Encoder > > - > > - > > -The HDMI transmitter is a Synopsys DesignWare HDMI 1.4 TX controller IP > > -with a companion PHY IP. > > - > > -These DT bindings follow the Synopsys DWC HDMI TX bindings defined in > > -Documentation/devicetree/bindings/display/bridge/dw_hdmi.txt with the > > -following device-specific properties. > > - > > - > > -Required properties: > > - > > -- compatible: should be one of the following: > > - "rockchip,rk3228-dw-hdmi" > > - "rockchip,rk3288-dw-hdmi" > > - "rockchip,rk3328-dw-hdmi" > > - "rockchip,rk3399-dw-hdmi" > > -- reg: See dw_hdmi.txt. > > -- reg-io-width: See dw_hdmi.txt. Shall be 4. > > -- interrupts: HDMI interrupt number > > -- clocks: See dw_hdmi.txt. > > -- clock-names: Shall contain "iahb" and "isfr" as defined in dw_hdmi.txt. > > -- ports: See dw_hdmi.txt. The DWC HDMI shall have a single port numbered 0 > > - corresponding to the video input of the controller. The port shall have > > two > > - endpoints, numbered 0 and 1, connected respectively to the vopb and vopl. > > -- rockchip,grf: Shall reference the GRF to mux vopl/vopb. > > - > > -Optional properties > > - > > -- ddc-i2c-bus: The HDMI DDC bus can be connected to either a system I2C > > master > > - or the functionally-reduced I2C master contained in the DWC HDMI. When > > - connected to a system I2C master this property contains a phandle to that > > - I2C master controller. > > -- clock-names: See dw_hdmi.txt. The "cec" clock is optional. > > -- clock-names: May contain "cec" as defined in dw_hdmi.txt. > > -- clock-names: May contain "grf", power for grf io. > > -- clock-names: May contain "vpll", external clock for some hdmi phy. > > -- phys: from general PHY binding: the phandle for the PHY device. > > -- phy-names: Should be "hdmi" if phys references an external phy. > > - > > -Optional pinctrl entry: > > -- If you have both a "unwedge" and "default" pinctrl entry, dw_hdmi > > - will switch to the unwedge pinctrl state for 10ms if it ever gets an > > - i2c timeout. It's intended that this unwedge pinctrl entry will > > - cause the SDA line to be driven low to work around a hardware > > - errata. > > - > > -Example: > > - > > -hdmi: hdmi@ff98 { > > - compatible = "rockchip,rk3288-dw-hdmi"; > > - reg = <0xff98 0x2>; > > - reg-io-width = <4>; > > - ddc-i2c-bus = <>; > > - rockchip,grf = <>; > > - interrupts = ; > > - clocks = < PCLK_HDMI_CTRL>, < SCLK_HDMI_HDCP>; > > - clock-names = "iahb", "isfr"; > > - ports { > > - hdmi_in: port { > > - #address-cells = <1>; > > - #size-cells = <0>; > > - hdmi_in_vopb: endpoint@0 { > > - reg = <0>; > > - remote-endpoint = <_out_hdmi>; > > - }; > > - hdmi_in_vopl: endpoint@1 { > > - reg = <1>; > > - remote-endpoint = <_out_hdmi>; > > - }; > > - }; > > - }; > > -}; > > diff --git > > a/Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > > b/Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > > new file mode 100644 > > index ..d3b2f87f152a > > --- /dev/null > > +++ > > b/Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > > @@ -0,0 +1,158 @@ > > +# SPDX-License-Identifier:
Re: [PATCH v3 4/6] dt-bindings: display: rockchip: dw-hdmi: Convert binding to YAML
On Tue, Jan 05, 2021 at 08:08:16AM +0200, Laurent Pinchart wrote: > Convert the Rockchip HDMI TX text binding to YAML. > > Signed-off-by: Laurent Pinchart > --- > Changes since v2: > > - Use Mark's @gmail.com e-mail address as the @rock-chips.com address > bounces > > Changes since v1: > > - Drop pinctrl-0 and pinctrl-1 > - Use unevaluatedProperties instead of additionalProperties > - Drop reg and interrupts as they're checked in the base schema > - Rebase on top of OF graph schema, dropped redundant properties > - Fix identation for enum entries > - Tidy up clock names > --- > .../display/rockchip/dw_hdmi-rockchip.txt | 74 > .../display/rockchip/rockchip,dw-hdmi.yaml| 158 ++ > 2 files changed, 158 insertions(+), 74 deletions(-) > delete mode 100644 > Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > create mode 100644 > Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > > diff --git > a/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > b/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > deleted file mode 100644 > index 3d32ce137e7f.. > --- a/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > +++ /dev/null > @@ -1,74 +0,0 @@ > -Rockchip DWC HDMI TX Encoder > - > - > -The HDMI transmitter is a Synopsys DesignWare HDMI 1.4 TX controller IP > -with a companion PHY IP. > - > -These DT bindings follow the Synopsys DWC HDMI TX bindings defined in > -Documentation/devicetree/bindings/display/bridge/dw_hdmi.txt with the > -following device-specific properties. > - > - > -Required properties: > - > -- compatible: should be one of the following: > - "rockchip,rk3228-dw-hdmi" > - "rockchip,rk3288-dw-hdmi" > - "rockchip,rk3328-dw-hdmi" > - "rockchip,rk3399-dw-hdmi" > -- reg: See dw_hdmi.txt. > -- reg-io-width: See dw_hdmi.txt. Shall be 4. > -- interrupts: HDMI interrupt number > -- clocks: See dw_hdmi.txt. > -- clock-names: Shall contain "iahb" and "isfr" as defined in dw_hdmi.txt. > -- ports: See dw_hdmi.txt. The DWC HDMI shall have a single port numbered 0 > - corresponding to the video input of the controller. The port shall have two > - endpoints, numbered 0 and 1, connected respectively to the vopb and vopl. > -- rockchip,grf: Shall reference the GRF to mux vopl/vopb. > - > -Optional properties > - > -- ddc-i2c-bus: The HDMI DDC bus can be connected to either a system I2C > master > - or the functionally-reduced I2C master contained in the DWC HDMI. When > - connected to a system I2C master this property contains a phandle to that > - I2C master controller. > -- clock-names: See dw_hdmi.txt. The "cec" clock is optional. > -- clock-names: May contain "cec" as defined in dw_hdmi.txt. > -- clock-names: May contain "grf", power for grf io. > -- clock-names: May contain "vpll", external clock for some hdmi phy. > -- phys: from general PHY binding: the phandle for the PHY device. > -- phy-names: Should be "hdmi" if phys references an external phy. > - > -Optional pinctrl entry: > -- If you have both a "unwedge" and "default" pinctrl entry, dw_hdmi > - will switch to the unwedge pinctrl state for 10ms if it ever gets an > - i2c timeout. It's intended that this unwedge pinctrl entry will > - cause the SDA line to be driven low to work around a hardware > - errata. > - > -Example: > - > -hdmi: hdmi@ff98 { > - compatible = "rockchip,rk3288-dw-hdmi"; > - reg = <0xff98 0x2>; > - reg-io-width = <4>; > - ddc-i2c-bus = <>; > - rockchip,grf = <>; > - interrupts = ; > - clocks = < PCLK_HDMI_CTRL>, < SCLK_HDMI_HDCP>; > - clock-names = "iahb", "isfr"; > - ports { > - hdmi_in: port { > - #address-cells = <1>; > - #size-cells = <0>; > - hdmi_in_vopb: endpoint@0 { > - reg = <0>; > - remote-endpoint = <_out_hdmi>; > - }; > - hdmi_in_vopl: endpoint@1 { > - reg = <1>; > - remote-endpoint = <_out_hdmi>; > - }; > - }; > - }; > -}; > diff --git > a/Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > b/Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > new file mode 100644 > index ..d3b2f87f152a > --- /dev/null > +++ b/Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > @@ -0,0 +1,158 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/display/rockchip/rockchip,dw-hdmi.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Rockchip DWC HDMI TX Encoder > + > +maintainers: > + - Mark Yao > + >
Re: [PATCH v3 4/6] dt-bindings: display: rockchip: dw-hdmi: Convert binding to YAML
Hi Rob, On Mon, Jan 11, 2021 at 05:01:36PM -0600, Rob Herring wrote: > On Wed, Jan 06, 2021 at 05:17:55PM +0200, Laurent Pinchart wrote: > > Hi Rob, > > > > Given that the maintainers property is mandatory in the schema, what's > > the procedure when no maintainer steps up for a converter YAML binding ? > > Delete it if no one cares... > > Typically we just put a subsystem or platform maintainer. Do you mean dropping dw_hdmi-rockchip.txt completely, even if it's in use by a driver ? > > On Tue, Jan 05, 2021 at 08:08:16AM +0200, Laurent Pinchart wrote: > > > Convert the Rockchip HDMI TX text binding to YAML. > > > > > > Signed-off-by: Laurent Pinchart > > > > > > --- > > > Changes since v2: > > > > > > - Use Mark's @gmail.com e-mail address as the @rock-chips.com address > > > bounces > > > > > > Changes since v1: > > > > > > - Drop pinctrl-0 and pinctrl-1 > > > - Use unevaluatedProperties instead of additionalProperties > > > - Drop reg and interrupts as they're checked in the base schema > > > - Rebase on top of OF graph schema, dropped redundant properties > > > - Fix identation for enum entries > > > - Tidy up clock names > > > --- > > > .../display/rockchip/dw_hdmi-rockchip.txt | 74 > > > .../display/rockchip/rockchip,dw-hdmi.yaml| 158 ++ > > > 2 files changed, 158 insertions(+), 74 deletions(-) > > > delete mode 100644 > > > Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > > > create mode 100644 > > > Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > > > > > > diff --git > > > a/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > > > b/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > > > deleted file mode 100644 > > > index 3d32ce137e7f.. > > > --- > > > a/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > > > +++ /dev/null > > > @@ -1,74 +0,0 @@ > > > -Rockchip DWC HDMI TX Encoder > > > - > > > - > > > -The HDMI transmitter is a Synopsys DesignWare HDMI 1.4 TX controller IP > > > -with a companion PHY IP. > > > - > > > -These DT bindings follow the Synopsys DWC HDMI TX bindings defined in > > > -Documentation/devicetree/bindings/display/bridge/dw_hdmi.txt with the > > > -following device-specific properties. > > > - > > > - > > > -Required properties: > > > - > > > -- compatible: should be one of the following: > > > - "rockchip,rk3228-dw-hdmi" > > > - "rockchip,rk3288-dw-hdmi" > > > - "rockchip,rk3328-dw-hdmi" > > > - "rockchip,rk3399-dw-hdmi" > > > -- reg: See dw_hdmi.txt. > > > -- reg-io-width: See dw_hdmi.txt. Shall be 4. > > > -- interrupts: HDMI interrupt number > > > -- clocks: See dw_hdmi.txt. > > > -- clock-names: Shall contain "iahb" and "isfr" as defined in dw_hdmi.txt. > > > -- ports: See dw_hdmi.txt. The DWC HDMI shall have a single port numbered > > > 0 > > > - corresponding to the video input of the controller. The port shall > > > have two > > > - endpoints, numbered 0 and 1, connected respectively to the vopb and > > > vopl. > > > -- rockchip,grf: Shall reference the GRF to mux vopl/vopb. > > > - > > > -Optional properties > > > - > > > -- ddc-i2c-bus: The HDMI DDC bus can be connected to either a system I2C > > > master > > > - or the functionally-reduced I2C master contained in the DWC HDMI. When > > > - connected to a system I2C master this property contains a phandle to > > > that > > > - I2C master controller. > > > -- clock-names: See dw_hdmi.txt. The "cec" clock is optional. > > > -- clock-names: May contain "cec" as defined in dw_hdmi.txt. > > > -- clock-names: May contain "grf", power for grf io. > > > -- clock-names: May contain "vpll", external clock for some hdmi phy. > > > -- phys: from general PHY binding: the phandle for the PHY device. > > > -- phy-names: Should be "hdmi" if phys references an external phy. > > > - > > > -Optional pinctrl entry: > > > -- If you have both a "unwedge" and "default" pinctrl entry, dw_hdmi > > > - will switch to the unwedge pinctrl state for 10ms if it ever gets an > > > - i2c timeout. It's intended that this unwedge pinctrl entry will > > > - cause the SDA line to be driven low to work around a hardware > > > - errata. > > > - > > > -Example: > > > - > > > -hdmi: hdmi@ff98 { > > > - compatible = "rockchip,rk3288-dw-hdmi"; > > > - reg = <0xff98 0x2>; > > > - reg-io-width = <4>; > > > - ddc-i2c-bus = <>; > > > - rockchip,grf = <>; > > > - interrupts = ; > > > - clocks = < PCLK_HDMI_CTRL>, < SCLK_HDMI_HDCP>; > > > - clock-names = "iahb", "isfr"; > > > - ports { > > > - hdmi_in: port { > > > - #address-cells = <1>; > > > - #size-cells = <0>; > > > - hdmi_in_vopb: endpoint@0 { > > > - reg = <0>; > > > - remote-endpoint = <_out_hdmi>; > > > - }; > > >
Re: [PATCH v3 4/6] dt-bindings: display: rockchip: dw-hdmi: Convert binding to YAML
On Wed, Jan 06, 2021 at 05:17:55PM +0200, Laurent Pinchart wrote: > Hi Rob, > > Given that the maintainers property is mandatory in the schema, what's > the procedure when no maintainer steps up for a converter YAML binding ? Delete it if no one cares... Typically we just put a subsystem or platform maintainer. > > On Tue, Jan 05, 2021 at 08:08:16AM +0200, Laurent Pinchart wrote: > > Convert the Rockchip HDMI TX text binding to YAML. > > > > Signed-off-by: Laurent Pinchart > > --- > > Changes since v2: > > > > - Use Mark's @gmail.com e-mail address as the @rock-chips.com address > > bounces > > > > Changes since v1: > > > > - Drop pinctrl-0 and pinctrl-1 > > - Use unevaluatedProperties instead of additionalProperties > > - Drop reg and interrupts as they're checked in the base schema > > - Rebase on top of OF graph schema, dropped redundant properties > > - Fix identation for enum entries > > - Tidy up clock names > > --- > > .../display/rockchip/dw_hdmi-rockchip.txt | 74 > > .../display/rockchip/rockchip,dw-hdmi.yaml| 158 ++ > > 2 files changed, 158 insertions(+), 74 deletions(-) > > delete mode 100644 > > Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > > create mode 100644 > > Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > > > > diff --git > > a/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > > b/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > > deleted file mode 100644 > > index 3d32ce137e7f.. > > --- > > a/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > > +++ /dev/null > > @@ -1,74 +0,0 @@ > > -Rockchip DWC HDMI TX Encoder > > - > > - > > -The HDMI transmitter is a Synopsys DesignWare HDMI 1.4 TX controller IP > > -with a companion PHY IP. > > - > > -These DT bindings follow the Synopsys DWC HDMI TX bindings defined in > > -Documentation/devicetree/bindings/display/bridge/dw_hdmi.txt with the > > -following device-specific properties. > > - > > - > > -Required properties: > > - > > -- compatible: should be one of the following: > > - "rockchip,rk3228-dw-hdmi" > > - "rockchip,rk3288-dw-hdmi" > > - "rockchip,rk3328-dw-hdmi" > > - "rockchip,rk3399-dw-hdmi" > > -- reg: See dw_hdmi.txt. > > -- reg-io-width: See dw_hdmi.txt. Shall be 4. > > -- interrupts: HDMI interrupt number > > -- clocks: See dw_hdmi.txt. > > -- clock-names: Shall contain "iahb" and "isfr" as defined in dw_hdmi.txt. > > -- ports: See dw_hdmi.txt. The DWC HDMI shall have a single port numbered 0 > > - corresponding to the video input of the controller. The port shall have > > two > > - endpoints, numbered 0 and 1, connected respectively to the vopb and vopl. > > -- rockchip,grf: Shall reference the GRF to mux vopl/vopb. > > - > > -Optional properties > > - > > -- ddc-i2c-bus: The HDMI DDC bus can be connected to either a system I2C > > master > > - or the functionally-reduced I2C master contained in the DWC HDMI. When > > - connected to a system I2C master this property contains a phandle to that > > - I2C master controller. > > -- clock-names: See dw_hdmi.txt. The "cec" clock is optional. > > -- clock-names: May contain "cec" as defined in dw_hdmi.txt. > > -- clock-names: May contain "grf", power for grf io. > > -- clock-names: May contain "vpll", external clock for some hdmi phy. > > -- phys: from general PHY binding: the phandle for the PHY device. > > -- phy-names: Should be "hdmi" if phys references an external phy. > > - > > -Optional pinctrl entry: > > -- If you have both a "unwedge" and "default" pinctrl entry, dw_hdmi > > - will switch to the unwedge pinctrl state for 10ms if it ever gets an > > - i2c timeout. It's intended that this unwedge pinctrl entry will > > - cause the SDA line to be driven low to work around a hardware > > - errata. > > - > > -Example: > > - > > -hdmi: hdmi@ff98 { > > - compatible = "rockchip,rk3288-dw-hdmi"; > > - reg = <0xff98 0x2>; > > - reg-io-width = <4>; > > - ddc-i2c-bus = <>; > > - rockchip,grf = <>; > > - interrupts = ; > > - clocks = < PCLK_HDMI_CTRL>, < SCLK_HDMI_HDCP>; > > - clock-names = "iahb", "isfr"; > > - ports { > > - hdmi_in: port { > > - #address-cells = <1>; > > - #size-cells = <0>; > > - hdmi_in_vopb: endpoint@0 { > > - reg = <0>; > > - remote-endpoint = <_out_hdmi>; > > - }; > > - hdmi_in_vopl: endpoint@1 { > > - reg = <1>; > > - remote-endpoint = <_out_hdmi>; > > - }; > > - }; > > - }; > > -}; > > diff --git > > a/Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > >
Re: [PATCH v3 4/6] dt-bindings: display: rockchip: dw-hdmi: Convert binding to YAML
Hi Rob, Given that the maintainers property is mandatory in the schema, what's the procedure when no maintainer steps up for a converter YAML binding ? On Tue, Jan 05, 2021 at 08:08:16AM +0200, Laurent Pinchart wrote: > Convert the Rockchip HDMI TX text binding to YAML. > > Signed-off-by: Laurent Pinchart > --- > Changes since v2: > > - Use Mark's @gmail.com e-mail address as the @rock-chips.com address > bounces > > Changes since v1: > > - Drop pinctrl-0 and pinctrl-1 > - Use unevaluatedProperties instead of additionalProperties > - Drop reg and interrupts as they're checked in the base schema > - Rebase on top of OF graph schema, dropped redundant properties > - Fix identation for enum entries > - Tidy up clock names > --- > .../display/rockchip/dw_hdmi-rockchip.txt | 74 > .../display/rockchip/rockchip,dw-hdmi.yaml| 158 ++ > 2 files changed, 158 insertions(+), 74 deletions(-) > delete mode 100644 > Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > create mode 100644 > Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > > diff --git > a/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > b/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > deleted file mode 100644 > index 3d32ce137e7f.. > --- a/Documentation/devicetree/bindings/display/rockchip/dw_hdmi-rockchip.txt > +++ /dev/null > @@ -1,74 +0,0 @@ > -Rockchip DWC HDMI TX Encoder > - > - > -The HDMI transmitter is a Synopsys DesignWare HDMI 1.4 TX controller IP > -with a companion PHY IP. > - > -These DT bindings follow the Synopsys DWC HDMI TX bindings defined in > -Documentation/devicetree/bindings/display/bridge/dw_hdmi.txt with the > -following device-specific properties. > - > - > -Required properties: > - > -- compatible: should be one of the following: > - "rockchip,rk3228-dw-hdmi" > - "rockchip,rk3288-dw-hdmi" > - "rockchip,rk3328-dw-hdmi" > - "rockchip,rk3399-dw-hdmi" > -- reg: See dw_hdmi.txt. > -- reg-io-width: See dw_hdmi.txt. Shall be 4. > -- interrupts: HDMI interrupt number > -- clocks: See dw_hdmi.txt. > -- clock-names: Shall contain "iahb" and "isfr" as defined in dw_hdmi.txt. > -- ports: See dw_hdmi.txt. The DWC HDMI shall have a single port numbered 0 > - corresponding to the video input of the controller. The port shall have two > - endpoints, numbered 0 and 1, connected respectively to the vopb and vopl. > -- rockchip,grf: Shall reference the GRF to mux vopl/vopb. > - > -Optional properties > - > -- ddc-i2c-bus: The HDMI DDC bus can be connected to either a system I2C > master > - or the functionally-reduced I2C master contained in the DWC HDMI. When > - connected to a system I2C master this property contains a phandle to that > - I2C master controller. > -- clock-names: See dw_hdmi.txt. The "cec" clock is optional. > -- clock-names: May contain "cec" as defined in dw_hdmi.txt. > -- clock-names: May contain "grf", power for grf io. > -- clock-names: May contain "vpll", external clock for some hdmi phy. > -- phys: from general PHY binding: the phandle for the PHY device. > -- phy-names: Should be "hdmi" if phys references an external phy. > - > -Optional pinctrl entry: > -- If you have both a "unwedge" and "default" pinctrl entry, dw_hdmi > - will switch to the unwedge pinctrl state for 10ms if it ever gets an > - i2c timeout. It's intended that this unwedge pinctrl entry will > - cause the SDA line to be driven low to work around a hardware > - errata. > - > -Example: > - > -hdmi: hdmi@ff98 { > - compatible = "rockchip,rk3288-dw-hdmi"; > - reg = <0xff98 0x2>; > - reg-io-width = <4>; > - ddc-i2c-bus = <>; > - rockchip,grf = <>; > - interrupts = ; > - clocks = < PCLK_HDMI_CTRL>, < SCLK_HDMI_HDCP>; > - clock-names = "iahb", "isfr"; > - ports { > - hdmi_in: port { > - #address-cells = <1>; > - #size-cells = <0>; > - hdmi_in_vopb: endpoint@0 { > - reg = <0>; > - remote-endpoint = <_out_hdmi>; > - }; > - hdmi_in_vopl: endpoint@1 { > - reg = <1>; > - remote-endpoint = <_out_hdmi>; > - }; > - }; > - }; > -}; > diff --git > a/Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > b/Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > new file mode 100644 > index ..d3b2f87f152a > --- /dev/null > +++ b/Documentation/devicetree/bindings/display/rockchip/rockchip,dw-hdmi.yaml > @@ -0,0 +1,158 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: