xref: /freebsd/sys/contrib/device-tree/Bindings/display/st,stm32-ltdc.yaml (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/st,stm32-ltdc.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: STMicroelectronics STM32 lcd-tft display controller
8
9maintainers:
10  - Philippe Cornu <philippe.cornu@st.com>
11  - Yannick Fertre <yannick.fertre@st.com>
12
13properties:
14  compatible:
15    const: st,stm32-ltdc
16
17  reg:
18    maxItems: 1
19
20  interrupts:
21    items:
22      - description: events interrupt line.
23      - description: errors interrupt line.
24    minItems: 1
25    maxItems: 2
26
27  clocks:
28    maxItems: 1
29
30  clock-names:
31    items:
32      - const: lcd
33
34  resets:
35    maxItems: 1
36
37  port:
38    type: object
39    description:
40      "Video port for DPI RGB output.
41      ltdc has one video port with up to 2 endpoints:
42      - for external dpi rgb panel or bridge, using gpios.
43      - for internal dpi input of the MIPI DSI host controller.
44      Note: These 2 endpoints cannot be activated simultaneously.
45      Please refer to the bindings defined in
46      Documentation/devicetree/bindings/media/video-interfaces.txt."
47
48required:
49  - compatible
50  - reg
51  - interrupts
52  - clocks
53  - clock-names
54  - resets
55  - port
56
57additionalProperties: false
58
59examples:
60  - |
61    #include <dt-bindings/interrupt-controller/arm-gic.h>
62    #include <dt-bindings/clock/stm32mp1-clks.h>
63    #include <dt-bindings/reset/stm32mp1-resets.h>
64    ltdc: display-controller@40016800 {
65        compatible = "st,stm32-ltdc";
66        reg = <0x5a001000 0x400>;
67        interrupts = <GIC_SPI 88 IRQ_TYPE_LEVEL_HIGH>,
68                     <GIC_SPI 89 IRQ_TYPE_LEVEL_HIGH>;
69        clocks = <&rcc LTDC_PX>;
70        clock-names = "lcd";
71        resets = <&rcc LTDC_R>;
72
73        port {
74             ltdc_out_dsi: endpoint {
75                     remote-endpoint = <&dsi_in>;
76             };
77        };
78    };
79
80...
81
82