From patchwork Thu Feb 6 17:27:21 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tomasz Figa X-Patchwork-Id: 317511 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id B39AA2C00A6 for ; Fri, 7 Feb 2014 04:27:37 +1100 (EST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751968AbaBFR1g (ORCPT ); Thu, 6 Feb 2014 12:27:36 -0500 Received: from mailout3.w1.samsung.com ([210.118.77.13]:8962 "EHLO mailout3.w1.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751578AbaBFR1f (ORCPT ); Thu, 6 Feb 2014 12:27:35 -0500 Received: from eucpsbgm1.samsung.com (unknown [203.254.199.244]) by mailout3.w1.samsung.com (Oracle Communications Messaging Server 7u4-24.01(7.0.4.24.0) 64bit (built Nov 17 2011)) with ESMTP id <0N0L00H104HXMLA0@mailout3.w1.samsung.com> for devicetree@vger.kernel.org; Thu, 06 Feb 2014 17:27:33 +0000 (GMT) X-AuditID: cbfec7f4-b7f796d000005a13-93-52f3c604f257 Received: from eusync3.samsung.com ( [203.254.199.213]) by eucpsbgm1.samsung.com (EUCPMTA) with SMTP id 89.39.23059.406C3F25; Thu, 06 Feb 2014 17:27:32 +0000 (GMT) Received: from AMDC1227.digital.local ([106.116.147.199]) by eusync3.samsung.com (Oracle Communications Messaging Server 7u4-23.01(7.0.4.23.0) 64bit (built Aug 10 2011)) with ESMTPA id <0N0L00DK24HQ5E50@eusync3.samsung.com>; Thu, 06 Feb 2014 17:27:32 +0000 (GMT) From: Tomasz Figa To: k.kozlowski@samsung.com, t.figa@samsung.com Cc: Kyungmin Park , Marek Szyprowski , devicetree@vger.kernel.org, Rob Herring , Pawel Moll , Mark Rutland Subject: [PATCH 2/2] mfd: max14577: Add device tree bindings document Date: Thu, 06 Feb 2014 18:27:21 +0100 Message-id: <1391707641-13543-2-git-send-email-t.figa@samsung.com> X-Mailer: git-send-email 1.8.5.2 In-reply-to: <1391707641-13543-1-git-send-email-t.figa@samsung.com> References: <1391707641-13543-1-git-send-email-t.figa@samsung.com> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrCJMWRmVeSWpSXmKPExsVy+t/xq7osxz4HGVw9K2Ex/8g5VovXLwwt zja9YbdYe+Quu8XS6xeZLCZMX8ti0br3CLvF+hmvWRw4PNbMW8PosWlVJ5tH35ZVjB6fN8kF sERx2aSk5mSWpRbp2yVwZax6Mp2t4Kx6xf/3f1gbGDsUuhg5OSQETCQO/1nDDmGLSVy4t56t i5GLQ0hgKaPEhQ/PWCGcPiaJKX0r2UCq2ATUJD43PAKyOThEBPQlls1hAqlhFnjCKPF/90+w GmEBV4lHLe1gU1kEVCVmbm5mArF5BZwk+r6sYgfplRBQkFh9XQgkzCngLHFzMsQRQkAl647s Z5zAyLuAkWEVo2hqaXJBcVJ6rqFecWJucWleul5yfu4mRkhIfdnBuPiY1SFGAQ5GJR7eE0s/ BwmxJpYVV+YeYpTgYFYS4dXcCxTiTUmsrEotyo8vKs1JLT7EyMTBKdXAuORBk+dRx4us0+bl vJf5ln++z65q3We/o5PF3lU9Dr72MdZg/+uTZmppy7kCnz4+fdByz2LJ3cespzcEzhdaOSU5 xdFvv+3k5jlr/eM5w4Oysq7bTW410tn9p5f5sXD13SfuT7R9niyrlqpS7ZaR8nnNxuF+Jqe/ oJEpqE9Zw332ivd1c6P3KbEUZyQaajEXFScCANB0fOAHAgAA Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Krzysztof Kozlowski Add document describing device tree bindings for MAX14577 MFD driver (for both MAX14577 and MAX77836 chipsets). Signed-off-by: Krzysztof Kozlowski Cc: Kyungmin Park Cc: Tomasz Figa Cc: Marek Szyprowski Cc: devicetree@vger.kernel.org Cc: Rob Herring Cc: Pawel Moll Cc: Mark Rutland --- Documentation/devicetree/bindings/mfd/max14577.txt | 149 ++++++++++++++++++++ 1 file changed, 149 insertions(+) create mode 100644 Documentation/devicetree/bindings/mfd/max14577.txt diff --git a/Documentation/devicetree/bindings/mfd/max14577.txt b/Documentation/devicetree/bindings/mfd/max14577.txt new file mode 100644 index 0000000..f59a4f3 --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/max14577.txt @@ -0,0 +1,149 @@ +Maxim MAX14577/77836 Multi-Function Device + +MAX14577 is a Multi-Function Device with Micro-USB Interface Circuit, Li+ +Battery Charger and SFOUT LDO output for powering USB devices. It is +interfaced to host controller using I2C. + +MAX77836 additionally contains PMIC (with two LDO regulators) and Fuel Gauge. + + +Required properties: +- compatible : Must be "maxim,max14577" or "maxim,max77836". +- reg : I2C slave address for the max14577 chip (0x25 for max14577/max77836) +- interrupts : IRQ line for the chip. +- interrupt-parent : The parent interrupt controller. + + +Optional nodes: +- max14577-muic/max77836-muic : + Node used only by extcon consumers. + Required properties: + - compatible : "maxim,max14577-muic" or "maxim,max77836-muic" + +- regulators : + Required properties: + - compatible : "maxim,max14577-regulator" + or "maxim,max77836-regulator" + + May contain a sub-node per regulator from the list below. Each + sub-node should contain the constraints and initialization information + for that regulator. See regulator.txt for a description of standard + properties for these sub-nodes. + + List of valid regulator names: + - for max14577: CHARGER, SAFEOUT. + - for max77836: CHARGER, SAFEOUT, LDO1, LDO2. + + The SAFEOUT is a fixed voltage regulator so there is no need to specify + voltages for it. + + - charger : + Required properties: + - compatible : "maxim,max14577-charger" + or "maxim,max77836-charger" + - maxim,fast-charge-timer : Timer in hours to trigger the + INT3/MBCCHGERR interrupt; Valid values: + - 5, 6 or 7 (hours), + - 0 to disable. + - maxim,fast-charge-uamp : Current in uA for Fast Charge; + Valid values: + - for max14577: 90000 - 950000; + - for max77836: 45000 - 475000; + - maxim,eoc-uamp : Current in uA for End-Of-Charge mode; + Valid values: + - for max14577: 50000 - 200000; + - for max77836: 5000 - 10000; + - maxim,ovp-uvolt : OverVoltage Protection Threshold in uV; + In an overvoltage condition, INT asserts and charging + stops. Valid values: + - 6000000, 6500000, 7000000, 7500000; + - maxim,constant-uvolt : Battery Constant Voltage in uV; + Valid values: + - 4000000 - 4280000; + - 4350000; + + +Example: + +#include + +max14577@25 { + compatible = "maxim,max14577"; + reg = <0x25>; + interrupt-parent = <&gpx1>; + interrupts = <5 IRQ_TYPE_NONE>; + + muic: max14577-muic { + compatible = "maxim,max14577-muic"; + }; + + regulators { + compatible = "maxim,max14577-regulator"; + + SAFEOUT { + regulator-name = "SAFEOUT"; + }; + CHARGER { + regulator-name = "CHARGER"; + regulator-min-microamp = <90000>; + regulator-max-microamp = <950000>; + regulator-boot-on; + }; + }; + + charger { + compatible = "maxim,max14577-charger"; + + maxim,fast-charge-timer = <6>; + maxim,constant-uvolt = <4350000>; + maxim,fast-charge-uamp = <450000>; + maxim,eoc-uamp = <50000>; + maxim,ovp-uvolt = <6500000>; + }; +}; + + +max77836@25 { + compatible = "maxim,max77836"; + reg = <0x25>; + interrupt-parent = <&gpx1>; + interrupts = <5 IRQ_TYPE_NONE>; + + muic: max77836-muic { + compatible = "maxim,max77836-muic"; + }; + + regulators { + compatible = "maxim,max77836-regulator"; + + SAFEOUT { + regulator-name = "SAFEOUT"; + }; + CHARGER { + regulator-name = "CHARGER"; + regulator-min-microamp = <90000>; + regulator-max-microamp = <950000>; + regulator-boot-on; + }; + LDO1 { + regulator-name = "LDO1"; + regulator-min-microvolt = <2700000>; + regulator-max-microvolt = <2700000>; + }; + LDO2 { + regulator-name = "LDO2"; + regulator-min-microvolt = <800000>; + regulator-max-microvolt = <3950000>; + }; + }; + + charger { + compatible = "maxim,max77836-charger"; + + maxim,fast-charge-timer = <6>; + maxim,constant-uvolt = <4350000>; + maxim,fast-charge-uamp = <225000>; + maxim,eoc-uamp = <7500>; + maxim,ovp-uvolt = <6500000>; + }; +};