From patchwork Fri Jul 11 14:04:20 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jacek Anaszewski X-Patchwork-Id: 4534471 Return-Path: X-Original-To: patchwork-linux-media@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork2.web.kernel.org (Postfix) with ESMTP id 69D73BEEAA for ; Fri, 11 Jul 2014 14:07:55 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 6D84A201D3 for ; Fri, 11 Jul 2014 14:07:54 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 54EC12017A for ; Fri, 11 Jul 2014 14:07:53 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754508AbaGKOHg (ORCPT ); Fri, 11 Jul 2014 10:07:36 -0400 Received: from mailout2.samsung.com ([203.254.224.25]:49215 "EHLO mailout2.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754110AbaGKOFi (ORCPT ); Fri, 11 Jul 2014 10:05:38 -0400 Received: from epcpsbgm2.samsung.com (epcpsbgm2 [203.254.230.27]) by mailout2.samsung.com (Oracle Communications Messaging Server 7u4-24.01(7.0.4.24.0) 64bit (built Nov 17 2011)) with ESMTP id <0N8J001X5WHCX630@mailout2.samsung.com>; Fri, 11 Jul 2014 23:05:36 +0900 (KST) X-AuditID: cbfee61b-f79f86d00000144c-35-53bfef30680a Received: from epmmp2 ( [203.254.227.17]) by epcpsbgm2.samsung.com (EPCPMTA) with SMTP id A2.C0.05196.03FEFB35; Fri, 11 Jul 2014 23:05:36 +0900 (KST) Received: from AMDC2362.DIGITAL.local ([106.120.53.23]) by mmp2.samsung.com (Oracle Communications Messaging Server 7u4-24.01 (7.0.4.24.0) 64bit (built Nov 17 2011)) with ESMTPA id <0N8J00JI5WF7VM80@mmp2.samsung.com>; Fri, 11 Jul 2014 23:05:36 +0900 (KST) From: Jacek Anaszewski To: linux-leds@vger.kernel.org, devicetree@vger.kernel.org, linux-media@vger.kernel.org, linux-kernel@vger.kernel.org Cc: kyungmin.park@samsung.com, b.zolnierkie@samsung.com, Jacek Anaszewski , Andrzej Hajda , Rob Herring , Pawel Moll , Mark Rutland , Ian Campbell , Kumar Gala Subject: [PATCH/RFC v4 17/21] DT: Add documentation for the mfd Maxim max77693 Date: Fri, 11 Jul 2014 16:04:20 +0200 Message-id: <1405087464-13762-18-git-send-email-j.anaszewski@samsung.com> X-Mailer: git-send-email 1.7.9.5 In-reply-to: <1405087464-13762-1-git-send-email-j.anaszewski@samsung.com> References: <1405087464-13762-1-git-send-email-j.anaszewski@samsung.com> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFtrGLMWRmVeSWpSXmKPExsVy+t9jQV2D9/uDDQ6ckLG4te4cq8XGGetZ LeYfAbL63yxktTj3aiWjRe/V54wWZ5vesFtc3jWHzWLrm3WMFj0btrJaLL1+kcliwvS1LBat e4+wO/B6rJm3htHjcl8vk8fK5V/YPDat6mTz6NuyitHj8ya5ALYoLpuU1JzMstQifbsErozu PdvYC6ZLVxx6qNPA+F20i5GTQ0LAROLsu9ksELaYxIV769m6GLk4hASmM0ocaupngnDamSQe Ne0Dq2ITMJT4+eI1E4gtIlAu0fP+GVgHs8ApJonzR9rZQBLCAn4Sq99dArNZBFQlvh+9ywxi 8wp4Svx+dpe1i5EDaJ2CxJxJNiBhTqDwwf6bYOVCAh4SD9eeYJ/AyLuAkWEVo2hqQXJBcVJ6 rpFecWJucWleul5yfu4mRnBoPpPewbiqweIQowAHoxIP74k1+4KFWBPLiitzDzFKcDArifBe fbM/WIg3JbGyKrUoP76oNCe1+BCjNAeLkjjvwVbrQCGB9MSS1OzU1ILUIpgsEwenVANjufip dc23Pq9t7PAIXupxPjH/dt+tNu2LEbNluM/8PuuV2VMmrXOqaMEDGdcFJSLr6hMnPpj+yGxj 54+Yv1FOU/9XrvhvUdE+Z8IG8ynsrQdv9OpUOzL+kjUyOjHZhGn33wV9CxV/X39kyvS4evuN 4NBNysr90owNthNMt+qcMTLPUUteOP2/EktxRqKhFnNRcSIAGsEpbkkCAAA= Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org X-Spam-Status: No, score=-7.5 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_HI, RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP This patch adds device tree binding documentation for the flash cell of the Maxim max77693 multifunctional device. Signed-off-by: Andrzej Hajda Acked-by: Kyungmin Park Cc: Rob Herring Cc: Pawel Moll Cc: Mark Rutland Cc: Ian Campbell Cc: Kumar Gala --- Documentation/devicetree/bindings/mfd/max77693.txt | 62 ++++++++++++++++++++ 1 file changed, 62 insertions(+) diff --git a/Documentation/devicetree/bindings/mfd/max77693.txt b/Documentation/devicetree/bindings/mfd/max77693.txt index 11921cc..0c3db3d 100644 --- a/Documentation/devicetree/bindings/mfd/max77693.txt +++ b/Documentation/devicetree/bindings/mfd/max77693.txt @@ -27,6 +27,55 @@ Optional properties: [*] refer Documentation/devicetree/bindings/regulator/regulator.txt +Optional node: +- led-flash : the LED submodule device node + +Required properties of "led-flash" node: +- compatible : must be "maxim,max77693-flash" +- maxim,num-leds : number of connected leds + Possible values: 1 or 2. +- maxim,fleds : array of current outputs in order: fled1, fled2 + Note: both current outputs can be connected to a single led + Possible values: + 0 - the output is left disconnected, + 1 - a diode is connected to the output. + +Optional properties of "led-flash" node: +- maxim,boost-mode : + In boost mode the device can produce up to 1.2A of total current + on both outputs. The maximum current on each output is reduced + to 625mA then. If maxim,num-leds == <2> boost must be enabled + (it defaults to 1 if not set): + Possible values: + 0 - no boost, + 1 - adaptive mode, + 2 - fixed mode. +- iout-torch : Array of maximum intensities in microamperes of the torch + led currents in order: fled1, fled2. + 15625 - 250000 +- iout-flash : Array of maximum intensities in microamperes of the flash + led currents in order: fled1, fled2. + Range: + 15625 - 1000000 (max 625000 if boost mode is enabled) +- flash-timeout : timeout in microseconds after which flash led + is turned off + Range: + 62500 - 1000000 +- maxim,trigger : Array of flags indicating which trigger can activate given led + in order: fled1, fled2 + Possible flag values (can be combined): + 1 - FLASH pin of the chip, + 2 - TORCH pin of the chip, + 4 - software via I2C command. +- maxim,trigger-type : Array of trigger types in order: flash, torch. + Possible trigger types: + 0 - Rising edge of the signal triggers the flash/torch, + 1 - Signal level controls duration of the flash/torch. +- maxim,boost-vout : Output voltage of the boost module in millivolts. +- maxim,vsys-min : Low input voltage level in millivolts. Flash is not fired + if chip estimates that system voltage could drop below this level due + to flash power consumption. + Example: max77693@66 { compatible = "maxim,max77693"; @@ -52,4 +101,17 @@ Example: regulator-boot-on; }; }; + led_flash: led-flash { + compatible = "maxim,max77693-flash"; + iout-torch = <500000 0>; + iout-flash = <1250000 0>; + flash-timeout = <1000000 1000000>; + maxim,num-leds = <1>; + maxim,fleds = <1 1>; + maxim,trigger = <7 7>; + maxim,trigger-type = <0 1>; + maxim,boost-mode = <1>; + maxim,boost-vout = <5000>; + maxim,vsys-min = <2400>; + }; };