[1/2] dt-bindings: iio: sx9310: Add close/far debouncer strength

Commit Message

Gwendal Grignou March 28, 2021, 3:36 a.m. UTC

Debouncer are used to prevent false positive: only when N measurement
are above/below the far/close threshold an event is sent to the host.

Define 2 new entries: a close and far debouncer.

Signed-off-by: Gwendal Grignou <[e-mail]>
---
 .../bindings/iio/proximity/semtech,sx9310.yaml | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

Patch

diff --git a/Documentation/devicetree/bindings/iio/proximity/semtech,sx9310.yaml b/Documentation/devicetree/bindings/iio/proximity/semtech,sx9310.yaml
index ccfb163f3d341..f2656f87e2c44 100644
--- a/Documentation/devicetree/bindings/iio/proximity/semtech,sx9310.yaml
+++ b/Documentation/devicetree/bindings/iio/proximity/semtech,sx9310.yaml
@@ -97,6 +97,24 @@  properties:
       UINT_MAX (4294967295) represents infinite. Other values
       represent 1-1/N.
 
+  semtech,close-debouncer-depth:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    enum: [0, 2, 4, 8]
+    default: 0
+    description:
+      Number of samples need to trigger a transition from far to close event.
+      0 disables the debouncer, N is the number of samples needed under the
+      proximity threshold to trigger an event.
+
+  semtech,far-debouncer-depth:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    enum: [0, 2, 4, 8]
+    default: 0
+    description:
+      Number of samples need to trigger a transition from close to far event.
+      0 disables the debouncer, N is the number of samples needed above the
+      proximity threshold to trigger an event.
+
 required:
   - compatible
   - reg