Re: [PATCH v17 06/12] dt-bindings: add document for dw_hdmi

[Andy Yan]

Hi Philipp:
On 2014å12æ04æ 19:30, Philipp Zabel wrote:
> Hi Andy,
>
> Am Donnerstag, den 04.12.2014, 18:06 +0800 schrieb Andy Yan:
> > Signed-off-by: Andy Yan <andy.yan@xxxxxxxxxxxxxx>
> >
> > ---
> >
> > Changes in v17: None
> > Changes in v16:
> > - describe ddc-i2c-bus as optional
> > - add common clocks bindings
> >
> > Changes in v15: None
> > Changes in v14: None
> > Changes in v13: None
> > Changes in v12: None
> > Changes in v11: None
> > Changes in v10: None
> > Changes in v9: None
> > Changes in v8:
> > - correct some spelling mistake
> > - modify ddc-i2c-bus and interrupt description
> >
> > Changes in v7: None
> > Changes in v6: None
> > Changes in v5: None
> > Changes in v4: None
> > Changes in v3: None
> >
> >   .../devicetree/bindings/drm/bridge/dw_hdmi.txt     | 45 ++++++++++++++++++++++
> >   1 file changed, 45 insertions(+)
> >   create mode 100644 Documentation/devicetree/bindings/drm/bridge/dw_hdmi.txt
> >
> > diff --git a/Documentation/devicetree/bindings/drm/bridge/dw_hdmi.txt b/Documentation/devicetree/bindings/drm/bridge/dw_hdmi.txt
> > new file mode 100644
> > index 0000000..fb14730
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/drm/bridge/dw_hdmi.txt
> > @@ -0,0 +1,45 @@
> > +DesignWare HDMI bridge bindings
> > +
> > +Required properities:
> > +- compatible: platform specific such as:
> > +   * "snps,dw-hdmi-tx"
> > +   * "fsl,imx6q-hdmi"
> > +   * "fsl,imx6dl-hdmi"
> > +   * "rockchip,rk3288-dw-hdmi"
> > +- reg: Physical base address and length of the controller's registers.
> > +- interrupts: The HDMI interrupt number
> > +- clocks, clock-names : must have the phandles to the HDMI iahb and isrf clocks,
> > +  as described in Documentation/devicetree/bindings/clock/clock-bindings.txt,
> > +  the clock-names should be "iahb", "isfr"
> This is missing the port bindings, I think it should mention the port
> property here and refer to the soc specific binding document.
>
>   - port@...: SoC specific port nodes with endpoint definitions as defined
>     in Documentation/devicetree/bindings/media/video-interfaces.txt,
>     please refer to the SoC specific binding document:
>      * Documentation/devicetree/bindings/drm/imx/hdmi.txt
>      * Documentation/devicetree/bindings/video/dw_hdmi-rockchip.txt
>
> This also makes be wonder, shouldn't dw_hdmi-rockchip be under drm/?
   ok, I will add the port bindings
   because rockchip drm binds are under video, so I put the 
dw_hdmi-rockchip
   under video to keep consistency.
> > +Optional properties
> > +- reg-io-width: the width of the reg:1,4, default set to 1 if not present
> > +- ddc-i2c-bus: phandle of an I2C controller used for DDC EDID probing
> > +- clkocks, clock-names: phandle to the HDMI cec clock, name should be "cec"
> s/clkocks/clocks/, and I'd uppercase the HDMI CEC clock for consistency.
    thanks for point it, I will correct it in next version
> > +
> > +Example:
> > +	hdmi: hdmi@0120000 {
> > +		compatible = "fsl,imx6q-hdmi";
> Could you change this example to:
> 		compatible = "fsl,imx6q-hdmi", "snps,dw-hdmi-tx"
>
> > +		reg = <0x00120000 0x9000>;
> > +		interrupts = <0 115 0x04>;
> > +		gpr = <&gpr>;
> > +		clocks = <&clks 123>, <&clks 124>;
> > +		clock-names = "iahb", "isfr";
> > +		ddc-i2c-bus = <&i2c2>;
> > +
> > +		port@0 {
> > +			reg = <0>;
> > +
> > +			hdmi_mux_0: endpoint {
> > +				remote-endpoint = <&ipu1_di0_hdmi>;
> > +			};
> > +		};
> > +
> > +		port@1 {
> > +			reg = <1>;
> > +
> > +			hdmi_mux_1: endpoint {
> > +				remote-endpoint = <&ipu1_di1_hdmi>;
> > +			};
> > +		};
> > +	};


--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/