From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-15.5 required=3.0 tests=BAYES_00,INCLUDES_CR_TRAILER, INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_SANE_2 autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 8D039C433FE for ; Sat, 18 Sep 2021 16:28:22 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 729C961108 for ; Sat, 18 Sep 2021 16:28:22 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234300AbhIRQ3n (ORCPT ); Sat, 18 Sep 2021 12:29:43 -0400 Received: from mail.kernel.org ([198.145.29.99]:53522 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231415AbhIRQ3n (ORCPT ); Sat, 18 Sep 2021 12:29:43 -0400 Received: from jic23-huawei (cpc108967-cmbg20-2-0-cust86.5-4.cable.virginm.net [81.101.6.87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id E255861100; Sat, 18 Sep 2021 16:28:14 +0000 (UTC) Date: Sat, 18 Sep 2021 17:31:54 +0100 From: Jonathan Cameron To: Miquel Raynal Cc: Lars-Peter Clausen , Peter Meerwald-Stadler , Rob Herring , Dmitry Torokhov , Lee Jones , bcousson@baylibre.com, Tony Lindgren , linux-iio@vger.kernel.org, devicetree@vger.kernel.org, linux-omap@vger.kernel.org, Thomas Petazzoni , Vignesh Raghavendra , Lokesh Vutla , Tero Kristo , Ryan Barnett , Grygorii Strashko , Jason Reeder Subject: Re: [PATCH v3 28/47] mfd: ti_am335x_tscadc: Drop useless definitions from the header Message-ID: <20210918173154.70c0b04b@jic23-huawei> In-Reply-To: <20210915155908.476767-29-miquel.raynal@bootlin.com> References: <20210915155908.476767-1-miquel.raynal@bootlin.com> <20210915155908.476767-29-miquel.raynal@bootlin.com> X-Mailer: Claws Mail 4.0.0 (GTK+ 3.24.30; x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org On Wed, 15 Sep 2021 17:58:49 +0200 Miquel Raynal wrote: > Drop unused and useless definitions from the header. Besides the STEP > ENABLE register which is highly unclear (and not used), drop all the Agreed - I started trying to figure out what they were in the earlier patch! > "masks" definitions which are only used by the following definition. It > could be possible to got even further by removing these definitions > entirely and use FIELD_PREP() macros from the code directly, but while I > have no troubles making these changes in the header, changing the values > in the code directly could IMHO darkening a bit the logic and > furthermore hardening future git-blames. Hmm. Maybe on that... I'm not that bothered either way but there is definitely clarity in FIELD_PREP being used inline for writes to a device. You can very clearly see what is going on. Note that it only really works here because the driver only ever uses the masks to 'set' the value, but never to read any of them back from the hardware. Your point about it making a messy history is true of almost any change :) > > Certain macros are using GENMASK() to define the value of a particular > field, while this is purely "by chance" that the value and the mask have > the same value. In this case, drop the "mask" definition, use > FIELD_PREP() and GENMASK() in the macro defining the field, and use the > new macro to define the particular value by feeding directly the actual > number advertised in the datasheet into that macro, as in: > -#define STEPCONFIG_RFM_VREFN GENMASK(24, 23) > -#define STEPCONFIG_RFM(val) FIELD_PREP(STEPCONFIG_RFM_VREFN, (val)) > +#define STEPCONFIG_RFM(val) FIELD_PREP(GENMASK(24, 23), (val)) > +#define STEPCONFIG_RFM_VREFN STEPCONFIG_RFM(3) This is indeed an improvement. > > Signed-off-by: Miquel Raynal I'm a bit in two minds out about how you should handle the multiple patches involved in cleaning these up. Definitely not good to do modifications on elements you are going to drop - so for those pull them out earlier. The others are a little odd because you first introduce some of the GENMASK stuff then rework it in this patch. Perhaps this split is the best way to handle those. Jonathan > --- > include/linux/mfd/ti_am335x_tscadc.h | 51 +++++++++------------------- > 1 file changed, 16 insertions(+), 35 deletions(-) > > diff --git a/include/linux/mfd/ti_am335x_tscadc.h b/include/linux/mfd/ti_am335x_tscadc.h > index babc2e36c5d0..32b26e56eebb 100644 > --- a/include/linux/mfd/ti_am335x_tscadc.h > +++ b/include/linux/mfd/ti_am335x_tscadc.h > @@ -40,13 +40,6 @@ > /* IRQ wakeup enable */ > #define IRQWKUP_ENB BIT(0) > > -/* Step Enable */ > -#define STEPENB_MASK GENMASK(16, 0) > -#define STEPENB(val) FIELD_PREP(STEPENB_MASK, (val)) > -#define ENB(val) BIT(val) > -#define STPENB_STEPENB STEPENB(GENMASK(16, 0)) > -#define STPENB_STEPENB_TC STEPENB(GENMASK(12, 0)) > - With this first block moved much earlier in the series - to before any of the other patches touch it. Reviwed-by: Jonathan Cameron > /* IRQ enable */ > #define IRQENB_HW_PEN BIT(0) > #define IRQENB_EOS BIT(1) > @@ -59,12 +52,10 @@ > #define IRQENB_PENUP BIT(9) > > /* Step Configuration */ > -#define STEPCONFIG_MODE_MASK GENMASK(1, 0) > -#define STEPCONFIG_MODE(val) FIELD_PREP(STEPCONFIG_MODE_MASK, (val)) > +#define STEPCONFIG_MODE(val) FIELD_PREP(GENMASK(1, 0), (val)) > #define STEPCONFIG_MODE_SWCNT STEPCONFIG_MODE(1) > #define STEPCONFIG_MODE_HWSYNC STEPCONFIG_MODE(2) > -#define STEPCONFIG_AVG_MASK GENMASK(4, 2) > -#define STEPCONFIG_AVG(val) FIELD_PREP(STEPCONFIG_AVG_MASK, (val)) > +#define STEPCONFIG_AVG(val) FIELD_PREP(GENMASK(4, 2), (val)) > #define STEPCONFIG_AVG_16 STEPCONFIG_AVG(4) > #define STEPCONFIG_XPP BIT(5) > #define STEPCONFIG_XNN BIT(6) > @@ -72,45 +63,36 @@ > #define STEPCONFIG_YNN BIT(8) > #define STEPCONFIG_XNP BIT(9) > #define STEPCONFIG_YPN BIT(10) > -#define STEPCONFIG_RFP_VREFP GENMASK(13, 12) > -#define STEPCONFIG_RFP(val) FIELD_PREP(STEPCONFIG_RFP_VREFP, (val)) > -#define STEPCONFIG_INM_MASK GENMASK(18, 15) > -#define STEPCONFIG_INM(val) FIELD_PREP(STEPCONFIG_INM_MASK, (val)) > +#define STEPCONFIG_RFP(val) FIELD_PREP(GENMASK(13, 12), (val)) > +#define STEPCONFIG_RFP_VREFP STEPCONFIG_RFP(3) > +#define STEPCONFIG_INM(val) FIELD_PREP(GENMASK(18, 15), (val)) > #define STEPCONFIG_INM_ADCREFM STEPCONFIG_INM(8) > -#define STEPCONFIG_INP_MASK GENMASK(22, 19) > -#define STEPCONFIG_INP(val) FIELD_PREP(STEPCONFIG_INP_MASK, (val)) > +#define STEPCONFIG_INP(val) FIELD_PREP(GENMASK(22, 19), (val)) > #define STEPCONFIG_INP_AN4 STEPCONFIG_INP(4) > #define STEPCONFIG_INP_ADCREFM STEPCONFIG_INP(8) > #define STEPCONFIG_FIFO1 BIT(26) > -#define STEPCONFIG_RFM_VREFN GENMASK(24, 23) > -#define STEPCONFIG_RFM(val) FIELD_PREP(STEPCONFIG_RFM_VREFN, (val)) > +#define STEPCONFIG_RFM(val) FIELD_PREP(GENMASK(24, 23), (val)) > +#define STEPCONFIG_RFM_VREFN STEPCONFIG_RFM(3) > > /* Delay register */ > -#define STEPDELAY_OPEN_MASK GENMASK(17, 0) > -#define STEPDELAY_OPEN(val) FIELD_PREP(STEPDELAY_OPEN_MASK, (val)) > +#define STEPDELAY_OPEN(val) FIELD_PREP(GENMASK(17, 0), (val)) > #define STEPCONFIG_OPENDLY STEPDELAY_OPEN(0x098) > -#define STEPDELAY_SAMPLE_MASK GENMASK(31, 24) > -#define STEPDELAY_SAMPLE(val) FIELD_PREP(STEPDELAY_SAMPLE_MASK, (val)) > #define STEPCONFIG_MAX_OPENDLY GENMASK(17, 0) > +#define STEPDELAY_SAMPLE(val) FIELD_PREP(GENMASK(31, 24), (val)) > #define STEPCONFIG_SAMPLEDLY STEPDELAY_SAMPLE(0) > #define STEPCONFIG_MAX_SAMPLE GENMASK(7, 0) > > /* Charge Config */ > -#define STEPCHARGE_RFP_MASK GENMASK(14, 12) > -#define STEPCHARGE_RFP(val) FIELD_PREP(STEPCHARGE_RFP_MASK, (val)) > +#define STEPCHARGE_RFP(val) FIELD_PREP(GENMASK(14, 12), (val)) > #define STEPCHARGE_RFP_XPUL STEPCHARGE_RFP(1) > -#define STEPCHARGE_INM_MASK GENMASK(18, 15) > -#define STEPCHARGE_INM(val) FIELD_PREP(STEPCHARGE_INM_MASK, (val)) > +#define STEPCHARGE_INM(val) FIELD_PREP(GENMASK(18, 15), (val)) > #define STEPCHARGE_INM_AN1 STEPCHARGE_INM(1) > -#define STEPCHARGE_INP_MASK GENMASK(22, 19) > -#define STEPCHARGE_INP(val) FIELD_PREP(STEPCHARGE_INP_MASK, (val)) > -#define STEPCHARGE_RFM_MASK GENMASK(24, 23) > -#define STEPCHARGE_RFM(val) FIELD_PREP(STEPCHARGE_RFM_MASK, (val)) > +#define STEPCHARGE_INP(val) FIELD_PREP(GENMASK(22, 19), (val)) > +#define STEPCHARGE_RFM(val) FIELD_PREP(GENMASK(24, 23), (val)) > #define STEPCHARGE_RFM_XNUR STEPCHARGE_RFM(1) > > /* Charge delay */ > -#define CHARGEDLY_OPEN_MASK GENMASK(17, 0) > -#define CHARGEDLY_OPEN(val) FIELD_PREP(CHARGEDLY_OPEN_MASK, (val)) > +#define CHARGEDLY_OPEN(val) FIELD_PREP(GENMASK(17, 0), (val)) > #define CHARGEDLY_OPENDLY CHARGEDLY_OPEN(0x400) > > /* Control register */ > @@ -118,8 +100,7 @@ > #define CNTRLREG_STEPID BIT(1) > #define CNTRLREG_STEPCONFIGWRT BIT(2) > #define CNTRLREG_POWERDOWN BIT(4) > -#define CNTRLREG_AFE_CTRL_MASK GENMASK(6, 5) > -#define CNTRLREG_AFE_CTRL(val) FIELD_PREP(CNTRLREG_AFE_CTRL_MASK, (val)) > +#define CNTRLREG_AFE_CTRL(val) FIELD_PREP(GENMASK(6, 5), (val)) > #define CNTRLREG_4WIRE CNTRLREG_AFE_CTRL(1) > #define CNTRLREG_5WIRE CNTRLREG_AFE_CTRL(2) > #define CNTRLREG_8WIRE CNTRLREG_AFE_CTRL(3)