cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

semtech,sx9324.yaml (4417B)


      1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
      2%YAML 1.2
      3---
      4$id: http://devicetree.org/schemas/iio/proximity/semtech,sx9324.yaml#
      5$schema: http://devicetree.org/meta-schemas/core.yaml#
      6
      7title: Semtech's SX9324 capacitive proximity sensor
      8
      9maintainers:
     10  - Gwendal Grignou <gwendal@chromium.org>
     11  - Daniel Campello <campello@chromium.org>
     12
     13description: |
     14  Semtech's SX9324 proximity sensor.
     15
     16properties:
     17  compatible:
     18    const: semtech,sx9324
     19
     20  reg:
     21    maxItems: 1
     22
     23  interrupts:
     24    description:
     25      Generated by device to announce preceding read request has finished
     26      and data is available or that a close/far proximity event has happened.
     27    maxItems: 1
     28
     29  vdd-supply:
     30    description: Main power supply
     31
     32  svdd-supply:
     33    description: Host interface power supply
     34
     35  "#io-channel-cells":
     36    const: 1
     37
     38  semtech,ph0-pin:
     39    $ref: /schemas/types.yaml#/definitions/uint32-array
     40    description: |
     41      Array of 3 entries. Index represent the id of the CS pin.
     42      Value indicates how each CS pin is used during phase 0.
     43      Each of the 3 pins have the following value -
     44      0 : unused (high impedance)
     45      1 : measured input
     46      2 : dynamic shield
     47      3 : grounded.
     48      For instance, CS0 measured, CS1 shield and CS2 ground is [1, 2, 3]
     49    items:
     50      enum: [ 0, 1, 2, 3 ]
     51    minItems: 3
     52    maxItems: 3
     53
     54  semtech,ph1-pin:
     55    $ref: /schemas/types.yaml#/definitions/uint32-array
     56    description: Same as ph0-pin for phase 1.
     57    items:
     58      enum: [ 0, 1, 2, 3 ]
     59    minItems: 3
     60    maxItems: 3
     61
     62  semtech,ph2-pin:
     63    $ref: /schemas/types.yaml#/definitions/uint32-array
     64    description: Same as ph0-pin for phase 2.
     65    items:
     66      enum: [ 0, 1, 2, 3 ]
     67    minItems: 3
     68    maxItems: 3
     69
     70  semtech,ph3-pin:
     71    $ref: /schemas/types.yaml#/definitions/uint32-array
     72    description: Same as ph0-pin for phase 3.
     73    items:
     74      enum: [ 0, 1, 2, 3 ]
     75    minItems: 3
     76    maxItems: 3
     77
     78
     79  semtech,ph01-resolution:
     80    $ref: /schemas/types.yaml#/definitions/uint32
     81    enum: [8, 16, 32, 64, 128, 256, 512, 1024]
     82    description:
     83      Capacitance measurement resolution. For phase 0 and 1.
     84      Higher the number, higher the resolution.
     85    default: 128
     86
     87  semtech,ph23-resolution:
     88    $ref: /schemas/types.yaml#/definitions/uint32
     89    enum: [8, 16, 32, 64, 128, 256, 512, 1024]
     90    description:
     91      Capacitance measurement resolution. For phase 2 and 3
     92    default: 128
     93
     94  semtech,startup-sensor:
     95    $ref: /schemas/types.yaml#/definitions/uint32
     96    enum: [0, 1, 2, 3]
     97    default: 0
     98    description: |
     99      Phase used for start-up proximity detection.
    100      It is used when we enable a phase to remove static offset and measure
    101      only capacitance changes introduced by the user.
    102
    103  semtech,ph01-proxraw-strength:
    104    $ref: /schemas/types.yaml#/definitions/uint32
    105    minimum: 0
    106    maximum: 7
    107    default: 1
    108    description:
    109      PROXRAW filter strength for phase 0 and 1. A value of 0 represents off,
    110      and other values represent 1-1/2^N.
    111
    112  semtech,ph23-proxraw-strength:
    113    $ref: /schemas/types.yaml#/definitions/uint32
    114    minimum: 0
    115    maximum: 7
    116    default: 1
    117    description:
    118      Same as proxraw-strength01, for phase 2 and 3.
    119
    120  semtech,avg-pos-strength:
    121    $ref: /schemas/types.yaml#/definitions/uint32
    122    enum: [0, 16, 64, 128, 256, 512, 1024, 4294967295]
    123    default: 16
    124    description: |
    125      Average positive filter strength. A value of 0 represents off and
    126      UINT_MAX (4294967295) represents infinite. Other values
    127      represent 1-1/N.
    128
    129required:
    130  - compatible
    131  - reg
    132  - "#io-channel-cells"
    133
    134additionalProperties: false
    135
    136examples:
    137  - |
    138    #include <dt-bindings/interrupt-controller/irq.h>
    139    i2c {
    140      #address-cells = <1>;
    141      #size-cells = <0>;
    142      proximity@28 {
    143        compatible = "semtech,sx9324";
    144        reg = <0x28>;
    145        interrupt-parent = <&pio>;
    146        interrupts = <5 IRQ_TYPE_LEVEL_LOW 5>;
    147        vdd-supply = <&pp3300_a>;
    148        svdd-supply = <&pp1800_prox>;
    149        #io-channel-cells = <1>;
    150        semtech,ph0-pin = <1 2 3>;
    151        semtech,ph1-pin = <3 2 1>;
    152        semtech,ph2-pin = <1 2 3>;
    153        semtech,ph3-pin = <3 2 1>;
    154        semtech,ph01-resolution = <256>;
    155        semtech,ph23-resolution = <256>;
    156        semtech,startup-sensor = <1>;
    157        semtech,ph01-proxraw-strength = <2>;
    158        semtech,ph23-proxraw-strength = <2>;
    159        semtech,avg-pos-strength = <64>;
    160      };
    161    };