linux-kernel - Re: [PATCH v6 3/9] iio: imu: inv_icm45600: add buffer support in iio devices

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <20251004164123.4faf4b45@jic23-huawei>
Date: Sat, 4 Oct 2025 16:41:23 +0100
From: Jonathan Cameron <jic23@...nel.org>
To: Remi Buisson <Remi.Buisson@....com>
Cc: Remi Buisson via B4 Relay <devnull+remi.buisson.tdk.com@...nel.org>,
 David Lechner <dlechner@...libre.com>, Nuno Sá
 <nuno.sa@...log.com>, Andy Shevchenko <andy@...nel.org>, Rob Herring
 <robh@...nel.org>, Krzysztof Kozlowski <krzk+dt@...nel.org>, Conor Dooley
 <conor+dt@...nel.org>, "linux-kernel@...r.kernel.org"
 <linux-kernel@...r.kernel.org>, "linux-iio@...r.kernel.org"
 <linux-iio@...r.kernel.org>, "devicetree@...r.kernel.org"
 <devicetree@...r.kernel.org>
Subject: Re: [PATCH v6 3/9] iio: imu: inv_icm45600: add buffer support in
 iio devices

On Wed, 1 Oct 2025 12:07:40 +0000
Remi Buisson <Remi.Buisson@....com> wrote:

> >
> >
> >From: Jonathan Cameron <jic23@...nel.org> 
> >Sent: Sunday, September 28, 2025 10:45 AM
> >To: Remi Buisson via B4 Relay <devnull+remi.buisson.tdk.com@...nel.org>
> >Cc: Remi Buisson <Remi.Buisson@....com>; David Lechner <dlechner@...libre.com>; Nuno Sá <nuno.sa@...log.com>; Andy Shevchenko <andy@...nel.org>; Rob Herring <robh@...nel.org>; Krzysztof Kozlowski <krzk+dt@...nel.org>; Conor Dooley <conor+dt@...nel.org>; linux-kernel@...r.kernel.org; linux-iio@...r.kernel.org; devicetree@...r.kernel.org
> >Subject: Re: [PATCH v6 3/9] iio: imu: inv_icm45600: add buffer support in iio devices
> >
> >On Wed, 24 Sep 2025 09:23:56 +0000
> >Remi Buisson via B4 Relay <devnull+remi.buisson.tdk.com@...nel.org> wrote:
> >  
> >> From: Remi Buisson <remi.buisson@....com>
> >> 
> >> Add FIFO control functions.
> >> Support hwfifo watermark by multiplexing gyro and accel settings.
> >> Support hwfifo flush.
> >> 
> >> Signed-off-by: Remi Buisson <remi.buisson@....com>  
> >Hi Remi,
> >
> >A few trivial things in here as well.
> >
> >Jonathan  
> Thanks again for the review !
> Remi
> >  
> >> diff --git a/drivers/iio/imu/inv_icm45600/inv_icm45600.h b/drivers/iio/imu/inv_icm45600/inv_icm45600.h
> >> index 5f637e2f2ec8f1537459459dbb7e8a796d0ef7a6..aac8cd852c12cfba5331f2b7c1ffbbb2ed23d1c7 100644
> >> --- a/drivers/iio/imu/inv_icm45600/inv_icm45600.h
> >> +++ b/drivers/iio/imu/inv_icm45600/inv_icm45600.h
> >> @@ -5,6 +5,7 @@
> >>  #define INV_ICM45600_H_
> >>  
> >>  #include <linux/bits.h>
> >> +#include <linux/limits.h>  
> >
> >Why this in the header?  Should be only needed in some of the c files I think
> >so push the include down there.  
> This is because the below line uses U8_MAX:
> #define INV_ICM45600_SENSOR_CONF_KEEP_VALUES { U8_MAX, U8_MAX, U8_MAX, U8_MAX }
> So I guess the header from where it comes from should be included.
> Please correct if I miss something.

Nope. Should indeed be there. I just missed that.

> >  
> ...
> >  
> >> diff --git a/drivers/iio/imu/inv_icm45600/inv_icm45600_buffer.h b/drivers/iio/imu/inv_icm45600/inv_icm45600_buffer.h
> >> new file mode 100644
> >> index 0000000000000000000000000000000000000000..0c8caa8287dd4373cf11bb6c7b913a6c49e9eee5
> >> --- /dev/null
> >> +++ b/drivers/iio/imu/inv_icm45600/inv_icm45600_buffer.h  
> >  
> >> +
> >> +/**
> >> + * struct inv_icm45600_fifo - FIFO state variables
> >> + * @on:		reference counter for FIFO on.
> >> + * @en:		bits field of INV_ICM45600_SENSOR_* for FIFO EN bits.
> >> + * @period:	FIFO internal period.
> >> + * @watermark:	watermark configuration values for accel and gyro.  
> >Given the contents of this to me look like things to also document.e
> > * @watermark.gyro:	....
> >etc as well would be good to add
> >  
> >> + * @count:	number of bytes in the FIFO data buffer.
> >> + * @nb:		gyro, accel and total samples in the FIFO data buffer.  
> >
> >This is more obvious.  Check if the kernel-doc script minds these subfields not
> >being defined.  If it does, add a the trivial documentation just to squash warnings
> >and make it easier to spot real issues.  
> 
> With my setup "./scripts/kernel-doc.py -v -none drivers/iio/imu/inv_icm45600/*" does not catch anything, even with -Wall.
> I'll detail the gyro/accel watermark comment anyway.

I guess it doesn't mind not documenting nested structure elements

Jonathan

>