From mboxrd@z Thu Jan 1 00:00:00 1970 From: Pavel Machek Subject: Re: [PATCH v3 07/11] power: supply: max77650: add support for battery charger Date: Tue, 12 Feb 2019 14:54:26 +0100 Message-ID: <20190212135426.GA2723@amd> References: <20190201094736.32057-1-brgl@bgdev.pl> <20190201094736.32057-8-brgl@bgdev.pl> <20190212120742.GA25613@amd> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="NzB8fVQJ5HfG6fxh" Return-path: Content-Disposition: inline In-Reply-To: Sender: linux-kernel-owner@vger.kernel.org To: Bartosz Golaszewski Cc: Rob Herring , Mark Rutland , Linus Walleij , Dmitry Torokhov , Jacek Anaszewski , Lee Jones , Sebastian Reichel , Liam Girdwood , Greg Kroah-Hartman , Linux Kernel Mailing List , "open list:GPIO SUBSYSTEM" , devicetree , Linux Input , Linux LED Subsystem , Linux PM list , Bartosz Golaszewski List-Id: linux-leds@vger.kernel.org --NzB8fVQJ5HfG6fxh Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue 2019-02-12 14:31:52, Bartosz Golaszewski wrote: > wt., 12 lut 2019 o 13:07 Pavel Machek napisa=C5=82(a): > > > > Hi! > > > > > +#define MAX77650_CHARGER_ENABLED BIT(0) > > > +#define MAX77650_CHARGER_DISABLED 0x00 > > > +#define MAX77650_CHARGER_CHG_EN_MASK BIT(0) > > > + > > > +#define MAX77650_CHARGER_CHG_DTLS_MASK GENMASK(7, 4) > > > +#define MAX77650_CHARGER_CHG_DTLS_BITS(_reg) \ > > > + (((_reg) & MAX77650_CHARGER_CHG_DTLS_MASK) >> 4) > > > + > > > +#define MAX77650_CHARGER_CHG_OFF 0x00 > > > +#define MAX77650_CHARGER_CHG_PREQ 0x01 > > > +#define MAX77650_CHARGER_CHG_ON_CURR 0x02 > > > +#define MAX77650_CHARGER_CHG_ON_JCURR 0x03 > > > +#define MAX77650_CHARGER_CHG_ON_VOLT 0x04 > > > +#define MAX77650_CHARGER_CHG_ON_JVOLT 0x05 > > > +#define MAX77650_CHARGER_CHG_ON_TOPOFF 0x06 > > > +#define MAX77650_CHARGER_CHG_ON_JTOPOFF 0x07 > > > +#define MAX77650_CHARGER_CHG_DONE 0x08 > > > +#define MAX77650_CHARGER_CHG_JDONE 0x09 > > > +#define MAX77650_CHARGER_CHG_SUSP_PF 0x0a > > > +#define MAX77650_CHARGER_CHG_SUSP_FCF 0x0b > > > +#define MAX77650_CHARGER_CHG_SUSP_BTF 0x0c > > > > These are really bad define names. We are in charger driver, so > > MAX77650_CHARGER_ really should be shortened/ommited. OTOH > > more space should be given to "CHG_SUSP_BTF" as it is impossible to dec= ipher. > > >=20 > I disagree about the prefix bit. I prefer to use common prefixes for > all symbols in a driver. I would rather add comments to every > definition here. So what about shortened? (And what about UVL/OVL below?) And... what you prefer is not quite important. It is important that other people can read your code. And what "PF" is is important... unlike MAX77650_CHARGER_ which is long but unimportant. > > > +#define MAX77650_CHARGER_CHGIN_DTLS_MASK GENMASK(3, 2) > > > +#define MAX77650_CHARGER_CHGIN_DTLS_BITS(_reg) \ > > > + (((_reg) & MAX77650_CHARGER_CHGIN_DTLS_MASK) >> 2) > > > + > > > +#define MAX77650_CHARGER_CHGIN_UVL 0x00 > > > +#define MAX77650_CHARGER_CHGIN_OVL 0x01 > > > +#define MAX77650_CHARGER_CHGIN_OKAY 0x11 > > > > UVL -> UNDERVOLTAGE, OVL -> OVERVOLTAGE? > > > > > > -- > > (english) http://www.livejournal.com/~pavelmachek > > (cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses= /blog.html --=20 (english) http://www.livejournal.com/~pavelmachek (cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blo= g.html --NzB8fVQJ5HfG6fxh Content-Type: application/pgp-signature; name="signature.asc" Content-Description: Digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iEYEARECAAYFAlxi0BIACgkQMOfwapXb+vIaagCgk6DlnW3/xbOCbPYyCrnh2T7N 1bIAoJVMj262FTNdBE3Hoc3T17lu2iCz =Csmp -----END PGP SIGNATURE----- --NzB8fVQJ5HfG6fxh--