From 2ece55ef849e159d7f871957ab721bdcee1049bc Mon Sep 17 00:00:00 2001
From: John Kaiser <35939694+CoveMiner@users.noreply.github.com>
Date: Mon, 17 Dec 2018 12:54:07 -0800
Subject: [PATCH 01/68] Create optimizing-surface-power-management
new article
---
.../optimizing-surface-power-management | 199 ++++++++++++++++++
1 file changed, 199 insertions(+)
create mode 100644 devices/surface/optimizing-surface-power-management
diff --git a/devices/surface/optimizing-surface-power-management b/devices/surface/optimizing-surface-power-management
new file mode 100644
index 0000000000..ab344d28f5
--- /dev/null
+++ b/devices/surface/optimizing-surface-power-management
@@ -0,0 +1,199 @@
+---
+title: Optimizing power management for Surface devices
+description: This topic explains best practice recommendations for maintaining optimal power settings on your Surface device.
+ms.prod: w10
+ms.mktglfcycl: manage
+ms.sitesec: library
+author: coveminer
+ms.author: v-jokai
+ms.topic: article
+ms.date: 12/17/2018
+---
+#Optimizing power management for Surface devices
+This topic explains best practice recommendations for maintaining
+optimal power settings on your Surface device.
+
+ - [Windows performance power slider ](\\l)
+
+ - [Modern Standby](#modern-standby)
+
+ - [Connected standby for always-on computing](#connected-standby)
+
+ - [Disconnected standby for longer battery
+ life](#disconnected-standby)
+
+ - [Changing hibernation timeout](#changing-hibernation-timeout)
+
+ - [Changing settings in Advanced power
+ options](#changing-settings-in-advanced-power-options)
+
+ - [Changing settings in Group
+ Policy](#changing-settings-in-group-policy)
+
+# Using the Windows performance power slider
+
+Surface devices running Windows 10 build 1709and later, provide an
+option to directly control power consumption for the CPU and hardware
+components. Power slider settings — consisting of four slider modes do
+not change any of the power settings in the operating system
+(configurable via advanced power options or via Group
+Policy).
+
+| Slider mode | Description |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Battery Saver | Helps conserve power, and prolong battery life, when the system is not connected to a power source. When battery saver is on, some Windows features are disabled, throttled, or behave differently. Screen brightness is also reduced. Battery Saver is only available when using battery power (DC). To learn more, see [Battery Saver](https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/battery-saver). |
+| Recommended | Delivers longer battery life than the default settings on previous versions of Windows. In some cases, users will see this mode labeled **Better Battery**. |
+| Better Performance | Default slider mode that slightly favors performance over battery life and is appropriate for users who want to exchange power for better app performance. |
+| Best Performance | Favors performance over power, designed for users requiring maximum performance and responsiveness without regard for battery power consumption. |
+
+To learn more, see:
+
+ - [Customize the Windows performance power
+ slider](https://docs.microsoft.com/en-us/windows-hardware/customize/desktop/customize-power-slider)
+
+ - [Battery
+ saver.](https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/battery-saver)
+
+# Modern Standby
+
+Surface is designed as a modern standby device, dynamically fine-tuning
+power management of individual hardware components. Modern standby
+enables an instant on experience like smartphones.
+
+It consists of two modes:
+
+ - [Connected Standby](#connected-standby)
+
+ - [Disconnected Standby](#disconnected-standby)
+
+# Connected Standby
+
+In contrast to traditional sleep modes — ACPI Sleep (S3) and Hibernate
+(S4) States — that shut off all system activity when the device screen
+is off, Connected Standby maintains network connectivity and syncs with
+the cloud.
+
+For example, when you get email or your applications receive data over
+the network, Connected Standby powers components only while actively
+processing incoming data.
+
+By managing power consumption directly at the individual hardware
+component level, fine-tunes power consumption by waking up small
+portions of the system for short time spans to handle background tasks
+such as an incoming email or network traffic before returning to
+(S0), also known as Deepest Runtime Idle Platform State (DRIPS). It is
+the default power mode for Surface devices except for Surface Studio.
+
+
+
+**Figure 1.** Power management and core components in Surface Pro
+
+To learn more, see:
+
+ - [Modern
+ Standby](https://docs.microsoft.com/en-us/windows-hardware/design/device-experiences/modern-standby)
+
+ - [Modern Standby Wake
+ Sources](https://docs.microsoft.com/en-us/windows-hardware/design/device-experiences/modern-standby-wake-sources)
+
+# Disconnected Standby
+
+Disconnected standby extends battery life by disabling Wi-Fi, Bluetooth,
+and other network traffic when you close the lid on your Surface.
+
+**To enable Disconnected Standby:**
+
+1. Click **PC settings** \> **System** \> **Power & sleep**.
+
+2. Under Network connection, for the setting **When my PC is asleep and
+ on battery power, disconnect from the network**, select **Always**.
+
+
+
+Figure 2. Disconnected Standby
+
+# Changing settings in Advanced power options
+
+You can adjust settings for various preferences such as how long it
+takes for the screen to turn off when you step away from the device or
+what happens when you close the lid on your device – sleep (default) or
+do nothing, hibernate, or shutdown. You can also adjust notification
+settings that are triggered when battery power drops below a certain
+threshold as shown below.
+
+
+
+Figure 3. Advanced Power Options
+
+NOTE: In general, it’s recommended to leave the default settings
+unchanged and avoid creating custom power plans. This is because Surface
+uses an algorithm to intelligently manage power related components
+including settings that are not configurable in the Power Options user
+interface.
+
+## Changing hibernation timeout
+
+During Connected Standby, Surface devices consume an average of
+approximately 1 percent of battery power per hour depending on the
+network activity. By default, Surface devices are set to enter
+hibernation after six hours.
+
+Since Surface consumes almost no power during hibernation, you may wish
+to reduce the timeout period to extend battery life.
+
+To set hibernation timeout on your Surface device:
+
+ - In the advanced Power Options dialog box, click **Sleep** \>
+ **Hibernate** **after**\> and reduce the number of minutes as
+ appropriate.
+
+
+
+Figure 4. Setting hibernation timeout
+
+## Changing settings in Group Policy
+
+To set hibernation timeout for multiple Surface devices via Group
+Policy:
+
+1. Open the **Group Policy Editor** (gpedit.msc) and browse to:
+
+ - Computer Configuration\\Administrative Templates\\System\\Power
+ Management\\ Sleep Settings
+
+2. In the list of available settings, double-click **Specify the system
+ hibernate timeout (on battery)** and specify the period of
+ inactivity — in seconds — before Windows transitions the system to
+ hibernate.
+
+3. Ensure the policy setting is scoped to take effect on the Surface
+ devices you’re targeting. For example if all your managed Surface
+ devices belong to a specific security group, use the Group Policy
+ Management console to configure the policy setting appropriately.
+ For more information, refer to Recommendations for managing Group
+ Policy administrative template (.adm) files.
+
+
+
+Figure 5. Managing power settings in the Group Policy Editor
+
+# Viewing supported power states
+
+Powercfg is a command-line utility that is used from an elevated Windows
+Command Prompt to control all configurable power system settings,
+including hardware-specific configurations that are not configurable
+through the Control Panel, on a per-user basis. It was first introduced
+by Microsoft in Windows XP SP2 in 2003.
+
+To check the supported power states, open an elevated command window and
+enter the command:
+
+ - powercfg /a
+
+To learn more about managing power, see [Powercfg command line
+options](https://docs.microsoft.com/en-us/windows-hardware/design/device-experiences/powercfg-command-line-options).
From 2fb10575c552b2545c421f21e76497a51c6e8b20 Mon Sep 17 00:00:00 2001
From: John Kaiser <35939694+CoveMiner@users.noreply.github.com>
Date: Mon, 17 Dec 2018 14:54:50 -0800
Subject: [PATCH 02/68] Rename optimizing-surface-power-management to
optimizing-surface-power-management.md
---
...ce-power-management => optimizing-surface-power-management.md} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
rename devices/surface/{optimizing-surface-power-management => optimizing-surface-power-management.md} (100%)
diff --git a/devices/surface/optimizing-surface-power-management b/devices/surface/optimizing-surface-power-management.md
similarity index 100%
rename from devices/surface/optimizing-surface-power-management
rename to devices/surface/optimizing-surface-power-management.md
From e52a70047f6cea8a5527b7f727aea0c3e6ce261c Mon Sep 17 00:00:00 2001
From: John Kaiser <35939694+CoveMiner@users.noreply.github.com>
Date: Thu, 20 Dec 2018 12:40:09 -0800
Subject: [PATCH 03/68] Update optimizing-surface-power-management.md
revised content
---
.../optimizing-surface-power-management.md | 322 +++++++++---------
1 file changed, 157 insertions(+), 165 deletions(-)
diff --git a/devices/surface/optimizing-surface-power-management.md b/devices/surface/optimizing-surface-power-management.md
index ab344d28f5..2cfa3f1021 100644
--- a/devices/surface/optimizing-surface-power-management.md
+++ b/devices/surface/optimizing-surface-power-management.md
@@ -9,191 +9,183 @@ ms.author: v-jokai
ms.topic: article
ms.date: 12/17/2018
---
-#Optimizing power management for Surface devices
-This topic explains best practice recommendations for maintaining
-optimal power settings on your Surface device.
+This document provides best practice recommendations for maintaining
+optimal power settings and explains how Surface streamlines the power
+management experience.
- - [Windows performance power slider ](\\l)
+Introduction
+============
- - [Modern Standby](#modern-standby)
+Surface devices are designed to take advantage of the latest advances in
+mobile device energy consumption, utilizing algorithms and a
+software-defined battery to deliver a streamlined experience optimized
+across workloads. Depending on what you're doing, Surface dynamically
+finetunes how power flows to individual hardware component, momentarily
+waking up system components to handle background tasks such as an
+incoming email or network traffic before returning to a low power idle
+state (S0).
- - [Connected standby for always-on computing](#connected-standby)
+The way Surface implements power management differs significantly from
+the earlier OS standard that gradually reduces and turns off power via a
+series of sleep states (S1, S2, S3).
- - [Disconnected standby for longer battery
- life](#disconnected-standby)
+Instead, Surface is imaged with a custom power profile that replaces
+legacy sleep and energy consumption functionality with Modern Standby
+features and dynamic fine tuning. This custom power profile is
+implemented via a driver --- the system aggregator module (SAM) --- and
+included in Surface firmware. The SAM driver functions as the Surface
+device power-policy owner, using algorithms to calculate optimal power
+requirements. It works in conjunction with Windows power manager to
+allocate or throttle only the exact amount of power required for
+hardware components to function.
- - [Changing hibernation timeout](#changing-hibernation-timeout)
+Modern Standby
+==============
- - [Changing settings in Advanced power
- options](#changing-settings-in-advanced-power-options)
+The algorithmically embedded custom power profile enables Modern Standby
+connectivity for Surface by maintaining an S0 low power state for
+instant on/instant off functionality typical of smartphones. S0, also
+known as Deepest Runtime Idle Platform State (DRIPS), is the default
+power mode for Surface devices. Modern Standby has two modes:
- - [Changing settings in Group
- Policy](#changing-settings-in-group-policy)
+- **Connected Standby.** The default mode for up-to-the minute
+ delivery of emails, messaging, and cloud-synced data, Connected
+ Standby keeps Wi-Fi on and maintains network connectivity.
-# Using the Windows performance power slider
+- **Disconnected Standby.** An optional mode for extended battery
+ life, disconnected standby delivers the same instant-on experience
+ and saves power by turning off Wi-Fi, Bluetooth, and related network
+ connectivity.
-Surface devices running Windows 10 build 1709and later, provide an
-option to directly control power consumption for the CPU and hardware
-components. Power slider settings — consisting of four slider modes do
-not change any of the power settings in the operating system
-(configurable via advanced power options or via Group
-Policy).
+To learn more, refer to Modern Standby in the [Microsoft Hardware Dev
+Center](https://docs.microsoft.com/en-us/windows-hardware/design/device-experiences/modern-standby-wake-sources).
-| Slider mode | Description |
-| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Battery Saver | Helps conserve power, and prolong battery life, when the system is not connected to a power source. When battery saver is on, some Windows features are disabled, throttled, or behave differently. Screen brightness is also reduced. Battery Saver is only available when using battery power (DC). To learn more, see [Battery Saver](https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/battery-saver). |
-| Recommended | Delivers longer battery life than the default settings on previous versions of Windows. In some cases, users will see this mode labeled **Better Battery**. |
-| Better Performance | Default slider mode that slightly favors performance over battery life and is appropriate for users who want to exchange power for better app performance. |
-| Best Performance | Favors performance over power, designed for users requiring maximum performance and responsiveness without regard for battery power consumption. |
+How Surface streamlines the power management experience
+========================================================
+
+Surface integrates the following features designed to help users
+optimize the power management experience:
+
+- [Singular power plan](#singular-power-plan)
+
+- [Simplified power settings user
+ interface](#simplified-power-settings-user-interface)
+
+- [Windows performance power
+ slider](#windows-performance-power-slider)
+
+Singular power plan
+-------------------
+
+Surface is designed for a streamlined power management experience that
+eliminates the need to create custom power plans or manually configure
+power settings.
+
+As shown in the following two figures, Surface streamlines the user
+experience by providing: a single power plan (balanced) that replaces
+the multiple power plans from standard Windows builds.
+
+{width="5.208601268591426in"
+height="2.3473425196850393in"}
+
+Figure 1. Single power plan in Surface
+
+{width="5.278261154855643in"
+height="3.0327449693788275in"}
+
+Figure 2. Multiple power plans in standard Windows builds
+
+Simplified power settings user interface
+----------------------------------------
+
+Using the default screen and sleep timeouts while avoiding maximum
+brightness levels are the most effective ways for users to maintain
+extended battery life.
+
+Surface provides a simplified UI in accord with best practice power
+setting recommendations:
+
+- Limit changing of default settings to the options visible in the
+ user interface.
+
+{width="3.5956047681539807in"
+height="2.977159886264217in"}
+
+Figure 3. Simplified power & sleep settings
+
+Windows performance power slider
+--------------------------------
+
+Surface devices running Windows 10 build 1709 and later include a power
+slider allowing you to prioritize battery life versus performance. You
+can access the power slider from the taskbar by clicking on the battery
+icon. Slide left for longer battery life (battery saver mode) or slide
+left for faster performance.
+
+{width="3.6112970253718286in"
+height="3.041823053368329in"}
+
+Figure 4. Power slider
+
+Power slider enables four states as described in the following table
+
+ **Slider mode** **Description**
+ -------------------- ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
+ Battery saver Helps conserve power, and prolong battery life, when the system is not connected to a power source. When battery saver is on, some Windows features are disabled, throttled, or behave differently. Screen brightness is also reduced. Battery Saver is only available when using battery power (DC). To learn more, see [Battery Saver](https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/battery-saver).
+ Recommended Delivers longer battery life than the default settings on previous versions of Windows.
+ Better Performance Default slider mode that slightly favors performance over battery life and is appropriate for users who want to exchange power for better app performance.
+ Best Performance Favors performance over power, designed for users requiring maximum performance and responsiveness without regard for battery power consumption.
+
+Power slider modes directly control specific hardware components shown
+in the following table.
+
+ **Component** **Slider functionality**
+ ---------------------------------------------------------- --------------------------------------------------------------------------------------------------------------------------------
+ Intel Speed Shift (CPU energy registers). Selects the best operating frequency and voltage for optimal performance and power.
+ Fan speed (RPM) Where applicable, adjusts for changing conditions such as keeping fan silent in battery saver slider mode
+ Processor power states (P1/P2). Adjusts operating voltage to lower power consumption of the coprocessor.
+ Processor turbo frequency limits (IA turbo limitations). Adjusts processor and graphics performance allowing processor cores to run faster or slower than the rated operating frequency
+
+**NOTE:** The power slider is entirely independent of operating system
+power settings whether configured from Control Panel/ Power Options,
+Group Policy, or related methods.
To learn more, see:
- - [Customize the Windows performance power
+- [Customize the Windows performance power
slider](https://docs.microsoft.com/en-us/windows-hardware/customize/desktop/customize-power-slider)
- - [Battery
+- [Battery
saver.](https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/battery-saver)
-# Modern Standby
+Best practices for extended battery life
+========================================
-Surface is designed as a modern standby device, dynamically fine-tuning
-power management of individual hardware components. Modern standby
-enables an instant on experience like smartphones.
+ **Best practice** **Go to** **Next steps**
+ ----------------------------------------------------- ---------------------- -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
+ Ensure your Surface device is up-to-date Windows Update In the taskbar search box, type **Windows Update** and select **Check for updates**
+ Choose the best power setting for what you're doing Power slider In the taskbar, select the battery icon, then choose **Best performance**, **Best battery life**, or somewhere in between.
+ Conserve battery when it's low Battery saver In the taskbar, select the battery icon and click **Battery settings.** Select **Turn battery saver on automatically if my battery falls below** and then move the slider further to the right for longer battery life.
+ Configure optimal screen brightness Battery saver In the taskbar, select the battery icon and click **Battery settings,** select **Lower screen brightness while in battery saver**
+ Conserve power whenever you're not plugged in Battery saver Select **Turn on battery saver status until next charge. **
+ Investigate problems with your power settings. Power troubleshooter In the Taskbar search for troubleshoot, select **Troubleshoot**, and then select **Power** and follow the instructions
+ Check app usage Your apps Close apps
+ Check your power cord for any damage. Your power cord Replace power cord if worn or damaged
-It consists of two modes:
+Learn more
+===========
- - [Connected Standby](#connected-standby)
+- [Modern
+ Standby](https://docs.microsoft.com/en-us/windows-hardware/design/device-experiences/modern-standby-wake-sources)
- - [Disconnected Standby](#disconnected-standby)
+
-# Connected Standby
+- [Customize the Windows performance power
+ slider](https://docs.microsoft.com/en-us/windows-hardware/customize/desktop/customize-power-slider)
-In contrast to traditional sleep modes — ACPI Sleep (S3) and Hibernate
-(S4) States — that shut off all system activity when the device screen
-is off, Connected Standby maintains network connectivity and syncs with
-the cloud.
-
-For example, when you get email or your applications receive data over
-the network, Connected Standby powers components only while actively
-processing incoming data.
-
-By managing power consumption directly at the individual hardware
-component level, fine-tunes power consumption by waking up small
-portions of the system for short time spans to handle background tasks
-such as an incoming email or network traffic before returning to
-(S0), also known as Deepest Runtime Idle Platform State (DRIPS). It is
-the default power mode for Surface devices except for Surface Studio.
-
-
-
-**Figure 1.** Power management and core components in Surface Pro
-
-To learn more, see:
-
- - [Modern
- Standby](https://docs.microsoft.com/en-us/windows-hardware/design/device-experiences/modern-standby)
-
- - [Modern Standby Wake
- Sources](https://docs.microsoft.com/en-us/windows-hardware/design/device-experiences/modern-standby-wake-sources)
-
-# Disconnected Standby
-
-Disconnected standby extends battery life by disabling Wi-Fi, Bluetooth,
-and other network traffic when you close the lid on your Surface.
-
-**To enable Disconnected Standby:**
-
-1. Click **PC settings** \> **System** \> **Power & sleep**.
-
-2. Under Network connection, for the setting **When my PC is asleep and
- on battery power, disconnect from the network**, select **Always**.
-
-
-
-Figure 2. Disconnected Standby
-
-# Changing settings in Advanced power options
-
-You can adjust settings for various preferences such as how long it
-takes for the screen to turn off when you step away from the device or
-what happens when you close the lid on your device – sleep (default) or
-do nothing, hibernate, or shutdown. You can also adjust notification
-settings that are triggered when battery power drops below a certain
-threshold as shown below.
-
-
-
-Figure 3. Advanced Power Options
-
-NOTE: In general, it’s recommended to leave the default settings
-unchanged and avoid creating custom power plans. This is because Surface
-uses an algorithm to intelligently manage power related components
-including settings that are not configurable in the Power Options user
-interface.
-
-## Changing hibernation timeout
-
-During Connected Standby, Surface devices consume an average of
-approximately 1 percent of battery power per hour depending on the
-network activity. By default, Surface devices are set to enter
-hibernation after six hours.
-
-Since Surface consumes almost no power during hibernation, you may wish
-to reduce the timeout period to extend battery life.
-
-To set hibernation timeout on your Surface device:
-
- - In the advanced Power Options dialog box, click **Sleep** \>
- **Hibernate** **after**\> and reduce the number of minutes as
- appropriate.
-
-
-
-Figure 4. Setting hibernation timeout
-
-## Changing settings in Group Policy
-
-To set hibernation timeout for multiple Surface devices via Group
-Policy:
-
-1. Open the **Group Policy Editor** (gpedit.msc) and browse to:
-
- - Computer Configuration\\Administrative Templates\\System\\Power
- Management\\ Sleep Settings
-
-2. In the list of available settings, double-click **Specify the system
- hibernate timeout (on battery)** and specify the period of
- inactivity — in seconds — before Windows transitions the system to
- hibernate.
-
-3. Ensure the policy setting is scoped to take effect on the Surface
- devices you’re targeting. For example if all your managed Surface
- devices belong to a specific security group, use the Group Policy
- Management console to configure the policy setting appropriately.
- For more information, refer to Recommendations for managing Group
- Policy administrative template (.adm) files.
-
-
-
-Figure 5. Managing power settings in the Group Policy Editor
-
-# Viewing supported power states
-
-Powercfg is a command-line utility that is used from an elevated Windows
-Command Prompt to control all configurable power system settings,
-including hardware-specific configurations that are not configurable
-through the Control Panel, on a per-user basis. It was first introduced
-by Microsoft in Windows XP SP2 in 2003.
-
-To check the supported power states, open an elevated command window and
-enter the command:
-
- - powercfg /a
-
-To learn more about managing power, see [Powercfg command line
-options](https://docs.microsoft.com/en-us/windows-hardware/design/device-experiences/powercfg-command-line-options).
+- [Battery
+ saver.](https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/battery-saver)
From fed3e8077fc67d562222605ff3f095f093c53868 Mon Sep 17 00:00:00 2001
From: John Kaiser <35939694+CoveMiner@users.noreply.github.com>
Date: Thu, 20 Dec 2018 12:46:26 -0800
Subject: [PATCH 04/68] Update optimizing-surface-power-management.md
formatted tables
---
.../optimizing-surface-power-management.md | 64 ++++++++-----------
1 file changed, 28 insertions(+), 36 deletions(-)
diff --git a/devices/surface/optimizing-surface-power-management.md b/devices/surface/optimizing-surface-power-management.md
index 2cfa3f1021..8cc7fcaa59 100644
--- a/devices/surface/optimizing-surface-power-management.md
+++ b/devices/surface/optimizing-surface-power-management.md
@@ -19,7 +19,7 @@ Introduction
Surface devices are designed to take advantage of the latest advances in
mobile device energy consumption, utilizing algorithms and a
software-defined battery to deliver a streamlined experience optimized
-across workloads. Depending on what you're doing, Surface dynamically
+across workloads. Depending on what you’re doing, Surface dynamically
finetunes how power flows to individual hardware component, momentarily
waking up system components to handle background tasks such as an
incoming email or network traffic before returning to a low power idle
@@ -32,7 +32,7 @@ series of sleep states (S1, S2, S3).
Instead, Surface is imaged with a custom power profile that replaces
legacy sleep and energy consumption functionality with Modern Standby
features and dynamic fine tuning. This custom power profile is
-implemented via a driver --- the system aggregator module (SAM) --- and
+implemented via a driver — the system aggregator module (SAM) — and
included in Surface firmware. The SAM driver functions as the Surface
device power-policy owner, using algorithms to calculate optimal power
requirements. It works in conjunction with Windows power manager to
@@ -85,15 +85,11 @@ As shown in the following two figures, Surface streamlines the user
experience by providing: a single power plan (balanced) that replaces
the multiple power plans from standard Windows builds.
-{width="5.208601268591426in"
-height="2.3473425196850393in"}
+
Figure 1. Single power plan in Surface
-{width="5.278261154855643in"
-height="3.0327449693788275in"}
+
Figure 2. Multiple power plans in standard Windows builds
@@ -110,9 +106,7 @@ setting recommendations:
- Limit changing of default settings to the options visible in the
user interface.
-{width="3.5956047681539807in"
-height="2.977159886264217in"}
+
Figure 3. Simplified power & sleep settings
@@ -125,30 +119,28 @@ can access the power slider from the taskbar by clicking on the battery
icon. Slide left for longer battery life (battery saver mode) or slide
left for faster performance.
-{width="3.6112970253718286in"
-height="3.041823053368329in"}
+
Figure 4. Power slider
Power slider enables four states as described in the following table
- **Slider mode** **Description**
- -------------------- ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
- Battery saver Helps conserve power, and prolong battery life, when the system is not connected to a power source. When battery saver is on, some Windows features are disabled, throttled, or behave differently. Screen brightness is also reduced. Battery Saver is only available when using battery power (DC). To learn more, see [Battery Saver](https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/battery-saver).
- Recommended Delivers longer battery life than the default settings on previous versions of Windows.
- Better Performance Default slider mode that slightly favors performance over battery life and is appropriate for users who want to exchange power for better app performance.
- Best Performance Favors performance over power, designed for users requiring maximum performance and responsiveness without regard for battery power consumption.
+| **Slider mode** | **Description** |
+|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Battery saver | Helps conserve power, and prolong battery life, when the system is not connected to a power source. When battery saver is on, some Windows features are disabled, throttled, or behave differently. Screen brightness is also reduced. Battery Saver is only available when using battery power (DC). To learn more, see [Battery Saver](https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/battery-saver). |
+| Recommended | Delivers longer battery life than the default settings on previous versions of Windows. |
+| Better Performance | Default slider mode that slightly favors performance over battery life and is appropriate for users who want to exchange power for better app performance. |
+| Best Performance | Favors performance over power, designed for users requiring maximum performance and responsiveness without regard for battery power consumption. |
Power slider modes directly control specific hardware components shown
in the following table.
- **Component** **Slider functionality**
- ---------------------------------------------------------- --------------------------------------------------------------------------------------------------------------------------------
- Intel Speed Shift (CPU energy registers). Selects the best operating frequency and voltage for optimal performance and power.
- Fan speed (RPM) Where applicable, adjusts for changing conditions such as keeping fan silent in battery saver slider mode
- Processor power states (P1/P2). Adjusts operating voltage to lower power consumption of the coprocessor.
- Processor turbo frequency limits (IA turbo limitations). Adjusts processor and graphics performance allowing processor cores to run faster or slower than the rated operating frequency
+| **Component** | **Slider functionality** |
+|----------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|
+| Intel Speed Shift (CPU energy registers). | Selects the best operating frequency and voltage for optimal performance and power. |
+| Fan speed (RPM) | Where applicable, adjusts for changing conditions such as keeping fan silent in battery saver slider mode |
+| Processor power states (P1/P2). | Adjusts operating voltage to lower power consumption of the coprocessor. |
+| Processor turbo frequency limits (IA turbo limitations). | Adjusts processor and graphics performance allowing processor cores to run faster or slower than the rated operating frequency |
**NOTE:** The power slider is entirely independent of operating system
power settings whether configured from Control Panel/ Power Options,
@@ -165,16 +157,16 @@ To learn more, see:
Best practices for extended battery life
========================================
- **Best practice** **Go to** **Next steps**
- ----------------------------------------------------- ---------------------- -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
- Ensure your Surface device is up-to-date Windows Update In the taskbar search box, type **Windows Update** and select **Check for updates**
- Choose the best power setting for what you're doing Power slider In the taskbar, select the battery icon, then choose **Best performance**, **Best battery life**, or somewhere in between.
- Conserve battery when it's low Battery saver In the taskbar, select the battery icon and click **Battery settings.** Select **Turn battery saver on automatically if my battery falls below** and then move the slider further to the right for longer battery life.
- Configure optimal screen brightness Battery saver In the taskbar, select the battery icon and click **Battery settings,** select **Lower screen brightness while in battery saver**
- Conserve power whenever you're not plugged in Battery saver Select **Turn on battery saver status until next charge. **
- Investigate problems with your power settings. Power troubleshooter In the Taskbar search for troubleshoot, select **Troubleshoot**, and then select **Power** and follow the instructions
- Check app usage Your apps Close apps
- Check your power cord for any damage. Your power cord Replace power cord if worn or damaged
+| **Best practice** | **Go to** | **Next steps** |
+|-----------------------------------------------------|----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Ensure your Surface device is up-to-date | Windows Update | In the taskbar search box, type **Windows Update** and select **Check for updates** |
+| Choose the best power setting for what you’re doing | Power slider | In the taskbar, select the battery icon, then choose **Best performance**, **Best battery life**, or somewhere in between. |
+| Conserve battery when it’s low | Battery saver | In the taskbar, select the battery icon and click **Battery settings.** Select **Turn battery saver on automatically if my battery falls below** and then move the slider further to the right for longer battery life. |
+| Configure optimal screen brightness | Battery saver | In the taskbar, select the battery icon and click **Battery settings,** select **Lower screen brightness while in battery saver** |
+| Conserve power whenever you’re not plugged in | Battery saver | Select **Turn on battery saver status until next charge. ** |
+| Investigate problems with your power settings. | Power troubleshooter | In the Taskbar search for troubleshoot, select **Troubleshoot**, and then select **Power** and follow the instructions |
+| Check app usage | Your apps | Close apps |
+| Check your power cord for any damage. | Your power cord | Replace power cord if worn or damaged |
Learn more
===========
From 3a3972d3824acb4cd36c1795ba0ea8c0055cb8de Mon Sep 17 00:00:00 2001
From: John Kaiser <35939694+CoveMiner@users.noreply.github.com>
Date: Thu, 20 Dec 2018 13:04:56 -0800
Subject: [PATCH 05/68] Add files via upload
---
devices/surface/images/powerintrofig1.png | Bin 0 -> 83547 bytes
devices/surface/images/powerintrofig2.png | Bin 0 -> 197974 bytes
devices/surface/images/powerintrofig3.png | Bin 0 -> 216817 bytes
devices/surface/images/powerintrofig4.png | Bin 0 -> 141933 bytes
4 files changed, 0 insertions(+), 0 deletions(-)
create mode 100644 devices/surface/images/powerintrofig1.png
create mode 100644 devices/surface/images/powerintrofig2.png
create mode 100644 devices/surface/images/powerintrofig3.png
create mode 100644 devices/surface/images/powerintrofig4.png
diff --git a/devices/surface/images/powerintrofig1.png b/devices/surface/images/powerintrofig1.png
new file mode 100644
index 0000000000000000000000000000000000000000..8e1caa83a81e17e44f9c80e4e6d5a3be6d4d229f
GIT binary patch
literal 83547
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ℜc8g{d&Y0HL7@Tz77E&?n9EY=49mEjMxz7$T^00|IcckOR0Gu1>gc$i4k?4fOeR
z(6#WX!zVsC5jpWXQi?JvFaLV1`n~btno7u$g=m!l9O8Hg?*L=4^_yAHc&b%X24b;_K%wa6=2FhRCD`hr9H^)`3bEKtwKsU_N2y*1<(|BZ
zv2DY;Vw+0-$!S>#8u}iRYVdK2bmqv*O74g{e|K;Cp^wQlnn%8<$C@K_$3Xr@SdRJ(t8Qy!co%qyvq7G*y~bMa%p=CnRfLq*ugJxc5Hb*83!f
zd4Wt#