From patchwork Thu Dec 15 19:08:39 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Steve Twiss X-Patchwork-Id: 9476775 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 942216047D for ; Thu, 15 Dec 2016 19:40:04 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 80B8B2877A for ; Thu, 15 Dec 2016 19:40:04 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 748F1287D8; Thu, 15 Dec 2016 19:40:04 +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 A91822877A for ; Thu, 15 Dec 2016 19:40:03 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754069AbcLOTjT (ORCPT ); Thu, 15 Dec 2016 14:39:19 -0500 Received: from mail1.bemta5.messagelabs.com ([195.245.231.139]:44509 "EHLO mail1.bemta5.messagelabs.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753065AbcLOTjQ (ORCPT ); Thu, 15 Dec 2016 14:39:16 -0500 Received: from [85.158.139.19] by server-3.bemta-5.messagelabs.com id DB/F6-01948-87FE2585; Thu, 15 Dec 2016 19:31:04 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFlrHKsWRWlGSWpSXmKPExsUSt3OpsW7F+6A Igw3TxSymPnzCZjH/yDlWi8OLXjBazL9yjdXi/tejjBbfrnQwWdz89I3V4vKuOWwWn3uPMFrc WLeP3eLJwjNMFkuvX2SyaN17BMh92MdmcXliJ7vFrRkvWB0EPNbMW8PosXPWXXaPa5vFPBbve cnksWlVJ5vHnWt72Dx2fm9g9/i8SS6AI4o1My8pvyKBNWPq5eWsBXe1Kq4v62JqYHyh0MXIxS EksJ5R4tb0xaxdjJxAToXEz3tLGEFsXoFkiRe9v8HinAKOEiuerWSDqHGQeHmviQXEZhMwlJj 35j1YPYuAqsSFi8vAaoQFfCWWHj3JBrJAROAMo8SuZb+YQRxmgUfMErtObGWF2CAocXLmE7BJ zAISEgdfvAAq4gDaoCWx/FgkSFhCwF5i+vurYGEJAX2JxmOxEGFDie+zvrFA2OYSMx4cY5vAK DgLydBZSIYuYGRaxahRnFpUllqka2Sul1SUmZ5RkpuYmaNraGCql5taXJyYnpqTmFSsl5yfu4 kRGHf1DAyMOxivbvE7xCjJwaQkypu9PChCiC8pP6UyI7E4I76oNCe1+BCjDAeHkgRv1DugnGB RanpqRVpmDjABwKQlOHiURHingqR5iwsSc4sz0yFSpxh1Ob40LHnKJMSSl5+XKiXOWwxSJABS lFGaBzcClowuMcpKCfMyMjAwCPEUpBblZpagyr9iFOdgVBLmXQsyhSczrwRu0yugI5iAjhBd4 g9yREkiQkqqgbHffQJLTvYnG6Mfn6x196x2qUsqD2mMqPyyw7hpqr+81rn2J8fcVnva3k7PKX vbxv34De/S6Q7Tu7jP3bh7/WXHfrute7UzVU+K7fLWtTPcxHv6bNNb6cP/f61fF7jRZcauJQK L7tTdt418W9exRLXkukKf51vJ9C61k3d1eJJazUuLlJ65bVBiKc5INNRiLipOBAD/OmqyQQMA AA== X-Env-Sender: stwiss.opensource@diasemi.com X-Msg-Ref: server-14.tower-178.messagelabs.com!1481830263!75802103!2 X-Originating-IP: [94.185.165.51] X-StarScan-Received: X-StarScan-Version: 9.1.1; banners=-,-,- X-VirusChecked: Checked Received: (qmail 20407 invoked from network); 15 Dec 2016 19:31:04 -0000 Received: from mailrelay2.diasemi.com (HELO sw-ex-cashub01.diasemi.com) (94.185.165.51) by server-14.tower-178.messagelabs.com with AES128-SHA encrypted SMTP; 15 Dec 2016 19:31:04 -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; Thu, 15 Dec 2016 19:31:03 +0000 Received: by swsrvapps-01.diasemi.com (Postfix, from userid 22547) id 3D4443FBB4; Thu, 15 Dec 2016 19:31:03 +0000 (GMT) Message-ID: <3254de40a5ca19e7b124ea386e1705ac5b5ebccf.1481828921.git.stwiss.opensource@diasemi.com> In-Reply-To: References: From: Steve Twiss Date: Thu, 15 Dec 2016 19:08:39 +0000 Subject: [PATCH V5 3/8] Documentation: devicetree: mfd: da9062/61 MFD binding To: DEVICETREE , LINUX-INPUT , LINUX-KERNEL , Mark Rutland , Rob Herring CC: Dmitry Torokhov , Eduardo Valentin , Guenter Roeck , LINUX-INPUT , LINUX-PM , LINUX-WATCHDOG , Lee Jones , Liam Girdwood , Mark Brown , Support Opensource , Wim Van Sebroeck , Zhang Rui 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: 15/12/2016 14:44: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 Extend existing DA9062 binding information to include the DA9061 PMIC for MFD core and regulators. Add a da9062-onkey link to the existing onkey binding file. Add a da9062-thermal link to the new temperature monitoring binding file. Delete the da9062-watchdog section and replace it with a link to the new DA9061/62 binding information file. Acked-by: Rob Herring Signed-off-by: Steve Twiss --- This patch applies against linux-next and v4.9 v4 -> v5 - NO CODE CHANGE - Rebased from v4.8 to v4.9 v3 -> v4 - Patch renamed from [PATCH V3 4/9] to [PATCH V4 3/8] - Remove double newline spacing in text file - Added Acked-by Rob Herring v2 -> v3 - Patch renamed from [PATCH V2 04/10] to [PATCH V3 4/9] - Ensure binding description concentrates on the device not the device driver - Separate the DA9061 and DA9062 sub-device tables to distinguish the difference between the two devices - Update the commit message to describe this change - 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 09/10] to [PATCH V2 04/10] -- these changes were made to fix checkpatch warnings caused by the patch set dependency order Hi, Added an Ack from Rob Herring for the PATCH V3 version. As previously: Other information: The device driver from this patch set (associated with this binding) is - [PATCH V5 4/8] mfd: da9061: MFD core support and also the following binding file changes: - Binding for onkey (already applied by Dmitry Torokhov) - [PATCH V5 1/8] Binding for watchdog - [PATCH V5 2/8] Binding for thermal Regards, Steve Twiss, Dialog Semiconductor Ltd. Documentation/devicetree/bindings/mfd/da9062.txt | 49 +++++++++++++++++------- 1 file changed, 36 insertions(+), 13 deletions(-) diff --git a/Documentation/devicetree/bindings/mfd/da9062.txt b/Documentation/devicetree/bindings/mfd/da9062.txt index 38802b5..c0a418c 100644 --- a/Documentation/devicetree/bindings/mfd/da9062.txt +++ b/Documentation/devicetree/bindings/mfd/da9062.txt @@ -1,22 +1,39 @@ * Dialog DA9062 Power Management Integrated Circuit (PMIC) -DA9062 consists of a large and varied group of sub-devices: +Product information for the DA9062 and DA9061 devices can be found here: +- http://www.dialog-semiconductor.com/products/da9062 +- http://www.dialog-semiconductor.com/products/da9061 + +The DA9062 PMIC consists of: Device Supply Names Description ------ ------------ ----------- da9062-regulator : : LDOs & BUCKs da9062-rtc : : Real-Time Clock +da9062-onkey : : On Key +da9062-watchdog : : Watchdog Timer +da9062-thermal : : Thermal + +The DA9061 PMIC consists of: + +Device Supply Names Description +------ ------------ ----------- +da9062-regulator : : LDOs & BUCKs +da9062-onkey : : On Key da9062-watchdog : : Watchdog Timer +da9062-thermal : : Thermal ====== Required properties: -- compatible : Should be "dlg,da9062". +- compatible : Should be + "dlg,da9062" for DA9062 + "dlg,da9061" for DA9061 - reg : Specifies the I2C slave address (this defaults to 0x58 but it can be modified to match the chip's OTP settings). - interrupt-parent : Specifies the reference to the interrupt controller for - the DA9062. + the DA9062 or DA9061. - interrupts : IRQ line information. - interrupt-controller @@ -25,8 +42,8 @@ further information on IRQ bindings. Sub-nodes: -- regulators : This node defines the settings for the LDOs and BUCKs. The - DA9062 regulators are bound using their names listed below: +- regulators : This node defines the settings for the LDOs and BUCKs. + The DA9062 regulators are bound using their names listed below: buck1 : BUCK_1 buck2 : BUCK_2 @@ -37,19 +54,29 @@ Sub-nodes: ldo3 : LDO_3 ldo4 : LDO_4 + The DA9061 regulators are bound using their names listed below: + + buck1 : BUCK_1 + buck2 : BUCK_2 + buck3 : BUCK_3 + ldo1 : LDO_1 + ldo2 : LDO_2 + ldo3 : LDO_3 + ldo4 : LDO_4 + The component follows the standard regulator framework and the bindings details of individual regulator device can be found in: Documentation/devicetree/bindings/regulator/regulator.txt - - rtc : This node defines settings required for the Real-Time Clock associated with the DA9062. There are currently no entries in this binding, however compatible = "dlg,da9062-rtc" should be added if a node is created. -- watchdog: This node defines the settings for the watchdog driver associated - with the DA9062 PMIC. The compatible = "dlg,da9062-watchdog" should be added - if a node is created. +- onkey : See ../input/da9062-onkey.txt + +- watchdog: See ../watchdog/da9062-watchdog.txt +- thermal : See ../thermal/da9062-thermal.txt Example: @@ -64,10 +91,6 @@ Example: compatible = "dlg,da9062-rtc"; }; - watchdog { - compatible = "dlg,da9062-watchdog"; - }; - regulators { DA9062_BUCK1: buck1 { regulator-name = "BUCK1";