Re: [PATCH v2 1/5] iio: Documentation: update definitions for bufferY and scan_elements

From: Jonathan Cameron
Date: Thu Feb 18 2021 - 10:18:55 EST

Next message: Nicola Mazzucato: "Re: [PATCH v7 1/3] scmi-cpufreq: Remove deferred probe"
Previous message: Chris Down: "Re: [PATCH v4] printk: Userspace format enumeration support"
In reply to: Alexandru Ardelean: "[PATCH v2 1/5] iio: Documentation: update definitions for bufferY and scan_elements"
Next in thread: Jonathan Cameron: "Re: [PATCH v2 1/5] iio: Documentation: update definitions for bufferY and scan_elements"
Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

On Wed, 17 Feb 2021 10:34:34 +0200
Alexandru Ardelean <alexandru.ardelean@xxxxxxxxxx> wrote:

> Since the new change to the IIO buffer infrastructure, the buffer/ and
> scan_elements/ directories have been merged into bufferY/ to have some
> attributes available per-buffer.
>
> This change updates the ABI docs to reflect this change.
>
> The hwfifo attributes are not updated, as for now these should be used
> via the legacy buffer/ directory until they are moved into core.
>
> Signed-off-by: Alexandru Ardelean <alexandru.ardelean@xxxxxxxxxx>

This doesn't really have anything to do with the rest of the set - so ideally
you'd have sent it separately.

One trivial typo below, that I can fix whilst applying.

> ---
> Documentation/ABI/testing/sysfs-bus-iio | 85 +++++++++++++++++++++++++
> 1 file changed, 85 insertions(+)
>
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio
> index d957f5da5c04..f2a72d7fbacb 100644
> --- a/Documentation/ABI/testing/sysfs-bus-iio
> +++ b/Documentation/ABI/testing/sysfs-bus-iio
> @@ -1118,12 +1118,16 @@ Description:
>
> What: /sys/bus/iio/devices/iio:deviceX/buffer/length
> KernelVersion: 2.6.35
> +What: /sys/bus/iio/devices/iio:deviceX/bufferY/length
> +KernelVersion: 5.11
> Contact: linux-iio@xxxxxxxxxxxxxxx
> Description:
> Number of scans contained by the buffer.
>
> What: /sys/bus/iio/devices/iio:deviceX/buffer/enable
> KernelVersion: 2.6.35
> +What: /sys/bus/iio/devices/iio:deviceX/bufferY/enable
> +KernelVersion: 5.11
> Contact: linux-iio@xxxxxxxxxxxxxxx
> Description:
> Actually start the buffer capture up. Will start trigger
> @@ -1131,11 +1135,16 @@ Description:
>
> What: /sys/bus/iio/devices/iio:deviceX/scan_elements
> KernelVersion: 2.6.37
> +What: /sys/bus/iio/devices/iio:deviceX/buffeY
bufferY

I'll fix whilst applying.

> +KernelVersion: 5.11
> Contact: linux-iio@xxxxxxxxxxxxxxx
> Description:
> Directory containing interfaces for elements that will be
> captured for a single triggered sample set in the buffer.
>
> + Since kernel 5.11 the scan_elements attributes are merged into
> + the bufferY directory, to be configurable per buffer.
> +
> What: /sys/.../iio:deviceX/scan_elements/in_accel_x_en
> What: /sys/.../iio:deviceX/scan_elements/in_accel_y_en
> What: /sys/.../iio:deviceX/scan_elements/in_accel_z_en
> @@ -1164,6 +1173,34 @@ What: /sys/.../iio:deviceX/scan_elements/in_pressure_en
> What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_en
> What: /sys/.../iio:deviceX/scan_elements/in_proximity_en
> KernelVersion: 2.6.37
> +What: /sys/.../iio:deviceX/bufferY/in_accel_x_en
> +What: /sys/.../iio:deviceX/bufferY/in_accel_y_en
> +What: /sys/.../iio:deviceX/bufferY/in_accel_z_en
> +What: /sys/.../iio:deviceX/bufferY/in_anglvel_x_en
> +What: /sys/.../iio:deviceX/bufferY/in_anglvel_y_en
> +What: /sys/.../iio:deviceX/bufferY/in_anglvel_z_en
> +What: /sys/.../iio:deviceX/bufferY/in_magn_x_en
> +What: /sys/.../iio:deviceX/bufferY/in_magn_y_en
> +What: /sys/.../iio:deviceX/bufferY/in_magn_z_en
> +What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_en
> +What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_true_en
> +What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_tilt_comp_en
> +What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_true_tilt_comp_en
> +What: /sys/.../iio:deviceX/bufferY/in_timestamp_en
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY_supply_en
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY_en
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY-voltageZ_en
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY_i_en
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY_q_en
> +What: /sys/.../iio:deviceX/bufferY/in_voltage_i_en
> +What: /sys/.../iio:deviceX/bufferY/in_voltage_q_en
> +What: /sys/.../iio:deviceX/bufferY/in_incli_x_en
> +What: /sys/.../iio:deviceX/bufferY/in_incli_y_en
> +What: /sys/.../iio:deviceX/bufferY/in_pressureY_en
> +What: /sys/.../iio:deviceX/bufferY/in_pressure_en
> +What: /sys/.../iio:deviceX/bufferY/in_rot_quaternion_en
> +What: /sys/.../iio:deviceX/bufferY/in_proximity_en
> +KernelVersion: 5.11
> Contact: linux-iio@xxxxxxxxxxxxxxx
> Description:
> Scan element control for triggered data capture.
> @@ -1185,6 +1222,23 @@ What: /sys/.../iio:deviceX/scan_elements/in_pressure_type
> What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_type
> What: /sys/.../iio:deviceX/scan_elements/in_proximity_type
> KernelVersion: 2.6.37
> +What: /sys/.../iio:deviceX/bufferY/in_accel_type
> +What: /sys/.../iio:deviceX/bufferY/in_anglvel_type
> +What: /sys/.../iio:deviceX/bufferY/in_magn_type
> +What: /sys/.../iio:deviceX/bufferY/in_incli_type
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY_type
> +What: /sys/.../iio:deviceX/bufferY/in_voltage_type
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY_supply_type
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY_i_type
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY_q_type
> +What: /sys/.../iio:deviceX/bufferY/in_voltage_i_type
> +What: /sys/.../iio:deviceX/bufferY/in_voltage_q_type
> +What: /sys/.../iio:deviceX/bufferY/in_timestamp_type
> +What: /sys/.../iio:deviceX/bufferY/in_pressureY_type
> +What: /sys/.../iio:deviceX/bufferY/in_pressure_type
> +What: /sys/.../iio:deviceX/bufferY/in_rot_quaternion_type
> +What: /sys/.../iio:deviceX/bufferY/in_proximity_type
> +KernelVersion: 5.11
> Contact: linux-iio@xxxxxxxxxxxxxxx
> Description:
> Description of the scan element data storage within the buffer
> @@ -1241,6 +1295,33 @@ What: /sys/.../iio:deviceX/scan_elements/in_pressure_index
> What: /sys/.../iio:deviceX/scan_elements/in_rot_quaternion_index
> What: /sys/.../iio:deviceX/scan_elements/in_proximity_index
> KernelVersion: 2.6.37
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY_index
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY_supply_index
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY_i_index
> +What: /sys/.../iio:deviceX/bufferY/in_voltageY_q_index
> +What: /sys/.../iio:deviceX/bufferY/in_voltage_i_index
> +What: /sys/.../iio:deviceX/bufferY/in_voltage_q_index
> +What: /sys/.../iio:deviceX/bufferY/in_accel_x_index
> +What: /sys/.../iio:deviceX/bufferY/in_accel_y_index
> +What: /sys/.../iio:deviceX/bufferY/in_accel_z_index
> +What: /sys/.../iio:deviceX/bufferY/in_anglvel_x_index
> +What: /sys/.../iio:deviceX/bufferY/in_anglvel_y_index
> +What: /sys/.../iio:deviceX/bufferY/in_anglvel_z_index
> +What: /sys/.../iio:deviceX/bufferY/in_magn_x_index
> +What: /sys/.../iio:deviceX/bufferY/in_magn_y_index
> +What: /sys/.../iio:deviceX/bufferY/in_magn_z_index
> +What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_index
> +What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_true_index
> +What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_tilt_comp_index
> +What: /sys/.../iio:deviceX/bufferY/in_rot_from_north_true_tilt_comp_index
> +What: /sys/.../iio:deviceX/bufferY/in_incli_x_index
> +What: /sys/.../iio:deviceX/bufferY/in_incli_y_index
> +What: /sys/.../iio:deviceX/bufferY/in_timestamp_index
> +What: /sys/.../iio:deviceX/bufferY/in_pressureY_index
> +What: /sys/.../iio:deviceX/bufferY/in_pressure_index
> +What: /sys/.../iio:deviceX/bufferY/in_rot_quaternion_index
> +What: /sys/.../iio:deviceX/bufferY/in_proximity_index
> +KernelVersion: 5.11
> Contact: linux-iio@xxxxxxxxxxxxxxx
> Description:
> A single positive integer specifying the position of this
> @@ -1455,6 +1536,8 @@ Description:
>
> What: /sys/bus/iio/devices/iio:deviceX/buffer/watermark
> KernelVersion: 4.2
> +What: /sys/bus/iio/devices/iio:deviceX/bufferY/watermark
> +KernelVersion: 5.11
> Contact: linux-iio@xxxxxxxxxxxxxxx
> Description:
> A single positive integer specifying the maximum number of scan
> @@ -1473,6 +1556,8 @@ Description:
>
> What: /sys/bus/iio/devices/iio:deviceX/buffer/data_available
> KernelVersion: 4.16
> +What: /sys/bus/iio/devices/iio:deviceX/bufferY/data_available
> +KernelVersion: 5.11
> Contact: linux-iio@xxxxxxxxxxxxxxx
> Description:
> A read-only value indicating the bytes of data available in the

Next message: Nicola Mazzucato: "Re: [PATCH v7 1/3] scmi-cpufreq: Remove deferred probe"
Previous message: Chris Down: "Re: [PATCH v4] printk: Userspace format enumeration support"
In reply to: Alexandru Ardelean: "[PATCH v2 1/5] iio: Documentation: update definitions for bufferY and scan_elements"
Next in thread: Jonathan Cameron: "Re: [PATCH v2 1/5] iio: Documentation: update definitions for bufferY and scan_elements"
Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]