xref: /freebsd/sys/contrib/device-tree/Bindings/input/touchscreen/zinitix,bt400.yaml (revision c7046f76c2c027b00c0e6ba57cfd28f1a78f5e23) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/input/touchscreen/zinitix,bt400.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Zinitix BT4xx and BT5xx series touchscreen controller bindings
8
9description: The Zinitix BT4xx and BT5xx series of touchscreen controllers
10  are Korea-produced touchscreens with embedded microcontrollers. The
11  BT4xx series was produced 2010-2013 and the BT5xx series 2013-2014.
12
13maintainers:
14  - Michael Srba <Michael.Srba@seznam.cz>
15  - Linus Walleij <linus.walleij@linaro.org>
16
17allOf:
18  - $ref: touchscreen.yaml#
19
20properties:
21  $nodename:
22    pattern: "^touchscreen(@.*)?$"
23
24  compatible:
25    enum:
26      - zinitix,bt402
27      - zinitix,bt403
28      - zinitix,bt404
29      - zinitix,bt412
30      - zinitix,bt413
31      - zinitix,bt431
32      - zinitix,bt432
33      - zinitix,bt531
34      - zinitix,bt532
35      - zinitix,bt538
36      - zinitix,bt541
37      - zinitix,bt548
38      - zinitix,bt554
39      - zinitix,at100
40
41  reg:
42    description: I2C address on the I2C bus
43
44  clock-frequency:
45    description: I2C client clock frequency, defined for host when using
46      the device on the I2C bus
47    minimum: 0
48    maximum: 400000
49
50  interrupts:
51    description: Interrupt to host
52    maxItems: 1
53
54  vcca-supply:
55    description: Analog power supply regulator on the VCCA pin
56
57  vdd-supply:
58    description: Digital power supply regulator on the VDD pin.
59      In older device trees this can be the accidental name for the analog
60      supply on the VCCA pin, and in that case the deprecated vddo-supply is
61      used for the digital power supply.
62
63  vddo-supply:
64    description: Deprecated name for the digital power supply, use vdd-supply
65      as this reflects the real name of the pin. If this supply is present,
66      the vdd-supply represents VCCA instead of VDD. Implementers should first
67      check for this property, and if it is present assume that the vdd-supply
68      represents the analog supply.
69    deprecated: true
70
71  reset-gpios:
72    description: Reset line for the touchscreen, should be tagged
73      as GPIO_ACTIVE_LOW
74
75  zinitix,mode:
76    description: Mode of reporting touch points. Some modes may not work
77      with a particular ts firmware for unknown reasons. Available modes are
78      1 and 2. Mode 2 is the default and preferred.
79    $ref: /schemas/types.yaml#/definitions/uint32
80    enum: [1, 2]
81
82  touchscreen-size-x: true
83  touchscreen-size-y: true
84  touchscreen-fuzz-x: true
85  touchscreen-fuzz-y: true
86
87additionalProperties: false
88
89required:
90  - compatible
91  - reg
92  - interrupts
93  - touchscreen-size-x
94  - touchscreen-size-y
95
96examples:
97  - |
98    #include <dt-bindings/interrupt-controller/irq.h>
99    #include <dt-bindings/gpio/gpio.h>
100    i2c {
101      #address-cells = <1>;
102      #size-cells = <0>;
103
104      touchscreen@20 {
105        compatible = "zinitix,bt541";
106        reg = <0x20>;
107        interrupt-parent = <&gpio>;
108        interrupts = <13 IRQ_TYPE_EDGE_FALLING>;
109        vcca-supply = <&reg_vcca_tsp>;
110        vdd-supply = <&reg_vdd_tsp>;
111        touchscreen-size-x = <540>;
112        touchscreen-size-y = <960>;
113        zinitix,mode = <2>;
114      };
115    };
116