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 };