0001 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
0002 %YAML 1.2
0003 ---
0004 $id: http://devicetree.org/schemas/display/dsi-controller.yaml#
0005 $schema: http://devicetree.org/meta-schemas/core.yaml#
0006
0007 title: Common Properties for DSI Display Panels
0008
0009 maintainers:
0010 - Linus Walleij <linus.walleij@linaro.org>
0011
0012 description: |
0013 This document defines device tree properties common to DSI, Display
0014 Serial Interface controllers and attached panels. It doesn't constitute
0015 a device tree binding specification by itself but is meant to be referenced
0016 by device tree bindings.
0017
0018 When referenced from panel device tree bindings the properties defined in
0019 this document are defined as follows. The panel device tree bindings are
0020 responsible for defining whether each property is required or optional.
0021
0022 Notice: this binding concerns DSI panels connected directly to a master
0023 without any intermediate port graph to the panel. Each DSI master
0024 can control one to four virtual channels to one panel. Each virtual
0025 channel should have a node "panel" for their virtual channel with their
0026 reg-property set to the virtual channel number, usually there is just
0027 one virtual channel, number 0.
0028
0029 properties:
0030 $nodename:
0031 pattern: "^dsi(@.*)?$"
0032
0033 "#address-cells":
0034 const: 1
0035
0036 "#size-cells":
0037 const: 0
0038
0039 patternProperties:
0040 "^panel@[0-3]$":
0041 description: Panels connected to the DSI link
0042 type: object
0043
0044 properties:
0045 reg:
0046 minimum: 0
0047 maximum: 3
0048 description:
0049 The virtual channel number of a DSI peripheral. Must be in the range
0050 from 0 to 3, as DSI uses a 2-bit addressing scheme. Some DSI
0051 peripherals respond to more than a single virtual channel. In that
0052 case the reg property can take multiple entries, one for each virtual
0053 channel that the peripheral responds to.
0054
0055 clock-master:
0056 type: boolean
0057 description:
0058 Should be enabled if the host is being used in conjunction with
0059 another DSI host to drive the same peripheral. Hardware supporting
0060 such a configuration generally requires the data on both the busses
0061 to be driven by the same clock. Only the DSI host instance
0062 controlling this clock should contain this property.
0063
0064 enforce-video-mode:
0065 type: boolean
0066 description:
0067 The best option is usually to run a panel in command mode, as this
0068 gives better control over the panel hardware. However for different
0069 reasons like broken hardware, missing features or testing, it may be
0070 useful to be able to force a command mode-capable panel into video
0071 mode.
0072
0073 required:
0074 - reg
0075
0076 additionalProperties: true
0077
0078 examples:
0079 - |
0080 #include <dt-bindings/gpio/gpio.h>
0081 dsi@a0351000 {
0082 reg = <0xa0351000 0x1000>;
0083 #address-cells = <1>;
0084 #size-cells = <0>;
0085 panel@0 {
0086 compatible = "sony,acx424akp";
0087 reg = <0>;
0088 vddi-supply = <&ab8500_ldo_aux1_reg>;
0089 reset-gpios = <&gpio2 1 GPIO_ACTIVE_LOW>;
0090 };
0091 };
0092
0093 ...
