xref: /freebsd/sys/contrib/device-tree/Bindings/display/panel/panel-dsi-cm.yaml (revision d485c77f203fb0f4cdc08dea5ff81631b51d8809)
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
7title: DSI command mode panels
8
9maintainers:
10  - Tomi Valkeinen <tomi.valkeinen@ti.com>
11  - Sebastian Reichel <sre@kernel.org>
12
13description: |
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
22allOf:
23  - $ref: panel-common.yaml#
24
25properties:
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
65additionalProperties: false
66
67required:
68  - compatible
69  - reg
70
71examples:
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...
87