From patchwork Mon Sep 22 15:22:54 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jacek Anaszewski X-Patchwork-Id: 4948531 Return-Path: X-Original-To: patchwork-linux-media@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 93F969F32F for ; Mon, 22 Sep 2014 15:23:33 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 57AD32021A for ; Mon, 22 Sep 2014 15:23:32 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 7AE6D20220 for ; Mon, 22 Sep 2014 15:23:27 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754203AbaIVPXZ (ORCPT ); Mon, 22 Sep 2014 11:23:25 -0400 Received: from mailout4.samsung.com ([203.254.224.34]:40668 "EHLO mailout4.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753524AbaIVPXY (ORCPT ); Mon, 22 Sep 2014 11:23:24 -0400 Received: from epcpsbgm1.samsung.com (epcpsbgm1 [203.254.230.26]) by mailout4.samsung.com (Oracle Communications Messaging Server 7u4-24.01(7.0.4.24.0) 64bit (built Nov 17 2011)) with ESMTP id <0NCB00GZ76QYHQB0@mailout4.samsung.com>; Tue, 23 Sep 2014 00:23:22 +0900 (KST) X-AuditID: cbfee61a-f79c06d000004e71-0b-54203eea7ae4 Received: from epmmp1.local.host ( [203.254.227.16]) by epcpsbgm1.samsung.com (EPCPMTA) with SMTP id 26.FA.20081.AEE30245; Tue, 23 Sep 2014 00:23:22 +0900 (KST) Received: from AMDC2362.DIGITAL.local ([106.120.53.23]) by mmp1.samsung.com (Oracle Communications Messaging Server 7u4-24.01 (7.0.4.24.0) 64bit (built Nov 17 2011)) with ESMTPA id <0NCB003W86QA6W90@mmp1.samsung.com>; Tue, 23 Sep 2014 00:23:22 +0900 (KST) From: Jacek Anaszewski To: linux-leds@vger.kernel.org, linux-media@vger.kernel.org, devicetree@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 v6 4/6] DT: Add documentation for the mfd Maxim max77693 Date: Mon, 22 Sep 2014 17:22:54 +0200 Message-id: <1411399376-16497-5-git-send-email-j.anaszewski@samsung.com> X-Mailer: git-send-email 1.7.9.5 In-reply-to: <1411399376-16497-1-git-send-email-j.anaszewski@samsung.com> References: <1411399376-16497-1-git-send-email-j.anaszewski@samsung.com> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFtrALMWRmVeSWpSXmKPExsVy+t9jAd1XdgohBjPb+CxurTvHarFxxnpW i/lHgKz+NwtZLc69Wslo0Xv1OaPF2aY37BZb36xjtOjZsJXVYun1i0wWE6avZbFo3XuE3YHH Y828NYwel/t6mTxWLv/C5rFpVSebR9+WVYwenzfJBbBFcdmkpOZklqUW6dslcGX8/TeHveCy dMWX/esZGxjXiXUxcnJICJhITO5uZIGwxSQu3FvP1sXIxSEksIhR4tvs48wQTjuTxL+l99hB qtgEDCV+vnjNBGKLCERKvDt6CayIWeAUk8T5I+1A7RwcwgI+Eps28IDUsAioSnzfMw+sl1fA Q+LJmx6wEgkBBYk5k2xATE4BT4mbPeogFUJAFf2HrjBPYORdwMiwilE0tSC5oDgpPddQrzgx t7g0L10vOT93EyM4HJ9J7WBc2WBxiFGAg1GJh3dBk3yIEGtiWXFl7iFGCQ5mJRHeIGmFECHe lMTKqtSi/Pii0pzU4kOM0hwsSuK8B1qtA4UE0hNLUrNTUwtSi2CyTBycUg2M56ayhTYkuIbF zuITvPpEfMXrEJ5V7jrLi28c7at+03Cz8bKNYoXRCSmW68761eeDw66sORi8QmLmUT9B9zUC s+7Xrr8w8VCN/X5+s8efr7Vp9myNWlJ9qMXal3difJtwxjGHLIkVizs2M6XdfibSYq97UkL6 xi5pp4il137aHWjd+X7Gg5XPlFiKMxINtZiLihMBh/HaCEMCAAA= 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.9 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: Jacek Anaszewski 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>; + }; };