From: Jonathan Cameron <jic23@kernel.org>
To: Andrea Merello <andrea.merello@gmail.com>
Cc: mchehab+huawei@kernel.org, linux-iio@vger.kernel.org,
linux-kernel@vger.kernel.org, devicetree@vger.kernel.org,
lars@metafoo.de, robh+dt@kernel.org, andy.shevchenko@gmail.com,
matt.ranostay@konsulko.com, ardeleanalex@gmail.com,
jacopo@jmondi.org, Andrea Merello <andrea.merello@iit.it>
Subject: Re: [v3 08/13] iio: document bno055 private sysfs attributes
Date: Sat, 19 Feb 2022 16:50:00 +0000 [thread overview]
Message-ID: <20220219165000.56877005@jic23-huawei> (raw)
In-Reply-To: <20220217162710.33615-9-andrea.merello@gmail.com>
On Thu, 17 Feb 2022 17:27:05 +0100
Andrea Merello <andrea.merello@gmail.com> wrote:
> This patch adds ABI documentation for bno055 driver private sysfs
> attributes.
>
> Signed-off-by: Andrea Merello <andrea.merello@iit.it>
> ---
> .../ABI/testing/sysfs-bus-iio-bno055 | 81 +++++++++++++++++++
> 1 file changed, 81 insertions(+)
> create mode 100644 Documentation/ABI/testing/sysfs-bus-iio-bno055
>
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-bno055 b/Documentation/ABI/testing/sysfs-bus-iio-bno055
> new file mode 100644
> index 000000000000..c239276f2b0f
> --- /dev/null
> +++ b/Documentation/ABI/testing/sysfs-bus-iio-bno055
> @@ -0,0 +1,81 @@
> +What: /sys/bus/iio/devices/iio:deviceX/in_accel_raw_range
> +KernelVersion: 5.17
Update this to 5.18 as hopefully we'll resolve remaining questions in
time to make the merge window.
> +Contact: linux-iio@vger.kernel.org
> +Description:
> + Range for acceleration readings in m/s^2.
If it is in m/s^2 then we need to not call it _raw_ as that implies application
of offset and scale. I didn't think this through in earlier discussion...
If it's in m/s^2 then in_accel_input_range would be appropriate.
Same for the other similar cases that follow.
> Note that this does
> + not affects the scale (which should be used when changing the
> + maximum and minimum readable value affects also the reading
> + scaling factor).
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_raw_range
> +KernelVersion: 5.17
> +Contact: linux-iio@vger.kernel.org
> +Description:
> + Range for angular velocity readings in radians per second. Note
> + that this does not affects the scale (which should be used when
> + changing the maximum and minimum readable value affects also the
> + reading scaling factor).
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_accel_raw_range_available
> +KernelVersion: 5.17
> +Contact: linux-iio@vger.kernel.org
> +Description:
> + List of allowed values for in_accel_raw_range attribute
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_anglvel_raw_range_available
> +KernelVersion: 5.17
> +Contact: linux-iio@vger.kernel.org
> +Description:
> + List of allowed values for in_anglvel_raw_range attribute
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_magn_calibration_fast_enable
> +KernelVersion: 5.17
> +Contact: linux-iio@vger.kernel.org
> +Description:
> + Can be 1 or 0. Enables/disables the "Fast Magnetometer
> + Calibration" HW function.
> +
> +What: /sys/bus/iio/devices/iio:deviceX/fusion_enable
> +KernelVersion: 5.17
> +Contact: linux-iio@vger.kernel.org
> +Description:
> + Can be 1 or 0. Enables/disables the "sensor fusion" (a.k.a.
> + NDOF) HW function.
> +
> +What: /sys/bus/iio/devices/iio:deviceX/calibration_data
> +KernelVersion: 5.17
> +Contact: linux-iio@vger.kernel.org
> +Description:
> + Reports the binary calibration data blob for the IMU sensors.
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_accel_calibration_auto_status
> +KernelVersion: 5.17
> +Contact: linux-iio@vger.kernel.org
> +Description:
> + Reports the autocalibration status for the accelerometer sensor.
> + Can be 0 (calibration non even enabled) or 1 to 5 where the greater
> + the number, the better the calibration status.
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_gyro_calibration_auto_status
> +KernelVersion: 5.17
> +Contact: linux-iio@vger.kernel.org
> +Description:
> + Reports the autocalibration status for the gyroscope sensor.
> + Can be 0 (calibration non even enabled) or 1 to 5 where the greater
> + the number, the better the calibration status.
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_magn_calibration_auto_status
> +KernelVersion: 5.17
> +Contact: linux-iio@vger.kernel.org
> +Description:
> + Reports the autocalibration status for the magnetometer sensor.
> + Can be 0 (calibration non even enabled) or 1 to 5 where the greater
> + the number, the better the calibration status.
> +
> +What: /sys/bus/iio/devices/iio:deviceX/sys_calibration_auto_status
> +KernelVersion: 5.17
> +Contact: linux-iio@vger.kernel.org
> +Description:
> + Reports the status for the IMU overall autocalibration.
> + Can be 0 (calibration non even enabled) or 1 to 5 where the greater
> + the number, the better the calibration status.
next prev parent reply other threads:[~2022-02-19 16:43 UTC|newest]
Thread overview: 28+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-02-17 16:26 [v3 00/13] Add support for Bosch BNO055 IMU Andrea Merello
2022-02-17 16:26 ` [v3 01/13] iio: add modifiers for linear acceleration Andrea Merello
2022-02-17 16:26 ` [v3 02/13] iio: document linear acceleration modifiers Andrea Merello
2022-02-19 16:08 ` Jonathan Cameron
2022-02-17 16:27 ` [v3 03/13] iio: event_monitor: add " Andrea Merello
2022-02-17 16:27 ` [v3 04/13] iio: add modifers for pitch, yaw, roll Andrea Merello
2022-02-17 16:27 ` [v3 05/13] iio: document pitch, yaw, roll modifiers Andrea Merello
2022-02-19 16:31 ` Jonathan Cameron
2022-02-17 16:27 ` [v3 06/13] iio: event_monitor: add pitch, yaw and " Andrea Merello
2022-02-17 16:27 ` [v3 07/13] iio: imu: add Bosch Sensortec BNO055 core driver Andrea Merello
2022-02-17 16:27 ` [v3 08/13] iio: document bno055 private sysfs attributes Andrea Merello
2022-02-19 16:50 ` Jonathan Cameron [this message]
2022-02-17 16:27 ` [v3 09/13] iio: document "serial_number" sysfs attribute Andrea Merello
2022-02-19 16:52 ` Jonathan Cameron
2022-02-17 16:27 ` [v3 10/13] dt-bindings: iio: imu: add documentation for Bosch BNO055 bindings Andrea Merello
2022-02-24 19:54 ` Rob Herring
2022-02-17 16:27 ` [v3 11/13] iio: imu: add BNO055 serdev driver Andrea Merello
2022-02-17 19:47 ` kernel test robot
2022-02-18 5:20 ` kernel test robot
2022-02-21 20:27 ` Andy Shevchenko
2022-03-22 10:37 ` Andrea Merello
2022-02-17 16:27 ` [v3 12/13] iio: imu: add BNO055 I2C driver Andrea Merello
2022-02-19 17:03 ` Jonathan Cameron
2022-02-21 20:32 ` Andy Shevchenko
2022-02-17 16:27 ` [v3 13/13] docs: iio: add documentation for BNO055 driver Andrea Merello
2022-02-19 17:06 ` Jonathan Cameron
2022-03-22 10:30 ` Andrea Merello
2022-03-22 20:32 ` Jonathan Cameron
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20220219165000.56877005@jic23-huawei \
--to=jic23@kernel.org \
--cc=andrea.merello@gmail.com \
--cc=andrea.merello@iit.it \
--cc=andy.shevchenko@gmail.com \
--cc=ardeleanalex@gmail.com \
--cc=devicetree@vger.kernel.org \
--cc=jacopo@jmondi.org \
--cc=lars@metafoo.de \
--cc=linux-iio@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=matt.ranostay@konsulko.com \
--cc=mchehab+huawei@kernel.org \
--cc=robh+dt@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).