> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview of thermal management

Thermal management is a configurable framework that ensures reliability of the device. It aids in maintaining the junction and surface temperatures of the device within the specified limits even when running high workload applications.

This guide provides information about:

* Thermal architecture
* Heat dissipation techniques supported on Qualcomm Linux
* Tuning of thermal thresholds for mitigation based on the thermal requirements of the product
* Sending a notification to the user space
* Features to adjust temperature configurations to achieve the required thermal behavior

**Note:** See [Platform support for thermal management](platform-support-thermal) that are supported on Qualcomm Linux.

***

## Thermal Overview

### Thermal Architecture

Understand the thermal components and their interactions.

[Learn more about thermal architecture →](thermal-architecture)

### Learn about Thermal Interfaces

Learn how to control the thermal behavior of the device.

[Explore thermal interfaces →](learn-about-thermal-interfaces)

## Thermal Mitigation

### Thermal Mitigation Policies

Provides in-built software and hardware temperature mitigation policies to maintain the device's temperature.

[View detailed mitigation policies →](thermal-architecture#thermal-mitigation-policies)

## Customize Device Thermal Behavior

### Configure a Thermal Zone

Add a new external thermistor to control the surface temperature.

[Configure a thermal zone →](configure-a-thermal-zone)

### Customize a Thermal Zone

Understand the device's thermal behavior with customization of the thermal zone parameters.

[Customize thermal zones →](customize-a-thermal-zone)

### Control Heat Dissipation with Cooling Devices

Adjust the performance of components, like the CPU, to reduce heat dissipation.

[Manage cooling devices →](control-heat-dissipation-with-cooling-devices)

## Advanced Features

### ThermalD Daemon

ThermalD is a Linux daemon that provides intelligent thermal management by monitoring temperature sensors and applying thermal compensation using available cooling methods.

[Learn about ThermalD →](thermalD)

### Battery Current Limiting (BCL)

The BCL hardware monitor driver provides real-time monitoring of battery overcurrent and undervoltage conditions, protecting the battery and system from potentially damaging electrical conditions.

[Explore BCL features →](BCL)

## Troubleshoot

### Verify Thermal State

Retrieve the thermal behavior and active mitigation levels of the device using the ftrace logs.

[Verify thermal state →](verify-thermal-state)

## Getting Started

New to thermal management? Start with our workflow guide:

[Get started with thermal management workflow →](get-started-with-thermal-management-workflow)

## Quick Reference

Common thermal management commands:

* **View all thermal zones:** `ls /sys/class/thermal/thermal_zone*`
* **Check temperature:** `cat /sys/class/thermal/thermal_zone<x>/temp`
* **View cooling devices:** `ls /sys/class/thermal/cooling_device*`
* **Enable ftrace logging:** `echo 1 > /sys/kernel/tracing/events/thermal/enable`

## Additional Resources

* [Thermal Architecture Details](thermal-architecture)
* [Linux Kernel Thermal Documentation](https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/driver-api/thermal/sysfs-api.rst?h=v6.6)