Date:   Sat, 11 Mar 2023 10:06:05 -0500
From:   William Breathitt Gray <william.gray@linaro.org>
To:     Guenter Roeck <linux@roeck-us.net>
Cc:     wim@linux-watchdog.org, linux-watchdog@vger.kernel.org,
        linux-kernel@vger.kernel.org,
        Andy Shevchenko <andriy.shevchenko@linux.intel.com>,
        Paul Demetrotion <pdemetrotion@winsystems.com>,
        techsupport@winsystems.com
Subject: Re: [PATCH] watchdog: ebc-c384_wdt: Migrate to the regmap API
Message-ID: <ZAyY3VGlo4N4SLZQ@fedora>
References: <20230311004404.62980-1-william.gray@linaro.org>
 <b65233f4-c8e2-435d-8321-03cc5f6b1c3d@roeck-us.net>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
        protocol="application/pgp-signature"; boundary="b+Kv2GvGpypcTEIM"
Content-Disposition: inline
In-Reply-To: <b65233f4-c8e2-435d-8321-03cc5f6b1c3d@roeck-us.net>
Precedence: bulk


--b+Kv2GvGpypcTEIM
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Sat, Mar 11, 2023 at 06:04:08AM -0800, Guenter Roeck wrote:
> On Fri, Mar 10, 2023 at 07:44:04PM -0500, William Breathitt Gray wrote:
> > The regmap API supports IO port accessors so we can take advantage of
> > regmap abstractions rather than handling access to the device registers
> > directly in the driver.
> >=20
> > Suggested-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
> > Signed-off-by: William Breathitt Gray <william.gray@linaro.org>
>=20
> I assume you did, but just to be sure: Did you test this on hardware ?

I've only done a build test; I no longer have access to a WINSYSTEMS
EBC-C384 motherboard to test this on real hardware. I've CC'd Paul
Demetrotion and the WINSYSTEMS tech support list to this thread as
hopefully one of the WINSYSTEMS engineers may help us test this.

> > @@ -37,43 +40,54 @@ module_param(timeout, uint, 0);
> >  MODULE_PARM_DESC(timeout, "Watchdog timeout in seconds (default=3D"
> >  	__MODULE_STRING(WATCHDOG_TIMEOUT) ")");
> > =20
> > +static const struct regmap_range ebc_c384_wdt_wr_ranges[] =3D {
> > +	regmap_reg_range(0x1, 0x2),
>=20
> Any reasons for not using defines ?

I feel direct addresses are somewhat clearer in this context. Regmap
configurations describe the address range of valid read and write
operations. Although the range for this device is simple, other devices
might have multiple ranges with gaps of invalid addresses.

For example, our valid write address range is 0x1-0x2 here:

    regmap_reg_range(0x1, 0x2)

Which is much clearer than trying to match these to register defines:

    regmap_reg_range(CFG_REG, PET_REG)

Because it's not immediately clear that CFG_REG to PET_REG is a
contiguous address range.

> > +};
> > +static const struct regmap_access_table ebc_c384_wdt_wr_table =3D {
> > +	.yes_ranges =3D ebc_c384_wdt_wr_ranges,
> > +	.n_yes_ranges =3D ARRAY_SIZE(ebc_c384_wdt_wr_ranges),
> > +};
> > +static const struct regmap_config ebc_c384_wdt_regmap_config =3D {
> > +	.reg_bits =3D 8,
> > +	.reg_stride =3D 1,
> > +	.val_bits =3D 8,
> > +	.io_port =3D true,
> > +	.max_register =3D 0x2,
>=20
> Any reason for not using a define ?

Same reason as above: `max_register =3D 0x2` is already clear enough and
`max_register =3D EBC_C384_MAX_REGISTER` wouldn't add any substantial
clarity.

> > +	.wr_table =3D &ebc_c384_wdt_wr_table,
> > +};
> > +
> >  static int ebc_c384_wdt_start(struct watchdog_device *wdev)
> >  {
> > +	struct regmap *const map =3D wdev->driver_data;
>=20
> Please use watchdog_get_drvdata() and watchdog_set_drvdata() when accessi=
ng
> or setting watchdog driver data.
>=20
> Guenter

I'll adjust the driver_data interactions in my v2 submission to utilize
watchdog_get_drvdata() and watchdog_set_drvdata().

William Breathitt Gray

--b+Kv2GvGpypcTEIM
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iHUEARYKAB0WIQSNN83d4NIlKPjon7a1SFbKvhIjKwUCZAyY3QAKCRC1SFbKvhIj
K7ZYAP0ame//zn/G+yvSJeRUMTvZqJhg5hNgtPG5kKZDam+8mgEA2zNrGImNqwNe
bjBGtRFEADurS58TbPdwdjn8yZ+9QAE=
=zCZs
-----END PGP SIGNATURE-----

--b+Kv2GvGpypcTEIM--