# Thermal management

Thermal management is important to keep the junction and surface temperature of the device under control. The device operates most efficiently when the temperature is within the specified threshold.

- [Overview of thermal management](https://docs.qualcomm.com/doc/80-70018-30/topic/thermal-overview.html)
Thermal management is a configurable framework that allows you to
control the temperature of the entire device, ensuring reliability of
the device. It aids in maintaining the junction and surface temperatures
of the device within specified limits even when running high workload
applications.
- [Get started with thermal management](https://docs.qualcomm.com/doc/80-70018-30/topic/get-started-thermal.html)
This section describes how to develop software on Qualcomm Linux. Ensure
to set up the infrastructure before building your software. For more
information on setting up infrastructure, see [Qualcomm Linux Build
Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/introduction.html).
This guide also provides information about the common build workflow.
- [Understand thermal architecture](https://docs.qualcomm.com/doc/80-70018-30/topic/thermal-architecture.html)
The thermal architecture shows how the thermal framework of
Qualcomm Linux interacts with temperature sensors (Tsens) hardware,
cooling map interfaces, and user space clients.
- [Learn about thermal interfaces](https://docs.qualcomm.com/doc/80-70018-30/topic/thermal-interfaces.html)
The thermal architecture includes the `sysfs`  interface, which reads the thermal zone configurations and applies cooling actions to the CPU. The user space clients use the `sysfs` interface to communicate with the cooling map interface.
- [Configure a new thermal zone](https://docs.qualcomm.com/doc/80-70018-30/topic/customize.html)
For optimal performance of your product or application, it’s important
to customize and control its thermal behavior. You can configure a new
thermal zone for a newly added external thermistor to control the
surface temperature of Qualcomm Linux.
- [Debug using ftrace method](https://docs.qualcomm.com/doc/80-70018-30/topic/thermal-debug.html)
Thermal logging helps to understand the active configurations of the
thermal zones and the existing thermal mitigation levels. To retrieve
thermal configuration and active mitigation levels, use ftrace logs.

Last Published: Apr 10, 2025

[Previous Topic
Debug high sleep current](https://docs.qualcomm.com/bundle/publicresource/80-70018-30/topics/debug.md) [Next Topic
Overview of thermal management](https://docs.qualcomm.com/bundle/publicresource/80-70018-30/topics/thermal-overview.md)