Re: [PATCH 1/5] soundwire: bus_type: add master_device/driver support
From: Pierre-Louis Bossart
Date: Fri Mar 20 2020 - 14:18:10 EST
Thanks for the quick review Srinivas,
This patch in general is missing device tree support for both matching
and uevent so this will not clearly work for Qualcomm controller unless
we do via platform bus, which does not sound right!
see other email, the platform bus is handled by a platform
device/driver. There was no intention to change that, it's by design
rather than an omission/error.
+
+/**
+ * sdw_master_device_startup() - startup hardware
+ * @md: Linux Soundwire master device
+ *
+ * This use of this function is optional. It is only needed if the
+ * hardware cannot be started during a driver probe, e.g. due to power
+ * rail dependencies. The implementation is platform-specific but the
+ * bus will typically go through a hardware-reset sequence and devices
+ * will be enumerated once they report as ATTACHED.
+ */
+int sdw_master_device_startup(struct sdw_master_device *md)
+{
+ÂÂÂ struct sdw_master_driver *mdrv;
+ÂÂÂ struct device *dev;
+ÂÂÂ int ret = 0;
+
+ÂÂÂ if (IS_ERR_OR_NULL(md))
+ÂÂÂÂÂÂÂ return -EINVAL;
+
+ÂÂÂ dev = &md->dev;
+ÂÂÂ mdrv = drv_to_sdw_master_driver(dev->driver);
+
+ÂÂÂ if (mdrv && mdrv->startup)
+ÂÂÂÂÂÂÂ ret = mdrv->startup(md);
+
+ÂÂÂ return ret;
+}
+EXPORT_SYMBOL_GPL(sdw_master_device_startup);
Who would call this function? and How would it get hold of master device
instance ?
sdw_master_device_add() returns a struct_master_device *md, so the
parent has a handle to that device. See the device creation here:
https://github.com/thesofproject/linux/blob/9c7487b33072040ab755d32ca173b75151c0160c/drivers/soundwire/intel_init.c#L238
This startup() would be called by the parent when all
requirements/dependencies are met. Put differently, it allows the probe
to run much earlier and check for platform firmware information (which
links are enabled, what devices are exposed by platform firmware), while
the startup is really when the bus clk/data lines will start toggling.
https://github.com/thesofproject/linux/blob/9c7487b33072040ab755d32ca173b75151c0160c/drivers/soundwire/intel_init.c#L341
and the call from the SOF layer is here:
https://github.com/thesofproject/linux/blob/9c7487b33072040ab755d32ca173b75151c0160c/sound/soc/sof/intel/hda-loader.c#L418
Again, if everything is ready at probe time there's no need to delay the
actual bus startup. This is not needed for Qualcomm platforms where the
Master device is part of a codec. It's actually irrelevant since there
is no driver, so the startup callback does not even exist :-)
How would soundwire core also ensure that we do not actively use this
master if it is not ready. Similar comment for shutdown callback.
That's a fair point, we could add a state variable and a check that the
probe happened before.
In practice the two cases of device creation and startup are different
phases so it'd more of a paranoia check.
Thanks,
-Pierre