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 parent entry for iio channels

Browse Source 
Add documentation for a read-only sysfs attribute that allows to expose
parent-child relationships between IIO channels.

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:30 +01:00 committed by Jonathan Cameron
parent f271823004
commit 1171811e2a
1 changed files with 28 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
Documentation/ABI/testing/sysfs-bus-iio
View File

@ -2174,6 +2174,34 @@ Description:
specific attributes. This is useful for userspace to be able to
better identify an individual channel.
What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_parent
What: /sys/bus/iio/devices/iio:deviceX/out_voltageY_parent
What: /sys/bus/iio/devices/iio:deviceX/in_altvoltageY_parent
What: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_parent
What: /sys/bus/iio/devices/iio:deviceX/in_currentY_parent
What: /sys/bus/iio/devices/iio:deviceX/out_currentY_parent
What: /sys/bus/iio/devices/iio:deviceX/in_altcurrentY_parent
What: /sys/bus/iio/devices/iio:deviceX/out_altcurrentY_parent
KernelVersion: 7.3
Contact: linux-iio@vger.kernel.org
Description:
Read-only attribute containing the sysfs name prefix of the parent
channel for hierarchical channel relationships (e.g. "out_altvoltage0").
The prefix uniquely identifies the parent channel and can be used by
userspace to organize channels in tree-like structures that reflects
virtual or logical relationships between them.
For example, an IIO device may expose a primary output channel as
"out_voltage0" together with a set of profile-based or mode-based
subchannels used to configure or compose the output signal. These
subchannels may carry common attributes such as frequency, phase, etc.
They do not represent physical outputs, but rather logical/virtual
channels grouping configurations that affect the primary output.
Each subchannel exposes a <dir>_<type>[Y]_parent attribute reading
"out_voltage0", allowing userspace to group controls under the output
channel they belong to rather than treating them as unrelated top-level
channels.
What: /sys/bus/iio/devices/iio:deviceX/in_frequencyY_raw
KernelVersion: 7.3
Contact: linux-iio@vger.kernel.org