Commit 0235c4fc authored by Rafael J. Wysocki's avatar Rafael J. Wysocki Committed by Jesse Barnes
Browse files

PCI PM: Introduce function pci_wake_from_d3 



Many device drivers use the following sequence of statements to enable
the device to wake up the system while being in the D3_hot or D3_cold
low power state:

        pci_enable_wake(pdev, PCI_D3hot, 1);
        pci_enable_wake(pdev, PCI_D3cold, 1);

However, the second call is not necessary if the first one succeeds (the
ordering of the statements above doesn't matter here) and it may even be
harmful, because we are not supposed to enable PME# after the wake-up
power has been enabled for the device.

To allow drivers to overcome this problem, introduce function
pci_wake_from_d3() that will enable the device to wake up the system
from any of D3_hot and D3_cold as long as the wake-up from at least one
of them is supported.

Acked-by: default avatarPavel Machek <pavel@suse.cz>
Signed-off-by: default avatarRafael J. Wysocki <rjw@sisk.pl>
Signed-off-by: default avatarJesse Barnes <jbarnes@virtuousgeek.org>
parent 3d137310

drivers/pci/pci.c

+22 −0
Original line number Diff line number Diff line
@@ -1126,6 +1126,27 @@ int pci_enable_wake(struct pci_dev *dev, pci_power_t state, int enable) 
	return pme_done ? 0 : error;

}



/**

 * pci_wake_from_d3 - enable/disable device to wake up from D3_hot or D3_cold

 * @dev: PCI device to prepare

 * @enable: True to enable wake-up event generation; false to disable

 *

 * Many drivers want the device to wake up the system from D3_hot or D3_cold

 * and this function allows them to set that up cleanly - pci_enable_wake()

 * should not be called twice in a row to enable wake-up due to PCI PM vs ACPI

 * ordering constraints.

 *

 * This function only returns error code if the device is not capable of

 * generating PME# from both D3_hot and D3_cold, and the platform is unable to

 * enable wake-up power for it.

 */

int pci_wake_from_d3(struct pci_dev *dev, bool enable)

{

	return pci_pme_capable(dev, PCI_D3cold) ?

			pci_enable_wake(dev, PCI_D3cold, enable) :

			pci_enable_wake(dev, PCI_D3hot, enable);

}



/**

 * pci_target_state - find an appropriate low power state for a given PCI dev

 * @dev: PCI device
@@ -1942,6 +1963,7 @@ EXPORT_SYMBOL(pci_restore_state); 
EXPORT_SYMBOL(pci_pme_capable);

EXPORT_SYMBOL(pci_pme_active);

EXPORT_SYMBOL(pci_enable_wake);

EXPORT_SYMBOL(pci_wake_from_d3);

EXPORT_SYMBOL(pci_target_state);

EXPORT_SYMBOL(pci_prepare_to_sleep);

EXPORT_SYMBOL(pci_back_from_sleep);

include/linux/pci.h

+1 −0
Original line number Diff line number Diff line
@@ -644,6 +644,7 @@ pci_power_t pci_choose_state(struct pci_dev *dev, pm_message_t state); 
bool pci_pme_capable(struct pci_dev *dev, pci_power_t state);

void pci_pme_active(struct pci_dev *dev, bool enable);

int pci_enable_wake(struct pci_dev *dev, pci_power_t state, int enable);

int pci_wake_from_d3(struct pci_dev *dev, bool enable);

pci_power_t pci_target_state(struct pci_dev *dev);

int pci_prepare_to_sleep(struct pci_dev *dev);

int pci_back_from_sleep(struct pci_dev *dev);

CRA Git | Maintained and supported by SUSTech CRA and CCSE