# Thermal management

Thermal management plays a crucial role in maintaining the junction
temperature of the device well below its operating temperature
limit.

- [Overview](https://docs.qualcomm.com/doc/80-70017-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.
- [Getting started](https://docs.qualcomm.com/doc/80-70017-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-70017-254/introduction.html).
This guide also provides information about the common build workflow.
- [Architecture](https://docs.qualcomm.com/doc/80-70017-30/topic/thermal-architecture.html)
The thermal architecture illustrates how the thermal framework of
Qualcomm Linux interacts with temperature sensors (Tsens) hardware,
cooling map interfaces, and user space clients.
- [Interfaces](https://docs.qualcomm.com/doc/80-70017-30/topic/thermal-interfaces.html)
The thermal architecture includes the `sysfs` interface, which is used
to read the thermal zone configurations and the cooling actions applied
on the CPU. The user space clients use the `sysfs` interface to
communicate with the cooling map interface.
- [Customize](https://docs.qualcomm.com/doc/80-70017-30/topic/customize.html)
For optimal performance of your product or application, it is 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](https://docs.qualcomm.com/doc/80-70017-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: Jan 26, 2025

[Previous Topic
Debug](https://docs.qualcomm.com/bundle/publicresource/80-70017-30/topics/debug.md) [Next Topic
Overview](https://docs.qualcomm.com/bundle/publicresource/80-70017-30/topics/thermal-overview.md)