Merge branch 'work.splice_read' of git://git.kernel.org/pub/scm/linux/kernel/git...
[cascardo/linux.git] / Documentation / devicetree / bindings / display / exynos / exynos_hdmi.txt
1 Device-Tree bindings for drm hdmi driver
2
3 Required properties:
4 - compatible: value should be one among the following:
5         1) "samsung,exynos4210-hdmi"
6         2) "samsung,exynos4212-hdmi"
7         3) "samsung,exynos5420-hdmi"
8         4) "samsung,exynos5433-hdmi"
9 - reg: physical base address of the hdmi and length of memory mapped
10         region.
11 - interrupts: interrupt number to the cpu.
12 - hpd-gpios: following information about the hotplug gpio pin.
13         a) phandle of the gpio controller node.
14         b) pin number within the gpio controller.
15         c) optional flags and pull up/down.
16 - ddc: phandle to the hdmi ddc node
17 - phy: phandle to the hdmi phy node
18 - samsung,syscon-phandle: phandle for system controller node for PMU.
19
20 Required properties for Exynos 4210, 4212, 5420 and 5433:
21 - clocks: list of clock IDs from SoC clock driver.
22         a) hdmi: Gate of HDMI IP bus clock.
23         b) sclk_hdmi: Gate of HDMI special clock.
24         c) sclk_pixel: Pixel special clock, one of the two possible inputs of
25                 HDMI clock mux.
26         d) sclk_hdmiphy: HDMI PHY clock output, one of two possible inputs of
27                 HDMI clock mux.
28         e) mout_hdmi: It is required by the driver to switch between the 2
29                 parents i.e. sclk_pixel and sclk_hdmiphy. If hdmiphy is stable
30                 after configuration, parent is set to sclk_hdmiphy else
31                 sclk_pixel.
32 - clock-names: aliases as per driver requirements for above clock IDs:
33         "hdmi", "sclk_hdmi", "sclk_pixel", "sclk_hdmiphy" and "mout_hdmi".
34
35 Required properties for Exynos 5433:
36 - clocks: list of clock specifiers according to common clock bindings.
37         a) hdmi_pclk: Gate of HDMI IP APB bus.
38         b) hdmi_i_pclk: Gate of HDMI-PHY IP APB bus.
39         d) i_tmds_clk: Gate of HDMI TMDS clock.
40         e) i_pixel_clk: Gate of HDMI pixel clock.
41         f) i_spdif_clk: Gate of HDMI SPDIF clock.
42         g) oscclk: Oscillator clock, used as parent of following *_user clocks
43                 in case HDMI-PHY is not operational.
44         h) tmds_clko: TMDS clock generated by HDMI-PHY.
45         i) tmds_clko_user: MUX used to switch between oscclk and tmds_clko,
46                 respectively if HDMI-PHY is off and operational.
47         j) pixel_clko: Pixel clock generated by HDMI-PHY.
48         k) pixel_clko_user: MUX used to switch between oscclk and pixel_clko,
49                 respectively if HDMI-PHY is off and operational.
50 - clock-names: aliases for above clock specfiers.
51 - samsung,sysreg: handle to syscon used to control the system registers.
52
53 Example:
54
55         hdmi {
56                 compatible = "samsung,exynos4212-hdmi";
57                 reg = <0x14530000 0x100000>;
58                 interrupts = <0 95 0>;
59                 hpd-gpios = <&gpx3 7 1>;
60                 ddc = <&hdmi_ddc_node>;
61                 phy = <&hdmi_phy_node>;
62                 samsung,syscon-phandle = <&pmu_system_controller>;
63         };