Some devices have an internal clock used to space out the conversion
trigger for the oversampling filter, Consider an ADC with conversion and
data ready pins topology:
Sampling trigger | | | | |
ADC conversion ++++ ++++ ++++ ++++ ++++
ADC data ready * * * * *
With the oversampling frequency, conversions are spaced:
Sampling trigger | | | | |
ADC conversion + + + + + + + + + + + + + + + + + + + +
ADC data ready * * * * *
In some devices and ranges, this internal clock can be used to evenly
space the conversions between the sampling edge. In other devices the
oversampling frequency is fixed or is computed based on the sampling
frequency parameter, and the parameter is read only.
Signed-off-by: Jorge Marques <jorge.marques@analog.com>
---
Documentation/ABI/testing/sysfs-bus-iio | 17 +++++++++++++++++
1 file changed, 17 insertions(+)
diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio
index ef52c427a015cf47bb9847782e13afbee01e9f31..e60367255be89a9acc827ec1a749b729735f60e6 100644
--- a/Documentation/ABI/testing/sysfs-bus-iio
+++ b/Documentation/ABI/testing/sysfs-bus-iio
@@ -139,6 +139,23 @@ Contact: linux-iio@vger.kernel.org
Description:
Hardware dependent values supported by the oversampling filter.
+What: /sys/bus/iio/devices/iio:deviceX/oversampling_frequency
+KernelVersion: 6.17
+Contact: linux-iio@vger.kernel.org
+Description:
+ Some devices have internal clocks for oversampling.
+ Sets the resulting frequency in Hz to trigger a conversion used by
+ the oversampling filter.
+ If the device has a fixed internal clock or is computed based on
+ the sampling frequency parameter, the parameter is read only.
+
+What: /sys/bus/iio/devices/iio:deviceX/oversampling_frequency_available
+KernelVersion: 6.17
+Contact: linux-iio@vger.kernel.org
+Description:
+ Hardware dependent values supported by the oversampling
+ frequency.
+
What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw
What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw
What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_raw
--
2.49.0On Tue, 10 Jun 2025 09:34:34 +0200 Jorge Marques <jorge.marques@analog.com> wrote: Trivial: In the patch title use the actual file name of the new ABI. add oversampling_frequency in sysfs-bus-iio > Some devices have an internal clock used to space out the conversion > trigger for the oversampling filter, Consider an ADC with conversion and > data ready pins topology: > > Sampling trigger | | | | | > ADC conversion ++++ ++++ ++++ ++++ ++++ > ADC data ready * * * * * > > With the oversampling frequency, conversions are spaced: > > Sampling trigger | | | | | > ADC conversion + + + + + + + + + + + + + + + + + + + + > ADC data ready * * * * * > > In some devices and ranges, this internal clock can be used to evenly > space the conversions between the sampling edge. In other devices the > oversampling frequency is fixed or is computed based on the sampling > frequency parameter, and the parameter is read only. > > Signed-off-by: Jorge Marques <jorge.marques@analog.com> > --- > Documentation/ABI/testing/sysfs-bus-iio | 17 +++++++++++++++++ > 1 file changed, 17 insertions(+) > > diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio > index ef52c427a015cf47bb9847782e13afbee01e9f31..e60367255be89a9acc827ec1a749b729735f60e6 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio > +++ b/Documentation/ABI/testing/sysfs-bus-iio > @@ -139,6 +139,23 @@ Contact: linux-iio@vger.kernel.org > Description: > Hardware dependent values supported by the oversampling filter. > > +What: /sys/bus/iio/devices/iio:deviceX/oversampling_frequency > +KernelVersion: 6.17 > +Contact: linux-iio@vger.kernel.org > +Description: > + Some devices have internal clocks for oversampling. Wrapping on each sentence is unusual. David pointed this out in v2. Wrap at 80 chars as a single paragraph. > + Sets the resulting frequency in Hz to trigger a conversion used by > + the oversampling filter. > + If the device has a fixed internal clock or is computed based on > + the sampling frequency parameter, the parameter is read only. > + > +What: /sys/bus/iio/devices/iio:deviceX/oversampling_frequency_available > +KernelVersion: 6.17 > +Contact: linux-iio@vger.kernel.org > +Description: > + Hardware dependent values supported by the oversampling > + frequency. > + > What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw > What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw > What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_raw >
On Wed, Jun 11, 2025 at 06:02:52PM +0100, Jonathan Cameron wrote: > On Tue, 10 Jun 2025 09:34:34 +0200 > Jorge Marques <jorge.marques@analog.com> wrote: > > Trivial: > In the patch title use the actual file name of the new ABI. > > add oversampling_frequency in sysfs-bus-iio > Ack. > > > Some devices have an internal clock used to space out the conversion > > trigger for the oversampling filter, Consider an ADC with conversion and > > data ready pins topology: > > > > Sampling trigger | | | | | > > ADC conversion ++++ ++++ ++++ ++++ ++++ > > ADC data ready * * * * * > > > > With the oversampling frequency, conversions are spaced: > > > > Sampling trigger | | | | | > > ADC conversion + + + + + + + + + + + + + + + + + + + + > > ADC data ready * * * * * > > > > In some devices and ranges, this internal clock can be used to evenly > > space the conversions between the sampling edge. In other devices the > > oversampling frequency is fixed or is computed based on the sampling > > frequency parameter, and the parameter is read only. > > > > Signed-off-by: Jorge Marques <jorge.marques@analog.com> > > --- > > Documentation/ABI/testing/sysfs-bus-iio | 17 +++++++++++++++++ > > 1 file changed, 17 insertions(+) > > > > diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio > > index ef52c427a015cf47bb9847782e13afbee01e9f31..e60367255be89a9acc827ec1a749b729735f60e6 100644 > > --- a/Documentation/ABI/testing/sysfs-bus-iio > > +++ b/Documentation/ABI/testing/sysfs-bus-iio > > @@ -139,6 +139,23 @@ Contact: linux-iio@vger.kernel.org > > Description: > > Hardware dependent values supported by the oversampling filter. > > > > +What: /sys/bus/iio/devices/iio:deviceX/oversampling_frequency > > +KernelVersion: 6.17 > > +Contact: linux-iio@vger.kernel.org > > +Description: > > + Some devices have internal clocks for oversampling. > > Wrapping on each sentence is unusual. David pointed this out in v2. > Wrap at 80 chars as a single paragraph. > Yep, sorry. Hopefully I develop muscle memory for vim's Vgq soon. Best regards, Jorge > > + Sets the resulting frequency in Hz to trigger a conversion used by > > + the oversampling filter. > > + If the device has a fixed internal clock or is computed based on > > + the sampling frequency parameter, the parameter is read only. > > + > > +What: /sys/bus/iio/devices/iio:deviceX/oversampling_frequency_available > > +KernelVersion: 6.17 > > +Contact: linux-iio@vger.kernel.org > > +Description: > > + Hardware dependent values supported by the oversampling > > + frequency. > > + > > What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_raw > > What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw > > What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_i_raw > > >
© 2016 - 2025 Red Hat, Inc.