# Architecture

The thermal architecture illustrates how the thermal framework of
Qualcomm Linux interacts with temperature sensors (Tsens) hardware,
cooling map interfaces, and user space clients.

![../../_images/thermal_arch.png](data:image/png;base64,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)

**Figure : Thermal architecture**

Table : Description of the components of thermal architecture

| Components of thermal architecture | Description |
| --- | --- |
| Thermal device tree | <ul class="simple"><br><li><p>A thermal zone is configured for every Tsens.</p></li><br><li><p>Each thermal zone consists of sensor hardware<br>information, different levels of thermal thresholds, and<br>their respective cooling actions.</p></li><br><li><p>All rules for a thermal zone are defined in the device<br>tree.</p></li><br></ul> |
| Thermal framework | The thermal framework parses the thermal zone rules from the<br>device tree and configures Tsens hardware to generate<br>interrupts when temperature crosses the threshold. |
| Thermal governor | <ul class="simple"><br><li><p>The thermal governor is a temperature monitor algorithm<br>that controls the temperature of a thermal zone.</p></li><br><li><p>It mitigates the cooling devices associated with the zone<br>and keeps the temperature within the limit.</p></li><br><li><p>Upon receipt of interrupt notification from Tsens<br>hardware, the thermal framework uses a stepwise thermal<br>governor to communicate the cooling actions to the<br>cooling map interface (CPU frequency driver).</p></li><br></ul> |
| Cooling map interface | <ul class="simple"><br><li><p>A cooling map interface is a collection of devices that<br>can be throttled to reduce the temperature of Qualcomm<br>Linux.</p></li><br><li><p>Every trip instance of the thermal zone is associated<br>with a cooling device.</p></li><br><li><p>The thermal core framework aggregates all the cooling<br>device instance requests and places the aggregated<br>requests to the cooling device.</p></li><br></ul> |
| User space clients | User space clients use the following interfaces to<br>communicate with the thermal framework:<br><br><br><br>> <br>> <br>> <ul class="simple"><br>> <li><p>The <code class="docutils literal notranslate"><span class="pre">sysfs</span></code> interface is used to read the temperature<br>> of Tsens and kernel trip information.</p></li><br>> <li><p>The <code class="docutils literal notranslate"><span class="pre">Netlink</span></code> interface gets information of Tsens<br>> temperature notifications.</p></li><br>> </ul> |

## Thermal mitigation policies

Qualcomm Linux has in-built software and hardware mitigation policies
that are used to regulate the thermal behavior of the device.

The thermal framework applies the mitigation policies when required and
operates in the following ways:

- Uses on-die Tsens to monitor the thermal response of the system
- Applies mitigation based on thermal threshold limits as per the
device tree
- Provides software throttling, hardware throttling, software shutdown,
and hardware shutdown mitigation policies to control temperature

Table : Temperature management techniques and description

| Temperature management techniques | Description |
| --- | --- |
| Software throttling | <ul><br><li><p>The Tsens triggers an interrupt whenever the temperature<br>in the system crosses the configured threshold.</p></li><br><li><p>The thermal framework initiates the following mitigation<br>actions on the CPU, GPU, and NSP in response to the<br>interrupts:</p><ul><br><li><p>Thermal DCVS</p><ul class="simple"><br><li><p>Reduces the maximum operating frequency if<br>temperature thresholds are crossed</p></li><br><li><p>Voltage scaling occurs according to clock scaling,<br>which reduces power consumption and temperature in<br>turn</p></li><br></ul><br></li><br><li><p>CPU idle injection</p><br><p>The core is put in the deepest Low-Power state for the<br>configured idle time.</p><br></li><br></ul><br></li><br></ul> |
| Hardware throttling | <ul class="simple"><br><li><p>In-built hardware executes thermal mitigation actions<br>ensuring system reliability</p></li><br><li><p>Reduces CPU and NSP clock speed to quickly recover from<br>high thermal conditions</p></li><br></ul> |
| Software shutdown | The thermal framework initiates graceful shutdown upon<br>receiving interruption from Tsens. |
| Hardware shutdown | The hardware initiates a device shutdown. |

Note

The thermal mitigation techniques are for information purpose only. They help to understand performance regressions during high thermal conditions.

The following tables show the temperatures at which in-built software and hardware mitigation occur.

Tab QCS6490/QCS5430
Tab QCS9075
Tab QCS8275

| Mitigation actions | CPU | NSP | GPU |
| --- | --- | --- | --- |
| Software throttling | 115 ºC<br><br><br>Mitigation action: Core idle injection | 110 ºC<br><br><br>Mitigation action: Frequency throttling | 105 ºC<br><br><br>Mitigation action: Frequency throttling |
| Hardware throttling | 105 ºC<br><br><br>Mitigation action: Frequency throttling | 102 ºC<br><br><br>Mitigation action: Frequency throttling | Not applicable |
| Software shutdown | <br>118 ºC<br><br><br>Mitigation action: Device shutdown | <br>118 ºC<br><br><br>Mitigation action: Device shutdown | <br>118 ºC<br><br><br>Mitigation action: Device shutdown |
| Hardware shutdown | <br>120 ºC<br><br><br>Mitigation action: Device shutdown | <br>120 ºC<br><br><br>Mitigation action: Device shutdown | <br>120 ºC<br><br><br>Mitigation action: Device shutdown |

| Mitigation actions | CPU | NSP | GPU |
| --- | --- | --- | --- |
| Software throttling | 116 ºC<br><br><br>Mitigation action: Core idle injection | 105 ºC<br><br><br>Mitigation action: Frequency throttling | 105 ºC<br><br><br>Mitigation action: Frequency throttling |
| Hardware throttling | 110 ºC<br><br><br>Mitigation action: Frequency throttling | 110 ºC<br><br><br>Mitigation action: Frequency throttling | Not applicable |
| Software shutdown | <br>118 ºC<br><br><br>Mitigation action: Device shutdown | <br>118 ºC<br><br><br>Mitigation action: Device shutdown | <br>118 ºC<br><br><br>Mitigation action: Device shutdown |
| Hardware shutdown | <br>120 ºC<br><br><br>Mitigation action: Device shutdown | <br>120 ºC<br><br><br>Mitigation action: Device shutdown | <br>120 ºC<br><br><br>Mitigation action: Device shutdown |

| Mitigation actions | CPU | NSP | GPU |
| --- | --- | --- | --- |
| Software throttling | 116 ºC<br><br><br>Mitigation action: Core idle injection | 105 ºC<br><br><br>Mitigation action: Frequency throttling | 105 ºC<br><br><br>Mitigation action: Frequency throttling |
| Hardware throttling | 110 ºC<br><br><br>Mitigation action: Frequency throttling | 110 ºC<br><br><br>Mitigation action: Frequency throttling | Not applicable |
| Software shutdown | <br>118 ºC<br><br><br>Mitigation action: Device shutdown | <br>118 ºC<br><br><br>Mitigation action: Device shutdown | <br>118 ºC<br><br><br>Mitigation action: Device shutdown |
| Hardware shutdown | <br>120 ºC<br><br><br>Mitigation action: Device shutdown | <br>120 ºC<br><br><br>Mitigation action: Device shutdown | <br>120 ºC<br><br><br>Mitigation action: Device shutdown |

Note

To mitigate thermal conditions, you can create your own thermal zone rules based on a PCB thermistor. For more information, see [Configure a new thermal zone](https://docs.qualcomm.com/doc/80-70017-30/topic/customize.html#section-lq4-xxb-51c).

Last Published: Jan 26, 2025

[Previous Topic
Getting started](https://docs.qualcomm.com/bundle/publicresource/80-70017-30/topics/get-started-thermal.md) [Next Topic
Interfaces](https://docs.qualcomm.com/bundle/publicresource/80-70017-30/topics/thermal-interfaces.md)

Source: [https://docs.qualcomm.com/doc/80-70017-30/topic/thermal-architecture.html](https://docs.qualcomm.com/doc/80-70017-30/topic/thermal-architecture.html)