Add documentation for the use of the Digital Attenuator gain.
Signed-off-by: Antoniu Miclaus <[email protected]>
---
changes in v3:
- add description for calibscale in I/Q mode
.../testing/sysfs-bus-iio-frequency-admv1014 | 29 +++++++++++++++++++
1 file changed, 29 insertions(+)
create mode 100644 Documentation/ABI/testing/sysfs-bus-iio-frequency-admv1014
diff --git a/Documentation/ABI/testing/sysfs-bus-iio-frequency-admv1014 b/Documentation/ABI/testing/sysfs-bus-iio-frequency-admv1014
new file mode 100644
index 000000000000..77c1691e6910
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-bus-iio-frequency-admv1014
@@ -0,0 +1,29 @@
+What: /sys/bus/iio/devices/iio:deviceX/in_altvoltage0_i_calibscale_coarse
+KernelVersion:
+Contact: [email protected]
+Description:
+ Read/write value for the digital attenuator gain (IF_I) with coarse steps.
+
+What: /sys/bus/iio/devices/iio:deviceX/in_altvoltage0_q_calibscale_coarse
+KernelVersion:
+Contact: [email protected]
+Description:
+ Read/write value for the digital attenuator gain (IF_Q) with coarse steps.
+
+What: /sys/bus/iio/devices/iio:deviceX/in_altvoltage0_i_calibscale_fine
+KernelVersion:
+Contact: [email protected]
+Description:
+ Read/write value for the digital attenuator gain (IF_I) with fine steps.
+
+What: /sys/bus/iio/devices/iio:deviceX/in_altvoltage0_q_calibscale_fine
+KernelVersion:
+Contact: [email protected]
+Description:
+ Read/write value for the digital attenuator gain (IF_Q) with fine steps.
+
+What: /sys/bus/iio/devices/iio:deviceX/in_altvoltage_calibscale
+KernelVersion:
+Contact: [email protected]
+Description:
+ Read/write value for the digital attenuator gain (I/Q).
--
2.34.1
On Wed, 19 Jan 2022 10:18:37 +0200
Antoniu Miclaus <[email protected]> wrote:
> Add documentation for the use of the Digital Attenuator gain.
>
> Signed-off-by: Antoniu Miclaus <[email protected]>
One entry that should be in the generic docs rather than here.
Given the documentation generation scripts don't support multiple
entries for a given attribute name an that one is 'standard'
we should just add it to the main file as otherwise the chances
are very high of accidentally getting duplication when it
turns up in another driver ABI doc.
We may need to move some of the others later if they turn out
to occur in multiple drivers but they are obscure enough to
be fine in this file for now.
Thanks,
Jonathan
> ---
> changes in v3:
> - add description for calibscale in I/Q mode
> .../testing/sysfs-bus-iio-frequency-admv1014 | 29 +++++++++++++++++++
> 1 file changed, 29 insertions(+)
> create mode 100644 Documentation/ABI/testing/sysfs-bus-iio-frequency-admv1014
>
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-frequency-admv1014 b/Documentation/ABI/testing/sysfs-bus-iio-frequency-admv1014
> new file mode 100644
> index 000000000000..77c1691e6910
> --- /dev/null
> +++ b/Documentation/ABI/testing/sysfs-bus-iio-frequency-admv1014
> @@ -0,0 +1,29 @@
> +What: /sys/bus/iio/devices/iio:deviceX/in_altvoltage0_i_calibscale_coarse
> +KernelVersion:
> +Contact: [email protected]
> +Description:
> + Read/write value for the digital attenuator gain (IF_I) with coarse steps.
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_altvoltage0_q_calibscale_coarse
> +KernelVersion:
> +Contact: [email protected]
> +Description:
> + Read/write value for the digital attenuator gain (IF_Q) with coarse steps.
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_altvoltage0_i_calibscale_fine
> +KernelVersion:
> +Contact: [email protected]
> +Description:
> + Read/write value for the digital attenuator gain (IF_I) with fine steps.
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_altvoltage0_q_calibscale_fine
> +KernelVersion:
> +Contact: [email protected]
> +Description:
> + Read/write value for the digital attenuator gain (IF_Q) with fine steps.
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_altvoltage_calibscale
This particular one is normal ABI, so should just be added to the list
in sysfs-bus-iio alongside all the other calibscale entries.
> +KernelVersion:
> +Contact: [email protected]
> +Description:
> + Read/write value for the digital attenuator gain (I/Q).