Documentation/devicetree/bindings/input/iqs626a.yaml

   1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/input/iqs626a.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Azoteq IQS626A Capacitive Touch Controller
   8
   9 maintainers:
  10   - Jeff LaBundy <jeff@labundy.com>
  11
  12 description: |
  13   The Azoteq IQS626A is a 14-channel capacitive touch controller that features
  14   additional Hall-effect and inductive sensing capabilities.
  15
  16   Link to datasheet: https://www.azoteq.com/
  17
  18 allOf:
  19   - $ref: touchscreen/touchscreen.yaml#
  20
  21 properties:
  22   compatible:
  23     const: azoteq,iqs626a
  24
  25   reg:
  26     maxItems: 1
  27
  28   interrupts:
  29     maxItems: 1
  30
  31   "#address-cells":
  32     const: 1
  33
  34   "#size-cells":
  35     const: 0
  36
  37   azoteq,suspend-mode:
  38     $ref: /schemas/types.yaml#/definitions/uint32
  39     enum: [0, 1, 2, 3]
  40     default: 0
  41     description: |
  42       Specifies the power mode during suspend as follows:
  43       0: Automatic (same as normal runtime, i.e. suspend/resume disabled)
  44       1: Low power (all sensing at a reduced reporting rate)
  45       2: Ultra-low power (ULP channel proximity sensing)
  46       3: Halt (no sensing)
  47
  48   azoteq,clk-div:
  49     type: boolean
  50     description: Divides the device's core clock by a factor of 4.
  51
  52   azoteq,ulp-enable:
  53     type: boolean
  54     description:
  55       Permits the device to automatically enter ultra-low-power mode from low-
  56       power mode.
  57
  58   azoteq,ulp-update:
  59     $ref: /schemas/types.yaml#/definitions/uint32
  60     enum: [0, 1, 2, 3, 4, 5, 6, 7]
  61     default: 3
  62     description: |
  63       Specifies the rate at which the trackpad, generic and Hall channels are
  64       updated during ultra-low-power mode as follows:
  65       0: 8
  66       1: 13
  67       2: 28
  68       3: 54
  69       4: 89
  70       5: 135
  71       6: 190
  72       7: 256
  73
  74   azoteq,ati-band-disable:
  75     type: boolean
  76     description: Disables the ATI band check.
  77
  78   azoteq,ati-lp-only:
  79     type: boolean
  80     description: Limits automatic ATI to low-power mode.
  81
  82   azoteq,gpio3-select:
  83     $ref: /schemas/types.yaml#/definitions/uint32
  84     enum: [0, 1, 2, 3, 4, 5, 6, 7]
  85     default: 1
  86     description: |
  87       Selects the channel or group of channels for which the GPIO3 pin
  88       represents touch state as follows:
  89       0: None
  90       1: ULP channel
  91       2: Trackpad
  92       3: Trackpad
  93       4: Generic channel 0
  94       5: Generic channel 1
  95       6: Generic channel 2
  96       7: Hall channel
  97
  98   azoteq,reseed-select:
  99     $ref: /schemas/types.yaml#/definitions/uint32
 100     enum: [0, 1, 2, 3]
 101     default: 0
 102     description: |
 103       Specifies the event(s) that prompt the device to reseed (i.e. reset the
 104       long-term average) of an associated channel as follows:
 105       0: None
 106       1: Proximity
 107       2: Proximity or touch
 108       3: Proximity, touch or deep touch
 109
 110   azoteq,thresh-extend:
 111     type: boolean
 112     description: Multiplies all touch and deep-touch thresholds by 4.
 113
 114   azoteq,tracking-enable:
 115     type: boolean
 116     description:
 117       Enables all associated channels to track their respective reference
 118       channels.
 119
 120   azoteq,reseed-offset:
 121     type: boolean
 122     description:
 123       Applies an 8-count offset to all long-term averages upon either ATI or
 124       reseed events.
 125
 126   azoteq,rate-np-ms:
 127     minimum: 0
 128     maximum: 255
 129     default: 150
 130     description: Specifies the report rate (in ms) during normal-power mode.
 131
 132   azoteq,rate-lp-ms:
 133     minimum: 0
 134     maximum: 255
 135     default: 150
 136     description: Specifies the report rate (in ms) during low-power mode.
 137
 138   azoteq,rate-ulp-ms:
 139     multipleOf: 16
 140     minimum: 0
 141     maximum: 4080
 142     default: 0
 143     description: Specifies the report rate (in ms) during ultra-low-power mode.
 144
 145   azoteq,timeout-pwr-ms:
 146     multipleOf: 512
 147     minimum: 0
 148     maximum: 130560
 149     default: 2560
 150     description:
 151       Specifies the length of time (in ms) to wait for an event before moving
 152       from normal-power mode to low-power mode, or (if 'azoteq,ulp-enable' is
 153       present) from low-power mode to ultra-low-power mode.
 154
 155   azoteq,timeout-lta-ms:
 156     multipleOf: 512
 157     minimum: 0
 158     maximum: 130560
 159     default: 40960
 160     description:
 161       Specifies the length of time (in ms) to wait before resetting the long-
 162       term average of all channels. Specify the maximum timeout to disable it
 163       altogether.
 164
 165   touchscreen-inverted-x: true
 166   touchscreen-inverted-y: true
 167   touchscreen-swapped-x-y: true
 168
 169 patternProperties:
 170   "^ulp-0|generic-[0-2]|hall$":
 171     type: object
 172     description:
 173       Represents a single sensing channel. A channel is active if defined and
 174       inactive otherwise.
 175
 176     properties:
 177       azoteq,ati-exclude:
 178         type: boolean
 179         description:
 180           Prevents the channel from participating in an ATI event that is
 181           manually triggered during initialization.
 182
 183       azoteq,reseed-disable:
 184         type: boolean
 185         description:
 186           Prevents the channel from being reseeded if the long-term average
 187           timeout (defined in 'azoteq,timeout-lta') expires.
 188
 189       azoteq,meas-cap-decrease:
 190         type: boolean
 191         description:
 192           Decreases the internal measurement capacitance from 60 pF to 15 pF.
 193
 194       azoteq,rx-inactive:
 195         $ref: /schemas/types.yaml#/definitions/uint32
 196         enum: [0, 1, 2]
 197         default: 0
 198         description: |
 199           Specifies how inactive CRX pins are to be terminated as follows:
 200           0: VSS
 201           1: Floating
 202           2: VREG (generic channels only)
 203
 204       azoteq,linearize:
 205         type: boolean
 206         description:
 207           Enables linearization of the channel's counts (generic and Hall
 208           channels) or inverts the polarity of the channel's proximity or
 209           touch states (ULP channel).
 210
 211       azoteq,dual-direction:
 212         type: boolean
 213         description:
 214           Specifies that the channel's long-term average is to freeze in the
 215           presence of either increasing or decreasing counts, thereby permit-
 216           ting events to be reported in either direction.
 217
 218       azoteq,filt-disable:
 219         type: boolean
 220         description: Disables raw count filtering for the channel.
 221
 222       azoteq,ati-mode:
 223         $ref: /schemas/types.yaml#/definitions/uint32
 224         enum: [0, 1, 2, 3]
 225         description: |
 226           Specifies the channel's ATI mode as follows:
 227           0: Disabled
 228           1: Semi-partial
 229           2: Partial
 230           3: Full
 231
 232           The default value is a function of the channel and the device's reset
 233           user interface (RUI); reference the datasheet for further information
 234           about the available RUI options.
 235
 236       azoteq,ati-base:
 237         $ref: /schemas/types.yaml#/definitions/uint32
 238         enum: [75, 100, 150, 200]
 239         description:
 240           Specifies the channel's ATI base. The default value is a function
 241           of the channel and the device's RUI.
 242
 243       azoteq,ati-target:
 244         $ref: /schemas/types.yaml#/definitions/uint32
 245         multipleOf: 32
 246         minimum: 0
 247         maximum: 2016
 248         description:
 249           Specifies the channel's ATI target. The default value is a function
 250           of the channel and the device's RUI.
 251
 252       azoteq,cct-increase:
 253         $ref: /schemas/types.yaml#/definitions/uint32
 254         minimum: 0
 255         maximum: 16
 256         default: 0
 257         description:
 258           Specifies the degree to which the channel's charge cycle time is to
 259           be increased, with 0 representing no increase. The maximum value is
 260           limited to 4 in the case of the ULP channel, and the property is un-
 261           available entirely in the case of the Hall channel.
 262
 263       azoteq,proj-bias:
 264         $ref: /schemas/types.yaml#/definitions/uint32
 265         enum: [0, 1, 2, 3]
 266         default: 0
 267         description: |
 268           Specifies the bias current applied during projected-capacitance
 269           sensing as follows:
 270           0: 2.5 uA
 271           1: 5 uA
 272           2: 10 uA
 273           3: 20 uA
 274
 275           This property is unavailable in the case of the Hall channel.
 276
 277       azoteq,sense-freq:
 278         $ref: /schemas/types.yaml#/definitions/uint32
 279         enum: [0, 1, 2, 3]
 280         description: |
 281           Specifies the channel's sensing frequency as follows (parenthesized
 282           numbers represent the frequency if 'azoteq,clk-div' is present):
 283           0: 4 MHz (1 MHz)
 284           1: 2 MHz (500 kHz)
 285           2: 1 MHz (250 kHz)
 286           3: 500 kHz (125 kHz)
 287
 288           This property is unavailable in the case of the Hall channel. The
 289           default value is a function of the channel and the device's RUI.
 290
 291       azoteq,ati-band-tighten:
 292         type: boolean
 293         description:
 294           Tightens the ATI band from 1/8 to 1/16 of the desired target (ULP and
 295           generic channels only).
 296
 297       azoteq,proj-enable:
 298         type: boolean
 299         description: Enables projected-capacitance sensing (ULP channel only).
 300
 301       azoteq,filt-str-np-cnt:
 302         $ref: /schemas/types.yaml#/definitions/uint32
 303         enum: [0, 1, 2, 3]
 304         default: 0
 305         description:
 306           Specifies the raw count filter strength during normal-power mode (ULP
 307           and generic channels only).
 308
 309       azoteq,filt-str-lp-cnt:
 310         $ref: /schemas/types.yaml#/definitions/uint32
 311         enum: [0, 1, 2, 3]
 312         default: 0
 313         description:
 314           Specifies the raw count filter strength during low-power mode (ULP and
 315           generic channels only).
 316
 317       azoteq,filt-str-np-lta:
 318         $ref: /schemas/types.yaml#/definitions/uint32
 319         enum: [0, 1, 2, 3]
 320         default: 0
 321         description:
 322           Specifies the long-term average filter strength during normal-power
 323           mode (ULP and generic channels only).
 324
 325       azoteq,filt-str-lp-lta:
 326         $ref: /schemas/types.yaml#/definitions/uint32
 327         enum: [0, 1, 2, 3]
 328         default: 0
 329         description:
 330           Specifies the long-term average filter strength during low-power mode
 331           (ULP and generic channels only).
 332
 333       azoteq,rx-enable:
 334         $ref: /schemas/types.yaml#/definitions/uint32-array
 335         minItems: 1
 336         maxItems: 8
 337         items:
 338           minimum: 0
 339           maximum: 7
 340         description:
 341           Specifies the CRX pin(s) associated with the channel.
 342
 343           This property is unavailable in the case of the Hall channel. The
 344           default value is a function of the channel and the device's RUI.
 345
 346       azoteq,tx-enable:
 347         $ref: /schemas/types.yaml#/definitions/uint32-array
 348         minItems: 1
 349         maxItems: 8
 350         items:
 351           minimum: 0
 352           maximum: 7
 353         description:
 354           Specifies the TX pin(s) associated with the channel.
 355
 356           This property is unavailable in the case of the Hall channel. The
 357           default value is a function of the channel and the device's RUI.
 358
 359       azoteq,local-cap-size:
 360         $ref: /schemas/types.yaml#/definitions/uint32
 361         enum: [0, 1, 2, 3, 4]
 362         default: 0
 363         description: |
 364           Specifies the capacitance to be added to the channel as follows:
 365           0: 0 pF
 366           1: 0.5 pF
 367           2: 1.0 pF
 368           3: 1.5 pF
 369           4: 2.0 pF
 370
 371           This property is unavailable in the case of the ULP or Hall channels.
 372
 373       azoteq,sense-mode:
 374         $ref: /schemas/types.yaml#/definitions/uint32
 375         enum: [0, 1, 8, 9, 12, 14, 15]
 376         description: |
 377           Specifies the channel's sensing mode as follows:
 378           0:  Self capacitance
 379           1:  Projected capacitance
 380           8:  Self inductance
 381           9:  Mutual inductance
 382           12: External
 383           14: Hall effect
 384           15: Temperature
 385
 386           This property is unavailable in the case of the ULP or Hall channels.
 387           The default value is a function of the channel and the device's RUI.
 388
 389       azoteq,tx-freq:
 390         $ref: /schemas/types.yaml#/definitions/uint32
 391         enum: [0, 1, 2, 3]
 392         default: 0
 393         description: |
 394           Specifies the inductive sensing excitation frequency as follows
 395           (parenthesized numbers represent the frequency if 'azoteq,clk-div'
 396           is present):
 397           0: 16 MHz (4 MHz)
 398           1: 8 MHz (2 MHz)
 399           2: 4 MHz (1 MHz)
 400           3: 2 MHz (500 kHz)
 401
 402           This property is unavailable in the case of the ULP or Hall channels.
 403
 404       azoteq,invert-enable:
 405         type: boolean
 406         description:
 407           Inverts the polarity of the states reported for proximity, touch and
 408           deep-touch events relative to their respective thresholds (generic
 409           channels only).
 410
 411       azoteq,comp-disable:
 412         type: boolean
 413         description:
 414           Disables compensation for the channel (generic channels only).
 415
 416       azoteq,static-enable:
 417         type: boolean
 418         description:
 419           Enables the static front-end for the channel (generic channels only).
 420
 421       azoteq,assoc-select:
 422         $ref: /schemas/types.yaml#/definitions/string-array
 423         minItems: 1
 424         maxItems: 6
 425         items:
 426           enum:
 427             - ulp-0
 428             - trackpad-3x2
 429             - trackpad-3x3
 430             - generic-0
 431             - generic-1
 432             - generic-2
 433             - hall
 434         description:
 435           Specifies the associated channels for which the channel serves as a
 436           reference channel. By default, no channels are selected. This prop-
 437           erty is only available for the generic channels.
 438
 439       azoteq,assoc-weight:
 440         $ref: /schemas/types.yaml#/definitions/uint32
 441         minimum: 0
 442         maximum: 255
 443         default: 0
 444         description:
 445           Specifies the channel's impact weight if it acts as an associated
 446           channel (0 = 0% impact, 255 = 200% impact). This property is only
 447           available for the generic channels.
 448
 449     patternProperties:
 450       "^event-(prox|touch|deep)(-alt)?$":
 451         type: object
 452         $ref: input.yaml#
 453         description:
 454           Represents a proximity, touch or deep-touch event reported by the
 455           channel in response to a decrease in counts. Node names suffixed with
 456           '-alt' instead correspond to an increase in counts.
 457
 458           By default, the long-term average tracks an increase in counts such
 459           that only events corresponding to a decrease in counts are reported
 460           (refer to the datasheet for more information).
 461
 462           Specify 'azoteq,dual-direction' to freeze the long-term average when
 463           the counts increase or decrease such that events of either direction
 464           can be reported. Alternatively, specify 'azoteq,invert-enable' to in-
 465           vert the polarity of the states reported by the channel.
 466
 467           Complementary events (e.g. event-touch and event-touch-alt) can both
 468           be present and specify different key or switch codes, but not differ-
 469           ent thresholds or hysteresis (if applicable).
 470
 471           Proximity events are unavailable in the case of the Hall channel, and
 472           deep-touch events are only available for the generic channels. Unless
 473           otherwise specified, default values are a function of the channel and
 474           the device's RUI.
 475
 476         properties:
 477           azoteq,thresh:
 478             $ref: /schemas/types.yaml#/definitions/uint32
 479             minimum: 0
 480             maximum: 255
 481             description: Specifies the threshold for the event.
 482
 483           azoteq,hyst:
 484             $ref: /schemas/types.yaml#/definitions/uint32
 485             minimum: 0
 486             maximum: 15
 487             description:
 488               Specifies the hysteresis for the event (touch and deep-touch
 489               events only).
 490
 491           linux,code: true
 492
 493           linux,input-type:
 494             enum: [1, 5]
 495             description:
 496               Specifies whether the event is to be interpreted as a key (1) or
 497               a switch (5). By default, Hall-channel events are interpreted as
 498               switches and all others are interpreted as keys.
 499
 500         additionalProperties: false
 501
 502     dependencies:
 503       azoteq,assoc-weight: ["azoteq,assoc-select"]
 504
 505     additionalProperties: false
 506
 507   "^trackpad-3x[2-3]$":
 508     type: object
 509     $ref: input.yaml#
 510     description:
 511       Represents all channels associated with the trackpad. The channels are
 512       collectively active if the trackpad is defined and inactive otherwise.
 513
 514     properties:
 515       azoteq,ati-exclude:
 516         type: boolean
 517         description:
 518           Prevents the trackpad channels from participating in an ATI event
 519           that is manually triggered during initialization.
 520
 521       azoteq,reseed-disable:
 522         type: boolean
 523         description:
 524           Prevents the trackpad channels from being reseeded if the long-term
 525           average timeout (defined in 'azoteq,timeout-lta') expires.
 526
 527       azoteq,meas-cap-decrease:
 528         type: boolean
 529         description:
 530           Decreases the internal measurement capacitance from 60 pF to 15 pF.
 531
 532       azoteq,rx-inactive:
 533         $ref: /schemas/types.yaml#/definitions/uint32
 534         enum: [0, 1]
 535         default: 0
 536         description: |
 537           Specifies how inactive CRX pins are to be terminated as follows:
 538           0: VSS
 539           1: Floating
 540
 541       azoteq,linearize:
 542         type: boolean
 543         description: Inverts the polarity of the trackpad's touch state.
 544
 545       azoteq,dual-direction:
 546         type: boolean
 547         description:
 548           Specifies that the trackpad's long-term averages are to freeze in
 549           the presence of either increasing or decreasing counts, thereby
 550           permitting events to be reported in either direction.
 551
 552       azoteq,filt-disable:
 553         type: boolean
 554         description: Disables raw count filtering for the trackpad channels.
 555
 556       azoteq,ati-mode:
 557         $ref: /schemas/types.yaml#/definitions/uint32
 558         enum: [0, 1, 2, 3]
 559         default: 0
 560         description: |
 561           Specifies the trackpad's ATI mode as follows:
 562           0: Disabled
 563           1: Semi-partial
 564           2: Partial
 565           3: Full
 566
 567       azoteq,ati-base:
 568         $ref: /schemas/types.yaml#/definitions/uint32-array
 569         minItems: 6
 570         maxItems: 9
 571         items:
 572           minimum: 45
 573           maximum: 300
 574         default: [45, 45, 45, 45, 45, 45, 45, 45, 45]
 575         description: Specifies each individual trackpad channel's ATI base.
 576
 577       azoteq,ati-target:
 578         $ref: /schemas/types.yaml#/definitions/uint32
 579         multipleOf: 32
 580         minimum: 0
 581         maximum: 2016
 582         default: 0
 583         description: Specifies the trackpad's ATI target.
 584
 585       azoteq,cct-increase:
 586         $ref: /schemas/types.yaml#/definitions/uint32
 587         minimum: 0
 588         maximum: 4
 589         default: 0
 590         description:
 591           Specifies the degree to which the trackpad's charge cycle time is to
 592           be increased, with 0 representing no increase.
 593
 594       azoteq,proj-bias:
 595         $ref: /schemas/types.yaml#/definitions/uint32
 596         enum: [0, 1, 2, 3]
 597         default: 0
 598         description: |
 599           Specifies the bias current applied during projected-capacitance
 600           sensing as follows:
 601           0: 2.5 uA
 602           1: 5 uA
 603           2: 10 uA
 604           3: 20 uA
 605
 606       azoteq,sense-freq:
 607         $ref: /schemas/types.yaml#/definitions/uint32
 608         enum: [0, 1, 2, 3]
 609         default: 0
 610         description: |
 611           Specifies the trackpad's sensing frequency as follows (parenthesized
 612           numbers represent the frequency if 'azoteq,clk-div' is present):
 613           0: 4 MHz (1 MHz)
 614           1: 2 MHz (500 kHz)
 615           2: 1 MHz (250 kHz)
 616           3: 500 kHz (125 kHz)
 617
 618       azoteq,ati-band-tighten:
 619         type: boolean
 620         description:
 621           Tightens the ATI band from 1/8 to 1/16 of the desired target.
 622
 623       azoteq,thresh:
 624         $ref: /schemas/types.yaml#/definitions/uint32-array
 625         minItems: 6
 626         maxItems: 9
 627         items:
 628           minimum: 0
 629           maximum: 255
 630         default: [0, 0, 0, 0, 0, 0, 0, 0, 0]
 631         description:
 632           Specifies each individual trackpad channel's touch threshold.
 633
 634       azoteq,hyst:
 635         $ref: /schemas/types.yaml#/definitions/uint32
 636         minimum: 0
 637         maximum: 15
 638         default: 0
 639         description: Specifies the trackpad's touch hysteresis.
 640
 641       azoteq,lta-update:
 642         $ref: /schemas/types.yaml#/definitions/uint32
 643         enum: [0, 1, 2, 3, 4, 5, 6, 7]
 644         default: 0
 645         description: |
 646           Specifies the update rate of the trackpad's long-term average during
 647           ultra-low-power mode as follows:
 648           0: 2
 649           1: 4
 650           2: 8
 651           3: 16
 652           4: 32
 653           5: 64
 654           6: 128
 655           7: 255
 656
 657       azoteq,filt-str-trackpad:
 658         $ref: /schemas/types.yaml#/definitions/uint32
 659         enum: [0, 1, 2, 3]
 660         default: 0
 661         description: Specifies the trackpad coordinate filter strength.
 662
 663       azoteq,filt-str-np-cnt:
 664         $ref: /schemas/types.yaml#/definitions/uint32
 665         enum: [0, 1, 2, 3]
 666         default: 0
 667         description:
 668           Specifies the raw count filter strength during normal-power mode.
 669
 670       azoteq,filt-str-lp-cnt:
 671         $ref: /schemas/types.yaml#/definitions/uint32
 672         enum: [0, 1, 2, 3]
 673         default: 0
 674         description:
 675           Specifies the raw count filter strength during low-power mode.
 676
 677       linux,keycodes:
 678         minItems: 1
 679         maxItems: 6
 680         description: |
 681           Specifies the numeric keycodes associated with each available gesture
 682           in the following order (enter 0 for unused gestures):
 683           0: Positive flick or swipe in X direction
 684           1: Negative flick or swipe in X direction
 685           2: Positive flick or swipe in Y direction
 686           3: Negative flick or swipe in Y direction
 687           4: Tap
 688           5: Hold
 689
 690       azoteq,gesture-swipe:
 691         type: boolean
 692         description:
 693           Directs the device to interpret axial gestures as a swipe (finger
 694           remains on trackpad) instead of a flick (finger leaves trackpad).
 695
 696       azoteq,timeout-tap-ms:
 697         multipleOf: 16
 698         minimum: 0
 699         maximum: 4080
 700         default: 0
 701         description:
 702           Specifies the length of time (in ms) within which a trackpad touch
 703           must be released in order to be interpreted as a tap.
 704
 705       azoteq,timeout-swipe-ms:
 706         multipleOf: 16
 707         minimum: 0
 708         maximum: 4080
 709         default: 0
 710         description:
 711           Specifies the length of time (in ms) within which an axial gesture
 712           must be completed in order to be interpreted as a flick or swipe.
 713
 714       azoteq,thresh-swipe:
 715         $ref: /schemas/types.yaml#/definitions/uint32
 716         minimum: 0
 717         maximum: 255
 718         default: 0
 719         description:
 720           Specifies the number of points across which an axial gesture must
 721           travel in order to be interpreted as a flick or swipe.
 722
 723     dependencies:
 724       azoteq,gesture-swipe: ["linux,keycodes"]
 725       azoteq,timeout-tap-ms: ["linux,keycodes"]
 726       azoteq,timeout-swipe-ms: ["linux,keycodes"]
 727       azoteq,thresh-swipe: ["linux,keycodes"]
 728
 729     additionalProperties: false
 730
 731 required:
 732   - compatible
 733   - reg
 734   - interrupts
 735   - "#address-cells"
 736   - "#size-cells"
 737
 738 additionalProperties: false
 739
 740 examples:
 741   - |
 742     #include <dt-bindings/input/input.h>
 743     #include <dt-bindings/interrupt-controller/irq.h>
 744
 745     i2c {
 746             #address-cells = <1>;
 747             #size-cells = <0>;
 748
 749             touch@44 {
 750                     #address-cells = <1>;
 751                     #size-cells = <0>;
 752
 753                     compatible = "azoteq,iqs626a";
 754                     reg = <0x44>;
 755                     interrupt-parent = <&gpio>;
 756                     interrupts = <17 IRQ_TYPE_LEVEL_LOW>;
 757
 758                     azoteq,rate-np-ms = <16>;
 759                     azoteq,rate-lp-ms = <160>;
 760
 761                     azoteq,timeout-pwr-ms = <2560>;
 762                     azoteq,timeout-lta-ms = <32768>;
 763
 764                     ulp-0 {
 765                             azoteq,meas-cap-decrease;
 766
 767                             azoteq,ati-base = <75>;
 768                             azoteq,ati-target = <1024>;
 769
 770                             azoteq,rx-enable = <2>, <3>, <4>,
 771                                                <5>, <6>, <7>;
 772
 773                             event-prox {
 774                                     linux,code = <KEY_POWER>;
 775                             };
 776                     };
 777
 778                     trackpad-3x3 {
 779                             azoteq,filt-str-np-cnt = <1>;
 780                             azoteq,filt-str-lp-cnt = <1>;
 781
 782                             azoteq,hyst = <4>;
 783                             azoteq,thresh = <35>, <40>, <40>,
 784                                             <38>, <33>, <38>,
 785                                             <35>, <35>, <35>;
 786
 787                             azoteq,ati-mode = <3>;
 788                             azoteq,ati-base = <195>, <195>, <195>,
 789                                               <195>, <195>, <195>,
 790                                               <195>, <195>, <195>;
 791                             azoteq,ati-target = <512>;
 792
 793                             azoteq,proj-bias = <1>;
 794                             azoteq,sense-freq = <2>;
 795
 796                             linux,keycodes = <KEY_VOLUMEUP>,
 797                                              <KEY_VOLUMEDOWN>,
 798                                              <KEY_NEXTSONG>,
 799                                              <KEY_PREVIOUSSONG>,
 800                                              <KEY_PLAYPAUSE>,
 801                                              <KEY_STOPCD>;
 802
 803                             azoteq,gesture-swipe;
 804                             azoteq,timeout-swipe-ms = <800>;
 805                             azoteq,timeout-tap-ms = <400>;
 806                             azoteq,thresh-swipe = <40>;
 807                     };
 808
 809                     /*
 810                      * Preserve the default register settings for
 811                      * the temperature-tracking channel leveraged
 812                      * by reset user interface (RUI) 1.
 813                      *
 814                      * Scalar properties (e.g. ATI mode) are left
 815                      * untouched by simply omitting them; boolean
 816                      * properties must be specified explicitly as
 817                      * needed.
 818                      */
 819                     generic-2 {
 820                             azoteq,reseed-disable;
 821                             azoteq,meas-cap-decrease;
 822                             azoteq,dual-direction;
 823                             azoteq,comp-disable;
 824                             azoteq,static-enable;
 825                     };
 826
 827                     hall {
 828                             azoteq,reseed-disable;
 829                             azoteq,meas-cap-decrease;
 830
 831                             event-touch {
 832                                     linux,code = <SW_LID>;
 833                             };
 834                     };
 835             };
 836     };
 837
 838 ...