From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jacek Anaszewski Subject: [PATCH/RFC v5 07/10] DT: Add documentation for the mfd Maxim max77693 Date: Wed, 20 Aug 2014 15:44:16 +0200 Message-ID: <1408542259-415-8-git-send-email-j.anaszewski@samsung.com> References: <1408542259-415-1-git-send-email-j.anaszewski@samsung.com> Return-path: Received: from mailout2.samsung.com ([203.254.224.25]:40305 "EHLO mailout2.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752062AbaHTNpE (ORCPT ); Wed, 20 Aug 2014 09:45:04 -0400 In-reply-to: <1408542259-415-1-git-send-email-j.anaszewski@samsung.com> Sender: linux-leds-owner@vger.kernel.org List-Id: linux-leds@vger.kernel.org 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 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>; + }; }; -- 1.7.9.5