[PATCH v1 1/2] mfd: mt6397: Add new bit definitions for RTC_BBPU register

[Shunxi Zhang (章顺喜)]

On Mon, 2025-08-11 at 15:21 +0400, Giorgi Tchankvetadze wrote:
> External email : Please do not click links or open attachments until
> you have verified the sender or the content.
> 
> 
> Cc: Krzysztof Kozlowski <krzk at kernel.org>,
>     linux-mediatek at lists.infradead.org,
>     linux-rtc at vger.kernel.org,
>     linux-kernel at vger.kernel.org
> 
> Shunxi,
> 
> Can you confirm whether `RTC_BBPU_PWREN` (bit 0),
> `RTC_BBPU_CLR` (bit 1) and `RTC_BBPU_RESET_AL` (bit 3) are documented
> in the MT6397 datasheet (please cite section/page)? They look like
> standard RTC controls (power enable, clear/reset, alarm reset) and
> might be useful to include, but I agree with Krzysztof that adding
> definitions with no users can accumulate technical debt.
> 
> Suggestion: either
> - add the definitions when a driver actually needs them, or
> - keep them now but add a short rationale in the commit message
>   (datasheet reference + intended use) so future reviewers understand
>   why they exist.
> 
> Also: please split cosmetic whitespace fixes (RTC_BBPU_KEY) into a
> separate patch to make review/merge easier.
> 
> Thanks for the patch; I’m following the thread.
> 
> — Giorgi

Dear sir,
The MT6397 is an integration of several ICs and does not have a
separate IC specification. I will check the relevant IC datasheets
again. I will remove the useless define in next version.

Thanks for your commnets.

Best regards
Shunxi Zhangus
> 
> 
> On Mon, Aug 11, 2025 at 3:03 PM Krzysztof Kozlowski <krzk at kernel.org>
> wrote:
> > 
> > On 11/08/2025 10:15, ot_shunxi.zhang at mediatek.com wrote:
> > > From: Shunxi Zhang <ot_shunxi.zhang at mediatek.com>
> > > 
> > > This patch adds new bit definitions for the RTC_BBPU register in
> > > the
> > 
> > Why? There is no user of these. Don't add useless defines.
> > 
> > > mt6397 RTC header file. The following bit definitions are
> > > introduced:
> > 
> > Hm?
> > 
> > > 
> > > Signed-off-by: Shunxi Zhang <ot_shunxi.zhang at mediatek.com>
> > > ---
> > >  include/linux/mfd/mt6397/rtc.h | 5 ++++-
> > >  1 file changed, 4 insertions(+), 1 deletion(-)
> > > 
> > > diff --git a/include/linux/mfd/mt6397/rtc.h
> > > b/include/linux/mfd/mt6397/rtc.h
> > > index 27883af44f87..001cef6b7302 100644
> > > --- a/include/linux/mfd/mt6397/rtc.h
> > > +++ b/include/linux/mfd/mt6397/rtc.h
> > > @@ -15,8 +15,11 @@
> > >  #include <linux/rtc.h>
> > > 
> > >  #define RTC_BBPU               0x0000
> > > +#define RTC_BBPU_PWREN         BIT(0)
> > > +#define RTC_BBPU_CLR           BIT(1)
> > > +#define RTC_BBPU_RESET_AL      BIT(3)
> > >  #define RTC_BBPU_CBUSY         BIT(6)
> > > -#define RTC_BBPU_KEY            (0x43 << 8)
> > > +#define RTC_BBPU_KEY           (0x43 << 8)
> > 
> > 
> > Why?
> > 
> > 
> > 
> > Best regards,
> > Krzysztof
> >