[PATCH 07/19] bus/cdx: add device attributes

[Gupta, Nipun]

[AMD Official Use Only - General]



> -----Original Message-----
> From: Greg KH <gregkh at linuxfoundation.org>
> Sent: Tuesday, January 17, 2023 7:44 PM
> To: Gupta, Nipun <Nipun.Gupta at amd.com>
> Cc: robh+dt at kernel.org; krzysztof.kozlowski+dt at linaro.org; rafael at kernel.org;
> eric.auger at redhat.com; alex.williamson at redhat.com; cohuck at redhat.com;
> song.bao.hua at hisilicon.com; mchehab+huawei at kernel.org; maz at kernel.org;
> f.fainelli at gmail.com; jeffrey.l.hugo at gmail.com; saravanak at google.com;
> Michael.Srba at seznam.cz; mani at kernel.org; yishaih at nvidia.com;
> jgg at ziepe.ca; jgg at nvidia.com; robin.murphy at arm.com; will at kernel.org;
> joro at 8bytes.org; masahiroy at kernel.org; ndesaulniers at google.com; linux-arm-
> kernel at lists.infradead.org; linux-kbuild at vger.kernel.org; linux-
> kernel at vger.kernel.org; devicetree at vger.kernel.org; okaya at kernel.org;
> Anand, Harpreet <harpreet.anand at amd.com>; Agarwal, Nikhil
> <nikhil.agarwal at amd.com>; Simek, Michal <michal.simek at amd.com>; git
> (AMD-Xilinx) <git at amd.com>
> Subject: Re: [PATCH 07/19] bus/cdx: add device attributes
> 
> Caution: This message originated from an External Source. Use proper caution
> when opening attachments, clicking links, or responding.
> 
> 
> On Tue, Jan 17, 2023 at 07:11:39PM +0530, Nipun Gupta wrote:
> > Create sysfs entry for CDX devices.
> >
> > Sysfs entries provided in each of the CDX device detected by
> > the CDX controller
> >  - vendor id
> >  - device id
> >  - remove
> >  - reset of the device.
> >  - driver override
> >
> > Signed-off-by: Puneet Gupta <puneet.gupta at amd.com>
> > Signed-off-by: Nipun Gupta <nipun.gupta at amd.com>
> > Signed-off-by: Tarak Reddy <tarak.reddy at amd.com>
> > ---
> >  Documentation/ABI/testing/sysfs-bus-cdx     |  34 +++++
> >  drivers/bus/cdx/cdx.c                       | 144 ++++++++++++++++++++
> >  drivers/bus/cdx/controller/cdx_controller.c |  19 +++
> >  drivers/bus/cdx/controller/mcdi_functions.c |  14 ++
> >  drivers/bus/cdx/controller/mcdi_functions.h |  11 ++
> >  include/linux/cdx/cdx_bus.h                 |  23 ++++
> >  6 files changed, 245 insertions(+)
> >
> > diff --git a/Documentation/ABI/testing/sysfs-bus-cdx
> b/Documentation/ABI/testing/sysfs-bus-cdx
> > index 8c2425fdb6d9..1e0fdce18cde 100644
> > --- a/Documentation/ABI/testing/sysfs-bus-cdx
> > +++ b/Documentation/ABI/testing/sysfs-bus-cdx
> > @@ -10,3 +10,37 @@ Description:
> >                  For example::
> >
> >                 # echo 1 > /sys/bus/cdx/rescan
> > +
> > +What:                /sys/bus/cdx/devices/.../vendor
> > +Date:                January 2023
> > +Contact:     nipun.gupta at amd.com
> > +Description:
> > +             Vendor ID for this CDX device
> 
> What format is this in?  How big is it?  Examples?

This is 16 bits. Agree need to add more info on this and other params.
Will update in next version.

> 
> > +
> > +What:                /sys/bus/cdx/devices/.../device
> > +Date:                January 2023
> > +Contact:     nipun.gupta at amd.com
> > +Description:
> > +             Device ID for this CDX device
> 
> Same here, be specific.
> 
> > +
> > +What:                /sys/bus/cdx/devices/.../reset
> > +Date:                January 2023
> > +Contact:     nipun.gupta at amd.com
> > +Description:
> > +             Writing a non-zero value to this file would reset the
> > +             CDX device
> > +
> > +                For example::
> > +
> > +               # echo 1 > /sys/bus/cdx/.../reset
> 
> Will that remove the device from the driver too?

No, it will not remove the device from the driver. We would
Introduce reset_done and reset_prepare callbacks which would
inform the device driver about reset in next spin.

> 
> Again, more documentation please.

Sure.

> 
> > +
> > +What:                /sys/bus/cdx/devices/.../remove
> > +Date:                January 2023
> > +Contact:     tarak.reddy at amd.com
> > +Description:
> > +             Writing a non-zero value to this file would remove the
> > +             corrosponding device from the CDX bus
> > +
> > +             For example::
> > +
> > +             # echo 1 > /sys/bus/cdx/devices/.../remove
> 
> Why would you want to remove a device from the bus like this?

This is required to prepare the bus for applying new fabric
configuration (pseudo hot plug). So that driver does not access the
device while it is being reconfigured.

> 
> > diff --git a/drivers/bus/cdx/cdx.c b/drivers/bus/cdx/cdx.c
> > index 2737470f08d3..1372d8dcaa4c 100644
> > --- a/drivers/bus/cdx/cdx.c
> > +++ b/drivers/bus/cdx/cdx.c
> > @@ -72,6 +72,38 @@ static DECLARE_BITMAP(cdx_controller_id_map,
> MAX_CDX_CONTROLLERS);
> >  /* List of CDX controllers registered with the CDX bus */
> >  static LIST_HEAD(cdx_controllers);
> >
> > +/**
> > + * reset_cdx_device - Reset a CDX device
> > + * @dev: CDX device
> > + * @data: This is always passed as NULL, and is not used in this API,
> > + *     but is required here as the bus_for_each_dev() API expects
> > + *     the passed function (reset_cdx_device) to have this
> > + *     as an argument.
> > + *
> > + * @return: -errno on failure, 0 on success.
> 
> I recommend this function actually be the one without the data pointer,
> that way you don't get confused here.

Agree will update this.

> 
> > + */
> > +static int reset_cdx_device(struct device *dev, void *data)
> > +{
> > +     struct cdx_device *cdx_dev = to_cdx_device(dev);
> > +     struct cdx_controller *cdx = cdx_dev->cdx;
> > +     struct cdx_device_config dev_config;
> > +     int ret;
> > +
> > +     dev_config.type = CDX_DEV_RESET_CONF;
> > +     ret = cdx->ops->dev_configure(cdx, cdx_dev->bus_num,
> > +                                   cdx_dev->dev_num, &dev_config);
> > +     if (ret)
> > +             dev_err(dev, "cdx device reset failed\n");
> > +
> > +     return ret;
> > +}
> > +
> > +int cdx_dev_reset(struct device *dev)
> > +{
> > +     return reset_cdx_device(dev, NULL);
> > +}
> > +EXPORT_SYMBOL_GPL(cdx_dev_reset);
> 
> Remove the indirection as mentioned above please.
> 
> Otherwise, very minor comments, nice work.
> 
> greg k-h