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