From patchwork Fri Sep 28 18:29:49 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dan Murphy X-Patchwork-Id: 147800 Delivered-To: patch@linaro.org Received: by 2002:a2e:8595:0:0:0:0:0 with SMTP id b21-v6csp1082484lji; Fri, 28 Sep 2018 11:30:07 -0700 (PDT) X-Google-Smtp-Source: ACcGV617SS1nfLQuXOA7/u5iyn8FV95CcAe1Mt4HgfIBd4hEqVd9xEYJd8tJXQeR9id1xXIEvIT+ X-Received: by 2002:a62:225d:: with SMTP id i90-v6mr17886228pfi.246.1538159407781; Fri, 28 Sep 2018 11:30:07 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1538159407; cv=none; d=google.com; s=arc-20160816; b=LM17XsMf96pwd94bn/kjOZFX09VR99aUvvL2ZC5FJizQekdt5ffAOwFiJp9WFRb/kv 0e9L1fwXzKxquXIDEi/Od67O0TNLhpL17eUoCTPmzeKlDOFmpVrGTJiBL59JorcGj+Tp e7Gx1cC6O4n7pXkDgMPcWZWV2jJjuIXd/EJZ3HBPjgCu6KnV+GiD22CBla7xb7GvuGXm /F/2aK4hMTZ+mJxrwTn34HdWxlI7GCYBjLdSLrfMp6DPU1i467pl1+JmtUkah3jyrE6f bj1MGVWKJPRo+hNf9Mk8Py47r3+EjbTcxC0mDYYvGVkX4nP+qhNbO/FqGwI9R2Z6S127 VdFg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=pSmD2M/O+yZuviPXrMoZZB16/Jfgp2hSP7dtvrq1WXQ=; b=DUpfIWJyOgwI+xc7m0AAyR8mO/drZKsSaEy0Es+iNzlp6ZSqDqx9P3wlQBwzOI7rdZ ED7ASBmvjfV+7E23sioEIDdAv45Eddsv8SOpG0zAwwxObwGpwPsyKdGqoOfYX+rIkkdc hOD/F37VmMS99QI6NfYwliiH6BWwPfAx+akSiVNRbzBRS7yyf91hdKwuJDN83j+2Lf61 gXHBaylJvhUN3ndfednbD8TAkT9CJx1B+mLbM1gagRyuwV56XiOVYl4CGErcdADjoztW c0Qal5yY5nC672n6Kf9HzwyYl3I94WRbkYtHU2/icmumbsNo8QnQuOfGwweR5tvPMn/+ T1tw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=SFUuihIZ; spf=pass (google.com: best guess record for domain of linux-leds-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-leds-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id f88-v6si5842995pfh.33.2018.09.28.11.30.07; Fri, 28 Sep 2018 11:30:07 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-leds-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=SFUuihIZ; spf=pass (google.com: best guess record for domain of linux-leds-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-leds-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726505AbeI2AzH (ORCPT + 1 other); Fri, 28 Sep 2018 20:55:07 -0400 Received: from lelv0142.ext.ti.com ([198.47.23.249]:39308 "EHLO lelv0142.ext.ti.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726405AbeI2AzH (ORCPT ); Fri, 28 Sep 2018 20:55:07 -0400 Received: from dflxv15.itg.ti.com ([128.247.5.124]) by lelv0142.ext.ti.com (8.15.2/8.15.2) with ESMTP id w8SIU2f1105751; Fri, 28 Sep 2018 13:30:02 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=ti-com-17Q1; t=1538159402; bh=pSmD2M/O+yZuviPXrMoZZB16/Jfgp2hSP7dtvrq1WXQ=; h=From:To:CC:Subject:Date:In-Reply-To:References; b=SFUuihIZy3+TXii2DRD7hJbyo5zIjezgZW4d3E78azALhF58ubeLz90JUPqA61kqr SY5RIDndnl/u01mpxLjTjgEMlTqVT+eJYRRvSTWAXmUZcF/zyuScd3AUnB2zM4DLNU F+/PL7Fw7THOADK8+iMxQYcwS+PMmSEqh+KWR3g4= Received: from DLEE110.ent.ti.com (dlee110.ent.ti.com [157.170.170.21]) by dflxv15.itg.ti.com (8.14.3/8.13.8) with ESMTP id w8SIU10J017185; Fri, 28 Sep 2018 13:30:02 -0500 Received: from DLEE114.ent.ti.com (157.170.170.25) by DLEE110.ent.ti.com (157.170.170.21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1466.3; Fri, 28 Sep 2018 13:30:00 -0500 Received: from dflp33.itg.ti.com (10.64.6.16) by DLEE114.ent.ti.com (157.170.170.25) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.1466.3 via Frontend Transport; Fri, 28 Sep 2018 13:30:00 -0500 Received: from legion.dal.design.ti.com (legion.dal.design.ti.com [128.247.22.53]) by dflp33.itg.ti.com (8.14.3/8.13.8) with ESMTP id w8SIU04x015017; Fri, 28 Sep 2018 13:30:00 -0500 Received: from localhost (a0272616local-lt.dhcp.ti.com [172.22.149.181]) by legion.dal.design.ti.com (8.11.7p1+Sun/8.11.7) with ESMTP id w8SIU0x27710; Fri, 28 Sep 2018 13:30:00 -0500 (CDT) From: Dan Murphy To: , , CC: , , , , , Dan Murphy Subject: [RFC PATCH v2 4/9] dt-bindings: leds: Add bindings for lm3697 driver Date: Fri, 28 Sep 2018 13:29:49 -0500 Message-ID: <20180928182954.25446-5-dmurphy@ti.com> X-Mailer: git-send-email 2.12.2 In-Reply-To: <20180928182954.25446-1-dmurphy@ti.com> References: <20180928182954.25446-1-dmurphy@ti.com> MIME-Version: 1.0 X-EXCLAIMER-MD-CONFIG: e1e8a2fd-e40a-4ac6-ac9b-f7e9cc9ee180 Sender: linux-leds-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-leds@vger.kernel.org Add the device tree bindings for the lm3697 LED driver for backlighting and display. Signed-off-by: Dan Murphy --- .../devicetree/bindings/leds/leds-lm3697.txt | 98 +++++++++++++++++++ 1 file changed, 98 insertions(+) create mode 100644 Documentation/devicetree/bindings/leds/leds-lm3697.txt -- 2.19.0 diff --git a/Documentation/devicetree/bindings/leds/leds-lm3697.txt b/Documentation/devicetree/bindings/leds/leds-lm3697.txt new file mode 100644 index 000000000000..4bb2ed51025b --- /dev/null +++ b/Documentation/devicetree/bindings/leds/leds-lm3697.txt @@ -0,0 +1,98 @@ +* Texas Instruments - LM3697 Highly Efficient White LED Driver + +The LM3697 11-bit LED driver provides high- +performance backlight dimming for 1, 2, or 3 series +LED strings while delivering up to 90% efficiency. + +This device is suitable for display and keypad Lighting + +Required properties: + - compatible: + "ti,lm3697" + - reg : I2C slave address + - #address-cells : 1 + - #size-cells : 0 + +Optional properties: + - enable-gpios : GPIO pin to enable/disable the device + - vled-supply : LED supply + +Required child properties: + - reg : 0 - LED is Controlled by bank A + 1 - LED is Controlled by bank B + - led-sources : Indicates which HVLED string is associated to which + control bank. Each element in the array is associated + with a specific HVLED string. Element 0 is HVLED1, + element 1 is HVLED2 and element 2 HVLED3. + Additional information is contained + in Documentation/devicetree/bindings/leds/common.txt + 0 - HVLED is not active in this control bank + 1 - HVLED string is controlled by this control bank + +Optional child properties: + - runtime-ramp-up-msec: Current ramping from one brightness level to + the a higher brightness level. + Range from 2048 us - 117.44 s + - runtime-ramp-down-msec: Current ramping from one brightness level to + the a lower brightness level. + Range from 2048 us - 117.44 s + - label : see Documentation/devicetree/bindings/leds/common.txt + - linux,default-trigger : + see Documentation/devicetree/bindings/leds/common.txt + +Example: + +HVLED string 1 and 3 are controlled by control bank A and HVLED 2 string is +controlled by control bank B. + +led-controller@36 { + compatible = "ti,lm3697"; + reg = <0x36>; + #address-cells = <1>; + #size-cells = <0>; + + enable-gpios = <&gpio1 28 GPIO_ACTIVE_HIGH>; + vled-supply = <&vbatt>; + + led@0 { + reg = <0>; + led-sources = <1 0 1>; + runtime-ramp-up-msec = <5000>; + runtime-ramp-down-msec = <1000>; + label = "white:first_backlight_cluster"; + linux,default-trigger = "backlight"; + }; + + led@1 { + reg = <1>; + led-sources = <0 1 0>; + runtime-ramp-up-msec = <500>; + runtime-ramp-down-msec = <1000>; + label = "white:second_backlight_cluster"; + linux,default-trigger = "backlight"; + }; +} + +All HVLED strings controlled by control bank A + +led-controller@36 { + compatible = "ti,lm3697"; + reg = <0x36>; + #address-cells = <1>; + #size-cells = <0>; + + enable-gpios = <&gpio1 28 GPIO_ACTIVE_HIGH>; + vled-supply = <&vbatt>; + + led@0 { + reg = <0>; + led-sources = <1 1 1>; + runtime-ramp-up-msec = <500>; + runtime-ramp-down-msec = <1000>; + label = "white:backlight_cluster"; + linux,default-trigger = "backlight"; + }; +} + +For more product information please see the link below: +http://www.ti.com/lit/ds/symlink/lm3697.pdf