# Getting started

Source: [https://docs.qualcomm.com/doc/80-70014-30/topic/get-started-thermal.html](https://docs.qualcomm.com/doc/80-70014-30/topic/get-started-thermal.html)

The information here describes how to start developing your software on the Qualcomm
        Linux platform. 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-70014-254/introduction.html). This guide also
        provides information about the common build workflows.

## Thermal mitigation policies

You must enable SSH in Permissive mode to securely access your host device. For
                instructions, see [How to SSH?](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-254/how_to.html#how-to-ssh-).

Table : SoC temperature management techniques and description

| SoC temperature management techniques | Description |
| --- | --- |
| Software throttling | Software throttling is a mechanism where the Tsens hardware<br>                                        triggers an interrupt whenever the temperature in the system<br>                                        crosses the configured temperature threshold.<br><br><br>                                    <br>Following are the mitigation actions that the thermal<br>                                        framework initiates on the CPU in response to these<br>                                            interrupts:<ul class="ul" id="get-started-thermal__ul_zdb_4gy_zbc"><br>                                            <li class="li">Thermal DCVS<ul class="ul" id="get-started-thermal__ul_a2b_4gy_zbc"><br>                                                  <li class="li">Reduces the maximum operating frequency if<br>                                                  temperature thresholds are crossed</li><br><br>                                                  <li class="li">Voltage scaling occurs according to clock<br>                                                  scaling, which reduces power consumption and in<br>                                                  turn reduces temperature</li><br><br>                                                </ul><br></li><br><br>                                            <li class="li">CPU idle injection<p class="p">Core is put in the deepest<br>                                                  Low-Power state for configured idle time</p><br></li><br><br>                                        </ul> |
| Hardware throttling | The SoC employs in-built hardware to execute thermal<br>                                        mitigation actions swiftly, ensuring system reliability.<br><br><br>                                    <br>Hardware throttling reduces the CPU clock speed to recover<br>                                        quickly from high thermal conditions. Following are the<br>                                        hardware throttling scenarios:<br><br><br>                                    <ul class="ul" id="get-started-thermal__ul_b2b_4gy_zbc"><br>                                        <li class="li">High thermal conditions (typically above 105°C of<br>                                            junction temperature)</li><br><br>                                        <li class="li">Voltage drop at PMIC</li><br><br>                                        <li class="li">Over current protection of battery</li><br><br>                                    </ul> |
| SoC software shutdown | The SoC software shutdown is triggered when the temperature<br>                                    of any of the on-die Tsens reaches 118 °C. Upon receiving an<br>                                    interruption from Tsens, the thermal framework initiates<br>                                    graceful shutdown. |
| SoC hardware shutdown | The SoC hardware shutdown is triggered when the temperature<br>                                    of any of the on-die sensors reaches 120°C. |

The thermal mitigation policies regulate the thermal behavior of the platform.

The thermal framework operates in the following ways:
1. The thermal framework uses on-die temperature sensors (Tsens) to monitor
                        system's thermal response.
2. It applies mitigation based on thermal threshold limits as per the device
                        tree.
3. It provides software throttling, hardware throttling, SoC software shutdown,
                        and SoC hardware shutdown mitigation policies to control temperature.

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

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-70014-30/topic/customize.html#customize__section_lq4_xxb_51c).

**Parent Topic:** [Thermal management](https://docs.qualcomm.com/doc/80-70014-30/topic/thermalmanagement.html)

Last Published: Jul 15, 2024

[Previous Topic
Overview](https://docs.qualcomm.com/bundle/publicresource/80-70014-30/topics/thermal-overview.md) [Next Topic
Architecture](https://docs.qualcomm.com/bundle/publicresource/80-70014-30/topics/thermal%20architecture.md)