Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
torvalds
GitHub Repository: torvalds/linux
 Path: blob/master/Documentation/devicetree/bindings/display/dsi-controller.yaml
26308 views
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


7
title: Common Properties for DSI Display Panels

8


9
maintainers:

10
  - Linus Walleij <linus.walleij@linaro.org>

11


12
description: |

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


29
properties:

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


48
patternProperties:

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


76
additionalProperties: true

77


78
examples:

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


95