iio: ABI: stm32-timer-trigger: Fuse unusual ABI into main doc.

We can't duplicate the description of sampling_frequency. This device
has some unusual requirements which we solved by giving a
sampling_frequency of 0 special meaning. As such add a note
about this unusual usage to the main documentation.

Whilst I don't particularly like this resolution, it is the best
I could come up with given earlier discussion on this topic.

Link: https://lore.kernel.org/linux-iio/20210315101217.00002c50@Huawei.com/
Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
Cc: Fabrice Gasnier <fabrice.gasnier@foss.st.com>
Reviewed-by: Mauro Carvalho Chehab <mchehab@kernel.org>
Link: https://lore.kernel.org/r/20220626165511.602202-4-jic23@kernel.org

diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio
index 3e00d7f..e81ba6f 100644 (file)
--- a/Documentation/ABI/testing/sysfs-bus-iio
+++ b/Documentation/ABI/testing/sysfs-bus-iio
@@ -107,6 +107,9 @@ Description:
                relevant directories.  If it affects all of the above
                then it is to be found in the base device directory.
 
+               The stm32-timer-trigger has the additional characteristic that
+               a sampling_frequency of 0 is defined to stop sampling.
+
 What:          /sys/bus/iio/devices/iio:deviceX/sampling_frequency_available
 What:          /sys/bus/iio/devices/iio:deviceX/in_intensity_sampling_frequency_available
 What:          /sys/bus/iio/devices/iio:deviceX/in_proximity_sampling_frequency_available

diff --git a/Documentation/ABI/testing/sysfs-bus-iio-timer-stm32 b/Documentation/ABI/testing/sysfs-bus-iio-timer-stm32
index c4a4497..05074c4 100644 (file)
--- a/Documentation/ABI/testing/sysfs-bus-iio-timer-stm32
+++ b/Documentation/ABI/testing/sysfs-bus-iio-timer-stm32
@@ -90,14 +90,6 @@ Description:
                Reading returns the current master modes.
                Writing set the master mode
 
-What:          /sys/bus/iio/devices/triggerX/sampling_frequency
-KernelVersion: 4.11
-Contact:       benjamin.gaignard@st.com
-Description:
-               Reading returns the current sampling frequency.
-               Writing an value different of 0 set and start sampling.
-               Writing 0 stop sampling.
-
 What:          /sys/bus/iio/devices/iio:deviceX/in_count0_preset
 KernelVersion: 4.12
 Contact:       benjamin.gaignard@st.com