[PATCH v1 14/14] dt-bindings: thermal: cooling-devices: Update support for 3 cells cooling device

[PATCH v1 14/14] dt-bindings: thermal: cooling-devices: Update support for 3 cells cooling device

[Daniel Lezcano]

From: Gaurav Kohli <gaurav.kohli@oss.qualcomm.com>

Extend the thermal cooling device binding to support a 3 cells specifier
along with tje 2 cells format.

Update #cooling-cells property to enum to support both 2 and 3 arguments.

Signed-off-by: Gaurav Kohli <gaurav.kohli@oss.qualcomm.com>
Signed-off-by: Daniel Lezcano <daniel.lezcano@oss.qualcomm.com>
---
 .../bindings/thermal/thermal-cooling-devices.yaml         | 8 ++++++--
 .../devicetree/bindings/thermal/thermal-zones.yaml        | 3 ++-
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/Documentation/devicetree/bindings/thermal/thermal-cooling-devices.yaml b/Documentation/devicetree/bindings/thermal/thermal-cooling-devices.yaml
index b9022f1613d8..28f5818f1e60 100644
--- a/Documentation/devicetree/bindings/thermal/thermal-cooling-devices.yaml
+++ b/Documentation/devicetree/bindings/thermal/thermal-cooling-devices.yaml
@@ -44,10 +44,14 @@ select: true
 properties:
   "#cooling-cells":
     description:
-      Must be 2, in order to specify minimum and maximum cooling state used in
+      Must be 2 or 3. If 2, specifies minimum and maximum cooling state used in
       the cooling-maps reference. The first cell is the minimum cooling state
       and the second cell is the maximum cooling state requested.
-    const: 2
+      If 3, the first cell specifies the thermal mitigation device specifier
+      index for devices that support multiple thermal mitigation mechanisms.
+      The two other cells are respectively the minimum cooling state and the
+      maximum cooling state.
+    enum: [2, 3]
 
 additionalProperties: true
 
diff --git a/Documentation/devicetree/bindings/thermal/thermal-zones.yaml b/Documentation/devicetree/bindings/thermal/thermal-zones.yaml
index 0de0a9757ccc..1261ba0e802e 100644
--- a/Documentation/devicetree/bindings/thermal/thermal-zones.yaml
+++ b/Documentation/devicetree/bindings/thermal/thermal-zones.yaml
@@ -214,7 +214,8 @@ patternProperties:
                   device. Using the THERMAL_NO_LIMIT (-1UL) constant in the
                   cooling-device phandle limit specifier lets the framework
                   use the minimum and maximum cooling state for that cooling
-                  device automatically.
+                  device automatically. If three arguments are specified,
+                  the first argument is the cooling device specifier.
 
               contribution:
                 $ref: /schemas/types.yaml#/definitions/uint32
-- 
2.43.0

Re: [PATCH v1 14/14] dt-bindings: thermal: cooling-devices: Update support for 3 cells cooling device

[Krzysztof Kozlowski]

On Sun, Apr 19, 2026 at 08:21:58PM +0200, Daniel Lezcano wrote:
> diff --git a/Documentation/devicetree/bindings/thermal/thermal-cooling-devices.yaml b/Documentation/devicetree/bindings/thermal/thermal-cooling-devices.yaml
> index b9022f1613d8..28f5818f1e60 100644
> --- a/Documentation/devicetree/bindings/thermal/thermal-cooling-devices.yaml
> +++ b/Documentation/devicetree/bindings/thermal/thermal-cooling-devices.yaml
> @@ -44,10 +44,14 @@ select: true
>  properties:
>    "#cooling-cells":
>      description:
> -      Must be 2, in order to specify minimum and maximum cooling state used in
> +      Must be 2 or 3. If 2, specifies minimum and maximum cooling state used in
>        the cooling-maps reference. The first cell is the minimum cooling state
>        and the second cell is the maximum cooling state requested.
> -    const: 2
> +      If 3, the first cell specifies the thermal mitigation device specifier
> +      index for devices that support multiple thermal mitigation mechanisms.
> +      The two other cells are respectively the minimum cooling state and the
> +      maximum cooling state.
> +    enum: [2, 3]

In the same commit you need to narrow
Documentation/devicetree/bindings/hwmon/pwm-fan.yaml
so it will keep value of '2' (const: 2, like all other bindings).

Best regards,
Krzysztof

Re: [PATCH v1 14/14] dt-bindings: thermal: cooling-devices: Update support for 3 cells cooling device

[Daniel Lezcano]

On 4/22/26 09:31, Krzysztof Kozlowski wrote:
> On Sun, Apr 19, 2026 at 08:21:58PM +0200, Daniel Lezcano wrote:
>> diff --git a/Documentation/devicetree/bindings/thermal/thermal-cooling-devices.yaml b/Documentation/devicetree/bindings/thermal/thermal-cooling-devices.yaml
>> index b9022f1613d8..28f5818f1e60 100644
>> --- a/Documentation/devicetree/bindings/thermal/thermal-cooling-devices.yaml
>> +++ b/Documentation/devicetree/bindings/thermal/thermal-cooling-devices.yaml
>> @@ -44,10 +44,14 @@ select: true
>>   properties:
>>     "#cooling-cells":
>>       description:
>> -      Must be 2, in order to specify minimum and maximum cooling state used in
>> +      Must be 2 or 3. If 2, specifies minimum and maximum cooling state used in
>>         the cooling-maps reference. The first cell is the minimum cooling state
>>         and the second cell is the maximum cooling state requested.
>> -    const: 2
>> +      If 3, the first cell specifies the thermal mitigation device specifier
>> +      index for devices that support multiple thermal mitigation mechanisms.
>> +      The two other cells are respectively the minimum cooling state and the
>> +      maximum cooling state.
>> +    enum: [2, 3]
> 
> In the same commit you need to narrow
> Documentation/devicetree/bindings/hwmon/pwm-fan.yaml
> so it will keep value of '2' (const: 2, like all other bindings).

Ah yes, thanks !