Merge tag 'zynqmp-soc-for-v5.9-v2' of https://github.com/Xilinx/linux-xlnx into arm...
[linux-2.6-microblaze.git] / Documentation / devicetree / bindings / display / mxsfb.txt
1 * Freescale MXS LCD Interface (LCDIF)
2
3 New bindings:
4 =============
5 Required properties:
6 - compatible:   Should be "fsl,imx23-lcdif" for i.MX23.
7                 Should be "fsl,imx28-lcdif" for i.MX28.
8                 Should be "fsl,imx6sx-lcdif" for i.MX6SX.
9                 Should be "fsl,imx8mq-lcdif" for i.MX8MQ.
10 - reg:          Address and length of the register set for LCDIF
11 - interrupts:   Should contain LCDIF interrupt
12 - clocks:       A list of phandle + clock-specifier pairs, one for each
13                 entry in 'clock-names'.
14 - clock-names:  A list of clock names. For MXSFB it should contain:
15     - "pix" for the LCDIF block clock
16     - (MX6SX-only) "axi", "disp_axi" for the bus interface clock
17
18 Required sub-nodes:
19   - port: The connection to an encoder chip.
20
21 Example:
22
23         lcdif1: display-controller@2220000 {
24                 compatible = "fsl,imx6sx-lcdif", "fsl,imx28-lcdif";
25                 reg = <0x02220000 0x4000>;
26                 interrupts = <GIC_SPI 5 IRQ_TYPE_LEVEL_HIGH>;
27                 clocks = <&clks IMX6SX_CLK_LCDIF1_PIX>,
28                          <&clks IMX6SX_CLK_LCDIF_APB>,
29                          <&clks IMX6SX_CLK_DISPLAY_AXI>;
30                 clock-names = "pix", "axi", "disp_axi";
31
32                 port {
33                         parallel_out: endpoint {
34                                 remote-endpoint = <&panel_in_parallel>;
35                         };
36                 };
37         };
38
39 Deprecated bindings:
40 ====================
41 Required properties:
42 - compatible:   Should be "fsl,imx23-lcdif" for i.MX23.
43                 Should be "fsl,imx28-lcdif" for i.MX28.
44 - reg:          Address and length of the register set for LCDIF
45 - interrupts:   Should contain LCDIF interrupts
46 - display:      phandle to display node (see below for details)
47
48 * display node
49
50 Required properties:
51 - bits-per-pixel:       <16> for RGB565, <32> for RGB888/666.
52 - bus-width:            number of data lines.  Could be <8>, <16>, <18> or <24>.
53
54 Required sub-node:
55 - display-timings:      Refer to binding doc display-timing.txt for details.
56
57 Examples:
58
59 lcdif@80030000 {
60         compatible = "fsl,imx28-lcdif";
61         reg = <0x80030000 2000>;
62         interrupts = <38 86>;
63
64         display: display {
65                 bits-per-pixel = <32>;
66                 bus-width = <24>;
67
68                 display-timings {
69                         native-mode = <&timing0>;
70                         timing0: timing0 {
71                                 clock-frequency = <33500000>;
72                                 hactive = <800>;
73                                 vactive = <480>;
74                                 hfront-porch = <164>;
75                                 hback-porch = <89>;
76                                 hsync-len = <10>;
77                                 vback-porch = <23>;
78                                 vfront-porch = <10>;
79                                 vsync-len = <10>;
80                                 hsync-active = <0>;
81                                 vsync-active = <0>;
82                                 de-active = <1>;
83                                 pixelclk-active = <0>;
84                         };
85                 };
86         };
87 };