All of lore.kernel.org
 help / color / mirror / Atom feed
From: Jonathan Cameron <jic23@kernel.org>
To: linux-iio@vger.kernel.org
Cc: Lars-Peter Clausen <lars@metafoo.de>,
	Michael Hennerich <Michael.Hennerich@analog.com>,
	Alexandru Ardelean <aardelean@deviqon.com>,
	Robh+dt@kernel.org, Alexandru Ardelean <ardeleanalex@gmail.com>,
	Jonathan Cameron <Jonathan.Cameron@huawei.com>
Subject: [PATCH v2 21/24] iio:Documentation:ABI Add missing elements as used by the adi,ad7150
Date: Sun, 14 Mar 2021 18:15:08 +0000	[thread overview]
Message-ID: <20210314181511.531414-22-jic23@kernel.org> (raw)
In-Reply-To: <20210314181511.531414-1-jic23@kernel.org>

From: Jonathan Cameron <Jonathan.Cameron@huawei.com>

Main additions are around thresh_adaptive.  This has been supported
by the core of IIO for a long time, but no driver that uses it has
previously graduated from staging, hence we are missing Docs.

Otherwise, just new entries in existing lists.

Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
Link: https://lore.kernel.org/r/20210207154623.433442-23-jic23@kernel.org
---
 Documentation/ABI/testing/sysfs-bus-iio | 33 +++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio
index affd4ce871d7..32d26c118141 100644
--- a/Documentation/ABI/testing/sysfs-bus-iio
+++ b/Documentation/ABI/testing/sysfs-bus-iio
@@ -371,6 +371,7 @@ What:		/sys/bus/iio/devices/iio:deviceX/in_humidityrelative_offset
 What:		/sys/bus/iio/devices/iio:deviceX/in_magn_offset
 What:		/sys/bus/iio/devices/iio:deviceX/in_rot_offset
 What:		/sys/bus/iio/devices/iio:deviceX/in_angl_offset
+What:		/sys/bus/iio/devices/iio:deviceX/in_capacitanceX_offset
 KernelVersion:	2.6.35
 Contact:	linux-iio@vger.kernel.org
 Description:
@@ -702,6 +703,8 @@ What:		/sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en
 What:		/sys/.../iio:deviceX/events/in_voltageY_thresh_either_en
 What:		/sys/.../iio:deviceX/events/in_tempY_thresh_rising_en
 What:		/sys/.../iio:deviceX/events/in_tempY_thresh_falling_en
+What:		/sys/.../iio:deviceX/events/in_capacitanceY_thresh_rising_en
+What:		/sys/.../iio:deviceX/events/in_capacitanceY_thresh_falling_en
 KernelVersion:	2.6.37
 Contact:	linux-iio@vger.kernel.org
 Description:
@@ -779,6 +782,32 @@ Description:
 		a given event type is enabled a future point (and not those for
 		whatever event was previously enabled).
 
+What:		/sys/.../events/in_capacitanceY_adaptive_thresh_rising_en
+What:		/sys/.../events/in_capacitanceY_adaptive_thresh_falling_en
+KernelVersion:	5.11
+Contact:	linux-iio@vger.kernel.org
+Descrption:
+		Adaptive thresholds are similar to normal fixed thresholds
+		but the value is expressed as an offset from a value which
+		provides a low frequency approximation of the channel itself.
+		Thus these detect if a rapid change occurs in the specified
+		direction which crosses tracking value + offset.
+		Tracking value calculation is devices specific.
+
+What:		/sys/.../in_capacitanceY_adaptive_thresh_rising_timeout
+What:		/sys/.../in_capacitanceY_adaptive_thresh_falling_timeout
+KernelVersion:	5.11
+Contact:	linux-iio@vger.kernel.org
+Descrption:
+		When adaptive thresholds are used, the tracking signal
+		may adjust too slowly to step changes in the raw signal.
+		*_timeout (in seconds) specifies a time for which the
+		difference between the slow tracking signal and the raw
+		signal is allowed to remain out-of-range before a reset
+		event occurs in which the tracking signal is made equal
+		to the raw signal, allowing slow tracking to resume and the
+		adaptive threshold event detection to function as expected.
+
 What:		/sys/.../events/in_accel_thresh_rising_value
 What:		/sys/.../events/in_accel_thresh_falling_value
 What:		/sys/.../events/in_accel_x_raw_thresh_rising_value
@@ -819,6 +848,10 @@ What:		/sys/.../events/in_proximity0_thresh_falling_value
 What:		/sys/.../events/in_proximity0_thresh_rising_value
 What:		/sys/.../events/in_illuminance_thresh_rising_value
 What:		/sys/.../events/in_illuminance_thresh_falling_value
+What:		/sys/.../events/in_capacitanceY_thresh_rising_value
+What:		/sys/.../events/in_capacitanceY_thresh_falling_value
+What:		/sys/.../events/in_capacitanceY_thresh_adaptive_rising_value
+What:		/sys/.../events/in_capacitanceY_thresh_falling_rising_value
 KernelVersion:	2.6.37
 Contact:	linux-iio@vger.kernel.org
 Description:
-- 
2.30.2


  parent reply	other threads:[~2021-03-14 18:18 UTC|newest]

Thread overview: 37+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-03-14 18:14 [PATCH v2 00/24] staging:iio:cdc:ad7150: cleanup / fixup / graduate Jonathan Cameron
2021-03-14 18:14 ` [PATCH v2 01/24] staging:iio:cdc:ad7150: use swapped reads for i2c rather than open coding Jonathan Cameron
2021-03-14 18:14 ` [PATCH v2 02/24] staging:iio:cdc:ad7150: Remove magnitude adaptive events Jonathan Cameron
2021-03-14 18:14 ` [PATCH v2 03/24] staging:iio:cdc:ad7150: Refactor event parameter update Jonathan Cameron
2021-03-14 18:14 ` [PATCH v2 04/24] staging:iio:cdc:ad7150: Timeout register covers both directions so both need updating Jonathan Cameron
2021-03-14 18:14 ` [PATCH v2 05/24] staging:iio:cdc:ad7150: Drop platform data support Jonathan Cameron
2021-03-14 18:14 ` [PATCH v2 06/24] staging:iio:cdc:ad7150: Handle variation in chan_spec across device and irq present or not Jonathan Cameron
2021-03-14 18:14 ` [PATCH v2 07/24] staging:iio:cdc:ad7150: Simplify event handling by only using rising direction Jonathan Cameron
2021-03-14 18:14 ` [PATCH v2 08/24] staging:iio:cdc:ad7150: Drop noisy print in probe Jonathan Cameron
2021-03-14 18:14 ` [PATCH v2 09/24] staging:iio:cdc:ad7150: Add sampling_frequency support Jonathan Cameron
2021-03-14 18:14 ` [PATCH v2 10/24] iio:event: Add timeout event info type Jonathan Cameron
2021-03-14 18:14 ` [PATCH v2 11/24] staging:iio:cdc:ad7150: Change timeout units to seconds and use core support Jonathan Cameron
2021-03-14 18:14 ` [PATCH v2 12/24] staging:iio:cdc:ad7150: Rework interrupt handling Jonathan Cameron
2021-03-31  7:29   ` Alexandru Ardelean
2021-03-31 12:05     ` Jonathan Cameron
2021-04-01  7:42       ` Alexandru Ardelean
2021-03-14 18:15 ` [PATCH v2 13/24] staging:iio:cdc:ad7150: More consistent register and field naming Jonathan Cameron
2021-03-14 18:15 ` [PATCH v2 14/24] staging:iio:cdc:ad7150: Reorganize headers Jonathan Cameron
2021-03-14 18:15 ` [PATCH v2 15/24] staging:iio:cdc:ad7150: Tidy up local variable positioning Jonathan Cameron
2021-03-14 18:15 ` [PATCH v2 16/24] staging:iio:cdc:ad7150: Drop unnecessary block comments Jonathan Cameron
2021-03-14 18:15 ` [PATCH v2 17/24] staging:iio:cdc:ad7150: Shift the _raw readings by 4 bits Jonathan Cameron
2021-03-14 18:15 ` [PATCH v2 18/24] staging:iio:cdc:ad7150: Add scale and offset to info_mask_shared_by_type Jonathan Cameron
2021-03-14 18:15 ` [PATCH v2 19/24] staging:iio:cdc:ad7150: Really basic regulator support Jonathan Cameron
2021-03-14 18:15 ` [PATCH v2 20/24] staging:iio:cdc:ad7150: Add of_match_table Jonathan Cameron
2021-03-31  6:42   ` Alexandru Ardelean
2021-03-14 18:15 ` Jonathan Cameron [this message]
2021-03-31  6:45   ` [PATCH v2 21/24] iio:Documentation:ABI Add missing elements as used by the adi,ad7150 Alexandru Ardelean
2021-03-14 18:15 ` [PATCH v2 22/24] staging:iio:cdc:ad7150: Add copyright notice given substantial changes Jonathan Cameron
2021-03-14 18:15 ` [PATCH v2 23/24] dt-bindings:iio:cdc:adi,ad7150 binding doc Jonathan Cameron
2021-03-24 17:13   ` Rob Herring
2021-03-14 18:15 ` [PATCH v2 24/24] iio:cdc:ad7150: Move driver out of staging Jonathan Cameron
2021-03-29 15:30 ` [PATCH v2 00/24] staging:iio:cdc:ad7150: cleanup / fixup / graduate Jonathan Cameron
2021-03-29 15:36   ` Jonathan Cameron
2021-03-30 21:23     ` Song Bao Hua (Barry Song)
2021-03-31 12:13       ` Jonathan Cameron
2021-04-01 10:15         ` Song Bao Hua (Barry Song)
2021-04-01 13:05           ` Jonathan Cameron

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20210314181511.531414-22-jic23@kernel.org \
    --to=jic23@kernel.org \
    --cc=Jonathan.Cameron@huawei.com \
    --cc=Michael.Hennerich@analog.com \
    --cc=Robh+dt@kernel.org \
    --cc=aardelean@deviqon.com \
    --cc=ardeleanalex@gmail.com \
    --cc=lars@metafoo.de \
    --cc=linux-iio@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.