From patchwork Wed Jun 7 10:32:39 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Enric Balletbo i Serra X-Patchwork-Id: 9771249 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 617EC6034B for ; Wed, 7 Jun 2017 10:33:49 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 3A5E2268AE for ; Wed, 7 Jun 2017 10:33:49 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 2EEA728471; Wed, 7 Jun 2017 10:33:49 +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=-1.9 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [65.50.211.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id B8573268AE for ; Wed, 7 Jun 2017 10:33:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:MIME-Version:Cc:List-Subscribe: List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id:Message-Id:Date: Subject:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To: References:List-Owner; bh=Uf5oRvPfoMSmbiV9txAH/YGFmMcCcZw0QLQPKJwylDk=; b=Gvn +YEbWtz0Z/dPAjxyRfpNO50IyM+uyTDcMfi2I0bqVd6+tR0mJwPe/Abw0SpxHDXadwLZ9cpyOCpMT pLDTuzFDzAoGXNhcGrWsvS4Wy1O2vsAPtb6UDRHXD9qhxlYKCch7ovSz2X+zSZYsZaNhI+VhLnSvL sL5q2nWJqXcWyStvSiTuHuhq3hPlp8Ht11/jj4IsMgFzPJ6IUS8IGNHdx4y79uj77B2r5Ubkcwt48 jLYqTTP1YEoBhkaDzP5Kqv2ltUuHXxtR8GHN8QsrsxDFERYtVVvQFmcqtl38mAkCWa+APq0eocfY7 yUNliA57eAWGHth4ZPtCtFz3rEW9RrA==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.87 #1 (Red Hat Linux)) id 1dIYHb-0002bW-53; Wed, 07 Jun 2017 10:33:47 +0000 Received: from bhuna.collabora.co.uk ([46.235.227.227]) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1dIYHB-000242-HX for linux-arm-kernel@lists.infradead.org; Wed, 07 Jun 2017 10:33:25 +0000 Received: from [127.0.0.1] (localhost [127.0.0.1]) (Authenticated sender: eballetbo) with ESMTPSA id C29022699F1 From: Enric Balletbo i Serra To: devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-omap@vger.kernel.org, linux-kernel@vger.kernel.org, linux-leds@vger.kernel.org, linux-input@vger.kernel.org Subject: [PATCH 1/4] dt-bindings: tps65217: Update binding documentation. Date: Wed, 7 Jun 2017 12:32:39 +0200 Message-Id: <20170607103242.16008-1-enric.balletbo@collabora.com> X-Mailer: git-send-email 2.9.3 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20170607_033321_867099_3414BD94 X-CRM114-Status: GOOD ( 14.14 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Mark Rutland , Daniel Thompson , Tony Lindgren , Jingoo Han , Dmitry Torokhov , Russell King , Rob Herring , Richard Purdie , Jacek Anaszewski , Pavel Machek , javier@dowhile0.org, Lee Jones MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP This patch adds a new binding documentation for the TPS65217 MFD and updates the documentation for all the sub-devices in accordance to get each individual sub-driver functioning correctly. Signed-off-by: Enric Balletbo i Serra --- .../bindings/input/tps65218-pwrbutton.txt | 2 +- .../bindings/leds/backlight/tps65217-backlight.txt | 24 ++--- Documentation/devicetree/bindings/mfd/tps65217.txt | 100 +++++++++++++++++++++ .../devicetree/bindings/regulator/tps65217.txt | 8 +- 4 files changed, 119 insertions(+), 15 deletions(-) create mode 100644 Documentation/devicetree/bindings/mfd/tps65217.txt diff --git a/Documentation/devicetree/bindings/input/tps65218-pwrbutton.txt b/Documentation/devicetree/bindings/input/tps65218-pwrbutton.txt index 8682ab6..603a3f0 100644 --- a/Documentation/devicetree/bindings/input/tps65218-pwrbutton.txt +++ b/Documentation/devicetree/bindings/input/tps65218-pwrbutton.txt @@ -1,7 +1,7 @@ Texas Instruments TPS65217 and TPS65218 power button This module is part of the TPS65217/TPS65218. For more details about the whole -TPS65217 chip see Documentation/devicetree/bindings/regulator/tps65217.txt. +TPS65217 chip see Documentation/devicetree/bindings/mfd/tps65217.txt. This driver provides a simple power button event via an Interrupt. diff --git a/Documentation/devicetree/bindings/leds/backlight/tps65217-backlight.txt b/Documentation/devicetree/bindings/leds/backlight/tps65217-backlight.txt index 5fb9279..a1bc465 100644 --- a/Documentation/devicetree/bindings/leds/backlight/tps65217-backlight.txt +++ b/Documentation/devicetree/bindings/leds/backlight/tps65217-backlight.txt @@ -1,11 +1,13 @@ -TPS65217 family of regulators +Texas Instruments TPS65217 backlight regulator + +This module is part of the TPS65217. For more details about the whole +TPS65217 chip see Documentation/devicetree/bindings/mfd/tps65217.txt. The TPS65217 chip contains a boost converter and current sinks which can be used to drive LEDs for use as backlights. Required properties: -- compatible: "ti,tps65217" -- reg: I2C slave address +- compatible: "ti,tps65217-bl" - backlight: node for specifying WLED1 and WLED2 lines in TPS65217 - isel: selection bit, valid values: 1 for ISEL1 (low-level) and 2 for ISEL2 (high-level) - fdim: PWM dimming frequency, valid values: 100, 200, 500, 1000 @@ -15,13 +17,13 @@ Each regulator is defined using the standard binding for regulators. Example: - tps: tps@24 { - reg = <0x24>; - compatible = "ti,tps65217"; - backlight { - isel = <1>; /* 1 - ISET1, 2 ISET2 */ - fdim = <100>; /* TPS65217_BL_FDIM_100HZ */ - default-brightness = <50>; - }; +&tps { + backlight { + compatible = "ti,tps65217-bl"; + status = "okay"; + isel = <1>; /* 1 - ISET1, 2 ISET2 */ + fdim = <100>; /* TPS65217_BL_FDIM_100HZ */ + default-brightness = <50>; }; +}; diff --git a/Documentation/devicetree/bindings/mfd/tps65217.txt b/Documentation/devicetree/bindings/mfd/tps65217.txt new file mode 100644 index 0000000..40c84ba --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/tps65217.txt @@ -0,0 +1,100 @@ +Texas Instruments TPS65217 Single-Chip PMIC for Battery-Powered Systems + +Required properties: +- compatible: "ti,tps65217" +- reg: I2C slave address. +- interrupt-controller: Marks the device node as an interrupt controller. +- #interrupt-cells: The number of cells to describe an IRQ, this should be 1. +- backlight: Child node that specify the backlight regulator sub-device. See: + Documentation/devicetree/bindings/leds/backlight/tps65217-backlight.txt +- charger: Child node that specify the charger sub-device. See: + Documentation/devicetree/bindings/power/supply/tps65217_charger.txt +- pwrbutton: Child node that specify the power button sub-device. See: + Documentation/devicetree/bindings/input/tps65218-pwrbutton.txt +- regulators: List of child nodes that specify the regulator initialization + data. See: + Documentation/devicetree/bindings/regulator/tps65217.txt. + +Optional properties: +- ti,pmic-shutdown-controller: Telling the PMIC to shutdown on PWR_EN toggle. + +Example: + + tps: tps@24 { + compatible = "ti,tps65217"; + interrupt-controller; + #interrupt-cells = <1>; + + ti,pmic-shutdown-controller; + + backlight { + compatible = "ti,tps65217-bl"; + status = "disabled"; + }; + + charger { + compatible = "ti,tps65217-charger"; + status = "disabled"; + }; + + pwrbutton { + compatible = "ti,tps65217-pwrbutton"; + status = "disabled"; + }; + + regulators { + compatible = "ti,tps65217-pmic"; + #address-cells = <1>; + #size-cells = <0>; + + dcdc1_reg: dcdc1 { + regulator-min-microvolt = <900000>; + regulator-max-microvolt = <1800000>; + regulator-boot-on; + regulator-always-on; + }; + + dcdc2_reg: dcdc2 { + regulator-min-microvolt = <900000>; + regulator-max-microvolt = <3300000>; + regulator-boot-on; + regulator-always-on; + }; + + dcdc3_reg: dcc3 { + regulator-min-microvolt = <900000>; + regulator-max-microvolt = <1500000>; + regulator-boot-on; + regulator-always-on; + }; + + ldo1_reg: ldo1 { + regulator-min-microvolt = <1000000>; + regulator-max-microvolt = <3300000>; + regulator-boot-on; + regulator-always-on; + }; + + ldo2_reg: ldo2 { + regulator-min-microvolt = <900000>; + regulator-max-microvolt = <3300000>; + regulator-boot-on; + regulator-always-on; + }; + + ldo3_reg: ldo3 { + regulator-min-microvolt = <1800000>; + regulator-max-microvolt = <3300000>; + regulator-boot-on; + regulator-always-on; + }; + + ldo4_reg: ldo4 { + regulator-min-microvolt = <1800000>; + regulator-max-microvolt = <3300000>; + regulator-boot-on; + regulator-always-on; + }; + }; + }; + diff --git a/Documentation/devicetree/bindings/regulator/tps65217.txt b/Documentation/devicetree/bindings/regulator/tps65217.txt index 4f05d20..2d9b519 100644 --- a/Documentation/devicetree/bindings/regulator/tps65217.txt +++ b/Documentation/devicetree/bindings/regulator/tps65217.txt @@ -1,8 +1,10 @@ -TPS65217 family of regulators +Texas Instruments TPS65217 family of regulators + +This module is part of the TPS65217. For more details about the whole +TPS65217 chip see Documentation/devicetree/bindings/mfd/tps65217.txt. Required properties: -- compatible: "ti,tps65217" -- reg: I2C slave address +- compatible: "ti,tps65217-pmic" - regulators: list of regulators provided by this controller, must be named after their hardware counterparts: dcdc[1-3] and ldo[1-4] - regulators: This is the list of child nodes that specify the regulator