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