diff --git a/man/systemd-sleep.conf.xml b/man/systemd-sleep.conf.xml index be04f2cdf1..79ebef1fef 100644 --- a/man/systemd-sleep.conf.xml +++ b/man/systemd-sleep.conf.xml @@ -77,29 +77,16 @@ suspend-then-hibernate - A low power state where initially user.slice unit is freezed. - If the hardware supports low-battery alarms (ACPI _BTP), then the system is - first suspended (the state is stored in RAM) and then hibernates if the system - is woken up by the hardware via ACPI low-battery signal. Unit user.slice is - thawed when system returns from hibernation. If the hardware does not support - low-battery alarms (ACPI _BTP), then the system is suspended based on battery's - current percentage capacity. If the current battery capacity is higher than 5%, the - system suspends for interval calculated using battery discharge rate per hour or - HibernateDelaySec= - if former is not available. - Battery discharge rate per hour is stored in a file which is created after - initial suspend-resume cycle. The value is calculated using battery decreasing - charge level over a timespan for which system was suspended. For each battery - connected to the system, there is a unique entry. After RTC alarm wakeup from - suspend, battery discharge rate per hour is again estimated. If the current battery - charge level is equal to or less than 5%, the system will be hibernated (the state - is then stored on disk) else the system goes back to suspend for the interval - calculated using battery discharge rate per hour. - In case of manual wakeup, if the battery was discharged while the system was - suspended, the battery discharge rate is estimated and stored on the filesystem. - In case the system is woken up by the hardware via the ACPI low-battery signal, - then it hibernates. - + + A low power state where the system is initially suspended (the state is stored in + RAM). If the system supports low-battery alarms (ACPI _BTP), then the system will be woken up by + the ACPI low-battery signal and hibernated (the state is then stored on disk). Also, if not + interrupted within the timespan specified by HibernateDelaySec= or the estimated + timespan until the system battery charge level goes down to 5%, then the system will be woken up by the + RTC alarm and hibernated. The estimated timespan is calculated from the change of the battery + capacity level after the time specified by SuspendEstimationSec= or when + the system is woken up from the suspend. + @@ -189,13 +176,28 @@ uses the value of SuspendState= when suspending and the value of HibernateState= when hibernating. + HibernateDelaySec= - The amount of time the system spends in suspend mode - before the RTC alarm wakes the system, before the battery discharge rate - can be estimated and used instead to calculate the suspension interval. - systemd-suspend-then-hibernate.service8. Defaults - to 2h. + + + The amount of time the system spends in suspend mode before the system is + automatically put into hibernate mode. Only used by + systemd-suspend-then-hibernate.service8. + If the system has a battery, then defaults to the estimated timespan until the system battery charge level goes down to 5%. + If the system has no battery, then defaults to 2h. + + + + + SuspendEstimationSec= + + + The RTC alarm will wake the system after the specified timespan to measure the system battery + capacity level and estimate battery discharging rate, which is used for estimating timespan until the system battery charge + level goes down to 5%. Only used by + systemd-suspend-then-hibernate.service8. + Defaults to 2h. diff --git a/src/shared/sleep-config.c b/src/shared/sleep-config.c index 260e8ccca4..45b78bdafa 100644 --- a/src/shared/sleep-config.c +++ b/src/shared/sleep-config.c @@ -65,10 +65,14 @@ int parse_sleep_config(SleepConfig **ret_sleep_config) { int allow_suspend = -1, allow_hibernate = -1, allow_s2h = -1, allow_hybrid_sleep = -1; - sc = new0(SleepConfig, 1); + sc = new(SleepConfig, 1); if (!sc) return log_oom(); + *sc = (SleepConfig) { + .hibernate_delay_usec = USEC_INFINITY, + }; + const ConfigTableItem items[] = { { "Sleep", "AllowSuspend", config_parse_tristate, 0, &allow_suspend }, { "Sleep", "AllowHibernation", config_parse_tristate, 0, &allow_hibernate }, @@ -83,6 +87,7 @@ int parse_sleep_config(SleepConfig **ret_sleep_config) { { "Sleep", "HybridSleepState", config_parse_strv, 0, sc->states + SLEEP_HYBRID_SLEEP }, { "Sleep", "HibernateDelaySec", config_parse_sec, 0, &sc->hibernate_delay_usec }, + { "Sleep", "SuspendEstimationSec", config_parse_sec, 0, &sc->suspend_estimation_usec }, {} }; @@ -113,8 +118,8 @@ int parse_sleep_config(SleepConfig **ret_sleep_config) { sc->modes[SLEEP_HYBRID_SLEEP] = strv_new("suspend", "platform", "shutdown"); if (!sc->states[SLEEP_HYBRID_SLEEP]) sc->states[SLEEP_HYBRID_SLEEP] = strv_new("disk"); - if (sc->hibernate_delay_usec == 0) - sc->hibernate_delay_usec = 2 * USEC_PER_HOUR; + if (sc->suspend_estimation_usec == 0) + sc->suspend_estimation_usec = DEFAULT_SUSPEND_ESTIMATION_USEC; /* Ensure values set for all required fields */ if (!sc->states[SLEEP_SUSPEND] || !sc->modes[SLEEP_HIBERNATE] diff --git a/src/shared/sleep-config.h b/src/shared/sleep-config.h index 813f33c7c0..99423fe3d3 100644 --- a/src/shared/sleep-config.h +++ b/src/shared/sleep-config.h @@ -6,6 +6,8 @@ #include "hashmap.h" #include "time-util.h" +#define DEFAULT_SUSPEND_ESTIMATION_USEC (1 * USEC_PER_HOUR) + typedef enum SleepOperation { SLEEP_SUSPEND, SLEEP_HIBERNATE, @@ -20,6 +22,7 @@ typedef struct SleepConfig { char **modes[_SLEEP_OPERATION_MAX]; char **states[_SLEEP_OPERATION_MAX]; usec_t hibernate_delay_usec; + usec_t suspend_estimation_usec; } SleepConfig; SleepConfig* free_sleep_config(SleepConfig *sc); diff --git a/src/sleep/sleep.c b/src/sleep/sleep.c index d1c45e264d..0611cfb780 100644 --- a/src/sleep/sleep.c +++ b/src/sleep/sleep.c @@ -267,10 +267,13 @@ static int execute( } static int custom_timer_suspend(const SleepConfig *sleep_config) { + usec_t hibernate_timestamp; int r; assert(sleep_config); + hibernate_timestamp = usec_add(now(CLOCK_BOOTTIME), sleep_config->hibernate_delay_usec); + while (battery_is_low() == 0) { _cleanup_hashmap_free_ Hashmap *last_capacity = NULL, *current_capacity = NULL; _cleanup_close_ int tfd = -EBADF; @@ -287,14 +290,25 @@ static int custom_timer_suspend(const SleepConfig *sleep_config) { if (r < 0) return log_error_errno(r, "Error fetching battery capacity percentage: %m"); - r = get_total_suspend_interval(last_capacity, &suspend_interval); - if (r < 0) { - log_debug_errno(r, "Failed to estimate suspend interval using previous discharge rate, ignoring: %m"); - /* In case of no battery or any errors, system suspend interval will be set to HibernateDelaySec=. */ - suspend_interval = sleep_config->hibernate_delay_usec; + if (hashmap_isempty(last_capacity)) + /* In case of no battery, system suspend interval will be set to HibernateDelaySec= or 2 hours. */ + suspend_interval = timestamp_is_set(hibernate_timestamp) ? sleep_config->hibernate_delay_usec : DEFAULT_SUSPEND_ESTIMATION_USEC; + else { + r = get_total_suspend_interval(last_capacity, &suspend_interval); + if (r < 0) { + log_debug_errno(r, "Failed to estimate suspend interval using previous discharge rate, ignoring: %m"); + /* In case of any errors, especially when we do not know the battery + * discharging rate, system suspend interval will be set to + * SuspendEstimationSec=. */ + suspend_interval = sleep_config->suspend_estimation_usec; + } } + /* Do not suspend more than HibernateDelaySec= */ usec_t before_timestamp = now(CLOCK_BOOTTIME); + suspend_interval = MIN(suspend_interval, usec_sub_unsigned(hibernate_timestamp, before_timestamp)); + if (suspend_interval <= 0) + break; /* system should hibernate */ log_debug("Set timerfd wake alarm for %s", FORMAT_TIMESPAN(suspend_interval, USEC_PER_SEC)); /* Wake alarm for system with or without battery to hibernate or estimate discharge rate whichever is applicable */ @@ -380,7 +394,7 @@ static int freeze_thaw_user_slice(const char **method) { static int execute_s2h(const SleepConfig *sleep_config) { _unused_ _cleanup_(freeze_thaw_user_slice) const char *auto_method_thaw = "ThawUnit"; - int r, k; + int r; assert(sleep_config); @@ -388,15 +402,21 @@ static int execute_s2h(const SleepConfig *sleep_config) { if (r < 0) log_debug_errno(r, "Failed to freeze unit user.slice, ignoring: %m"); - r = check_wakeup_type(); - if (r < 0) - log_debug_errno(r, "Failed to check hardware wakeup type, ignoring: %m"); + /* Only check if we have automated battery alarms if HibernateDelaySec= is not set, as in that case + * we'll busy poll for the configured interval instead */ + if (!timestamp_is_set(sleep_config->hibernate_delay_usec)) { + r = check_wakeup_type(); + if (r < 0) + log_debug_errno(r, "Failed to check hardware wakeup type, ignoring: %m"); + else { + r = battery_trip_point_alarm_exists(); + if (r < 0) + log_debug_errno(r, "Failed to check whether acpi_btp support is enabled or not, ignoring: %m"); + } + } else + r = 0; /* Force fallback path */ - k = battery_trip_point_alarm_exists(); - if (k < 0) - log_debug_errno(k, "Failed to check whether acpi_btp support is enabled or not, ignoring: %m"); - - if (r >= 0 && k > 0) { + if (r > 0) { /* If we have both wakeup alarms and battery trip point support, use them */ log_debug("Attempting to suspend..."); r = execute(sleep_config, SLEEP_SUSPEND, NULL); if (r < 0) diff --git a/src/sleep/sleep.conf b/src/sleep/sleep.conf index a3d31140d8..4c8e8b9680 100644 --- a/src/sleep/sleep.conf +++ b/src/sleep/sleep.conf @@ -23,4 +23,5 @@ #HibernateState=disk #HybridSleepMode=suspend platform shutdown #HybridSleepState=disk -#HibernateDelaySec=120min +#HibernateDelaySec= +#SuspendEstimationSec=60min