Capitalize "Add" in subject.
On Wed, Nov 10, 2021 at 05:14:45PM -0500, Jim Quinlan wrote:
> Adds a mechanism inside the root port device to identify standard PCIe
> regulators in the DT, allocate them, and turn them on before the rest of
> the bus is scanned during pci_host_probe(). A root complex driver can
> leverage this mechanism by setting the pci_ops methods add_bus and
> remove_bus to pci_subdev_regulators_{add,remove}_bus.
s/Adds a/Add a/
> The allocated structure that contains the regulators is stored in
> dev.driver_data.
>
> The unabridged reason for doing this is as follows. We would like the
> Broadcom STB PCIe root complex driver (and others) to be able to turn
> off/on regulators[1] that provide power to endpoint[2] devices. Typically,
> the drivers of these endpoint devices are stock Linux drivers that are not
> aware that these regulator(s) exist and must be turned on for the driver to
> be probed. The simple solution of course is to turn these regulators on at
> boot and keep them on. However, this solution does not satisfy at least
> three of our usage modes:
>
> 1. For example, one customer uses multiple PCIe controllers, but wants the
> ability to, by script invoking and unbind, turn any or all of them by and
> their subdevices off to save power, e.g. when in battery mode.
>
> 2. Another example is when a watchdog script discovers that an endpoint
> device is in an unresponsive state and would like to unbind, power toggle,
> and re-bind just the PCIe endpoint and controller.
>
> 3. Of course we also want power turned off during suspend mode. However,
> some endpoint devices may be able to "wake" during suspend and we need to
> recognise this case and veto the nominal act of turning off its regulator.
> Such is the case with Wake-on-LAN and Wake-on-WLAN support where PCIe
> end-point device needs to be kept powered on in order to receive network
> packets and wake-up the system.
>
> In all of these cases it is advantageous for the PCIe controller to govern
> the turning off/on the regulators needed by the endpoint device. The first
> two cases can be done by simply unbinding and binding the PCIe controller,
> if the controller has control of these regulators.
>
> [1] These regulators typically govern the actual power supply to the
> endpoint chip. Sometimes they may be a the official PCIe socket
> power -- such as 3.3v or aux-3.3v. Sometimes they are truly
> the regulator(s) that supply power to the EP chip.
s/may be a the/may be the/
> [2] The 99% configuration of our boards is a single endpoint device
> attached to the PCIe controller. I use the term endpoint but it could
> possible mean a switch as well.
s/possible/possibly/
This adds generic code, so it needs some connection to the generic DT
binding for these things, e.g., a commit in this series that adds it
(I see commits that touch brcm,stb-pcie.yaml, but not a generic
place).
> +static void *alloc_subdev_regulators(struct device *dev)
> +{
> + static const char * const supplies[] = {
> + "vpcie3v3",
> + "vpcie3v3aux",
> + "vpcie12v",
> + };
> + const size_t size = sizeof(struct subdev_regulators)
> + + sizeof(struct regulator_bulk_data) * ARRAY_SIZE(supplies);
> + struct subdev_regulators *sr;
> + int i;
> +
> + sr = devm_kzalloc(dev, size, GFP_KERNEL);
> +
> + if (sr) {
> + sr->num_supplies = ARRAY_SIZE(supplies);
> + for (i = 0; i < ARRAY_SIZE(supplies); i++)
> + sr->supplies[i].supply = supplies[i];
> + }
> +
> + return sr;
> +}
> +
> +
Spurious blank line.
> +int pci_subdev_regulators_add_bus(struct pci_bus *bus)
> ...
> @@ -131,6 +155,13 @@ static int pcie_portdrv_probe(struct pci_dev *dev,
> if (status)
> return status;
>
> + if (dev->bus->ops &&
> + dev->bus->ops->add_bus &&
> + dev->bus->dev.driver_data) {
> + pcie_portdriver.resume = subdev_regulator_resume;
> + pcie_portdriver.suspend = subdev_regulator_suspend;
The pci_driver.resume() and pci_driver.suspend() methods are going
away, so we shouldn't add new uses like this.
Doesn't this trigger the warning in pci_has_legacy_pm_support() about
supporting both legacy PM and the new PM?
Bjorn
