Unverified Commit c9390228 authored by Paul Cercueil's avatar Paul Cercueil
Browse files

dt-bindings: display: Convert ingenic,lcd.txt to YAML 



Convert the ingenic,lcd.txt to a new ingenic,lcd.yaml file.

In the process, the new ingenic,jz4780-lcd compatible string has been
added.

v2: Add info about IPU at port@8
v3: No change

Signed-off-by: default avatarPaul Cercueil <paul@crapouillou.net>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Reviewed-by: default avatarSam Ravnborg <sam@ravnborg.org>
Link: https://patchwork.freedesktop.org/patch/msgid/20200716163846.174790-2-paul@crapouillou.net
parent ca43f274

Documentation/devicetree/bindings/display/ingenic,lcd.txt

deleted100644 → 0
+0 −45
Original line number Diff line number Diff line 
Ingenic JZ47xx LCD driver



Required properties:

- compatible: one of:

  * ingenic,jz4740-lcd

  * ingenic,jz4725b-lcd

  * ingenic,jz4770-lcd

- reg: LCD registers location and length

- clocks: LCD pixclock and device clock specifiers.

	   The device clock is only required on the JZ4740.

- clock-names: "lcd_pclk" and "lcd"

- interrupts: Specifies the interrupt line the LCD controller is connected to.



Example:



panel {

	compatible = "sharp,ls020b1dd01d";



	backlight = <&backlight>;

	power-supply = <&vcc>;



	port {

		panel_input: endpoint {

			remote-endpoint = <&panel_output>;

		};

	};

};





lcd: lcd-controller@13050000 {

	compatible = "ingenic,jz4725b-lcd";

	reg = <0x13050000 0x1000>;



	interrupt-parent = <&intc>;

	interrupts = <31>;



	clocks = <&cgu JZ4725B_CLK_LCD>;

	clock-names = "lcd";



	port {

		panel_output: endpoint {

			remote-endpoint = <&panel_input>;

		};

	};

};

Documentation/devicetree/bindings/display/ingenic,lcd.yaml

0 → 100644
+126 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/display/ingenic,lcd.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Ingenic SoCs LCD controller devicetree bindings



maintainers:

  - Paul Cercueil <paul@crapouillou.net>



properties:

  $nodename:

    pattern: "^lcd-controller@[0-9a-f]+$"



  compatible:

    enum:

      - ingenic,jz4740-lcd

      - ingenic,jz4725b-lcd

      - ingenic,jz4770-lcd

      - ingenic,jz4780-lcd



  reg:

    maxItems: 1



  interrupts:

    maxItems: 1



  clocks:

    items:

      - description: Pixel clock

      - description: Module clock

    minItems: 1



  clock-names:

    items:

      - const: lcd_pclk

      - const: lcd

    minItems: 1



  port:

    description: OF graph bindings (specified in bindings/graph.txt).



  ports:

    description: OF graph bindings (specified in bindings/graph.txt).

    type: object

    properties:

      port@0:

        type: object

        description: DPI output, to interface with TFT panels.



      port@8:

        type: object

        description: Link to the Image Processing Unit (IPU).

          (See ingenic,ipu.yaml).



    required:

      - port@0



required:

    - compatible

    - reg

    - interrupts

    - clocks

    - clock-names



if:

  properties:

    compatible:

      contains:

        enum:

          - ingenic,jz4740-lcd

          - ingenic,jz4780-lcd

then:

  properties:

    clocks:

      minItems: 2

    clock-names:

      minItems: 2

else:

  properties:

    clocks:

      maxItems: 1

    clock-names:

      maxItems: 1



additionalProperties: false



examples:

  - |

    #include <dt-bindings/clock/jz4740-cgu.h>

    lcd-controller@13050000 {

      compatible = "ingenic,jz4740-lcd";

      reg = <0x13050000 0x1000>;



      interrupt-parent = <&intc>;

      interrupts = <30>;



      clocks = <&cgu JZ4740_CLK_LCD_PCLK>, <&cgu JZ4740_CLK_LCD>;

      clock-names = "lcd_pclk", "lcd";



      port {

        endpoint {

          remote-endpoint = <&panel_input>;

        };

      };

    };



  - |

    #include <dt-bindings/clock/jz4725b-cgu.h>

    lcd-controller@13050000 {

      compatible = "ingenic,jz4725b-lcd";

      reg = <0x13050000 0x1000>;



      interrupt-parent = <&intc>;

      interrupts = <31>;



      clocks = <&cgu JZ4725B_CLK_LCD>;

      clock-names = "lcd_pclk";



      port {

        endpoint {

          remote-endpoint = <&panel_input>;

        };

      };

    };