From 941b924f0a101df8b0ed6e40bb320a984dca700e Mon Sep 17 00:00:00 2001
From: Maximilian Luz <luzmaximilian@gmail.com>
Date: Tue, 20 Apr 2021 15:48:57 +0200
Subject: [PATCH] Add example thermald configuration

---
 contrib/thermald/README.md                  | 14 +++++++++++
 contrib/thermald/thermal-conf.xml           | 27 +++++++++++++++++++++
 contrib/thermald/thermal-cpu-cdev-order.xml |  8 ++++++
 3 files changed, 49 insertions(+)
 create mode 100644 contrib/thermald/README.md
 create mode 100644 contrib/thermald/thermal-conf.xml
 create mode 100644 contrib/thermald/thermal-cpu-cdev-order.xml

diff --git a/contrib/thermald/README.md b/contrib/thermald/README.md
new file mode 100644
index 000000000..8a3349313
--- /dev/null
+++ b/contrib/thermald/README.md
@@ -0,0 +1,14 @@
+# Example Thermald Configuration
+
+This is a minimal thermald configuration, which sets the maximum sustained CPU temperature to about 65°C.
+Modify the `<Temperature>65000</Temperature>` value to adapt that to your liking.
+
+Tested on a Surface Book 2, other devices may need adapting, see e.g. the [thermald man page](http://manpages.ubuntu.com/manpages/trusty/man5/thermal-conf.xml.5.html).
+
+## Installation
+
+Both XML files need to be placed in the `/etc/thermald/` directory.
+
+Newer thermald versions attempt to automatically load the configuration from ACPI.
+If you want to use a manual configuration with such a version, you may need to remove the `--adaptive` option from the systemd service `ExecStart` line.
+You can do so by running `sudo systemctl edit thermald.service`.
diff --git a/contrib/thermald/thermal-conf.xml b/contrib/thermald/thermal-conf.xml
new file mode 100644
index 000000000..b1efeb395
--- /dev/null
+++ b/contrib/thermald/thermal-conf.xml
@@ -0,0 +1,27 @@
+<?xml version="1.0"?>
+<ThermalConfiguration>
+   <Platform>
+      <Name>Intel Powered Laptop</Name>
+      <ProductName>*</ProductName>
+      <Preference>QUIET</Preference>
+      <ThermalZones>
+         <ThermalZone>
+            <Type>cpu</Type>
+            <TripPoints>
+               <TripPoint>
+                  <SensorType>x86_pkg_temp</SensorType>
+                  <Temperature>65000</Temperature>
+                  <type>passive</type>
+                  <ControlType>SEQUENTIAL</ControlType>
+                  <CoolingDevice>
+                     <index>1</index>
+                     <type>rapl_controller</type>
+                     <influence>100</influence>
+                     <SamplingPeriod>5</SamplingPeriod>
+                  </CoolingDevice>
+               </TripPoint>
+            </TripPoints>
+         </ThermalZone>
+      </ThermalZones>
+   </Platform>
+</ThermalConfiguration>
diff --git a/contrib/thermald/thermal-cpu-cdev-order.xml b/contrib/thermald/thermal-cpu-cdev-order.xml
new file mode 100644
index 000000000..5877d4856
--- /dev/null
+++ b/contrib/thermald/thermal-cpu-cdev-order.xml
@@ -0,0 +1,8 @@
+<CoolingDeviceOrder>
+    <!-- Specify Cooling device order -->
+    <CoolingDevice>rapl_controller</CoolingDevice>
+    <CoolingDevice>intel_pstate</CoolingDevice>
+    <CoolingDevice>intel_powerclamp</CoolingDevice>
+    <CoolingDevice>cpufreq</CoolingDevice>
+    <CoolingDevice>Processor</CoolingDevice>
+</CoolingDeviceOrder>