Documentation/devicetree/bindings/display/panel/panel-dsi-cm.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/panel/panel-dsi-cm.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: DSI command mode panels
   8
   9 maintainers:
  10   - Tomi Valkeinen <tomi.valkeinen@ti.com>
  11   - Sebastian Reichel <sre@kernel.org>
  12
  13 description: |
  14   This binding file is a collection of the DSI panels that
  15   are usually driven in command mode. If no backlight is
  16   referenced via the optional backlight property, the DSI
  17   panel is assumed to have native backlight support.
  18   The panel may use an OF graph binding for the association
  19   to the display, or it may be a direct child node of the
  20   display.
  21
  22 allOf:
  23   - $ref: panel-common.yaml#
  24
  25 properties:
  26
  27   compatible:
  28     items:
  29       - enum:
  30           - motorola,droid4-panel        # Panel from Motorola Droid4 phone
  31           - nokia,himalaya               # Panel from Nokia N950 phone
  32           - tpo,taal                     # Panel from OMAP4 SDP board
  33       - const: panel-dsi-cm              # Generic DSI command mode panel compatible fallback
  34
  35   reg:
  36     maxItems: 1
  37     description: DSI virtual channel
  38
  39   vddi-supply:
  40     description:
  41       Display panels require power to be supplied. While several panels need
  42       more than one power supply with panel-specific constraints governing the
  43       order and timings of the power supplies, in many cases a single power
  44       supply is sufficient, either because the panel has a single power rail, or
  45       because all its power rails can be driven by the same supply. In that case
  46       the vddi-supply property specifies the supply powering the panel as a
  47       phandle to a regulator.
  48
  49   vpnl-supply:
  50     description:
  51       When the display panel needs a second power supply, this property can be
  52       used in addition to vddi-supply. Both supplies will be enabled at the
  53       same time before the panel is being accessed.
  54
  55   width-mm: true
  56   height-mm: true
  57   label: true
  58   rotation: true
  59   panel-timing: true
  60   port: true
  61   reset-gpios: true
  62   te-gpios: true
  63   backlight: true
  64
  65 additionalProperties: false
  66
  67 required:
  68   - compatible
  69   - reg
  70
  71 examples:
  72   - |
  73     #include <dt-bindings/gpio/gpio.h>
  74
  75     dsi-controller {
  76         #address-cells = <1>;
  77         #size-cells = <0>;
  78
  79         panel@0 {
  80             compatible = "tpo,taal", "panel-dsi-cm";
  81             reg = <0>;
  82             reset-gpios = <&gpio4 6 GPIO_ACTIVE_HIGH>;
  83         };
  84     };
  85
  86 ...