1*4882a593Smuzhiyun# SPDX-License-Identifier: GPL-2.0 2*4882a593Smuzhiyun%YAML 1.2 3*4882a593Smuzhiyun--- 4*4882a593Smuzhiyun$id: http://devicetree.org/schemas/display/panel/tpo,tpg110.yaml# 5*4882a593Smuzhiyun$schema: http://devicetree.org/meta-schemas/core.yaml# 6*4882a593Smuzhiyun 7*4882a593Smuzhiyuntitle: TPO TPG110 Panel 8*4882a593Smuzhiyun 9*4882a593Smuzhiyunmaintainers: 10*4882a593Smuzhiyun - Linus Walleij <linus.walleij@linaro.org> 11*4882a593Smuzhiyun - Thierry Reding <thierry.reding@gmail.com> 12*4882a593Smuzhiyun 13*4882a593Smuzhiyundescription: |+ 14*4882a593Smuzhiyun This panel driver is a component that acts as an intermediary 15*4882a593Smuzhiyun between an RGB output and a variety of panels. The panel 16*4882a593Smuzhiyun driver is strapped up in electronics to the desired resolution 17*4882a593Smuzhiyun and other properties, and has a control interface over 3WIRE 18*4882a593Smuzhiyun SPI. By talking to the TPG110 over SPI, the strapped properties 19*4882a593Smuzhiyun can be discovered and the hardware is therefore mostly 20*4882a593Smuzhiyun self-describing. 21*4882a593Smuzhiyun 22*4882a593Smuzhiyun +--------+ 23*4882a593Smuzhiyun SPI -> | TPO | -> physical display 24*4882a593Smuzhiyun RGB -> | TPG110 | 25*4882a593Smuzhiyun +--------+ 26*4882a593Smuzhiyun 27*4882a593Smuzhiyun If some electrical strap or alternate resolution is desired, 28*4882a593Smuzhiyun this can be set up by taking software control of the display 29*4882a593Smuzhiyun over the SPI interface. The interface can also adjust 30*4882a593Smuzhiyun for properties of the display such as gamma correction and 31*4882a593Smuzhiyun certain electrical driving levels. 32*4882a593Smuzhiyun 33*4882a593Smuzhiyun The TPG110 does not know the physical dimensions of the panel 34*4882a593Smuzhiyun connected, so this needs to be specified in the device tree. 35*4882a593Smuzhiyun 36*4882a593Smuzhiyun It requires a GPIO line for control of its reset line. 37*4882a593Smuzhiyun 38*4882a593Smuzhiyun The serial protocol has line names that resemble I2C but the 39*4882a593Smuzhiyun protocol is not I2C but 3WIRE SPI. 40*4882a593Smuzhiyun 41*4882a593Smuzhiyun 42*4882a593SmuzhiyunallOf: 43*4882a593Smuzhiyun - $ref: panel-common.yaml# 44*4882a593Smuzhiyun 45*4882a593Smuzhiyunproperties: 46*4882a593Smuzhiyun compatible: 47*4882a593Smuzhiyun oneOf: 48*4882a593Smuzhiyun - items: 49*4882a593Smuzhiyun - enum: 50*4882a593Smuzhiyun - ste,nomadik-nhk15-display 51*4882a593Smuzhiyun - const: tpo,tpg110 52*4882a593Smuzhiyun - const: tpo,tpg110 53*4882a593Smuzhiyun 54*4882a593Smuzhiyun reg: true 55*4882a593Smuzhiyun 56*4882a593Smuzhiyun grestb-gpios: 57*4882a593Smuzhiyun maxItems: 1 58*4882a593Smuzhiyun description: panel reset GPIO 59*4882a593Smuzhiyun 60*4882a593Smuzhiyun spi-3wire: true 61*4882a593Smuzhiyun 62*4882a593Smuzhiyun spi-max-frequency: 63*4882a593Smuzhiyun const: 3000000 64*4882a593Smuzhiyun 65*4882a593Smuzhiyunrequired: 66*4882a593Smuzhiyun - compatible 67*4882a593Smuzhiyun - reg 68*4882a593Smuzhiyun - grestb-gpios 69*4882a593Smuzhiyun - width-mm 70*4882a593Smuzhiyun - height-mm 71*4882a593Smuzhiyun - spi-3wire 72*4882a593Smuzhiyun - spi-max-frequency 73*4882a593Smuzhiyun - port 74*4882a593Smuzhiyun 75*4882a593SmuzhiyununevaluatedProperties: false 76*4882a593Smuzhiyun 77*4882a593Smuzhiyunexamples: 78*4882a593Smuzhiyun - |+ 79*4882a593Smuzhiyun spi { 80*4882a593Smuzhiyun #address-cells = <1>; 81*4882a593Smuzhiyun #size-cells = <0>; 82*4882a593Smuzhiyun 83*4882a593Smuzhiyun panel: display@0 { 84*4882a593Smuzhiyun compatible = "tpo,tpg110"; 85*4882a593Smuzhiyun reg = <0>; 86*4882a593Smuzhiyun spi-3wire; 87*4882a593Smuzhiyun /* 320 ns min period ~= 3 MHz */ 88*4882a593Smuzhiyun spi-max-frequency = <3000000>; 89*4882a593Smuzhiyun /* Width and height from data sheet */ 90*4882a593Smuzhiyun width-mm = <116>; 91*4882a593Smuzhiyun height-mm = <87>; 92*4882a593Smuzhiyun grestb-gpios = <&foo_gpio 5 1>; 93*4882a593Smuzhiyun backlight = <&bl>; 94*4882a593Smuzhiyun 95*4882a593Smuzhiyun port { 96*4882a593Smuzhiyun nomadik_clcd_panel: endpoint { 97*4882a593Smuzhiyun remote-endpoint = <&foo>; 98*4882a593Smuzhiyun }; 99*4882a593Smuzhiyun }; 100*4882a593Smuzhiyun }; 101*4882a593Smuzhiyun }; 102*4882a593Smuzhiyun 103*4882a593Smuzhiyun... 104