From: Rodrigo Alencar <[email protected]>

Add custom ABI documentation file for the DDS AD9910 with sysfs entries to
control Parallel Port, Digital Ramp Generator and OSK parameters.

Signed-off-by: Rodrigo Alencar <[email protected]>
---
 .../ABI/testing/sysfs-bus-iio-frequency-ad9910     | 73 ++++++++++++++++++++++
 MAINTAINERS                                        |  1 +
 2 files changed, 74 insertions(+)

diff --git a/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9910 
b/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9910
new file mode 100644
index 000000000000..eb0ff96a6e10
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9910
@@ -0,0 +1,73 @@
+What:          
/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency_offset
+KernelVersion:
+Contact:       [email protected]
+Description:
+               For a channel that allows frequency control through buffers, 
this
+               represents the base frequency value in Hz. The actual output 
frequency
+               is a result with the sum of this value.
+
+What:          /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency_scale
+KernelVersion:
+Contact:       [email protected]
+Description:
+               For a channel that allows frequency control through buffers, 
this
+               represents the frequency modulation gain. This value multiplies 
the
+               buffer input sample value before it is added to a frequency 
offset.
+
+What:          /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase_offset
+KernelVersion:
+Contact:       [email protected]
+Description:
+               For a channel that allows phase control through buffers, this
+               represents the base phase value in radians. The actual output 
phase
+               is a result with the sum of this value.
+
+What:          /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale_offset
+KernelVersion:
+Contact:       [email protected]
+Description:
+               For a channel that allows amplitude control through buffers, 
this
+               represents the value for a base amplitude scale. The actual 
output
+               amplitude scale is a result with the sum of this value.
+
+What:          /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_dwell_en
+KernelVersion:
+Contact:       [email protected]
+Description:
+               For a channel that produces parametric sweeps, this attribute 
controls
+               the sweep behavior at the configured limits. It enables dwell 
mode at a
+               sweep limit when set to 1. Otherwise, the sweep may stop at the 
initial
+               position or restart from that initial position or continue by 
reversing
+               its direction.
+
+What:          /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency_roc
+KernelVersion:
+Contact:       [email protected]
+Description:
+               Frequency rate of change in Hz/s for channels that produce 
linear
+               frequency sweeps. This value may be influenced by the channel's
+               sampling_frequency setting.
+
+What:          /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase_roc
+KernelVersion:
+Contact:       [email protected]
+Description:
+               Phase rate of change in rad/s for channels that produce linear
+               phase sweeps. This value may be influenced by the channel's
+               sampling_frequency setting.
+
+What:          /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale_roc
+KernelVersion:
+Contact:       [email protected]
+Description:
+               Amplitude scale rate of change in 1/s for channels that ramp
+               amplitude. This value may be influenced by the channel's
+               sampling_frequency setting.
+
+What:          
/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale_roc_available
+KernelVersion:
+Contact:       [email protected]
+Description:
+               Lists the available scale_roc values for the channel based on
+               the current sampling_frequency. Values are space-separated in
+               ascending order.
diff --git a/MAINTAINERS b/MAINTAINERS
index 6a53b202a84d..b52c0aae96b7 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -1643,6 +1643,7 @@ M:        Rodrigo Alencar <[email protected]>
 L:     [email protected]
 S:     Supported
 W:     https://ez.analog.com/linux-software-drivers
+F:     Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9910
 F:     Documentation/devicetree/bindings/iio/frequency/adi,ad9910.yaml
 F:     drivers/iio/frequency/ad9910.c
 

-- 
2.43.0



Reply via email to