1# Copyright (c) 2022 Andreas Sandberg
2# Copyright (c) 2020, Phytec Messtechnik GmbH
3# Copyright 2024 NXP
4# SPDX-License-Identifier: Apache-2.0
5
6description: UltraChip UC81xx EPD display controller common properties
7
8include: [mipi-dbi-spi-device.yaml, display-controller.yaml]
9
10properties:
11  busy-gpios:
12    type: phandle-array
13    required: true
14    description: BUSY pin.
15
16      The BUSY pin of UC81xx is active low.
17      If connected directly the MCU pin should be configured
18      as active low.
19
20  softstart:
21    type: uint8-array
22    description: Booster Soft Start (BTST) values
23
24child-binding:
25  description: |
26    Child nodes describe refresh profiles. Each refresh profile
27    specifies a set of voltages used to drive the refresh
28    cycle. Refresh nodes are optional and are used to override
29    defaults loaded from the controllers OTP memory.
30
31    The partial refresh profile is used when performing a partial
32    refresh (writes while blanking is off). Since the controller
33    always supports partial updates, the driver uses the full refresh
34    profile and scans the partial window corresponding to the write if
35    no partial profile has been provided. An empty profile can be used
36    to use the reset values from OTP instead of the values specified
37    in the full profile.
38
39    The driver typically looks for the following child nodes:
40
41      - 'full' - Normal / full refresh.
42      - 'partial' - Partial refresh, defaults to the values in the
43        full profile if not present.
44
45  properties:
46    pwr:
47      type: uint8-array
48      description: Power Setting (PWR) values
49
50    cdi:
51      type: int
52      description: |
53        VCOM and data interval value. This value is optional but must
54        be provided to enable border refresh control.
55
56    tcon:
57      type: int
58      description: TCON setting value
59
60    pll:
61      type: int
62      description: PLL / frame rate control
63
64    vdcs:
65      type: int
66      description: VCOM DC settings
67
68    lutc:
69      type: uint8-array
70      description: VCOM LUT
71
72    lutww:
73      type: uint8-array
74      description: White-to-white LUT
75
76    lutkw:
77      type: uint8-array
78      description: Black-to-white LUT
79
80    lutwk:
81      type: uint8-array
82      description: White-to-black LUT
83
84    lutkk:
85      type: uint8-array
86      description: White-to-black LUT
87
88    lutbd:
89      type: uint8-array
90      description: Border LUT
91