From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933681AbaHZCRc (ORCPT ); Mon, 25 Aug 2014 22:17:32 -0400 Received: from hqemgate15.nvidia.com ([216.228.121.64]:5930 "EHLO hqemgate15.nvidia.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1757049AbaHZCRb (ORCPT ); Mon, 25 Aug 2014 22:17:31 -0400 X-PGP-Universal: processed; by hqnvupgp07.nvidia.com on Mon, 25 Aug 2014 19:03:20 -0700 Message-ID: <53FBEE39.2020001@nvidia.com> Date: Tue, 26 Aug 2014 10:17:29 +0800 From: Wei Ni User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.6.0 MIME-Version: 1.0 To: Eduardo Valentin CC: , , , , , Subject: Re: [PATCH v3 3/4] thermal: add more description for thermal-zones References: <1408948188-4181-1-git-send-email-wni@nvidia.com> <1408948188-4181-4-git-send-email-wni@nvidia.com> <20140825110711.GA12349@developer> In-Reply-To: <20140825110711.GA12349@developer> X-Originating-IP: [10.19.224.131] X-ClientProxiedBy: HKMAIL101.nvidia.com (10.18.16.10) To HKMAIL101.nvidia.com (10.18.16.10) Content-Type: text/plain; charset="ISO-8859-1" Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 08/25/2014 07:07 PM, Eduardo Valentin wrote: > Hello Wei Ni, > > On Mon, Aug 25, 2014 at 02:29:47PM +0800, Wei Ni wrote: >> Add more description for the "polling-delay" property. >> Set "trips" and "cooling maps" as optional property, because >> if missing these two sub-nodes, the thermal zone device still >> work properly. >> >> Signed-off-by: Wei Ni >> --- >> Documentation/devicetree/bindings/thermal/thermal.txt | 10 ++++++---- >> 1 file changed, 6 insertions(+), 4 deletions(-) >> >> diff --git a/Documentation/devicetree/bindings/thermal/thermal.txt b/Documentation/devicetree/bindings/thermal/thermal.txt >> index f5db6b7..e3d3ed9 100644 >> --- a/Documentation/devicetree/bindings/thermal/thermal.txt >> +++ b/Documentation/devicetree/bindings/thermal/thermal.txt >> @@ -136,8 +136,8 @@ containing trip nodes and one sub-node containing all the zone cooling maps. >> >> Required properties: >> - polling-delay: The maximum number of milliseconds to wait between polls >> - Type: unsigned when checking this thermal zone. >> - Size: one cell >> + Type: unsigned when checking this thermal zone. If this value is 0, the >> + Size: one cell driver will not run polling queue, but just cancel it. >> > > The description above is specific to Linux kernel implementation > nomenclature. DT description needs to be OS agnostic. > >> - polling-delay-passive: The maximum number of milliseconds to wait >> Type: unsigned between polls when performing passive cooling. >> @@ -148,14 +148,16 @@ Required properties: >> phandles + sensor >> specifier >> >> +Optional property: >> - trips: A sub-node which is a container of only trip point nodes >> Type: sub-node required to describe the thermal zone. >> >> - cooling-maps: A sub-node which is a container of only cooling device >> Type: sub-node map nodes, used to describe the relation between trips >> - and cooling devices. >> + and cooling devices. If missing the "trips" property, >> + This sub-node will not be parsed, because no trips can >> + be bound to cooling devices. > > Do you mean if the thermal zone misses the "trips" property? Actually, > the binding describes both, cooling-maps and trips, as required > properties. Thus, both needs to be in place to consider the thermal zone > as a proper described zone. I moved the "trips" and "cooling-maps" to optional property, because if missing these two properties, the thermal zone devices still can be registered, and the driver can work properly, it has the basic function, can read temperature from thermal sysfs, although it doesn't have trips and bind with cooling devices. Thanks. Wei. > >> >> -Optional property: >> - coefficients: An array of integers (one signed cell) containing >> Type: array coefficients to compose a linear relation between >> Elem size: one cell the sensors listed in the thermal-sensors property. >> -- >> 1.8.1.5 >>