3  * drivers/acpi/device_pm.c - ACPI device power management routines.
15 #include <linux/acpi.h>
27  * acpi_power_state_string - String representation of ACPI device power state.
28  * @state: ACPI device power state to return the string representation of.
62  * acpi_device_get_power - Get power state of an ACPI device.
113 		 * For systems predating ACPI 4.0 we assume that D3hot is the  in acpi_device_get_power()
155  * acpi_device_set_power - Set power state of an ACPI device.
212 	 * In accordance with ACPI 6, _PSx is executed before manipulating power  in acpi_device_set_power()
218 		 * According to ACPI 6, devices cannot go from lower-power  in acpi_device_set_power()
489  * @adev: Parent ACPI device object.
502  * @adev: ACPI companion of the target device.
560  * acpi_add_pm_notifier - Register PM notify handler for given ACPI device.
561  * @adev: ACPI device to add the notify handler for.
601  * acpi_remove_pm_notifier - Unregister PM notifier from given ACPI device.
602  * @adev: ACPI device to remove the notifier from.
647  * acpi_dev_pm_get_state - Get preferred power state of ACPI device.
649  * @adev: ACPI device node corresponding to @dev.
654  * Find the lowest power (highest number) and highest power (lowest number) ACPI
663  * Returns 0 on success or -ENODATA when one of the ACPI methods fails or
690 	 * minimum D-state is D0 (ACPI 3.x).  in acpi_dev_pm_get_state()
723 		 * The ACPI subsystem doesn't manage the wake bit for IRQs  in acpi_dev_pm_get_state()
736 		/* ACPI GPE is specified in _PRW. */  in acpi_dev_pm_get_state()
744 	 * (ACPI 3.x), it should return the maximum (lowest power) D-state that  in acpi_dev_pm_get_state()
751 			/* No _SxW. In this case, the ACPI spec says that we  in acpi_dev_pm_get_state()
778  * acpi_pm_device_sleep_state - Get preferred power state of ACPI device.
784  * incorrect, or -ENODATA on ACPI method failure.
806 		dev_dbg(dev, "ACPI companion missing in %s!\n", __func__);  in acpi_pm_device_sleep_state()
833  * acpi_pm_notify_work_func - ACPI devices wakeup notification work function.
901  * @adev: ACPI device to enable wakeup functionality for.
908  * Callers must ensure that @adev is a valid ACPI device node before executing
918  * @adev: ACPI device to disable wakeup functionality for.
922  * Callers must ensure that @adev is a valid ACPI device node before executing
955 		dev_dbg(dev, "ACPI companion missing in %s!\n", __func__);  in acpi_pm_set_device_wakeup()
964 		dev_dbg(dev, "Wakeup disabled by ACPI\n");  in acpi_pm_set_device_wakeup()
970 		dev_dbg(dev, "Wakeup enabled by ACPI\n");  in acpi_pm_set_device_wakeup()
977  * acpi_dev_pm_low_power - Put ACPI device into a low-power state.
979  * @adev: ACPI device node corresponding to @dev.
995  * acpi_dev_pm_full_power - Put ACPI device into the full-power state.
996  * @adev: ACPI device node to put into the full-power state.
1005  * acpi_dev_suspend - Put device into a low-power state using ACPI.
1009  * Put the given device into a low-power state using the standard ACPI
1040  * acpi_dev_resume - Put device into the full-power state using ACPI.
1043  * Put the given device into the full-power state using the standard ACPI
1044  * mechanism.  Set the power state of the device to ACPI D0 and disable wakeup.
1061  * acpi_subsys_runtime_suspend - Suspend device using ACPI.
1064  * Carry out the generic runtime suspend procedure for @dev and use ACPI to put
1076  * acpi_subsys_runtime_resume - Resume device using ACPI.
1079  * Use ACPI to put the given device into the full-power state and carry out the
1162  * devices during system suspend and there are no ACPI-specific reasons for
1176  * acpi_subsys_suspend_late - Suspend device using ACPI.
1179  * Carry out the generic late suspend procedure for @dev and use ACPI to put
1236  * acpi_subsys_resume_early - Resume device using ACPI.
1239  * Use ACPI to put the given device into the full-power state and carry out the
1254 		dev_dbg(dev, "Postponing ACPI PM to normal resume stage\n");  in acpi_subsys_resume_early()
1263  * acpi_subsys_resume - Resume device using ACPI.
1266  * Use ACPI to put the given device into the full-power state if it has not been
1276 		dev_dbg(dev, "Applying postponed ACPI PM\n");  in acpi_subsys_resume()
1304  * acpi_subsys_restore_early - Restore device using ACPI.
1321  * devices during system suspend and there are no ACPI-specific reasons for
1338  * Carry out the generic late poweroff procedure for @dev and use ACPI to put
1394  * acpi_dev_pm_detach - Remove ACPI power management from the device.
1398  * Remove the device from the general ACPI PM domain and remove its wakeup
1428  * acpi_dev_pm_attach - Prepare device for ACPI power management.
1432  * If @dev has a valid ACPI handle that has a valid struct acpi_device object
1434  * add it to the general ACPI PM domain.  If @power_on is set, the device will
1435  * be put into the ACPI D0 state before the function returns.
1446 	 * Skip devices whose ACPI companions match the device IDs below,  in acpi_dev_pm_attach()
1448 	 * with the generic ACPI PM domain.  in acpi_dev_pm_attach()
1511  * @dev: Physical device the ACPI power state of which to check
1513  * On a system without ACPI, return true. On a system with ACPI, return true if
1514  * the current ACPI power state of the device is D0, or false otherwise.
1518  * not valid to ask for the ACPI power state of the device in that time frame.
1521  * function. See Documentation/firmware-guide/acpi/non-d0-probe.rst for