Commit df4f9bc4 authored by David E. Box's avatar David E. Box Committed by Christoph Hellwig
Browse files

nvme-pci: add support for ACPI StorageD3Enable property 

This patch implements a solution for a BIOS hack used on some currently
shipping Intel systems to change driver power management policy for PCIe
NVMe drives. Some newer Intel platforms, like some Comet Lake systems,
require that PCIe devices use D3 when doing suspend-to-idle in order to
allow the platform to realize maximum power savings. This is particularly
needed to support ATX power supply shutdown on desktop systems. In order to
ensure this happens for root ports with storage devices, Microsoft
apparently created this ACPI _DSD property as a way to influence their
driver policy. To my knowledge this property has not been discussed with
the NVME specification body.

Though the solution is not ideal, it addresses a problem that also affects
Linux since the NVMe driver's default policy of using NVMe APST during
suspend-to-idle prevents the PCI root port from going to D3 and leads to
higher power consumption for these platforms. The power consumption
difference may be negligible on laptop systems, but many watts on desktop
systems when the ATX power supply is blocked from powering down.

The patch creates a new nvme_acpi_storage_d3 function to check for the
StorageD3Enable property during probe and enables D3 as a quirk if set.  It
also provides a 'noacpi' module parameter to allow skipping the quirk if
needed.

Tested with:
 - PM961 NVMe SED Samsung 512GB
 - INTEL SSDPEKKF512G8

Link: https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/power-management-for-storage-hardware-devices-intro


Signed-off-by: default avatarDavid E. Box <david.e.box@linux.intel.com>
Reviewed-by: default avatarRafael J. Wysocki <rafael.j.wysocki@intel.com>
Signed-off-by: default avatarChristoph Hellwig <hch@lst.de>
parent b13c6393

drivers/acpi/property.c

+3 −0
Original line number Diff line number Diff line
@@ -45,6 +45,9 @@ static const guid_t prp_guids[] = { 
	/* Thunderbolt GUID for WAKE_SUPPORTED: 6c501103-c189-4296-ba72-9bf5a26ebe5d */

	GUID_INIT(0x6c501103, 0xc189, 0x4296,

		  0xba, 0x72, 0x9b, 0xf5, 0xa2, 0x6e, 0xbe, 0x5d),

	/* Storage device needs D3 GUID: 5025030f-842f-4ab4-a561-99a5189762d0 */

	GUID_INIT(0x5025030f, 0x842f, 0x4ab4,

		  0xa5, 0x61, 0x99, 0xa5, 0x18, 0x97, 0x62, 0xd0),

};



/* ACPI _DSD data subnodes GUID: dbb8e3e6-5886-4ba6-8795-1319f52a966b */

drivers/nvme/host/pci.c

+63 −0
Original line number Diff line number Diff line
@@ -4,6 +4,7 @@ 
 * Copyright (c) 2011-2014, Intel Corporation.

 */



#include <linux/acpi.h>

#include <linux/aer.h>

#include <linux/async.h>

#include <linux/blkdev.h>
@@ -94,6 +95,10 @@ static unsigned int poll_queues; 
module_param_cb(poll_queues, &io_queue_count_ops, &poll_queues, 0644);

MODULE_PARM_DESC(poll_queues, "Number of queues to use for polled IO.");



static bool noacpi;

module_param(noacpi, bool, 0444);

MODULE_PARM_DESC(noacpi, "disable acpi bios quirks");



struct nvme_dev;

struct nvme_queue;
@@ -2754,6 +2759,54 @@ static unsigned long check_vendor_combination_bug(struct pci_dev *pdev) 
	return 0;

}



#ifdef CONFIG_ACPI

static bool nvme_acpi_storage_d3(struct pci_dev *dev)

{

	struct acpi_device *adev;

	struct pci_dev *root;

	acpi_handle handle;

	acpi_status status;

	u8 val;



	/*

	 * Look for _DSD property specifying that the storage device on the port

	 * must use D3 to support deep platform power savings during

	 * suspend-to-idle.

	 */

	root = pcie_find_root_port(dev);

	if (!root)

		return false;



	adev = ACPI_COMPANION(&root->dev);

	if (!adev)

		return false;



	/*

	 * The property is defined in the PXSX device for South complex ports

	 * and in the PEGP device for North complex ports.

	 */

	status = acpi_get_handle(adev->handle, "PXSX", &handle);

	if (ACPI_FAILURE(status)) {

		status = acpi_get_handle(adev->handle, "PEGP", &handle);

		if (ACPI_FAILURE(status))

			return false;

	}



	if (acpi_bus_get_device(handle, &adev))

		return false;



	if (fwnode_property_read_u8(acpi_fwnode_handle(adev), "StorageD3Enable",

			&val))

		return false;

	return val == 1;

}

#else

static inline bool nvme_acpi_storage_d3(struct pci_dev *dev)

{

	return false;

}

#endif /* CONFIG_ACPI */



static void nvme_async_probe(void *data, async_cookie_t cookie)

{

	struct nvme_dev *dev = data;
@@ -2803,6 +2856,16 @@ static int nvme_probe(struct pci_dev *pdev, const struct pci_device_id *id) 


	quirks |= check_vendor_combination_bug(pdev);



	if (!noacpi && nvme_acpi_storage_d3(pdev)) {

		/*

		 * Some systems use a bios work around to ask for D3 on

		 * platforms that support kernel managed suspend.

		 */

		dev_info(&pdev->dev,

			 "platform quirk: setting simple suspend\n");

		quirks |= NVME_QUIRK_SIMPLE_SUSPEND;

	}



	/*

	 * Double check that our mempool alloc size will cover the biggest

	 * command we support.

CRA Git | Maintained and supported by SUSTech CRA and CCSE