Merge tag 'spi-fix-v5.5-rc2' of git://git.kernel.org/pub/scm/linux/kernel/git/broonie/spi
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / display / rockchip / rockchip-vop.txt
1 device-tree bindings for rockchip soc display controller (vop)
2
3 VOP (Visual Output Processor) is the Display Controller for the Rockchip
4 series of SoCs which transfers the image data from a video memory
5 buffer to an external LCD interface.
6
7 Required properties:
8 - compatible: value should be one of the following
9                 "rockchip,rk3036-vop";
10                 "rockchip,rk3126-vop";
11                 "rockchip,px30-vop-lit";
12                 "rockchip,px30-vop-big";
13                 "rockchip,rk3066-vop";
14                 "rockchip,rk3188-vop";
15                 "rockchip,rk3288-vop";
16                 "rockchip,rk3368-vop";
17                 "rockchip,rk3366-vop";
18                 "rockchip,rk3399-vop-big";
19                 "rockchip,rk3399-vop-lit";
20                 "rockchip,rk3228-vop";
21                 "rockchip,rk3328-vop";
22
23 - reg: Must contain one entry corresponding to the base address and length
24         of the register space. Can optionally contain a second entry
25         corresponding to the CRTC gamma LUT address.
26
27 - interrupts: should contain a list of all VOP IP block interrupts in the
28                  order: VSYNC, LCD_SYSTEM. The interrupt specifier
29                  format depends on the interrupt controller used.
30
31 - clocks: must include clock specifiers corresponding to entries in the
32                 clock-names property.
33
34 - clock-names: Must contain
35                 aclk_vop: for ddr buffer transfer.
36                 hclk_vop: for ahb bus to R/W the phy regs.
37                 dclk_vop: pixel clock.
38
39 - resets: Must contain an entry for each entry in reset-names.
40   See ../reset/reset.txt for details.
41 - reset-names: Must include the following entries:
42   - axi
43   - ahb
44   - dclk
45
46 - iommus: required a iommu node
47
48 - port: A port node with endpoint definitions as defined in
49   Documentation/devicetree/bindings/media/video-interfaces.txt.
50
51 Example:
52 SoC specific DT entry:
53         vopb: vopb@ff930000 {
54                 compatible = "rockchip,rk3288-vop";
55                 reg = <0x0 0xff930000 0x0 0x19c>, <0x0 0xff931000 0x0 0x1000>;
56                 interrupts = <GIC_SPI 15 IRQ_TYPE_LEVEL_HIGH>;
57                 clocks = <&cru ACLK_VOP0>, <&cru DCLK_VOP0>, <&cru HCLK_VOP0>;
58                 clock-names = "aclk_vop", "dclk_vop", "hclk_vop";
59                 resets = <&cru SRST_LCDC1_AXI>, <&cru SRST_LCDC1_AHB>, <&cru SRST_LCDC1_DCLK>;
60                 reset-names = "axi", "ahb", "dclk";
61                 iommus = <&vopb_mmu>;
62                 vopb_out: port {
63                         #address-cells = <1>;
64                         #size-cells = <0>;
65                         vopb_out_edp: endpoint@0 {
66                                 reg = <0>;
67                                 remote-endpoint=<&edp_in_vopb>;
68                         };
69                         vopb_out_hdmi: endpoint@1 {
70                                 reg = <1>;
71                                 remote-endpoint=<&hdmi_in_vopb>;
72                         };
73                 };
74         };