Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7;
Date:   Tue, 31 Oct 2023 12:18:13 +0200
From:   Laurent Pinchart <laurent.pinchart@ideasonboard.com>
To:     Sakari Ailus <sakari.ailus@linux.intel.com>
Cc:     Tommaso Merciai <tomm.merciai@gmail.com>, martin.hecht@avnet.eu,
        michael.roeder@avnet.eu, mhecht73@gmail.com,
        linuxfancy@googlegroups.com,
        Mauro Carvalho Chehab <mchehab@kernel.org>,
        Liam Girdwood <lgirdwood@gmail.com>,
        Mark Brown <broonie@kernel.org>,
        Hans de Goede <hdegoede@redhat.com>,
        Hans Verkuil <hverkuil-cisco@xs4all.nl>,
        Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>,
        Marco Felsch <m.felsch@pengutronix.de>,
        Gerald Loacker <gerald.loacker@wolfvision.net>,
        Andy Shevchenko <andy.shevchenko@gmail.com>,
        Daniel Scally <djrscally@gmail.com>,
        Shawn Tu <shawnx.tu@intel.com>,
        Linus Walleij <linus.walleij@linaro.org>,
        linux-kernel@vger.kernel.org, linux-media@vger.kernel.org
Subject: Re: [PATCH v10 3/3] media: i2c: Add support for alvium camera
Message-ID: <20231031101813.GI12764@pendragon.ideasonboard.com>
References: <20231020141354.2500602-1-tomm.merciai@gmail.com>
 <20231020141354.2500602-4-tomm.merciai@gmail.com>
 <ZTpnHdpTgRNll3TC@kekkonen.localdomain>
 <ZT+hEg7WqkQBnLV5@tom-HP-ZBook-Fury-15-G7-Mobile-Workstation>
 <ZUAxoy2cRR6Rm9ig@kekkonen.localdomain>
 <20231030233809.GD12764@pendragon.ideasonboard.com>
 <ZUCf_74Z0igCiJ_-@kekkonen.localdomain>
 <20231031085347.GH12764@pendragon.ideasonboard.com>
 <ZUDDuoNO5AGjyJLh@kekkonen.localdomain>
 <ZUDTaq9-j1HmqiEp@kekkonen.localdomain>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
In-Reply-To: <ZUDTaq9-j1HmqiEp@kekkonen.localdomain>
Precedence: bulk

On Tue, Oct 31, 2023 at 10:14:02AM +0000, Sakari Ailus wrote:
> On Tue, Oct 31, 2023 at 09:07:06AM +0000, Sakari Ailus wrote:
> > On Tue, Oct 31, 2023 at 10:53:47AM +0200, Laurent Pinchart wrote:
> > > On Tue, Oct 31, 2023 at 06:34:39AM +0000, Sakari Ailus wrote:
> > > > On Tue, Oct 31, 2023 at 01:38:09AM +0200, Laurent Pinchart wrote:
> > > > > On Mon, Oct 30, 2023 at 10:43:47PM +0000, Sakari Ailus wrote:
> > > > > > On Mon, Oct 30, 2023 at 01:26:58PM +0100, Tommaso Merciai wrote:
> > > > > > 
> > > > > > ...
> > > > > > 
> > > > > > > > > +static int alvium_get_host_supp_csi_lanes(struct alvium_dev *alvium)
> > > > > > > > > +{
> > > > > > > > > +	u64 val;
> > > > > > > > > +	int ret = 0;
> > > > > > > > > +
> > > > > > > > > +	alvium_read(alvium, REG_BCRM_CSI2_LANE_COUNT_RW, &val, &ret);
> > > > > > > > 
> > > > > > > > Missing error checking before the use of the value. The same pattern
> > > > > > > > remains prevalent throughout the driver.
> > > > > > > > 
> > > > > > > > I think it'd be easier if you didn't use a temporary variable for reading,
> > > > > > > > but instead had a register width specific access function. You could even
> > > > > > > > introduce a helper macro to read this information as I suggested in an
> > > > > > > > earlier review.
> > > > > > > 
> > > > > > > oks.
> > > > > > > We are moving to use the following macros:
> > > > > > > 
> > > > > > > #define alvium_read_check(alvium, reg, value) \
> > > > > > > { \
> > > > > > > 	int ret = alvium_read(alvium, reg, value, NULL); \
> > > > > > > 	if (ret) \
> > > > > > > 		return ret; \
> > > > > > > }
> > > > > > > 
> > > > > > 
> > > > > > You could do something like (entirely untested):
> > > > > > 
> > > > > > #define ALVIUM_DECLARE_READ(sign, bits) \
> > > > > > 	static int
> > > > > > 	alvium_read_ ## sign ## bits(struct alvium_dev *alvium, u32 reg, \
> > > > > > 				     sign ## bits *val, int *err) \
> > > > > > 	{ \
> > > > > > 		u64 val64; \
> > > > > > 		int ret; \
> > > > > > 			\
> > > > > > 		if (err && *err < 0) \
> > > > > > 			return *err; \
> > > > > > 			\
> > > > > > 		alvium_read(alvium, reg, &val64, &ret); \
> > > > > > 		if (ret < 0) { \
> > > > > > 			if (err) \
> > > > > > 				*err = ret; \
> > > > > > 			return ret; \
> > > > > > 		}	\
> > > > > > 			\
> > > > > > 		*val = val64; \
> > > > > > 			\
> > > > > > 		return 0; \
> > > > > > 	}
> > > > > > 
> > > > > > ALVIUM_DECLARE_READ(u, 32);
> > > > > > 
> > > > > > And then, e.g. instead of (and failing to check ret):
> > > > > > 
> > > > > > 	u64 val;
> > > > > > 
> > > > > > 	alvium_read(alvium, REG_BCRM_CONTRAST_VALUE_RW, &val, &ret);
> > > > > > 	alvium->dft_contrast = val;
> > > > > > 
> > > > > > you'd have a single call:
> > > > > > 
> > > > > > 	alvium_read_u32(alvium, REG_BCRM_CONTRAST_VALUE_RW,
> > > > > > 		        &alvium->dft_contrast, &ret);
> > > > > > 
> > > > > > And so on.
> > > > > > 
> > > > > > You can drop sign if you don't need signed reads but some of the struct
> > > > > > fields you're writing something appear to be signed.
> > > > > > 
> > > > > > It'd be good to check the register size matches with the size of *val, too.
> > > > > > Maybe something like:
> > > > > > 
> > > > > > WARN_ON((CCI_REG ## bits(0) && CCI_REG_WIDTH_MASK) >> CCI_REG_WIDTH_SHIFT
> > > > > > 	!= sizeof(sign ## bits));
> > > > > 
> > > > > I think this could actually be automated, and implemented in v4l2-cci.
> > > > > Something like the following:
> > > > > 
> > > > > diff --git a/drivers/media/v4l2-core/v4l2-cci.c b/drivers/media/v4l2-core/v4l2-cci.c
> > > > > index bc2dbec019b0..27f1eaa7777d 100644
> > > > > --- a/drivers/media/v4l2-core/v4l2-cci.c
> > > > > +++ b/drivers/media/v4l2-core/v4l2-cci.c
> > > > > @@ -16,7 +16,7 @@
> > > > > 
> > > > >  #include <media/v4l2-cci.h>
> > > > > 
> > > > > -int cci_read(struct regmap *map, u32 reg, u64 *val, int *err)
> > > > > +int __cci_read(struct regmap *map, u32 reg, void *val, int *err)
> > > > >  {
> > > > >  	unsigned int len;
> > > > >  	u8 buf[8];
> > > > > @@ -37,19 +37,19 @@ int cci_read(struct regmap *map, u32 reg, u64 *val, int *err)
> > > > > 
> > > > >  	switch (len) {
> > > > >  	case 1:
> > > > > -		*val = buf[0];
> > > > > +		*(u8 *)val = buf[0];
> > > > >  		break;
> > > > >  	case 2:
> > > > > -		*val = get_unaligned_be16(buf);
> > > > > +		*(u16 *)val = get_unaligned_be16(buf);
> > > > >  		break;
> > > > >  	case 3:
> > > > > -		*val = get_unaligned_be24(buf);
> > > > > +		*(u32 *)val = get_unaligned_be24(buf);
> > > > >  		break;
> > > > >  	case 4:
> > > > > -		*val = get_unaligned_be32(buf);
> > > > > +		*(u32 *)val = get_unaligned_be32(buf);
> > > > >  		break;
> > > > >  	case 8:
> > > > > -		*val = get_unaligned_be64(buf);
> > > > > +		*(u64 *)val = get_unaligned_be64(buf);
> > > > >  		break;
> > > > >  	default:
> > > > >  		dev_err(regmap_get_device(map), "Error invalid reg-width %u for reg 0x%04x\n",
> > > > > @@ -64,7 +64,7 @@ int cci_read(struct regmap *map, u32 reg, u64 *val, int *err)
> > > > > 
> > > > >  	return ret;
> > > > >  }
> > > > > -EXPORT_SYMBOL_GPL(cci_read);
> > > > > +EXPORT_SYMBOL_GPL(__cci_read);
> > > > > 
> > > > >  int cci_write(struct regmap *map, u32 reg, u64 val, int *err)
> > > > >  {
> > > > > @@ -119,7 +119,7 @@ int cci_update_bits(struct regmap *map, u32 reg, u64 mask, u64 val, int *err)
> > > > >  	u64 readval;
> > > > >  	int ret;
> > > > > 
> > > > > -	ret = cci_read(map, reg, &readval, err);
> > > > > +	ret = __cci_read(map, reg, &readval, err);
> > > > >  	if (ret)
> > > > >  		return ret;
> > > > > 
> > > > > diff --git a/include/media/v4l2-cci.h b/include/media/v4l2-cci.h
> > > > > index 0f6803e4b17e..31223ce8d741 100644
> > > > > --- a/include/media/v4l2-cci.h
> > > > > +++ b/include/media/v4l2-cci.h
> > > > > @@ -7,6 +7,9 @@
> > > > >  #ifndef _V4L2_CCI_H
> > > > >  #define _V4L2_CCI_H
> > > > > 
> > > > > +#include <linux/bitfield.h>
> > > > > +#include <linux/build_bug.h>
> > > > > +#include <linux/log2.h>
> > > > >  #include <linux/types.h>
> > > > > 
> > > > >  struct i2c_client;
> > > > > @@ -39,6 +42,8 @@ struct cci_reg_sequence {
> > > > >  #define CCI_REG32(x)			((4 << CCI_REG_WIDTH_SHIFT) | (x))
> > > > >  #define CCI_REG64(x)			((8 << CCI_REG_WIDTH_SHIFT) | (x))
> > > > > 
> > > > > +int __cci_read(struct regmap *map, u32 reg, void *val, int *err);
> > > > > +
> > > > >  /**
> > > > >   * cci_read() - Read a value from a single CCI register
> > > > >   *
> > > > > @@ -48,9 +53,17 @@ struct cci_reg_sequence {
> > > > >   * @err: Optional pointer to store errors, if a previous error is set
> > > > >   *       then the read will be skipped
> > > > >   *
> > > > > + * The type of the @val pointer must match the size of the register being read.
> > > > > + * Mismatches will result in compile-time errors.
> > > > > + *
> > > > >   * Return: %0 on success or a negative error code on failure.
> > > > >   */
> > > > > -int cci_read(struct regmap *map, u32 reg, u64 *val, int *err);
> > > > > +#define cci_read(map, reg, val, err) ({					\
> > > > > +	u32 __reg = (reg);						\
> > > > > +	u32 __size = FIELD_GET(CCI_REG_WIDTH_MASK, __reg);		\
> > > > > +	BUILD_BUG_ON(sizeof(*(val)) != roundup_pow_of_two(__size));	\
> > > > > +	__cci_read(map, __reg, (void *)(val), err);			\
> > > > > +})
> > > > > 
> > > > >  /**
> > > > >   * cci_write() - Write a value to a single CCI register
> > > > > 
> > > > > The change to cci_update_bits() is obviously wrong, I've hacked that to
> > > > > compile-test the rest with the drivers using cci_read(), and I get nice
> > > > > build-time errors due to usage of the wrong type :-)
> > > > > 
> > > > > Is this something that would be considered ? Bonus points to anyone who
> > > > > would fix cci_update_bits() :-)
> > > > 
> > > > I like the idea of moving this to v4l2-cci.
> > > > 
> > > > I'd prefer _Generic() based solution as we'd have exact types there instead
> > > > of just size. E.g. with the above code, reading a value to a long variable
> > > > would work on some archs but fail on others.
> > > 
> > > Doesn't _Generic() treat compatible types identically ?
> > 
> > Ah, it does, indeed. So that doesn't solve the long problem.
> > 
> > I guess the code will be more compact with just void *, on the expense of
> > (some) type checking.
> > 
> > I'm fine with either.
> 
> You can't check the variable size matches the register width by using a
> void pointer. That'd be a source for possibly difficult to debug problems:
> passing a pointer to u8 variable while reading a 64-bit register overwrites
> seven bytes on the stack outside the variable itself.
> 
> Let's use _Generic().

I still don't see how that will help :-) The prototype of the
__cci_read() function is unrelated to whether or not _Generic() gets
used. The cci_read() macro will cause a *build* time error if the value
pointer doesn't match the register size. The __cci_read() function must
not be used directly by drivers.

-- 
Regards,

Laurent Pinchart