public inbox for linux-kernel@vger.kernel.org
 help / color / mirror / Atom feed
From: Lee Jones <lee@kernel.org>
To: Artur Weber <aweber.kernel@gmail.com>
Cc: linux-kernel@vger.kernel.org, phone-devel@vger.kernel.org,
	~postmarketos/upstreaming@lists.sr.ht,
	Stanislav Jakubek <stano.jakubek@gmail.com>
Subject: Re: [PATCH v3] mfd: bcm590xx: Add support for interrupt handling
Date: Thu, 13 Nov 2025 13:26:48 +0000	[thread overview]
Message-ID: <20251113132648.GG1949330@google.com> (raw)
In-Reply-To: <b0cffa2f-6ad2-40a3-a5ee-5df6b2918524@gmail.com>

On Wed, 29 Oct 2025, Artur Weber wrote:

> On 23.10.2025 15:03, Lee Jones wrote:
> > On Mon, 13 Oct 2025, Artur Weber wrote:
> > 
> > > The BCM590XX supports up to 128 internal interrupts, which are used by
> > > various parts of the chip. Add regmap_irq-based interrupt handling and
> > > helper functions to allow subdevice drivers to easily use the interrupts.
> > > 
> > > Signed-off-by: Artur Weber <aweber.kernel@gmail.com>
> > > 
> > > (...)>>
> > > diff --git a/drivers/mfd/bcm590xx.c b/drivers/mfd/bcm590xx.c
> > > index 5a8456bbd63f..fb6afe277ebf 100644
> > > --- a/drivers/mfd/bcm590xx.c
> > > +++ b/drivers/mfd/bcm590xx.c
> > > @@ -26,16 +26,29 @@
> > >   #define BCM590XX_PMUREV_ANA_MASK	0xF0
> > >   #define BCM590XX_PMUREV_ANA_SHIFT	4
> > > +#define BCM590XX_REG_IRQ1		0x20
> > > +#define BCM590XX_REG_IRQ1MASK		0x30
> > 
> > This isn't better.
> > 
> > And now the nomenclature is inconsistent with the one above.
> > 
> > What is a mask register?  I don't understand.
> 
> The IRQxMASK registers store the interrupt masks for each interrupt. To
> explain this more clearly:
> 
> The BCM590xx chips have up to 128 internal interrupts (the exact number
> is different between the BCM59054 and BCM59056, but both reserve the
> exact same amount of registers for them).
> 
> The status of each interrupt is stored in the IRQx registers
> (0x20-0x2f), and each bit represents a single interrupt.
> 
> The interrupt masks (that is, whether the interrupt is enabled or
> disabled) are stored in the IRQx_MASK registers (0x30-0x3f), and each
> bit represents the mask for a single interrupt, in the same order as the
> IRQx registers. (...would IRQMASKx be more consistent?)
> 
> Each register stores 8 bits of data, meaning the {status, mask} for 8
> interrupts can fit into one {status, mask} register.

Okay, so the "MASK" thing is just silly naming by the H/W designers?

STATUS or ENABLE sounds like it would be better, since a "mask" to me is
a software term which describes the methods for manipulating these kinds
of groups of bits.

> > > +{
> > > +	/*
> > > +	 * IRQ registers are clear-on-read, make sure we don't cache them
> > > +	 * so that they get read/cleared correctly
> > > +	 */
> > > +	return (reg >= BCM590XX_REG_IRQ1 && reg <= (BCM590XX_REG_IRQ1 + 15));
> > > +}
> > > +
> > >   static const struct regmap_config bcm590xx_regmap_config_pri = {
> > >   	.reg_bits	= 8,
> > >   	.val_bits	= 8,
> > >   	.max_register	= BCM590XX_MAX_REGISTER_PRI,
> > > +	.volatile_reg	= bcm590xx_volatile_pri,
> > >   	.cache_type	= REGCACHE_MAPLE,
> > >   };
> > > @@ -46,6 +59,258 @@ static const struct regmap_config bcm590xx_regmap_config_sec = {
> > >   	.cache_type	= REGCACHE_MAPLE,
> > >   };
> > > +#define BCM590XX_REGMAP_IRQ_REG(id)	REGMAP_IRQ_REG_LINE(id, 8)
> > 
> > It looks like this may benefit more than just this driver.
> > 
> > Please create a generic helper in include/linux/regmap.h.
> > 
> > Perhaps REGMAP_IRQ_REG_LINE_BYTE, or whatever the 8 represents.
> 
> I would rather avoid modifying the regmap code if possible.

Why not?

> I've seen another driver (drivers/power/supply/max77705_charger.c) use
> REGMAP_IRQ_REG_LINE(id, BITS_PER_BYTE), which is more descriptive than
> just leaving the raw number of bits. Would that be a good alternative?

Sounds fine to me.

-- 
Lee Jones [李琼斯]

  reply	other threads:[~2025-11-13 13:26 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-10-13 13:41 [PATCH v3] mfd: bcm590xx: Add support for interrupt handling Artur Weber
2025-10-23 13:03 ` Lee Jones
2025-10-29 12:34   ` Artur Weber
2025-11-13 13:26     ` Lee Jones [this message]
2026-01-24 20:38       ` Artur Weber
2026-02-04 13:15         ` Lee Jones
2026-01-24 20:23   ` Artur Weber
2026-02-04 13:18     ` Lee Jones

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=20251113132648.GG1949330@google.com \
    --to=lee@kernel.org \
    --cc=aweber.kernel@gmail.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=phone-devel@vger.kernel.org \
    --cc=stano.jakubek@gmail.com \
    --cc=~postmarketos/upstreaming@lists.sr.ht \
    /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