zephyr,cpu-freq-thermal-cap

Description

CPU frequency thermal cap.

Thermal cap constraints use the performance-states child order as the
CPU frequency ordering: lower index P-states are treated as higher-performance,
higher index P-states are treated as lower-performance and more restrictive.

Properties

Top level properties

These property descriptions apply to “zephyr,cpu-freq-thermal-cap” nodes themselves. This page also describes child node properties in the following sections.

Properties not inherited from the base binding file.

Name

Type

Details

sensor

phandle

Temperature sensor used to compute the CPU frequency thermal cap.

This property is required.

sensor-channel

string

Sensor channel used for temperature samples.

Default value: die-temp

Legal values: die-temp, ambient-temp

polling-delay-ms

int

Polling interval in milliseconds while no thermal trip is active.

Default value: 1000

trip-active-polling-delay-ms

int

Polling interval in milliseconds while one or more thermal trips are active.
This is typically shorter than polling-delay-ms so cap changes and release
decisions are reflected promptly.

Default value: 100

Child node properties

Name

Type

Details

temperature-millicelsius

int

Temperature threshold in millicelsius. When this threshold is reached, the
trip becomes active and constrains CPU frequency to cap-pstate or lower.

This property is required.

hysteresis-millicelsius

int

Hysteresis in millicelsius. An active trip is released when the measured
temperature falls to temperature-millicelsius minus this value.

This property is required.

cap-pstate

phandle

Highest-performance P-state allowed while this trip is active.
The referenced P-state must belong to the ordered performance-states table.

This property is required.