xref: /freebsd/sys/contrib/device-tree/Bindings/display/renesas,shmobile-lcdc.yaml (revision 8d13bc63c0e1d50bc9e47ac1f26329c999bfecf0) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/renesas,shmobile-lcdc.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Renesas SH-Mobile LCD Controller (LCDC)
8
9maintainers:
10  - Laurent Pinchart <laurent.pinchart+renesas@ideasonboard.com>
11  - Geert Uytterhoeven <geert+renesas@glider.be>
12
13properties:
14  compatible:
15    enum:
16      - renesas,r8a7740-lcdc # R-Mobile A1
17      - renesas,sh73a0-lcdc  # SH-Mobile AG5
18
19  reg:
20    maxItems: 1
21
22  interrupts:
23    maxItems: 1
24
25  clocks:
26    minItems: 1
27    maxItems: 5
28    description:
29      Only the functional clock is mandatory.
30      Some of the optional clocks are model-dependent (e.g. "video" (a.k.a.
31      "vou" or "dv_clk") is available on R-Mobile A1 only).
32
33  clock-names:
34    minItems: 1
35    items:
36      - const: fck
37      - enum: [ media, lclk, hdmi, video ]
38      - enum: [ media, lclk, hdmi, video ]
39      - enum: [ media, lclk, hdmi, video ]
40      - enum: [ media, lclk, hdmi, video ]
41
42  power-domains:
43    maxItems: 1
44
45  ports:
46    $ref: /schemas/graph.yaml#/properties/ports
47
48    properties:
49      port@0:
50        $ref: /schemas/graph.yaml#/properties/port
51        description: LCD port (R-Mobile A1 and SH-Mobile AG5)
52        unevaluatedProperties: false
53
54      port@1:
55        $ref: /schemas/graph.yaml#/properties/port
56        description: HDMI port (R-Mobile A1 LCDC1 and SH-Mobile AG5)
57        unevaluatedProperties: false
58
59      port@2:
60        $ref: /schemas/graph.yaml#/properties/port
61        description: MIPI-DSI port (SH-Mobile AG5)
62        unevaluatedProperties: false
63
64    required:
65      - port@0
66
67    unevaluatedProperties: false
68
69required:
70  - compatible
71  - reg
72  - interrupts
73  - clocks
74  - clock-names
75  - power-domains
76  - ports
77
78additionalProperties: false
79
80allOf:
81  - if:
82      properties:
83        compatible:
84          contains:
85            const: renesas,r8a7740-lcdc
86    then:
87      properties:
88        ports:
89          properties:
90            port@2: false
91
92  - if:
93      properties:
94        compatible:
95          contains:
96            const: renesas,sh73a0-lcdc
97    then:
98      properties:
99        ports:
100          required:
101            - port@1
102            - port@2
103
104examples:
105  - |
106    #include <dt-bindings/clock/r8a7740-clock.h>
107    #include <dt-bindings/interrupt-controller/arm-gic.h>
108
109    lcd-controller@fe940000 {
110        compatible = "renesas,r8a7740-lcdc";
111        reg = <0xfe940000 0x4000>;
112        interrupts = <GIC_SPI 177 IRQ_TYPE_LEVEL_HIGH>;
113        clocks = <&mstp1_clks R8A7740_CLK_LCDC0>,
114                 <&cpg_clocks R8A7740_CLK_M3>, <&lcdlclk0_clk>,
115                 <&vou_clk>;
116        clock-names = "fck", "media", "lclk", "video";
117        power-domains = <&pd_a4lc>;
118
119        ports {
120            #address-cells = <1>;
121            #size-cells = <0>;
122
123            port@0 {
124                reg = <0>;
125
126                lcdc0_rgb: endpoint {
127                };
128            };
129        };
130    };
131