xref: /freebsd/sys/contrib/device-tree/Bindings/input/azoteq,iqs7222.yaml (revision a90b9d0159070121c221b966469c3e36d912bf82)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/input/azoteq,iqs7222.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Azoteq IQS7222A/B/C/D Capacitive Touch Controller
8
9maintainers:
10  - Jeff LaBundy <jeff@labundy.com>
11
12description: |
13  The Azoteq IQS7222A, IQS7222B, IQS7222C and IQS7222D are multichannel
14  capacitive touch controllers that feature additional sensing capabilities.
15
16  Link to datasheets: https://www.azoteq.com/
17
18properties:
19  compatible:
20    enum:
21      - azoteq,iqs7222a
22      - azoteq,iqs7222b
23      - azoteq,iqs7222c
24      - azoteq,iqs7222d
25
26  reg:
27    maxItems: 1
28
29  irq-gpios:
30    maxItems: 1
31    description:
32      Specifies the GPIO connected to the device's active-low RDY output.
33
34  reset-gpios:
35    maxItems: 1
36    description:
37      Specifies the GPIO connected to the device's active-low MCLR input. The
38      device is temporarily held in hardware reset prior to initialization if
39      this property is present.
40
41  azoteq,max-counts:
42    $ref: /schemas/types.yaml#/definitions/uint32
43    enum: [0, 1, 2, 3]
44    description: |
45      Specifies the maximum number of conversion periods (counts) that can be
46      reported as follows:
47      0: 1023
48      1: 2047
49      2: 4095
50      3: 16384
51
52  azoteq,auto-mode:
53    $ref: /schemas/types.yaml#/definitions/uint32
54    enum: [0, 1, 2, 3]
55    description: |
56      Specifies the number of conversions to occur before an interrupt is
57      generated as follows:
58      0: 4
59      1: 8
60      2: 16
61      3: 32
62
63  azoteq,ati-frac-div-fine:
64    $ref: /schemas/types.yaml#/definitions/uint32
65    minimum: 0
66    maximum: 31
67    description: Specifies the preloaded ATI fine fractional divider.
68
69  azoteq,ati-frac-div-coarse:
70    $ref: /schemas/types.yaml#/definitions/uint32
71    minimum: 0
72    maximum: 31
73    description: Specifies the preloaded ATI coarse fractional divider.
74
75  azoteq,ati-comp-select:
76    $ref: /schemas/types.yaml#/definitions/uint32
77    minimum: 0
78    maximum: 1023
79    description: Specifies the preloaded ATI compensation selection.
80
81  azoteq,lta-beta-lp:
82    $ref: /schemas/types.yaml#/definitions/uint32
83    minimum: 0
84    maximum: 15
85    description:
86      Specifies the long-term average filter damping factor to be applied during
87      low-power mode.
88
89  azoteq,lta-beta-np:
90    $ref: /schemas/types.yaml#/definitions/uint32
91    minimum: 0
92    maximum: 15
93    description:
94      Specifies the long-term average filter damping factor to be applied during
95      normal-power mode.
96
97  azoteq,counts-beta-lp:
98    $ref: /schemas/types.yaml#/definitions/uint32
99    minimum: 0
100    maximum: 15
101    description:
102      Specifies the counts filter damping factor to be applied during low-power
103      mode.
104
105  azoteq,counts-beta-np:
106    $ref: /schemas/types.yaml#/definitions/uint32
107    minimum: 0
108    maximum: 15
109    description:
110      Specifies the counts filter damping factor to be applied during normal-
111      power mode.
112
113  azoteq,lta-fast-beta-lp:
114    $ref: /schemas/types.yaml#/definitions/uint32
115    minimum: 0
116    maximum: 15
117    description:
118      Specifies the long-term average filter fast damping factor to be applied
119      during low-power mode.
120
121  azoteq,lta-fast-beta-np:
122    $ref: /schemas/types.yaml#/definitions/uint32
123    minimum: 0
124    maximum: 15
125    description:
126      Specifies the long-term average filter fast damping factor to be applied
127      during normal-power mode.
128
129  azoteq,timeout-ati-ms:
130    multipleOf: 500
131    minimum: 0
132    maximum: 32767500
133    description:
134      Specifies the delay (in ms) before ATI is retried following an ATI error.
135
136  azoteq,rate-ati-ms:
137    minimum: 0
138    maximum: 65535
139    description: Specifies the rate (in ms) at which ATI status is evaluated.
140
141  azoteq,timeout-np-ms:
142    minimum: 0
143    maximum: 65535
144    description:
145      Specifies the length of time (in ms) to wait for an event before moving
146      from normal-power mode to low-power mode.
147
148  azoteq,rate-np-ms:
149    minimum: 0
150    maximum: 3000
151    description: Specifies the report rate (in ms) during normal-power mode.
152
153  azoteq,timeout-lp-ms:
154    minimum: 0
155    maximum: 65535
156    description:
157      Specifies the length of time (in ms) to wait for an event before moving
158      from low-power mode to ultra-low-power mode.
159
160  azoteq,rate-lp-ms:
161    minimum: 0
162    maximum: 3000
163    description: Specifies the report rate (in ms) during low-power mode.
164
165  azoteq,timeout-ulp-ms:
166    minimum: 0
167    maximum: 65535
168    description:
169      Specifies the rate (in ms) at which channels not regularly sampled during
170      ultra-low-power mode are updated.
171
172  azoteq,rate-ulp-ms:
173    minimum: 0
174    maximum: 3000
175    description: Specifies the report rate (in ms) during ultra-low-power mode.
176
177  touchscreen-size-x: true
178  touchscreen-size-y: true
179  touchscreen-inverted-x: true
180  touchscreen-inverted-y: true
181  touchscreen-swapped-x-y: true
182
183  trackpad:
184    type: object
185    description: Represents all channels associated with the trackpad.
186
187    properties:
188      azoteq,channel-select:
189        $ref: /schemas/types.yaml#/definitions/uint32-array
190        minItems: 1
191        maxItems: 12
192        items:
193          minimum: 0
194          maximum: 13
195        description:
196          Specifies the order of the channels that participate in the trackpad.
197          Specify 255 to omit a given channel for the purpose of mapping a non-
198          rectangular trackpad.
199
200      azoteq,num-rows:
201        $ref: /schemas/types.yaml#/definitions/uint32
202        minimum: 1
203        maximum: 12
204        description: Specifies the number of rows that comprise the trackpad.
205
206      azoteq,num-cols:
207        $ref: /schemas/types.yaml#/definitions/uint32
208        minimum: 1
209        maximum: 12
210        description: Specifies the number of columns that comprise the trackpad.
211
212      azoteq,top-speed:
213        $ref: /schemas/types.yaml#/definitions/uint32
214        multipleOf: 4
215        minimum: 0
216        maximum: 1020
217        description:
218          Specifies the speed (in coordinates traveled per conversion) after
219          which coordinate filtering is no longer applied.
220
221      azoteq,bottom-speed:
222        $ref: /schemas/types.yaml#/definitions/uint32
223        minimum: 0
224        maximum: 255
225        description:
226          Specifies the speed (in coordinates traveled per conversion) after
227          which coordinate filtering is linearly reduced.
228
229      azoteq,use-prox:
230        type: boolean
231        description:
232          Directs the trackpad to respond to the proximity states of the
233          selected channels instead of their corresponding touch states.
234          Note the trackpad cannot report granular coordinates during a
235          state of proximity.
236
237    patternProperties:
238      "^azoteq,lower-cal-(x|y)$":
239        $ref: /schemas/types.yaml#/definitions/uint32
240        minimum: 0
241        maximum: 255
242        description: Specifies the trackpad's lower starting points.
243
244      "^azoteq,upper-cal-(x|y)$":
245        $ref: /schemas/types.yaml#/definitions/uint32
246        minimum: 0
247        maximum: 255
248        description: Specifies the trackpad's upper starting points.
249
250      "^event-(press|tap|(swipe|flick)-(x|y)-(pos|neg))$":
251        type: object
252        $ref: input.yaml#
253        description:
254          Represents a press or gesture event reported by the trackpad. Specify
255          'linux,code' under the press event to report absolute coordinates.
256
257        properties:
258          linux,code: true
259
260          azoteq,gesture-angle-tighten:
261            type: boolean
262            description:
263              Limits the tangent of the gesture angle to 0.5 (axial gestures
264              only). If specified in one direction, the effect is applied in
265              either direction.
266
267          azoteq,gesture-max-ms:
268            multipleOf: 16
269            minimum: 0
270            maximum: 4080
271            description:
272              Specifies the length of time (in ms) within which a tap, swipe
273              or flick gesture must be completed in order to be acknowledged
274              by the device. The number specified for any one swipe or flick
275              gesture applies to all other swipe or flick gestures.
276
277          azoteq,gesture-min-ms:
278            multipleOf: 16
279            minimum: 0
280            maximum: 4080
281            description:
282              Specifies the length of time (in ms) for which a tap gesture must
283              be held in order to be acknowledged by the device.
284
285          azoteq,gesture-dist:
286            $ref: /schemas/types.yaml#/definitions/uint32
287            minimum: 0
288            maximum: 65535
289            description:
290              Specifies the distance (in coordinates) across which a swipe or
291              flick gesture must travel in order to be acknowledged by the
292              device. The number specified for any one swipe or flick gesture
293              applies to all remaining swipe or flick gestures.
294
295              For tap gestures, this property specifies the distance from the
296              original point of contact across which the contact is permitted
297              to travel before the gesture is rejected by the device.
298
299          azoteq,gpio-select:
300            $ref: /schemas/types.yaml#/definitions/uint32-array
301            minItems: 1
302            maxItems: 3
303            items:
304              minimum: 0
305              maximum: 2
306            description: |
307              Specifies one or more GPIO mapped to the event as follows:
308              0: GPIO0
309              1: GPIO3
310              2: GPIO4
311
312              Note that although multiple events can be mapped to a single
313              GPIO, they must all be of the same type (proximity, touch or
314              trackpad gesture).
315
316        additionalProperties: false
317
318    required:
319      - azoteq,channel-select
320
321    additionalProperties: false
322
323patternProperties:
324  "^cycle-[0-9]$":
325    type: object
326    description: Represents a conversion cycle serving two sensing channels.
327
328    properties:
329      azoteq,conv-period:
330        $ref: /schemas/types.yaml#/definitions/uint32
331        minimum: 0
332        maximum: 255
333        description: Specifies the cycle's conversion period.
334
335      azoteq,conv-frac:
336        $ref: /schemas/types.yaml#/definitions/uint32
337        minimum: 0
338        maximum: 255
339        description: Specifies the cycle's conversion frequency fraction.
340
341      azoteq,tx-enable:
342        $ref: /schemas/types.yaml#/definitions/uint32-array
343        minItems: 1
344        maxItems: 9
345        items:
346          minimum: 0
347          maximum: 8
348        description: Specifies the CTx pin(s) associated with the cycle.
349
350      azoteq,rx-float-inactive:
351        type: boolean
352        description: Floats any inactive CRx pins instead of grounding them.
353
354      azoteq,dead-time-enable:
355        type: boolean
356        description:
357          Increases the denominator of the conversion frequency formula by one.
358
359      azoteq,tx-freq-fosc:
360        type: boolean
361        description:
362          Fixes the conversion frequency to that of the device's core clock.
363
364      azoteq,vbias-enable:
365        type: boolean
366        description: Enables the bias voltage for use during inductive sensing.
367
368      azoteq,sense-mode:
369        $ref: /schemas/types.yaml#/definitions/uint32
370        enum: [0, 1, 2, 3]
371        description: |
372          Specifies the cycle's sensing mode as follows:
373          0: None
374          1: Self capacitive
375          2: Mutual capacitive
376          3: Inductive
377
378          Note that in the case of IQS7222A, cycles 5 and 6 are restricted to
379          Hall-effect sensing.
380
381      azoteq,iref-enable:
382        type: boolean
383        description:
384          Enables the current reference for use during various sensing modes.
385
386      azoteq,iref-level:
387        $ref: /schemas/types.yaml#/definitions/uint32
388        minimum: 0
389        maximum: 15
390        description: Specifies the cycle's current reference level.
391
392      azoteq,iref-trim:
393        $ref: /schemas/types.yaml#/definitions/uint32
394        minimum: 0
395        maximum: 15
396        description: Specifies the cycle's current reference trim.
397
398    dependencies:
399      azoteq,iref-level: ["azoteq,iref-enable"]
400      azoteq,iref-trim: ["azoteq,iref-enable"]
401
402    additionalProperties: false
403
404  "^channel-([0-9]|1[0-9])$":
405    type: object
406    description:
407      Represents a single sensing channel. A channel is active if defined and
408      inactive otherwise.
409
410      Note that in the case of IQS7222A, channels 10 and 11 are restricted to
411      Hall-effect sensing with events reported on channel 10 only.
412
413    properties:
414      azoteq,ulp-allow:
415        type: boolean
416        description:
417          Permits the device to enter ultra-low-power mode while the channel
418          lies in a state of touch or proximity.
419
420      azoteq,ref-select:
421        $ref: /schemas/types.yaml#/definitions/uint32
422        minimum: 0
423        maximum: 9
424        description: Specifies a separate reference channel to be followed.
425
426      azoteq,ref-weight:
427        $ref: /schemas/types.yaml#/definitions/uint32
428        minimum: 0
429        maximum: 65535
430        description: Specifies the relative weight of the reference channel.
431
432      azoteq,use-prox:
433        type: boolean
434        description:
435          Activates the reference channel in response to proximity events
436          instead of touch events.
437
438      azoteq,counts-filt-enable:
439        type: boolean
440        description: Applies counts filtering to the channel.
441
442      azoteq,ati-band:
443        $ref: /schemas/types.yaml#/definitions/uint32
444        enum: [0, 1, 2, 3]
445        description: |
446          Specifies the channel's ATI band as a fraction of its ATI target as
447          follows:
448          0: 1/16
449          1: 1/8
450          2: 1/4
451          3: 1/2
452
453      azoteq,global-halt:
454        type: boolean
455        description:
456          Specifies that the channel's long-term average is to freeze if any
457          other participating channel lies in a proximity or touch state.
458
459      azoteq,invert-enable:
460        type: boolean
461        description:
462          Inverts the polarity of the states reported for proximity and touch
463          events relative to their respective thresholds.
464
465      azoteq,dual-direction:
466        type: boolean
467        description:
468          Specifies that the channel's long-term average is to freeze in the
469          presence of either increasing or decreasing counts, thereby permit-
470          ting events to be reported in either direction.
471
472      azoteq,rx-enable:
473        $ref: /schemas/types.yaml#/definitions/uint32-array
474        minItems: 1
475        maxItems: 4
476        items:
477          minimum: 0
478          maximum: 7
479        description: Specifies the CRx pin(s) associated with the channel.
480
481      azoteq,samp-cap-double:
482        type: boolean
483        description: Doubles the sampling capacitance from 40 pF to 80 pF.
484
485      azoteq,vref-half:
486        type: boolean
487        description: Halves the discharge threshold from 1.0 V to 0.5 V.
488
489      azoteq,proj-bias:
490        $ref: /schemas/types.yaml#/definitions/uint32
491        enum: [0, 1, 2, 3]
492        description: |
493          Specifies the bias current applied during mutual (projected)
494          capacitive sensing as follows:
495          0: 2 uA
496          1: 5 uA
497          2: 7 uA
498          3: 10 uA
499
500      azoteq,ati-target:
501        $ref: /schemas/types.yaml#/definitions/uint32
502        multipleOf: 8
503        minimum: 0
504        maximum: 2040
505        description: Specifies the channel's ATI target.
506
507      azoteq,ati-base:
508        $ref: /schemas/types.yaml#/definitions/uint32
509        multipleOf: 16
510        minimum: 0
511        maximum: 496
512        description: Specifies the channel's ATI base.
513
514      azoteq,ati-mode:
515        $ref: /schemas/types.yaml#/definitions/uint32
516        enum: [0, 1, 2, 3, 4, 5]
517        description: |
518          Specifies the channel's ATI mode as follows:
519          0: Disabled
520          1: Compensation
521          2: Compensation divider
522          3: Fine fractional divider
523          4: Coarse fractional divider
524          5: Full
525
526      azoteq,ati-frac-div-fine:
527        $ref: /schemas/types.yaml#/definitions/uint32
528        minimum: 0
529        maximum: 31
530        description: Specifies the channel's ATI fine fractional divider.
531
532      azoteq,ati-frac-mult-coarse:
533        $ref: /schemas/types.yaml#/definitions/uint32
534        minimum: 0
535        maximum: 15
536        description: Specifies the channel's ATI coarse fractional multiplier.
537
538      azoteq,ati-frac-div-coarse:
539        $ref: /schemas/types.yaml#/definitions/uint32
540        minimum: 0
541        maximum: 31
542        description: Specifies the channel's ATI coarse fractional divider.
543
544      azoteq,ati-comp-div:
545        $ref: /schemas/types.yaml#/definitions/uint32
546        minimum: 0
547        maximum: 31
548        description: Specifies the channel's ATI compensation divider.
549
550      azoteq,ati-comp-select:
551        $ref: /schemas/types.yaml#/definitions/uint32
552        minimum: 0
553        maximum: 1023
554        description: Specifies the channel's ATI compensation selection.
555
556      azoteq,debounce-enter:
557        $ref: /schemas/types.yaml#/definitions/uint32
558        minimum: 0
559        maximum: 15
560        description: Specifies the channel's debounce entrance factor.
561
562      azoteq,debounce-exit:
563        $ref: /schemas/types.yaml#/definitions/uint32
564        minimum: 0
565        maximum: 15
566        description: Specifies the channel's debounce exit factor.
567
568    patternProperties:
569      "^event-(prox|touch)$":
570        type: object
571        $ref: input.yaml#
572        description:
573          Represents a proximity or touch event reported by the channel.
574
575        properties:
576          azoteq,gpio-select:
577            $ref: /schemas/types.yaml#/definitions/uint32-array
578            minItems: 1
579            maxItems: 3
580            items:
581              minimum: 0
582              maximum: 2
583            description: |
584              Specifies one or more GPIO mapped to the event as follows:
585              0: GPIO0
586              1: GPIO3
587              2: GPIO4
588
589              Note that although multiple events can be mapped to a single
590              GPIO, they must all be of the same type (proximity, touch or
591              slider/trackpad gesture).
592
593          azoteq,thresh:
594            $ref: /schemas/types.yaml#/definitions/uint32
595            description:
596              Specifies the threshold for the event. Valid entries range from
597              0-127 and 0-255 for proximity and touch events, respectively.
598
599          azoteq,hyst:
600            $ref: /schemas/types.yaml#/definitions/uint32
601            minimum: 0
602            maximum: 255
603            description:
604              Specifies the hysteresis for the event (touch events only).
605
606          azoteq,timeout-press-ms:
607            multipleOf: 500
608            minimum: 0
609            maximum: 127500
610            description:
611              Specifies the length of time (in ms) to wait before automatically
612              releasing a press event. Specify zero to allow the press state to
613              persist indefinitely.
614
615              The IQS7222B does not feature channel-specific timeouts; the time-
616              out specified for any one channel applies to all channels.
617
618          linux,code: true
619
620          linux,input-type:
621            enum: [1, 5]
622            default: 1
623            description:
624              Specifies whether the event is to be interpreted as a key (1)
625              or a switch (5).
626
627        additionalProperties: false
628
629    dependencies:
630      azoteq,ref-weight: ["azoteq,ref-select"]
631      azoteq,use-prox: ["azoteq,ref-select"]
632
633    additionalProperties: false
634
635  "^slider-[0-1]$":
636    type: object
637    description: Represents a slider comprising three or four channels.
638
639    properties:
640      azoteq,channel-select:
641        $ref: /schemas/types.yaml#/definitions/uint32-array
642        minItems: 3
643        maxItems: 4
644        items:
645          minimum: 0
646          maximum: 9
647        description:
648          Specifies the order of the channels that participate in the slider.
649
650      azoteq,slider-size:
651        $ref: /schemas/types.yaml#/definitions/uint32
652        minimum: 1
653        maximum: 65535
654        description:
655          Specifies the slider's one-dimensional resolution, equal to the
656          maximum coordinate plus one.
657
658      azoteq,lower-cal:
659        $ref: /schemas/types.yaml#/definitions/uint32
660        minimum: 0
661        maximum: 255
662        description: Specifies the slider's lower starting point.
663
664      azoteq,upper-cal:
665        $ref: /schemas/types.yaml#/definitions/uint32
666        minimum: 0
667        maximum: 255
668        description: Specifies the slider's upper starting point.
669
670      azoteq,top-speed:
671        $ref: /schemas/types.yaml#/definitions/uint32
672        minimum: 0
673        maximum: 65535
674        description:
675          Specifies the speed (in coordinates traveled per conversion) after
676          which coordinate filtering is no longer applied.
677
678      azoteq,bottom-speed:
679        $ref: /schemas/types.yaml#/definitions/uint32
680        minimum: 0
681        maximum: 255
682        description:
683          Specifies the speed (in coordinates traveled per conversion) after
684          which coordinate filtering is linearly reduced.
685
686      azoteq,bottom-beta:
687        $ref: /schemas/types.yaml#/definitions/uint32
688        minimum: 0
689        maximum: 7
690        description:
691          Specifies the coordinate filter damping factor to be applied
692          while the speed of movement is below that which is specified
693          by azoteq,bottom-speed.
694
695      azoteq,static-beta:
696        type: boolean
697        description:
698          Applies the coordinate filter damping factor specified by
699          azoteq,bottom-beta regardless of the speed of movement.
700
701      azoteq,use-prox:
702        type: boolean
703        description:
704          Directs the slider to respond to the proximity states of the selected
705          channels instead of their corresponding touch states. Note the slider
706          cannot report granular coordinates during a state of proximity.
707
708      linux,axis:
709        $ref: /schemas/types.yaml#/definitions/uint32
710        description:
711          Specifies the absolute axis to which coordinates are mapped. Specify
712          ABS_WHEEL to operate the slider as a wheel (IQS7222C only).
713
714    patternProperties:
715      "^event-(press|tap|(swipe|flick)-(pos|neg))$":
716        type: object
717        $ref: input.yaml#
718        description:
719          Represents a press or gesture (IQS7222A only) event reported by
720          the slider.
721
722        properties:
723          linux,code: true
724
725          azoteq,gesture-max-ms:
726            multipleOf: 16
727            minimum: 0
728            maximum: 4080
729            description:
730              Specifies the length of time (in ms) within which a tap, swipe
731              or flick gesture must be completed in order to be acknowledged
732              by the device. The number specified for any one swipe or flick
733              gesture applies to all remaining swipe or flick gestures.
734
735          azoteq,gesture-min-ms:
736            multipleOf: 16
737            minimum: 0
738            maximum: 496
739            description:
740              Specifies the length of time (in ms) for which a tap gesture must
741              be held in order to be acknowledged by the device.
742
743          azoteq,gesture-dist:
744            $ref: /schemas/types.yaml#/definitions/uint32
745            multipleOf: 16
746            minimum: 0
747            maximum: 4080
748            description:
749              Specifies the distance (in coordinates) across which a swipe or
750              flick gesture must travel in order to be acknowledged by the
751              device. The number specified for any one swipe or flick gesture
752              applies to all remaining swipe or flick gestures.
753
754          azoteq,gpio-select:
755            $ref: /schemas/types.yaml#/definitions/uint32-array
756            minItems: 1
757            maxItems: 3
758            items:
759              minimum: 0
760              maximum: 2
761            description: |
762              Specifies one or more GPIO mapped to the event as follows:
763              0: GPIO0
764              1: GPIO3
765              2: GPIO4
766
767              Note that although multiple events can be mapped to a single
768              GPIO, they must all be of the same type (proximity, touch or
769              slider gesture).
770
771        additionalProperties: false
772
773    required:
774      - azoteq,channel-select
775
776    additionalProperties: false
777
778  "^gpio-[0-2]$":
779    type: object
780    description: |
781      Represents a GPIO mapped to one or more events as follows:
782      gpio-0: GPIO0
783      gpio-1: GPIO3
784      gpio-2: GPIO4
785
786    allOf:
787      - $ref: ../pinctrl/pincfg-node.yaml#
788
789    properties:
790      drive-open-drain: true
791
792    additionalProperties: false
793
794allOf:
795  - $ref: touchscreen/touchscreen.yaml#
796
797  - if:
798      properties:
799        compatible:
800          contains:
801            enum:
802              - azoteq,iqs7222a
803              - azoteq,iqs7222b
804              - azoteq,iqs7222c
805
806    then:
807      properties:
808        touchscreen-size-x: false
809        touchscreen-size-y: false
810        touchscreen-inverted-x: false
811        touchscreen-inverted-y: false
812        touchscreen-swapped-x-y: false
813
814        trackpad: false
815
816      patternProperties:
817        "^channel-([0-9]|1[0-9])$":
818          properties:
819            azoteq,counts-filt-enable: false
820
821  - if:
822      properties:
823        compatible:
824          contains:
825            enum:
826              - azoteq,iqs7222b
827              - azoteq,iqs7222c
828
829    then:
830      patternProperties:
831        "^channel-([0-9]|1[0-9])$":
832          properties:
833            azoteq,ulp-allow: false
834
835  - if:
836      properties:
837        compatible:
838          contains:
839            enum:
840              - azoteq,iqs7222b
841              - azoteq,iqs7222d
842
843    then:
844      patternProperties:
845        "^cycle-[0-9]$":
846          properties:
847            azoteq,iref-enable: false
848
849        "^channel-([0-9]|1[0-9])$":
850          properties:
851            azoteq,ref-select: false
852
853        "^slider-[0-1]$": false
854
855  - if:
856      properties:
857        compatible:
858          contains:
859            const: azoteq,iqs7222b
860
861    then:
862      patternProperties:
863        "^channel-([0-9]|1[0-9])$":
864          patternProperties:
865            "^event-(prox|touch)$":
866              properties:
867                azoteq,gpio-select: false
868
869        "^gpio-[0-2]$": false
870
871  - if:
872      properties:
873        compatible:
874          contains:
875            const: azoteq,iqs7222a
876
877    then:
878      patternProperties:
879        "^channel-([0-9]|1[0-9])$":
880          patternProperties:
881            "^event-(prox|touch)$":
882              properties:
883                azoteq,gpio-select:
884                  maxItems: 1
885                  items:
886                    maximum: 0
887
888        "^slider-[0-1]$":
889          properties:
890            azoteq,slider-size:
891              multipleOf: 16
892              minimum: 16
893              maximum: 4080
894
895            azoteq,top-speed:
896              multipleOf: 4
897              maximum: 1020
898
899          patternProperties:
900            "^event-(press|tap|(swipe|flick)-(pos|neg))$":
901              properties:
902                azoteq,gpio-select:
903                  maxItems: 1
904                  items:
905                    maximum: 0
906
907    else:
908      patternProperties:
909        "^slider-[0-1]$":
910          patternProperties:
911            "^event-(press|tap|(swipe|flick)-(pos|neg))$":
912              properties:
913                azoteq,gesture-max-ms: false
914
915                azoteq,gesture-min-ms: false
916
917                azoteq,gesture-dist: false
918
919required:
920  - compatible
921  - reg
922  - irq-gpios
923
924additionalProperties: false
925
926examples:
927  - |
928    #include <dt-bindings/gpio/gpio.h>
929    #include <dt-bindings/input/input.h>
930
931    i2c {
932            #address-cells = <1>;
933            #size-cells = <0>;
934
935            iqs7222a@44 {
936                    compatible = "azoteq,iqs7222a";
937                    reg = <0x44>;
938                    irq-gpios = <&gpio 4 GPIO_ACTIVE_LOW>;
939                    azoteq,lta-beta-lp = <7>;
940                    azoteq,lta-beta-np = <8>;
941                    azoteq,counts-beta-lp = <2>;
942                    azoteq,counts-beta-np = <3>;
943                    azoteq,lta-fast-beta-lp = <3>;
944                    azoteq,lta-fast-beta-np = <4>;
945
946                    cycle-0 {
947                            azoteq,conv-period = <5>;
948                            azoteq,conv-frac = <127>;
949                            azoteq,tx-enable = <1>, <2>, <4>, <5>;
950                            azoteq,dead-time-enable;
951                            azoteq,sense-mode = <2>;
952                    };
953
954                    cycle-1 {
955                            azoteq,conv-period = <5>;
956                            azoteq,conv-frac = <127>;
957                            azoteq,tx-enable = <5>;
958                            azoteq,dead-time-enable;
959                            azoteq,sense-mode = <2>;
960                    };
961
962                    cycle-2 {
963                            azoteq,conv-period = <5>;
964                            azoteq,conv-frac = <127>;
965                            azoteq,tx-enable = <4>;
966                            azoteq,dead-time-enable;
967                            azoteq,sense-mode = <2>;
968                    };
969
970                    cycle-3 {
971                            azoteq,conv-period = <5>;
972                            azoteq,conv-frac = <127>;
973                            azoteq,tx-enable = <2>;
974                            azoteq,dead-time-enable;
975                            azoteq,sense-mode = <2>;
976                    };
977
978                    cycle-4 {
979                            azoteq,conv-period = <5>;
980                            azoteq,conv-frac = <127>;
981                            azoteq,tx-enable = <1>;
982                            azoteq,dead-time-enable;
983                            azoteq,sense-mode = <2>;
984                    };
985
986                    cycle-5 {
987                            azoteq,conv-period = <2>;
988                            azoteq,conv-frac = <0>;
989                    };
990
991                    cycle-6 {
992                            azoteq,conv-period = <2>;
993                            azoteq,conv-frac = <0>;
994                    };
995
996                    channel-0 {
997                            azoteq,ulp-allow;
998                            azoteq,global-halt;
999                            azoteq,invert-enable;
1000                            azoteq,rx-enable = <3>;
1001                            azoteq,ati-target = <800>;
1002                            azoteq,ati-base = <208>;
1003                            azoteq,ati-mode = <5>;
1004                    };
1005
1006                    channel-1 {
1007                            azoteq,global-halt;
1008                            azoteq,invert-enable;
1009                            azoteq,rx-enable = <3>;
1010                            azoteq,ati-target = <496>;
1011                            azoteq,ati-base = <208>;
1012                            azoteq,ati-mode = <5>;
1013                    };
1014
1015                    channel-2 {
1016                            azoteq,global-halt;
1017                            azoteq,invert-enable;
1018                            azoteq,rx-enable = <3>;
1019                            azoteq,ati-target = <496>;
1020                            azoteq,ati-base = <208>;
1021                            azoteq,ati-mode = <5>;
1022                    };
1023
1024                    channel-3 {
1025                            azoteq,global-halt;
1026                            azoteq,invert-enable;
1027                            azoteq,rx-enable = <3>;
1028                            azoteq,ati-target = <496>;
1029                            azoteq,ati-base = <208>;
1030                            azoteq,ati-mode = <5>;
1031                    };
1032
1033                    channel-4 {
1034                            azoteq,global-halt;
1035                            azoteq,invert-enable;
1036                            azoteq,rx-enable = <3>;
1037                            azoteq,ati-target = <496>;
1038                            azoteq,ati-base = <208>;
1039                            azoteq,ati-mode = <5>;
1040                    };
1041
1042                    channel-5 {
1043                            azoteq,ulp-allow;
1044                            azoteq,global-halt;
1045                            azoteq,invert-enable;
1046                            azoteq,rx-enable = <6>;
1047                            azoteq,ati-target = <800>;
1048                            azoteq,ati-base = <144>;
1049                            azoteq,ati-mode = <5>;
1050                    };
1051
1052                    channel-6 {
1053                            azoteq,global-halt;
1054                            azoteq,invert-enable;
1055                            azoteq,rx-enable = <6>;
1056                            azoteq,ati-target = <496>;
1057                            azoteq,ati-base = <160>;
1058                            azoteq,ati-mode = <5>;
1059
1060                            event-touch {
1061                                    linux,code = <KEY_MUTE>;
1062                            };
1063                    };
1064
1065                    channel-7 {
1066                            azoteq,global-halt;
1067                            azoteq,invert-enable;
1068                            azoteq,rx-enable = <6>;
1069                            azoteq,ati-target = <496>;
1070                            azoteq,ati-base = <160>;
1071                            azoteq,ati-mode = <5>;
1072
1073                            event-touch {
1074                                    linux,code = <KEY_VOLUMEDOWN>;
1075                            };
1076                    };
1077
1078                    channel-8 {
1079                            azoteq,global-halt;
1080                            azoteq,invert-enable;
1081                            azoteq,rx-enable = <6>;
1082                            azoteq,ati-target = <496>;
1083                            azoteq,ati-base = <160>;
1084                            azoteq,ati-mode = <5>;
1085
1086                            event-touch {
1087                                    linux,code = <KEY_VOLUMEUP>;
1088                            };
1089                    };
1090
1091                    channel-9 {
1092                            azoteq,global-halt;
1093                            azoteq,invert-enable;
1094                            azoteq,rx-enable = <6>;
1095                            azoteq,ati-target = <496>;
1096                            azoteq,ati-base = <160>;
1097                            azoteq,ati-mode = <5>;
1098
1099                            event-touch {
1100                                    linux,code = <KEY_POWER>;
1101                            };
1102                    };
1103
1104                    channel-10 {
1105                            azoteq,ulp-allow;
1106                            azoteq,ati-target = <496>;
1107                            azoteq,ati-base = <112>;
1108
1109                            event-touch {
1110                                    linux,code = <SW_LID>;
1111                                    linux,input-type = <EV_SW>;
1112                            };
1113                    };
1114
1115                    channel-11 {
1116                            azoteq,ati-target = <496>;
1117                            azoteq,ati-base = <112>;
1118                    };
1119
1120                    slider-0 {
1121                            azoteq,channel-select = <1>, <2>, <3>, <4>;
1122                            azoteq,slider-size = <4080>;
1123                            azoteq,upper-cal = <50>;
1124                            azoteq,lower-cal = <30>;
1125                            azoteq,top-speed = <200>;
1126                            azoteq,bottom-speed = <1>;
1127                            azoteq,bottom-beta = <3>;
1128
1129                            event-tap {
1130                                    linux,code = <KEY_PLAYPAUSE>;
1131                                    azoteq,gesture-max-ms = <400>;
1132                                    azoteq,gesture-min-ms = <32>;
1133                            };
1134
1135                            event-flick-pos {
1136                                    linux,code = <KEY_NEXTSONG>;
1137                                    azoteq,gesture-max-ms = <800>;
1138                                    azoteq,gesture-dist = <800>;
1139                            };
1140
1141                            event-flick-neg {
1142                                    linux,code = <KEY_PREVIOUSSONG>;
1143                            };
1144                    };
1145            };
1146    };
1147
1148...
1149