devicetree.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
  • * [PATCH v5 04/10] DT: Add documentation for the Skyworks AAT1290
           [not found] <1429080520-10687-1-git-send-email-j.anaszewski@samsung.com>
           [not found] ` <1429080520-10687-1-git-send-email-j.anaszewski-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
    @ 2015-04-15  6:48 ` Jacek Anaszewski
           [not found]   ` <1429080520-10687-5-git-send-email-j.anaszewski-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
      2015-04-15  6:48 ` [PATCH v5 09/10] DT: aat1290: Document handling external strobe sources Jacek Anaszewski
      2 siblings, 1 reply; 8+ messages in thread
    From: Jacek Anaszewski @ 2015-04-15  6:48 UTC (permalink / raw)
      To: linux-leds, linux-media
      Cc: kyungmin.park, pavel, cooloney, rpurdie, sakari.ailus, s.nawrocki,
    	Jacek Anaszewski, devicetree
    
    This patch adds device tree binding documentation for
    1.5A Step-Up Current Regulator for Flash LEDs.
    
    Signed-off-by: Jacek Anaszewski <j.anaszewski@samsung.com>
    Acked-by: Kyungmin Park <kyungmin.park@samsung.com>
    Cc: Bryan Wu <cooloney@gmail.com>
    Cc: Richard Purdie <rpurdie@rpsys.net>
    Cc: devicetree@vger.kernel.org
    ---
     .../devicetree/bindings/leds/leds-aat1290.txt      |   41 ++++++++++++++++++++
     1 file changed, 41 insertions(+)
     create mode 100644 Documentation/devicetree/bindings/leds/leds-aat1290.txt
    
    diff --git a/Documentation/devicetree/bindings/leds/leds-aat1290.txt b/Documentation/devicetree/bindings/leds/leds-aat1290.txt
    new file mode 100644
    index 0000000..ef88b9c
    --- /dev/null
    +++ b/Documentation/devicetree/bindings/leds/leds-aat1290.txt
    @@ -0,0 +1,41 @@
    +* Skyworks Solutions, Inc. AAT1290 Current Regulator for Flash LEDs
    +
    +The device is controlled through two pins: FL_EN and EN_SET. The pins when,
    +asserted high, enable flash strobe and movie mode (max 1/2 of flash current)
    +respectively.
    +
    +Required properties:
    +
    +- compatible : Must be "skyworks,aat1290".
    +- flen-gpios : Must be device tree identifier of the flash device FL_EN pin.
    +- enset-gpios : Must be device tree identifier of the flash device EN_SET pin.
    +
    +A discrete LED element connected to the device must be represented by a child
    +node - see Documentation/devicetree/bindings/leds/common.txt.
    +
    +Required properties of the LED child node:
    +- led-max-microamp : see Documentation/devicetree/bindings/leds/common.txt
    +- flash-max-microamp : see Documentation/devicetree/bindings/leds/common.txt
    +                       Maximum flash LED supply current can be calculated using
    +                       following formula: I = 1A * 162kohm / Rset.
    +- flash-timeout-us : see Documentation/devicetree/bindings/leds/common.txt
    +                     Maximum flash timeout can be calculated using following
    +                     formula: T = 8.82 * 10^9 * Ct.
    +
    +Optional properties of the LED child node:
    +- label : see Documentation/devicetree/bindings/leds/common.txt
    +
    +Example (by Ct = 220nF, Rset = 160kohm):
    +
    +aat1290 {
    +	compatible = "skyworks,aat1290";
    +	flen-gpios = <&gpj1 1 GPIO_ACTIVE_HIGH>;
    +	enset-gpios = <&gpj1 2 GPIO_ACTIVE_HIGH>;
    +
    +	camera_flash: flash-led {
    +		label = "aat1290-flash";
    +		led-max-microamp = <520833>;
    +		flash-max-microamp = <1012500>;
    +		flash-timeout-us = <1940000>;
    +	};
    +};
    -- 
    1.7.9.5
    
    ^ permalink raw reply related	[flat|nested] 8+ messages in thread
  • * [PATCH v5 09/10] DT: aat1290: Document handling external strobe sources
           [not found] <1429080520-10687-1-git-send-email-j.anaszewski@samsung.com>
           [not found] ` <1429080520-10687-1-git-send-email-j.anaszewski-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
      2015-04-15  6:48 ` [PATCH v5 04/10] DT: Add documentation for the Skyworks AAT1290 Jacek Anaszewski
    @ 2015-04-15  6:48 ` Jacek Anaszewski
      2 siblings, 0 replies; 8+ messages in thread
    From: Jacek Anaszewski @ 2015-04-15  6:48 UTC (permalink / raw)
      To: linux-leds, linux-media
      Cc: kyungmin.park, pavel, cooloney, rpurdie, sakari.ailus, s.nawrocki,
    	Jacek Anaszewski, devicetree
    
    This patch adds documentation for a pinctrl-names property.
    The property, when present, is used for switching the source
    of the strobe signal for the device.
    
    Signed-off-by: Jacek Anaszewski <j.anaszewski@samsung.com>
    Acked-by: Kyungmin Park <kyungmin.park@samsung.com>
    Cc: Bryan Wu <cooloney@gmail.com>
    Cc: Richard Purdie <rpurdie@rpsys.net>
    Cc: Sakari Ailus <sakari.ailus@iki.fi>
    Cc: devicetree@vger.kernel.org
    ---
     .../devicetree/bindings/leds/leds-aat1290.txt      |   36 ++++++++++++++++++--
     1 file changed, 34 insertions(+), 2 deletions(-)
    
    diff --git a/Documentation/devicetree/bindings/leds/leds-aat1290.txt b/Documentation/devicetree/bindings/leds/leds-aat1290.txt
    index ef88b9c..c05ed91 100644
    --- a/Documentation/devicetree/bindings/leds/leds-aat1290.txt
    +++ b/Documentation/devicetree/bindings/leds/leds-aat1290.txt
    @@ -2,7 +2,9 @@
     
     The device is controlled through two pins: FL_EN and EN_SET. The pins when,
     asserted high, enable flash strobe and movie mode (max 1/2 of flash current)
    -respectively.
    +respectively. In order to add a capability of selecting the strobe signal source
    +(e.g. CPU or camera sensor) there is an additional switch required, independent
    +of the flash chip. The switch is controlled with pin control.
     
     Required properties:
     
    @@ -10,6 +12,13 @@ Required properties:
     - flen-gpios : Must be device tree identifier of the flash device FL_EN pin.
     - enset-gpios : Must be device tree identifier of the flash device EN_SET pin.
     
    +Optional properties:
    +- pinctrl-names : Must contain entries: "default", "host", "isp". Entries
    +		"default" and "host" must refer to the same pin configuration
    +		node, which sets the host as a strobe signal provider. Entry
    +		"isp" must refer to the pin configuration node, which sets the
    +		ISP as a strobe signal provider.
    +
     A discrete LED element connected to the device must be represented by a child
     node - see Documentation/devicetree/bindings/leds/common.txt.
     
    @@ -25,13 +34,22 @@ Required properties of the LED child node:
     Optional properties of the LED child node:
     - label : see Documentation/devicetree/bindings/leds/common.txt
     
    -Example (by Ct = 220nF, Rset = 160kohm):
    +Example (by Ct = 220nF, Rset = 160kohm and exynos4412-trats2 board with
    +a switch that allows for routing strobe signal either from the host or from
    +the camera sensor):
    +
    +#include "exynos4412.dtsi"
     
     aat1290 {
     	compatible = "skyworks,aat1290";
     	flen-gpios = <&gpj1 1 GPIO_ACTIVE_HIGH>;
     	enset-gpios = <&gpj1 2 GPIO_ACTIVE_HIGH>;
     
    +	pinctrl-names = "default", "host", "isp";
    +	pinctrl-0 = <&camera_flash_host>;
    +	pinctrl-1 = <&camera_flash_host>;
    +	pinctrl-2 = <&camera_flash_isp>;
    +
     	camera_flash: flash-led {
     		label = "aat1290-flash";
     		led-max-microamp = <520833>;
    @@ -39,3 +57,17 @@ aat1290 {
     		flash-timeout-us = <1940000>;
     	};
     };
    +
    +&pinctrl_0 {
    +	camera_flash_host: camera-flash-host {
    +		samsung,pins = "gpj1-0";
    +		samsung,pin-function = <1>;
    +		samsung,pin-val = <0>;
    +	};
    +
    +	camera_flash_isp: camera-flash-isp {
    +		samsung,pins = "gpj1-0";
    +		samsung,pin-function = <1>;
    +		samsung,pin-val = <1>;
    +	};
    +};
    -- 
    1.7.9.5
    
    ^ permalink raw reply related	[flat|nested] 8+ messages in thread

  • end of thread, other threads:[~2015-04-29 13:16 UTC | newest]
    
    Thread overview: 8+ messages (download: mbox.gz follow: Atom feed
    -- links below jump to the message on this page --
         [not found] <1429080520-10687-1-git-send-email-j.anaszewski@samsung.com>
         [not found] ` <1429080520-10687-1-git-send-email-j.anaszewski-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
    2015-04-15  6:48   ` [PATCH v5 02/10] DT: Add documentation for the mfd Maxim max77693 Jacek Anaszewski
    2015-04-15  8:33     ` Sakari Ailus
    2015-04-29 12:34     ` Lee Jones
    2015-04-29 12:59       ` Jacek Anaszewski
    2015-04-29 13:16         ` Lee Jones
    2015-04-15  6:48 ` [PATCH v5 04/10] DT: Add documentation for the Skyworks AAT1290 Jacek Anaszewski
         [not found]   ` <1429080520-10687-5-git-send-email-j.anaszewski-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
    2015-04-19 12:05     ` Sakari Ailus
    2015-04-15  6:48 ` [PATCH v5 09/10] DT: aat1290: Document handling external strobe sources Jacek Anaszewski
    

    This is a public inbox, see mirroring instructions
    for how to clone and mirror all data and code used for this inbox;
    as well as URLs for NNTP newsgroup(s).