SSD thermal throttling
SSD thermal throttling is a controller response that limits activity or performance to manage device temperature.
Thermal behavior depends on the device and firmware; NVMe HCTM is one specified control mechanism, not a synonym for every thermal safeguard. The host sets TMT1 for light throttling and TMT2 for heavy throttling, each a 16-bit temperature in kelvins within the controller's reported range, and a non-zero TMT2 must exceed TMT1. [1]
In the SMART log, TMT1TC and TMT2TC count transitions, while TTTMT1 and TTTMT2 accumulate seconds of thermal-management action. Warning and critical composite temperature times are kept in minutes instead. These action counters must be distinguished from time above warning or critical thresholds. Each counter stops at FFFFFFFFh rather than wrapping. [1] [2]
A vendor-specific temperature-statistics command reports fields defined by one manufacturer and is undefined on other devices, so its output is not a portable inventory of every SSD's sensors or shutdown thresholds. [3]
Relations
- related
- Solid-state drive (SSD), Enterprise SSD, SD Express, NVMe Composite Temperature, NVMe Host Controlled Thermal Management, NVMe Warning Composite Temperature Time, NVMe Critical Composite Temperature Time, NVMe Autonomous Power State Transition, PCIe Active State Power Management
Advantages
- Two host-set thresholds allow light throttling to begin before heavy throttling, and the separate counters show which level was reached. [1]
Limitations
- A slowdown alone does not establish a thermal cause, and a zero HCTM counter can mean an unimplemented field rather than no throttling. [2]
Citations
- NVM Express Base Specification 2.3: Figure 210 (pp. 214-217), temperature hysteresis section 5.2.26.1.3.1, HCTM Figure 417 (p. 410)
- libnvme v1.15: nvme_smart_log field definitions (July 2025)
- nvme-cli v2.13: WDC vendor temperature statistics command
Sources & caveats
- base23 is NVM Express Base Specification 2.3, read 2026-10-23 for the SMART log thermal fields and HCTM Figure 417 with the kelvin thresholds.
- nvmelog is the libnvme v1.15 nvme_smart_log definition, re-read for the 32-bit thermal counters. nvmecli is the nvme-cli v2.13 vendor temperature page, re-read for its device restriction.
- The nvme-base-spec entry links here because host controlled thermal management and the SMART thermal counters are defined in that specification.