Documentation/devicetree/bindings/display/panel/panel-mipi-dbi-spi.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only or BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/display/panel/panel-mipi-dbi-spi.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: MIPI DBI SPI Panel
   8
   9 maintainers:
  10   - Noralf Trønnes <noralf@tronnes.org>
  11
  12 description: |
  13   This binding is for display panels using a MIPI DBI compatible controller
  14   in SPI mode.
  15
  16   The MIPI Alliance Standard for Display Bus Interface defines the electrical
  17   and logical interfaces for display controllers historically used in mobile
  18   phones. The standard defines 4 display architecture types and this binding is
  19   for type 1 which has full frame memory. There are 3 interface types in the
  20   standard and type C is the serial interface.
  21
  22   The standard defines the following interface signals for type C:
  23   - Power:
  24     - Vdd: Power supply for display module
  25     - Vddi: Logic level supply for interface signals
  26     Combined into one in this binding called: power-supply
  27   - Interface:
  28     - CSx: Chip select
  29     - SCL: Serial clock
  30     - Dout: Serial out
  31     - Din: Serial in
  32     - SDA: Bidrectional in/out
  33     - D/CX: Data/command selection, high=data, low=command
  34       Called dc-gpios in this binding.
  35     - RESX: Reset when low
  36       Called reset-gpios in this binding.
  37
  38   The type C interface has 3 options:
  39
  40     - Option 1: 9-bit mode and D/CX as the 9th bit
  41       |              Command              |  the next command or following data  |
  42       |<0><D7><D6><D5><D4><D3><D2><D1><D0>|<D/CX><D7><D6><D5><D4><D3><D2><D1><D0>|
  43
  44     - Option 2: 16-bit mode and D/CX as a 9th bit
  45       |              Command or data                              |
  46       |<X><X><X><X><X><X><X><D/CX><D7><D6><D5><D4><D3><D2><D1><D0>|
  47
  48     - Option 3: 8-bit mode and D/CX as a separate interface line
  49       |        Command or data         |
  50       |<D7><D6><D5><D4><D3><D2><D1><D0>|
  51
  52   The panel resolution is specified using the panel-timing node properties
  53   hactive (width) and vactive (height). The other mandatory panel-timing
  54   properties should be set to zero except clock-frequency which can be
  55   optionally set to inform about the actual pixel clock frequency.
  56
  57   If the panel is wired to the controller at an offset specify this using
  58   hback-porch (x-offset) and vback-porch (y-offset).
  59
  60 allOf:
  61   - $ref: panel-common.yaml#
  62   - $ref: /schemas/spi/spi-peripheral-props.yaml#
  63
  64 properties:
  65   compatible:
  66     items:
  67       - enum:
  68           - sainsmart18
  69       - const: panel-mipi-dbi-spi
  70
  71   write-only:
  72     type: boolean
  73     description:
  74       Controller is not readable (ie. Din (MISO on the SPI interface) is not
  75       wired up).
  76
  77   dc-gpios:
  78     maxItems: 1
  79     description: |
  80       Controller data/command selection (D/CX) in 4-line SPI mode.
  81       If not set, the controller is in 3-line SPI mode.
  82
  83 required:
  84   - compatible
  85   - reg
  86   - panel-timing
  87
  88 unevaluatedProperties: false
  89
  90 examples:
  91   - |
  92     #include <dt-bindings/gpio/gpio.h>
  93
  94     spi {
  95         #address-cells = <1>;
  96         #size-cells = <0>;
  97
  98         display@0{
  99             compatible = "sainsmart18", "panel-mipi-dbi-spi";
 100             reg = <0>;
 101             spi-max-frequency = <40000000>;
 102
 103             dc-gpios = <&gpio 24 GPIO_ACTIVE_HIGH>;
 104             reset-gpios = <&gpio 25 GPIO_ACTIVE_HIGH>;
 105             write-only;
 106
 107             backlight = <&backlight>;
 108
 109             width-mm = <35>;
 110             height-mm = <28>;
 111
 112             panel-timing {
 113                 hactive = <160>;
 114                 vactive = <128>;
 115                 hback-porch = <0>;
 116                 vback-porch = <0>;
 117                 clock-frequency = <0>;
 118                 hfront-porch = <0>;
 119                 hsync-len = <0>;
 120                 vfront-porch = <0>;
 121                 vsync-len = <0>;
 122             };
 123         };
 124     };
 125
 126 ...