xref: /linux/Documentation/devicetree/bindings/display/sharp,ls010b7dh04.yaml (revision 7f71507851fc7764b36a3221839607d3a45c2025) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/sharp,ls010b7dh04.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Sharp Memory LCD panels
8
9maintainers:
10  - Alex Lanzano <lanzano.alex@gmail.com>
11
12description:
13  Sharp Memory LCDs are a series of monochrome displays that operate over
14  a SPI bus. The displays require a signal (VCOM) to be generated to prevent
15  DC bias build up resulting in pixels being unable to change. Three modes
16  can be used to provide the VCOM signal ("software", "external", "pwm").
17
18properties:
19  compatible:
20    enum:
21      - sharp,ls010b7dh04
22      - sharp,ls011b7dh03
23      - sharp,ls012b7dd01
24      - sharp,ls013b7dh03
25      - sharp,ls013b7dh05
26      - sharp,ls018b7dh02
27      - sharp,ls027b7dh01
28      - sharp,ls027b7dh01a
29      - sharp,ls032b7dd02
30      - sharp,ls044q7dh01
31
32  reg:
33    maxItems: 1
34
35  spi-max-frequency:
36    maximum: 2000000
37
38  sharp,vcom-mode:
39    $ref: /schemas/types.yaml#/definitions/string
40    description: |
41      software - This mode relies on a software operation to send a
42      "maintain display" message to the display, toggling the vcom
43      bit on and off with each message
44
45      external - This mode relies on an external clock to generate
46      the signal on the EXTCOMM pin
47
48      pwm - This mode relies on a pwm device to generate the signal
49      on the EXTCOMM pin
50
51    enum: [software, external, pwm]
52
53  enable-gpios: true
54
55  pwms:
56    maxItems: 1
57    description: External VCOM signal
58
59required:
60  - compatible
61  - reg
62  - sharp,vcom-mode
63
64allOf:
65  - $ref: panel/panel-common.yaml#
66  - $ref: /schemas/spi/spi-peripheral-props.yaml#
67
68  - if:
69      properties:
70        sharp,vcom-mode:
71          const: pwm
72    then:
73      required:
74        - pwms
75
76unevaluatedProperties: false
77
78examples:
79  - |
80    spi {
81        #address-cells = <1>;
82        #size-cells = <0>;
83
84        display@0 {
85            compatible = "sharp,ls013b7dh03";
86            reg = <0>;
87            spi-cs-high;
88            spi-max-frequency = <1000000>;
89            sharp,vcom-mode = "software";
90        };
91    };
92...
93