From patchwork Mon Oct 31 16:02:03 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Steve Twiss X-Patchwork-Id: 9405817 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 3C30560588 for ; Mon, 31 Oct 2016 16:15:47 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 282C6291E3 for ; Mon, 31 Oct 2016 16:15:47 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 1C27E2933A; Mon, 31 Oct 2016 16:15:47 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=unavailable version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id AE9E5291E3 for ; Mon, 31 Oct 2016 16:15:46 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1758915AbcJaQPo (ORCPT ); Mon, 31 Oct 2016 12:15:44 -0400 Received: from mail1.bemta5.messagelabs.com ([195.245.231.138]:61739 "EHLO mail1.bemta5.messagelabs.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1757153AbcJaQPl (ORCPT ); Mon, 31 Oct 2016 12:15:41 -0400 Received: from [85.158.139.35] by server-2.bemta-5.messagelabs.com id 86/DC-08512-82E67185; Mon, 31 Oct 2016 16:15:36 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFlrIKsWRWlGSWpSXmKPExsUSt3Opsa56nni EwZ21NhZTHz5hs5h/5ByrxeFFLxgt5l+5xmpx/+tRRotvVzqYLG5++sZqcXnXHDaLz71HGC1u rNvHbvFk4Rkmi6XXLzJZtO49AuQ+7GOzuDyxk93i1owXrA4CHmvmrWH02DnrLrvHtc1iHov3v GTy2LSqk83jzrU9bB47vzewe3zeJBfAEcWamZeUX5HAmnF2+0rGgidSFReOLmRvYDwj1sXIxS EksJ5RYuHlO2xdjJxAToXEui0LmEBsXoFkidZpq4DiHBycAo4SX7pcIEocJHZevAJWziZgKDH vzXtGEJtFQFXiy+EzYLawQILEkmOHWUHmiwhMYJLY0LaSGcRhFvjMJLFkz3NmiAWCEidnPmEB sZkFJCQOvnjBDLJMSEBLYvmxSJCwhIC9xPT3V8HCEgL6Eo3HYiHChhLfZ31jgbDNJRoWdTJOY BSchWToLCRDFzAyrWLUKE4tKkst0jU01EsqykzPKMlNzMzRNTQw1ctNLS5OTE/NSUwq1kvOz9 3ECIw6BiDYwbiy3fkQoyQHk5Io79cw8QghvqT8lMqMxOKM+KLSnNTiQ4wyHBxKEry7c4BygkW p6akVaZk5wPiHSUtw8CiJ8HaBpHmLCxJzizPTIVKnGBWlxHkPgyQEQBIZpXlwbbCUc4lRVkqY lxHoECGegtSi3MwSVPlXjOIcjErCvH0gU3gy80rgpr8CWswEtDitUARkcUkiQkqqgTGxNIrjH JdeWHFR+5Tssxeszxdlqm2v0kqcO2uf+d/V6bdZJmd9ePL/0v78MJm532a4VM/5Un3X4bTb9i xBg4X2a/RWBu27vT5U7m5i/xyjdU/2Z0+vqN3Y++PptGtObarX+pz1+BTLHvEoTsp4YGHHp+L 3/WPZKdkfx61KH6V8aZo1KTBkykQlluKMREMt5qLiRAAH+QUpNAMAAA== X-Env-Sender: stwiss.opensource@diasemi.com X-Msg-Ref: server-6.tower-179.messagelabs.com!1477930534!63574082!2 X-Originating-IP: [94.185.165.51] X-StarScan-Received: X-StarScan-Version: 9.0.13; banners=-,-,- X-VirusChecked: Checked Received: (qmail 22478 invoked from network); 31 Oct 2016 16:15:35 -0000 Received: from mailrelay2.diasemi.com (HELO sw-ex-cashub01.diasemi.com) (94.185.165.51) by server-6.tower-179.messagelabs.com with AES128-SHA encrypted SMTP; 31 Oct 2016 16:15:35 -0000 Received: from swsrvapps-01.diasemi.com (10.20.28.141) by SW-EX-CASHUB01.diasemi.com (10.20.16.140) with Microsoft SMTP Server id 14.3.248.2; Mon, 31 Oct 2016 16:15:33 +0000 Received: by swsrvapps-01.diasemi.com (Postfix, from userid 22547) id 411DD3FBE5; Mon, 31 Oct 2016 16:15:33 +0000 (GMT) Message-ID: <318faafc8021e6adc683e62d57b8c031b9212e0f.1477929725.git.stwiss.opensource@diasemi.com> In-Reply-To: References: From: Steve Twiss Date: Mon, 31 Oct 2016 16:02:03 +0000 Subject: [PATCH V3 3/9] Documentation: devicetree: thermal: da9062/61 TJUNC temperature binding To: DEVICETREE , Eduardo Valentin , LINUX-KERNEL , LINUX-PM , Mark Rutland , Rob Herring , Zhang Rui CC: Dmitry Torokhov , Guenter Roeck , LINUX-INPUT , LINUX-WATCHDOG , Lee Jones , Liam Girdwood , Mark Brown , Support Opensource , Wim Van Sebroeck MIME-Version: 1.0 X-KSE-AttachmentFiltering-Interceptor-Info: protection disabled X-KSE-ServerInfo: sw-ex-cashub01.diasemi.com, 9 X-KSE-Antivirus-Interceptor-Info: scan successful X-KSE-Antivirus-Info: Clean, bases: 31/10/2016 13:14:00 Sender: linux-pm-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-pm@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP From: Steve Twiss Device tree binding information for DA9062 and DA9061 thermal junction temperature monitor. Binding descriptions for the DA9061 and DA9062 thermal TJUNC supervisor device driver, using a single THERMAL_TRIP_HOT trip-wire and allowing for a configurable polling period for over-temperature polling. This patch also adds two examples, one for DA9062 and one for DA9061. The DA9061 example uses a fall-back compatible string for the DA9062. Signed-off-by: Steve Twiss Acked-by: Rob Herring --- This patch applies against linux-next and v4.8 v2 -> v3 - Patch renamed from [PATCH V2 03/10] to [PATCH V3 3/9] - Changes suggested from other component reviews by Rob Herring: - Each compatible line should be a valid combination of compatible strings: alter DA9061 line to include the fall back compatible string and update the commit message accordingly - Add e-mail information about associated patches from this set without describing them as being explicitly dependent on this binding v1 -> v2 - Patch renamed from [PATCH V1 08/10] to [PATCH V2 03/10] -- these changes were made to fix checkpatch warnings caused by the patch set dependency order - A second example for DA9061 is provided to highlight the use of a fall-back compatible option for the DA9062 Hi, The older [PATCH V1 08/10] was acked-by: Rob Herring, however this has not been added because changes have been made to add a new binding example. This describes the use of DA9061. This addition was made after alterations to the device driver meant that a fall-back compatible string could reuse the DA9062 device driver. The device driver from this patch set (associated with this binding) is: [PATCH V3 8/9] thermal: da9061: TJUNC temperature driver Regards, Steve Twiss, Dialog Semiconductor Ltd. .../devicetree/bindings/thermal/da9062-thermal.txt | 37 ++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 Documentation/devicetree/bindings/thermal/da9062-thermal.txt diff --git a/Documentation/devicetree/bindings/thermal/da9062-thermal.txt b/Documentation/devicetree/bindings/thermal/da9062-thermal.txt new file mode 100644 index 0000000..460ce68 --- /dev/null +++ b/Documentation/devicetree/bindings/thermal/da9062-thermal.txt @@ -0,0 +1,37 @@ +* Dialog DA9062/61 TJUNC Thermal Module + +This module is part of the DA9061/DA9062. For more details about entire +DA9062 and DA9061 chips see Documentation/devicetree/bindings/mfd/da9062.txt + +Junction temperature thermal module uses an interrupt signal to identify +high THERMAL_TRIP_HOT temperatures for the PMIC device. + +Required properties: + +- compatible: should be one of the following valid compatible string lines: + "dlg,da9061-thermal", "dlg,da9062-thermal" + "dlg,da9062-thermal" + +Optional properties: + +- dlg,tjunc-temp-polling-period-ms : Specify the polling period, measured + in milliseconds, between thermal zone device update checks. + +Example: DA9062 + + pmic0: da9062@58 { + thermal { + compatible = "dlg,da9062-thermal"; + dlg,tjunc-temp-polling-period-ms = <3000>; + }; + }; + +Example: DA9061 using a fall-back compatible for the DA9062 onkey driver + + pmic0: da9061@58 { + thermal { + compatible = "dlg,da9061-thermal", "dlg,da9062-thermal"; + dlg,tjunc-temp-polling-period-ms = <3000>; + }; + }; +