Back to home page

OSCL-LXR

 
 

    


0001 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
0002 %YAML 1.2
0003 ---
0004 $id: http://devicetree.org/schemas/iio/proximity/semtech,sx9360.yaml#
0005 $schema: http://devicetree.org/meta-schemas/core.yaml#
0006 
0007 title: Semtech's SX9360 capacitive proximity sensor
0008 
0009 maintainers:
0010   - Gwendal Grignou <gwendal@chromium.org>
0011   - Daniel Campello <campello@chromium.org>
0012 
0013 description: |
0014   Semtech's SX9360 proximity sensor.
0015 
0016 properties:
0017   compatible:
0018     const: semtech,sx9360
0019 
0020   reg:
0021     maxItems: 1
0022 
0023   interrupts:
0024     description:
0025       Generated by device to announce preceding read request has finished
0026       and data is available or that a close/far proximity event has happened.
0027     maxItems: 1
0028 
0029   vdd-supply:
0030     description: Main power supply
0031 
0032   svdd-supply:
0033     description: Host interface power supply
0034 
0035   "#io-channel-cells":
0036     const: 1
0037 
0038   semtech,resolution:
0039     $ref: /schemas/types.yaml#/definitions/uint32-array
0040     enum: [8, 16, 32, 64, 128, 256, 512, 1024]
0041     description:
0042       Capacitance measurement resolution. For both phases, "reference" and
0043       "measurement". Higher the number, higher the resolution.
0044     default: 128
0045 
0046   semtech,proxraw-strength:
0047     $ref: /schemas/types.yaml#/definitions/uint32
0048     minimum: 0
0049     maximum: 7
0050     default: 1
0051     description:
0052       PROXRAW filter strength for both phases. A value of 0 represents off,
0053       and other values represent 1-1/2^N.
0054 
0055   semtech,avg-pos-strength:
0056     $ref: /schemas/types.yaml#/definitions/uint32
0057     enum: [0, 16, 64, 128, 256, 512, 1024, 4294967295]
0058     default: 16
0059     description: |
0060       Average positive filter strength. A value of 0 represents off and
0061       UINT_MAX (4294967295) represents infinite. Other values
0062       represent 1-1/N.
0063 
0064   semtech,input-precharge-resistor-ohms:
0065     default: 0
0066     multipleOf: 2000
0067     minimum: 0
0068     maximum: 30000
0069     description:
0070       Pre-charge input resistance in Ohm.
0071 
0072 required:
0073   - compatible
0074   - reg
0075   - "#io-channel-cells"
0076 
0077 additionalProperties: false
0078 
0079 examples:
0080   - |
0081     #include <dt-bindings/interrupt-controller/irq.h>
0082     i2c {
0083       #address-cells = <1>;
0084       #size-cells = <0>;
0085       proximity@28 {
0086         compatible = "semtech,sx9360";
0087         reg = <0x28>;
0088         interrupt-parent = <&pio>;
0089         interrupts = <5 IRQ_TYPE_LEVEL_LOW 5>;
0090         vdd-supply = <&pp3300_a>;
0091         svdd-supply = <&pp1800_prox>;
0092         #io-channel-cells = <1>;
0093         semtech,resolution = <256>;
0094         semtech,proxraw-strength = <2>;
0095         semtech,avg-pos-strength = <64>;
0096         semtech,input-precharge-resistor-ohms = <4000>;
0097       };
0098     };