[0/2] Add sys-bus-iio ABI frequency options to events and oversampling

Message

Jorge Marques March 21, 2025, 2:50 p.m. UTC

Some device families such as Analog Device's max1363, ad7606, ad799x, and
ad4052 contain internal clocks used by monitor modes and oversampling.
Devices' monitor modes are exposed as IIO events.
The max1363 driver included the events/sampling_frequency in
commit 168c9d95a940 ("iio:adc:max1363 move from staging.")
and ad799x in
commit ba1d79613df3 ("staging:iio:ad799x: Use event spec for threshold
hysteresis")
but went undocumented so far.

The oversampling sampling frequency is a planned feature to be patched
onto the ad7606 driver.
In this particular device, it is called oversampling padding.
The upcoming ad4052 linux driver will utilize both entries,
it is worth noting, however, there is a single register for both
options. Since the device is never concurrently in both modes, the
values will be safely cached on the device state.

Signed-off-by: Jorge Marques <[e-mail]>
---
Jorge Marques (2):
      Documentation: ABI: add events sampling frequency in sysfs-bus-iio
      Documentation: ABI: add oversampling frequency in sysfs-bus-iio

 Documentation/ABI/testing/sysfs-bus-iio | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
---
base-commit: 9f36acefb2621d980734a5bb7d74e0e24e0af166
change-id: 20250321-abi-oversampling-events-frequency-436c64fcece0

Best regards,