xref: /linux/Documentation/devicetree/bindings/display/dsi-controller.yaml (revision 1ac731c529cd4d6adbce134754b51ff7d822b145) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/dsi-controller.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Common Properties for DSI Display Panels
8
9maintainers:
10  - Linus Walleij <linus.walleij@linaro.org>
11
12description: |
13  This document defines device tree properties common to DSI, Display
14  Serial Interface controllers and attached panels. It doesn't constitute
15  a device tree binding specification by itself but is meant to be referenced
16  by device tree bindings.
17
18  When referenced from panel device tree bindings the properties defined in
19  this document are defined as follows. The panel device tree bindings are
20  responsible for defining whether each property is required or optional.
21
22  Notice: this binding concerns DSI panels connected directly to a master
23  without any intermediate port graph to the panel. Each DSI master
24  can control one to four virtual channels to one panel. Each virtual
25  channel should have a node "panel" for their virtual channel with their
26  reg-property set to the virtual channel number, usually there is just
27  one virtual channel, number 0.
28
29properties:
30  $nodename:
31    pattern: "^dsi(@.*)?$"
32
33  clock-master:
34    type: boolean
35    description:
36      Should be enabled if the host is being used in conjunction with
37      another DSI host to drive the same peripheral. Hardware supporting
38      such a configuration generally requires the data on both the busses
39      to be driven by the same clock. Only the DSI host instance
40      controlling this clock should contain this property.
41
42  "#address-cells":
43    const: 1
44
45  "#size-cells":
46    const: 0
47
48patternProperties:
49  "^panel@[0-3]$":
50    description: Panels connected to the DSI link
51    type: object
52
53    properties:
54      reg:
55        minimum: 0
56        maximum: 3
57        description:
58          The virtual channel number of a DSI peripheral. Must be in the range
59          from 0 to 3, as DSI uses a 2-bit addressing scheme. Some DSI
60          peripherals respond to more than a single virtual channel. In that
61          case the reg property can take multiple entries, one for each virtual
62          channel that the peripheral responds to.
63
64      enforce-video-mode:
65        type: boolean
66        description:
67          The best option is usually to run a panel in command mode, as this
68          gives better control over the panel hardware. However for different
69          reasons like broken hardware, missing features or testing, it may be
70          useful to be able to force a command mode-capable panel into video
71          mode.
72
73    required:
74      - reg
75
76additionalProperties: true
77
78examples:
79  - |
80    #include <dt-bindings/gpio/gpio.h>
81    dsi@a0351000 {
82        reg = <0xa0351000 0x1000>;
83        #address-cells = <1>;
84        #size-cells = <0>;
85        panel@0 {
86            compatible = "sony,acx424akp";
87            reg = <0>;
88            vddi-supply = <&ab8500_ldo_aux1_reg>;
89            reset-gpios = <&gpio2 1 GPIO_ACTIVE_LOW>;
90        };
91    };
92
93...
94