[PATCH v3 1/3] dt-bindings: thermal: samsung: Add a hw-sensor-indices property

Shin Son
2025-09-15T04:07:51Z

The exynosautov920 TMU requires per-sensor interrupt enablement
for its critical trip points.

- **samsung,hw-sensor-indices**: List of sensor indices physically
monitored by this TMU block.
Indicies not listed exist in the SoC
register map but are not part of
this TMU instance

Additionally, add myself to the bindings' maintainers list, as I plan
to actively work on the exynosautov920 TMU support and handle further
updates in this area.
I also restrict 'samsung,hw-sensor-indices' to the V920 variant. To
ensure properties introduced in 'if/then' blocks are recognized, I
replace 'addtionalProperties: false' with 'unevaluatedProperties: false'.

Signed-off-by: Shin Son <shin.son@samsung.com>
---
.../thermal/samsung,exynos-thermal.yaml | 40 ++++++++++++++++++-
1 file changed, 38 insertions(+), 2 deletions(-)

diff --git a/Documentation/devicetree/bindings/thermal/samsung,exynos-thermal.yaml b/Documentation/devicetree/bindings/thermal/samsung,exynos-thermal.yaml
index 29a08b0729ee..448c68986b10 100644
--- a/Documentation/devicetree/bindings/thermal/samsung,exynos-thermal.yaml
+++ b/Documentation/devicetree/bindings/thermal/samsung,exynos-thermal.yaml
@@ -8,6 +8,7 @@ title: Samsung Exynos SoC Thermal Management Unit (TMU)

maintainers:
- Krzysztof Kozlowski <krzk@kernel.org>
+ - Shin Son <shin.son@samsung.com>

description: |
For multi-instance tmu each instance should have an alias correctly numbered
@@ -27,6 +28,7 @@ properties:
- samsung,exynos5420-tmu-ext-triminfo
- samsung,exynos5433-tmu
- samsung,exynos7-tmu
+ - samsung,exynosautov920-tmu

clocks:
minItems: 1
@@ -62,7 +64,7 @@ properties:
minItems: 1

'#thermal-sensor-cells':
- const: 0
+ enum: [0, 1]

vtmu-supply:
description: The regulator node supplying voltage to TMU.
@@ -97,6 +99,8 @@ allOf:
reg:
minItems: 2
maxItems: 2
+ '#thermal-sensor-cells':
+ const: 0
- if:
properties:
compatible:
@@ -119,6 +123,8 @@ allOf:
reg:
minItems: 1
maxItems: 1
+ '#thermal-sensor-cells':
+ const: 0

- if:
properties:
@@ -139,8 +145,38 @@ allOf:
reg:
minItems: 1
maxItems: 1
+ '#thermal-sensor-cells':
+ const: 0

-additionalProperties: false
+ - if:
+ properties:
+ compatible:
+ contains:
+ const: samsung,exynosautov920-tmu
+ then:
+ properties:
+ clocks:
+ minItems: 1
+ maxItems: 1
+ reg:
+ minItems: 1
+ maxItems: 1
+ '#thermal-sensor-cells':
+ const: 1
+ samsung,hw-sensor-indices:
+ description:
+ List of thermal sensor indices physically monitored by this TMU instance.
+ Indices not listed correspond to registers that exist in the SoC
+ but are not connected to this TMU hardware block.
+ $ref: /schemas/types.yaml#/definitions/uint32-array
+ minItems: 1
+ maxItems: 16
+ uniqueItems: true
+ items:
+ minimum: 0
+ maximum: 15
+
+unevaluatedProperties: false

examples:
- |
--
2.50.1