github-mirror/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2026-11-07 06:17:02 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity Graph

iio: ABI: add docs for ad9910 sysfs and debugfs entries

Browse Source 
Add custom ABI documentation files for the DDS AD9910 with sysfs and
debugfs entries. The sysfs ones control parameters from the Digital Ramp
Generator and OSK engine. The debugfs attributes are read-only and
evaluate into source channel labels for each DDS core parameter.

Signed-off-by: Rodrigo Alencar <rodrigo.alencar@analog.com>
Signed-off-by: Jonathan Cameron <jonathan.cameron@oss.qualcomm.com>
This commit is contained in:
Rodrigo Alencar 2026-07-29 09:25:43 +01:00 committed by Jonathan Cameron
parent e84b62527f
commit e5f2f69db7
3 changed files with 56 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
Documentation/ABI/testing/debugfs-iio-ad9910 Normal file
View File

@ -0,0 +1,23 @@
What: /sys/kernel/debug/iio/iio:deviceX/frequency_source
KernelVersion: 7.3
Contact: linux-iio@vger.kernel.org
Description:
Read-only. Reports the channel label that is read from the
<dir>_<type>[Y]_label attribute, which corresponds to the on-chip
signal generator that is currently driving the output frequency.
What: /sys/kernel/debug/iio/iio:deviceX/phase_source
KernelVersion: 7.3
Contact: linux-iio@vger.kernel.org
Description:
Read-only. Reports the channel label that is read from the
<dir>_<type>[Y]_label attribute, which corresponds to the on-chip
signal generator that is currently driving the output phase.
What: /sys/kernel/debug/iio/iio:deviceX/amplitude_source
KernelVersion: 7.3
Contact: linux-iio@vger.kernel.org
Description:
Read-only. Reports the channel label that is read from the
<dir>_<type>[Y]_label attribute, which corresponds to the on-chip
signal generator that is currently driving the output amplitude.

31
Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9910 Normal file
View File

@ -0,0 +1,31 @@
What: /sys/bus/iio/devices/iio:deviceX/out_altcurrentY_dwell_en
What: /sys/bus/iio/devices/iio:deviceX/out_frequencyY_dwell_en
What: /sys/bus/iio/devices/iio:deviceX/out_phaseY_dwell_en
KernelVersion: 7.3
Contact: linux-iio@vger.kernel.org
Description:
For a channel that produces parametric sweeps, this attribute controls
the sweep behavior at the configured limit. It enables dwell mode at a
sweep limit when set to 1, i.e., after the sweep is complete the output
value stays at the limit. Otherwise (setting this value to 0), the sweep
may stop or restart from the initial position, or even continue by
reversing the sweep direction.
What: /sys/bus/iio/devices/iio:deviceX/out_altcurrentY_raw_roc
What: /sys/bus/iio/devices/iio:deviceX/out_frequencyY_raw_roc
What: /sys/bus/iio/devices/iio:deviceX/out_phaseY_raw_roc
KernelVersion: 7.3
Contact: linux-iio@vger.kernel.org
Description:
For a channel that produces parametric sweeps, this attribute controls
the rate of change of the parameter in raw units per second (slope).
This value may be influenced by the channel sampling_frequency attribute
if available. Multiplying this value by the scale attribute of the
channel yields the rate of change in physical units per second.
What: /sys/bus/iio/devices/iio:deviceX/out_altcurrentY_raw_roc_available
KernelVersion: 7.3
Contact: linux-iio@vger.kernel.org
Description:
Lists the available roc values for the channel. Values are
space-separated in ascending order.

2
MAINTAINERS
View File

@ -1720,6 +1720,8 @@ M: Rodrigo Alencar <rodrigo.alencar@analog.com>
L: linux-iio@vger.kernel.org
S: Supported
W: https://ez.analog.com/linux-software-drivers
F: Documentation/ABI/testing/debugfs-iio-ad9910
F: Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9910
F: Documentation/devicetree/bindings/iio/frequency/adi,ad9910.yaml
F: drivers/iio/frequency/ad9910.c