Documentation/devicetree/bindings/display/st,stm32-ltdc.yaml

   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
   7 title: STMicroelectronics STM32 lcd-tft display controller
   8
   9 maintainers:
  10   - Philippe Cornu <philippe.cornu@st.com>
  11   - Yannick Fertre <yannick.fertre@st.com>
  12
  13 properties:
  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
  48 required:
  49   - compatible
  50   - reg
  51   - interrupts
  52   - clocks
  53   - clock-names
  54   - resets
  55   - port
  56
  57 additionalProperties: false
  58
  59 examples:
  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