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,sx9310.yaml (3357B)


      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,sx9310.yaml#
      5$schema: http://devicetree.org/meta-schemas/core.yaml#
      6
      7title: Semtech's SX9310 capacitive proximity sensor
      8
      9maintainers:
     10  - Daniel Campello <campello@chromium.org>
     11
     12description: |
     13  Semtech's SX9310/SX9311 capacitive proximity/button solution.
     14
     15  Specifications about the devices can be found at:
     16  https://www.semtech.com/products/smart-sensing/sar-sensors/sx9310
     17
     18properties:
     19  compatible:
     20    enum:
     21      - semtech,sx9310
     22      - semtech,sx9311
     23
     24  reg:
     25    maxItems: 1
     26
     27  interrupts:
     28    description:
     29      The sole interrupt generated by the device used to announce the
     30      preceding reading request has finished and that data is
     31      available or that a close/far proximity event has happened.
     32    maxItems: 1
     33
     34  vdd-supply:
     35    description: Main power supply
     36
     37  svdd-supply:
     38    description: Host interface power supply
     39
     40  "#io-channel-cells":
     41    const: 1
     42
     43  semtech,cs0-ground:
     44    description: Indicates the CS0 sensor is connected to ground.
     45    type: boolean
     46
     47  semtech,combined-sensors:
     48    $ref: /schemas/types.yaml#/definitions/uint32-array
     49    description: |
     50      List of which sensors are combined and represented by CS3.
     51      Possible values are -
     52      3        - CS3 (internal)
     53      0 1      - CS0 + CS1
     54      1 2      - CS1 + CS2 (default)
     55      0 1 2 3  - CS0 + CS1 + CS2 + CS3
     56    items:
     57      enum: [ 0, 1, 2, 3 ]
     58    minItems: 1
     59    maxItems: 4
     60
     61  semtech,resolution:
     62    description:
     63      Capacitance measure resolution. Refer to datasheet for more details.
     64    enum:
     65      - coarsest
     66      - very-coarse
     67      - coarse
     68      - medium-coarse
     69      - medium
     70      - fine
     71      - very-fine
     72      - finest
     73
     74  semtech,startup-sensor:
     75    $ref: /schemas/types.yaml#/definitions/uint32
     76    enum: [0, 1, 2, 3]
     77    default: 0
     78    description:
     79      Sensor used for start-up proximity detection. The combined
     80      sensor is represented by the value 3. This is used for initial
     81      compensation.
     82
     83  semtech,proxraw-strength:
     84    $ref: /schemas/types.yaml#/definitions/uint32
     85    enum: [0, 2, 4, 8]
     86    default: 2
     87    description:
     88      PROXRAW filter strength. A value of 0 represents off, and other values
     89      represent 1-1/N.
     90
     91  semtech,avg-pos-strength:
     92    $ref: /schemas/types.yaml#/definitions/uint32
     93    enum: [0, 16, 64, 128, 256, 512, 1024, 4294967295]
     94    default: 16
     95    description:
     96      Average positive filter strength. A value of 0 represents off and
     97      UINT_MAX (4294967295) represents infinite. Other values
     98      represent 1-1/N.
     99
    100required:
    101  - compatible
    102  - reg
    103  - "#io-channel-cells"
    104
    105additionalProperties: false
    106
    107examples:
    108  - |
    109    #include <dt-bindings/interrupt-controller/irq.h>
    110    i2c {
    111      #address-cells = <1>;
    112      #size-cells = <0>;
    113      proximity@28 {
    114        compatible = "semtech,sx9310";
    115        reg = <0x28>;
    116        interrupt-parent = <&pio>;
    117        interrupts = <5 IRQ_TYPE_LEVEL_LOW 5>;
    118        vdd-supply = <&pp3300_a>;
    119        svdd-supply = <&pp1800_prox>;
    120        #io-channel-cells = <1>;
    121        semtech,cs0-ground;
    122        semtech,combined-sensors = <1 2 3>;
    123        semtech,resolution = "fine";
    124        semtech,startup-sensor = <1>;
    125        semtech,proxraw-strength = <2>;
    126        semtech,avg-pos-strength = <64>;
    127      };
    128    };