Difference between revisions of "PinePhone Thermal Tweaks"

From PINE64
Jump to navigation Jump to search
(See the Wikipedia Linux page and talk page for a worldwide consensus, it's just "Linux")
(added to pinephone category)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This page explains how to read the thermal sensor data and how to get and overwrite the default settings.
This page explains how to read the thermal sensor data, and how to read and change the default settings.


== Under Linux ==
== Under Linux ==


The thermal management is handled by the Thermal Sysfs driver under Linux. Depending on the used OS by the user, the default settings might differ from the showcased examples. In case of higher values it can be advised to lower the settings to prevent the phone components from being damaged by excessive heat.
{{warning|Setting wrong values for the thermal trip points poses a risk. These instructions are directed towards expert-level users and developers.}}


The current CPU temperature can be displayed by typing:
Thermal management of the PinePhone CPU is handled by the thermal framework of the Linux kernel. Depending on the Linux distribution used on a PinePhone, the default settings may differ. It may be advised to lower the settings (i.e. the thermal trip point temperatures) to prevent the phone components from being damaged by excessive heat.
 
Current CPU temperature can be displayed using the following command:


  cat /sys/class/thermal/thermal_zone0/temp
  cat /sys/class/thermal/thermal_zone0/temp


To retrieve the thermal zone types and trip points type:
The unit for all numeric values is millidegree Celsius. To read the thermal trip point types and current trip point temperatures, use the following:


  grep . /sys/class/thermal/thermal_zone0/trip_point_*_temp
  grep . /sys/class/thermal/thermal_zone0/trip_point_*_temp
  grep . /sys/class/thermal/thermal_zone0/trip_point_*_type
  grep . /sys/class/thermal/thermal_zone0/trip_point_*_type


The values of the trip point temperatures can be lowered individually (make sure the trip points have the correct number for their corresponding trip type, don't swap the values for "critical" and "passive", <b>danger</b>!), example values:
The default trip point temperatures are also available in the [https://elixir.bootlin.com/linux/v5.12/source/arch/arm64/boot/dts/allwinner/sun50i-a64.dtsi#L194 A64 device tree]. The possible names and associated meanings for the trip point types are the following:
 
* "active"&nbsp;&ndash; a trip point to enable active cooling
* "passive"&nbsp;&ndash; a trip point to enable passive cooling
* "hot"&nbsp;&ndash; a trip point to notify emergency
* "critical"&nbsp;&ndash; hardware not reliable
 
The values for the trip point temperatures can be lowered individually, but make sure the trip points have the correct value for their corresponding trip type, e.g. '''don't''' simply swap the values for the first and the second trip point. '''Make sure not to set values higher than 110000''' (i.e. 110 degrees Celsius, which is the default value) for the third threshold, as it may cause damage to the phone. Use the following commands:
 
echo 55000  > /sys/class/thermal/thermal_zone0/trip_point_0_temp  # passive
echo 75000  > /sys/class/thermal/thermal_zone0/trip_point_1_temp  # hot
echo 100000 > /sys/class/thermal/thermal_zone0/trip_point_2_temp  # critical


{{warning|Setting wrong values in the Thermal Sysfs driver poses a risk, the instructions are directed towards expert-level users and developers!}}
Further information can be found in these documents from the Linux kenel source:


echo 65000  > /sys/class/thermal/thermal_zone0/trip_point_0_temp
* [https://www.kernel.org/doc/Documentation/thermal/sysfs-api.txt Documentation/thermal/sysfs-api.txt]
echo 80000  > /sys/class/thermal/thermal_zone0/trip_point_1_temp
* [https://www.kernel.org/doc/Documentation/hwmon/sysfs-interface Documentation/hwmon/sysfs-interface]
echo 90000 > /sys/class/thermal/thermal_zone0/trip_point_2_temp
* [https://www.kernel.org/doc/Documentation/devicetree/bindings/thermal/thermal.txt Documentation/devicetree/bindings/thermal/thermal.txt]


For details see the kernel documentation, https://www.kernel.org/doc/Documentation/thermal/sysfs-api.txt.
[[Category:PinePhone]]

Latest revision as of 01:50, 16 August 2022

This page explains how to read the thermal sensor data, and how to read and change the default settings.

Under Linux

Warning: Setting wrong values for the thermal trip points poses a risk. These instructions are directed towards expert-level users and developers.

Thermal management of the PinePhone CPU is handled by the thermal framework of the Linux kernel. Depending on the Linux distribution used on a PinePhone, the default settings may differ. It may be advised to lower the settings (i.e. the thermal trip point temperatures) to prevent the phone components from being damaged by excessive heat.

Current CPU temperature can be displayed using the following command:

cat /sys/class/thermal/thermal_zone0/temp

The unit for all numeric values is millidegree Celsius. To read the thermal trip point types and current trip point temperatures, use the following:

grep . /sys/class/thermal/thermal_zone0/trip_point_*_temp
grep . /sys/class/thermal/thermal_zone0/trip_point_*_type

The default trip point temperatures are also available in the A64 device tree. The possible names and associated meanings for the trip point types are the following:

  • "active" – a trip point to enable active cooling
  • "passive" – a trip point to enable passive cooling
  • "hot" – a trip point to notify emergency
  • "critical" – hardware not reliable

The values for the trip point temperatures can be lowered individually, but make sure the trip points have the correct value for their corresponding trip type, e.g. don't simply swap the values for the first and the second trip point. Make sure not to set values higher than 110000 (i.e. 110 degrees Celsius, which is the default value) for the third threshold, as it may cause damage to the phone. Use the following commands:

echo 55000  > /sys/class/thermal/thermal_zone0/trip_point_0_temp  # passive
echo 75000  > /sys/class/thermal/thermal_zone0/trip_point_1_temp  # hot
echo 100000 > /sys/class/thermal/thermal_zone0/trip_point_2_temp  # critical

Further information can be found in these documents from the Linux kenel source: