1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
4 $id: http://devicetree.org/schemas/input/iqs62x-keys.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: Azoteq IQS620A/621/622/624/625 Keys and Switches
10 - Jeff LaBundy <jeff@labundy.com>
16 The Azoteq IQS620A, IQS621, IQS622, IQS624 and IQS625 multi-function sensors
17 feature a variety of self-capacitive, mutual-inductive and Hall-effect sens-
18 ing capabilities that can facilitate a variety of contactless key and switch
21 These functions are collectively represented by a "keys" child node from the
22 parent MFD driver. See Documentation/devicetree/bindings/mfd/iqs62x.yaml for
23 further details and examples. Sensor hardware configuration (self-capacitive
24 vs. mutual-inductive, etc.) is selected based on the device's firmware.
39 Specifies the numeric keycodes associated with each available touch or
40 proximity event according to the following table. An 'x' indicates the
41 event is supported for a given device. Specify 0 for unused events.
43 -------------------------------------------------------------------------
44 | # | Event | IQS620A | IQS621 | IQS622 | IQS624 | IQS625 |
45 -------------------------------------------------------------------------
46 | 0 | CH0 Touch | x | x | x | x | x |
47 | | Antenna 1 Touch* | x | | | | |
48 -------------------------------------------------------------------------
49 | 1 | CH0 Proximity | x | x | x | x | x |
50 | | Antenna 1 Prox.* | x | | | | |
51 -------------------------------------------------------------------------
52 | 2 | CH1 Touch | x | x | x | x | x |
53 | | Ant. 1 Deep Touch* | x | | | | |
54 -------------------------------------------------------------------------
55 | 3 | CH1 Proximity | x | x | x | x | x |
56 -------------------------------------------------------------------------
57 | 4 | CH2 Touch | x | | | | |
58 -------------------------------------------------------------------------
59 | 5 | CH2 Proximity | x | | | | |
60 | | Antenna 2 Prox.* | x | | | | |
61 -------------------------------------------------------------------------
62 | 6 | Metal (+) Touch** | x | x | | | |
63 | | Ant. 2 Deep Touch* | x | | | | |
64 -------------------------------------------------------------------------
65 | 7 | Metal (+) Prox.** | x | x | | | |
66 | | Antenna 2 Touch* | x | | | | |
67 -------------------------------------------------------------------------
68 | 8 | Metal (-) Touch** | x | x | | | |
69 -------------------------------------------------------------------------
70 | 9 | Metal (-) Prox.** | x | x | | | |
71 -------------------------------------------------------------------------
72 | 10 | SAR Active*** | x | | x | | |
73 -------------------------------------------------------------------------
74 | 11 | SAR Quick Rel.*** | x | | x | | |
75 -------------------------------------------------------------------------
76 | 12 | SAR Movement*** | x | | x | | |
77 -------------------------------------------------------------------------
78 | 13 | SAR Filter Halt*** | x | | x | | |
79 -------------------------------------------------------------------------
80 | 14 | Wheel Up | | | | x | |
81 -------------------------------------------------------------------------
82 | 15 | Wheel Down | | | | x | |
83 -------------------------------------------------------------------------
84 * Two-channel SAR. Replaces CH0-2 plus metal touch and proximity events
85 if enabled via firmware.
86 ** "+" and "-" refer to the polarity of a channel's delta (LTA - counts),
87 where "LTA" is defined as the channel's long-term average.
88 *** One-channel SAR. Replaces CH0-2 touch and proximity events if enabled
92 "^hall-switch-(north|south)$":
96 Represents north/south-field Hall-effect sensor touch or proximity
97 events. Note that north/south-field orientation is reversed on the
98 IQS620AXzCSR device due to its flip-chip package.
104 $ref: /schemas/types.yaml#/definitions/flag
106 If present, specifies that Hall-effect sensor reporting should
107 use the device's wide-range proximity threshold instead of its
108 close-range touch threshold (default).
113 additionalProperties: false
124 "^hall-switch-(north|south)$": false
130 additionalProperties: false