dt-bindings: thermal-zones: Document critical-action
authorFabio Estevam <festevam@denx.de>
Wed, 29 Nov 2023 12:43:27 +0000 (09:43 -0300)
committerDaniel Lezcano <daniel.lezcano@linaro.org>
Tue, 2 Jan 2024 08:33:18 +0000 (09:33 +0100)
commit87f67d1747bc3ce8ace14be99b47d7731041ff03
tree155fa72a7bc0b145b6ad48ecae943b5a7e63a4e3
parent748b49c7dfe59d026c2e44cfb63cf66659aceb50
dt-bindings: thermal-zones: Document critical-action

Document the critical-action property to describe the thermal action
the OS should perform after the critical temperature is reached.

The possible values are "shutdown" and "reboot".

The motivation for introducing the critical-action property is that
different systems may need different thermal actions when the critical
temperature is reached.

For example, in a desktop PC, it is desired that a shutdown happens
after the critical temperature is reached.

However, in some embedded cases, such behavior does not suit well,
as the board may be unattended in the field and rebooting may be a
better approach.

The bootloader may also benefit from this new property as it can check
the SoC temperature and in case the temperature is above the critical
point, it can trigger a shutdown or reboot accordingly.

Signed-off-by: Fabio Estevam <festevam@denx.de>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Signed-off-by: Daniel Lezcano <daniel.lezcano@linaro.org>
Link: https://lore.kernel.org/r/20231129124330.519423-1-festevam@gmail.com
Documentation/devicetree/bindings/thermal/thermal-zones.yaml