[PATCH v3 2/3] Documentation/ABI/testing: Add documentation for AD5766 new ABI

From: Cristian Pop
Date: Tue Dec 08 2020 - 08:16:11 EST


New interface is proposed for dither functionality. This future allows
composing an external signals to the selected output channel.
The dither signal can be turned on/off, scaled, inverted, or it can be
selected from different sources.

Signed-off-by: Cristian Pop <cristian.pop@xxxxxxxxxx>
---
.../ABI/testing/sysfs-bus-iio-dac-ad5766 | 45 +++++++++++++++++++
1 file changed, 45 insertions(+)
create mode 100644 Documentation/ABI/testing/sysfs-bus-iio-dac-ad5766

diff --git a/Documentation/ABI/testing/sysfs-bus-iio-dac-ad5766 b/Documentation/ABI/testing/sysfs-bus-iio-dac-ad5766
new file mode 100644
index 000000000000..361bbd0862df
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-bus-iio-dac-ad5766
@@ -0,0 +1,45 @@
+What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_dither_pwr
+KernelVersion:
+Contact: linux-iio@xxxxxxxxxxxxxxx
+Description:
+ Dither power on/off. Write 0 to power on dither or 1 to power it off.
+
+What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_dither_invert
+KernelVersion:
+Contact: linux-iio@xxxxxxxxxxxxxxx
+Description:
+ Inverts the dither applied to the selected DAC channel. Dither signal is
+ not inverted (default) Dither signal is inverted.
+
+What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_dither_scale_available
+KernelVersion:
+Contact: linux-iio@xxxxxxxxxxxxxxx
+Description:
+ Returns possible scalings available for the current channel:
+ "NO_SCALING 75%_SCALING 50%_SCALING 25%_SCALING"
+
+What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_dither_scale
+KernelVersion:
+Contact: linux-iio@xxxxxxxxxxxxxxx
+Description:
+ Scales the dither before it is applied to the selected channel.
+ NO_SCALING - No scaling
+ 75%_SCALING - 75% scaling
+ 50%_SCALING - 50% scaling
+ 25%_SCALING - 25% scaling
+
+What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_dither_source_available
+KernelVersion:
+Contact: linux-iio@xxxxxxxxxxxxxxx
+Description:
+ Returns possible dither sources available for the selected channel:
+ "NO_DITHER N0 N1"
+
+What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_dither_source
+KernelVersion:
+Contact: linux-iio@xxxxxxxxxxxxxxx
+Description:
+ Selects dither source applied to the selected channel.
+ NO_DITHER - No dither applied
+ N0 - N0 dither signal applied
+ N1 - N1 dither signal applied
--
2.17.1