xref: /linux/Documentation/devicetree/bindings/iio/proximity/awinic,aw96103.yaml (revision 566ab427f827b0256d3e8ce0235d088e6a9c28bd)
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/awinic,aw96103.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Awinic's AW96103 capacitive proximity sensor and similar
8
9maintainers:
10  - Wang Shuaijie <wangshuaijie@awinic.com>
11
12description: |
13  Awinic's AW96103/AW96105 proximity sensor.
14  The specific absorption rate (SAR) is a metric that measures
15  the degree of absorption of electromagnetic radiation emitted by
16  wireless devices, such as mobile phones and tablets, by human tissue.
17  In mobile phone applications, the proximity sensor is primarily
18  used to detect the proximity of the human body to the phone. When the
19  phone approaches the human body, it will actively reduce the transmit
20  power of the antenna to keep the SAR within a safe range. Therefore,
21  we also refer to the proximity sensor as a SAR sensor.
22
23properties:
24  compatible:
25    enum:
26      - awinic,aw96103
27      - awinic,aw96105
28
29  reg:
30    maxItems: 1
31
32  interrupts:
33    description:
34      Generated by the device to announce that a close/far
35      proximity event has happened.
36    maxItems: 1
37
38  vcc-supply: true
39
40required:
41  - compatible
42  - reg
43  - interrupts
44  - vcc-supply
45
46additionalProperties: false
47
48examples:
49  - |
50    #include <dt-bindings/interrupt-controller/irq.h>
51    i2c {
52        #address-cells = <1>;
53        #size-cells = <0>;
54        proximity@12 {
55            compatible = "awinic,aw96103";
56            reg = <0x12>;
57            interrupt-parent = <&gpio>;
58            interrupts = <23 IRQ_TYPE_EDGE_FALLING>;
59            vcc-supply = <&pp1800_prox>;
60        };
61    };
62