Commit 8cd4937e authored by Liu Ying's avatar Liu Ying Committed by Dmitry Baryshkov
Browse files

dt-bindings: display: Document dual-link LVDS display common properties 



Dual-link LVDS displays receive odd pixels and even pixels separately from
dual LVDS links.  One link receives odd pixels and the other receives even
pixels.  Some of those displays may also use only one LVDS link to receive
all pixels, being odd and even agnostic.  Document common properties for
those displays by extending LVDS display common properties defined in
lvds.yaml.

Suggested-by: default avatarDmitry Baryshkov <dmitry.baryshkov@linaro.org>
Signed-off-by: default avatarLiu Ying <victor.liu@nxp.com>
Reviewed-by: default avatarRob Herring (Arm) <robh@kernel.org>
Link: https://patchwork.freedesktop.org/patch/msgid/20241104032806.611890-9-victor.liu@nxp.com


Signed-off-by: default avatarDmitry Baryshkov <dmitry.baryshkov@linaro.org>
parent e3160748

Documentation/devicetree/bindings/display/lvds-dual-ports.yaml

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

%YAML 1.2

---

$id: http://devicetree.org/schemas/display/lvds-dual-ports.yaml#

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



title: Dual-link LVDS Display Common Properties



maintainers:

  - Liu Ying <victor.liu@nxp.com>



description: |

  Common properties for LVDS displays with dual LVDS links. Extend LVDS display

  common properties defined in lvds.yaml.



  Dual-link LVDS displays receive odd pixels and even pixels separately from

  the dual LVDS links. One link receives odd pixels and the other receives

  even pixels. Some of those displays may also use only one LVDS link to

  receive all pixels, being odd and even agnostic.



allOf:

  - $ref: lvds.yaml#



properties:

  ports:

    $ref: /schemas/graph.yaml#/properties/ports



    patternProperties:

      '^port@[01]$':

        $ref: /schemas/graph.yaml#/$defs/port-base

        unevaluatedProperties: false

        description: |

          port@0 represents the first LVDS input link.

          port@1 represents the second LVDS input link.



        properties:

          dual-lvds-odd-pixels:

            type: boolean

            description: LVDS input link for odd pixels



          dual-lvds-even-pixels:

            type: boolean

            description: LVDS input link for even pixels



        oneOf:

          - required: [dual-lvds-odd-pixels]

          - required: [dual-lvds-even-pixels]

          - properties:

              dual-lvds-odd-pixels: false

              dual-lvds-even-pixels: false



    anyOf:

      - required:

          - port@0

      - required:

          - port@1



required:

  - ports



additionalProperties: true



...

Documentation/devicetree/bindings/display/panel/advantech,idk-2121wr.yaml

+1 −13
Original line number Diff line number Diff line
@@ -20,6 +20,7 @@ description: | 
  dual-lvds-odd-pixels or dual-lvds-even-pixels).



allOf:

  - $ref: /schemas/display/lvds-dual-ports.yaml#

  - $ref: panel-common.yaml#



properties:
@@ -44,22 +45,10 @@ properties: 


    properties:

      port@0:

        $ref: /schemas/graph.yaml#/$defs/port-base

        unevaluatedProperties: false

        description: The sink for odd pixels.

        properties:

          dual-lvds-odd-pixels: true



        required:

          - dual-lvds-odd-pixels



      port@1:

        $ref: /schemas/graph.yaml#/$defs/port-base

        unevaluatedProperties: false

        description: The sink for even pixels.

        properties:

          dual-lvds-even-pixels: true



        required:

          - dual-lvds-even-pixels
@@ -75,7 +64,6 @@ required: 
  - height-mm

  - data-mapping

  - panel-timing

  - ports



examples:

  - |+

Documentation/devicetree/bindings/display/panel/panel-simple-lvds-dual-ports.yaml

+1 −19
Original line number Diff line number Diff line
@@ -22,6 +22,7 @@ description: | 
  If the panel is more advanced a dedicated binding file is required.



allOf:

  - $ref: /schemas/display/lvds-dual-ports.yaml#

  - $ref: panel-common.yaml#



properties:
@@ -55,28 +56,10 @@ properties: 


    properties:

      port@0:

        $ref: /schemas/graph.yaml#/$defs/port-base

        unevaluatedProperties: false

        description: The first sink port.



        properties:

          dual-lvds-odd-pixels:

            type: boolean

            description: The first sink port for odd pixels.



        required:

          - dual-lvds-odd-pixels



      port@1:

        $ref: /schemas/graph.yaml#/$defs/port-base

        unevaluatedProperties: false

        description: The second sink port.



        properties:

          dual-lvds-even-pixels:

            type: boolean

            description: The second sink port for even pixels.



        required:

          - dual-lvds-even-pixels
@@ -88,7 +71,6 @@ unevaluatedProperties: false 


required:

  - compatible

  - ports

  - power-supply



examples: