Re: [PATCH] iio: imu: inv_mpu6050: add comment about frequencies

[Jean-Baptiste Maneyrol <JManeyrol@invensense.com>]

Acked-by: Jean-Baptiste Maneyrol <jmaneyrol@invensense.com>


From: Martin Kelly <mkelly@xevo.com>
Sent: Monday, May 21, 2018 20:41
To: linux-iio@vger.kernel.org
Cc: Jean-Baptiste Maneyrol; Jonathan Cameron; Martin Kelly
Subject: [PATCH] iio: imu: inv_mpu6050: add comment about frequencies

Although the driver allows frequencies between 4 and 1000 Hz, only the
frequencies advertised in the available frequencies file are backed
properly by a low-pass filter to prevent aliasing, so it's best to use
them. Since this is not obvious to the user, add a comment explaining
what's going on.

Signed-off-by: Martin Kelly <mkelly@xevo.com>
---
=A0drivers/iio/imu/inv_mpu6050/inv_mpu_core.c | 9 ++++++++-
=A01 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/drivers/iio/imu/inv_mpu6050/inv_mpu_core.c b/drivers/iio/imu/i=
nv_mpu6050/inv_mpu_core.c
index 43fba5f7532b..f9c0624505a2 100644
--- a/drivers/iio/imu/inv_mpu6050/inv_mpu_core.c
+++ b/drivers/iio/imu/inv_mpu6050/inv_mpu_core.c
@@ -798,7 +798,14 @@ static const struct iio_chan_spec inv_mpu_channels[] =
=3D {
=A0=A0=A0=A0=A0=A0=A0 INV_MPU6050_CHAN(IIO_ACCEL, IIO_MOD_Z, INV_MPU6050_SC=
AN_ACCL_Z),
=A0};

-/* constant IIO attribute */
+/*
+ * The user can choose any frequency between INV_MPU6050_MIN_FIFO_RATE and
+ * INV_MPU6050_MAX_FIFO_RATE, but only these frequencies are matched by th=
e
+ * low-pass filter. Specifically, each of these sampling rates are about t=
wice
+ * the bandwidth of a corresponding low-pass filter, which should eliminat=
e
+ * aliasing following the Nyquist principle. By picking a frequency differ=
ent
+ * from these, the user risks aliasing effects.
+ */
=A0static IIO_CONST_ATTR_SAMP_FREQ_AVAIL("10 20 50 100 200 500");
=A0static IIO_CONST_ATTR(in_anglvel_scale_available,
=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=
=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0=A0 "0.000133090 0.000266181 0=
.000532362 0.001064724");
--
2.11.0

    =