From patchwork Mon Dec 26 18:11:49 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bjorn Andersson X-Patchwork-Id: 89048 Delivered-To: patch@linaro.org Received: by 10.140.20.101 with SMTP id 92csp4784044qgi; Mon, 26 Dec 2016 18:11:51 -0800 (PST) X-Received: by 10.99.219.21 with SMTP id e21mr53361910pgg.136.1482804710968; Mon, 26 Dec 2016 18:11:50 -0800 (PST) Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id v3si44835063plb.121.2016.12.26.18.11.49; Mon, 26 Dec 2016 18:11:50 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org; spf=pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=fail (p=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756316AbcL0CLs (ORCPT + 7 others); Mon, 26 Dec 2016 21:11:48 -0500 Received: from mail-pg0-f47.google.com ([74.125.83.47]:33132 "EHLO mail-pg0-f47.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755992AbcL0CLr (ORCPT ); Mon, 26 Dec 2016 21:11:47 -0500 Received: by mail-pg0-f47.google.com with SMTP id g1so100296433pgn.0 for ; Mon, 26 Dec 2016 18:11:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id; bh=8avgbt7QSstva6gVaUveEth2zINPYdgwWwtXrlH5vJU=; b=P0ni4EjW7eUL0XyVeVa1qfP6YnMCQv68I3Hml+c0SMio7Kcpks29I1GjLV5hba221x dSELnYI3yNGyIQglSySQKakREEX3llAyG/dK6LOBfGVQ0bH6oc0gPTaPgk35Iq6IeUnf n6owcBtqKXU2gLj1f2ZIg+0mvSnOw+riGAwvg= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=8avgbt7QSstva6gVaUveEth2zINPYdgwWwtXrlH5vJU=; b=BNktyKYU1uLdxfn8ZtluwB9fH0hgchbY2OKjSXI/Ai5jWvPRbXxFRM9bMyJurUxQkE 0xw69r2ensxayWVJ28tIO1HcZceQq58FbvYFi6qAOfg9r5FqCV4G18ZKBe4MdtAUc5J2 3Y5OgiLKGZC7TFWmvx+3raZolR+Ukx4P4ym8XhGd9g/LSrgn/Kdl/LatlZRBpM59vsTt /cKGEmQ3Hb7SFCIGZ/WhbiX+W6wBSvk50WdaH5b8UiegDiAmq8+4XvNCHxIKBRnPn1m1 S44DMHjU5ANxj5S3JyPOJ+gTmLTPH0jt0VofVkrT9S1fluIRV7vRTHeJ6/BdDZl0Agvt Pcmw== X-Gm-Message-State: AIkVDXJP2Bqz0vp69yVU+1WrUe6S2zvY+Fk9e5p+b3f0LiICGuwnG5FPCdIbcqn0QYvIdcEH X-Received: by 10.99.170.5 with SMTP id e5mr54975083pgf.46.1482804706243; Mon, 26 Dec 2016 18:11:46 -0800 (PST) Received: from localhost.localdomain (ip68-111-223-48.sd.sd.cox.net. [68.111.223.48]) by smtp.gmail.com with ESMTPSA id g82sm84886867pfb.43.2016.12.26.18.11.44 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 26 Dec 2016 18:11:45 -0800 (PST) From: Bjorn Andersson To: Rob Herring , Mark Rutland , Jonathan Cameron Cc: Lee Jones , Hartmut Knaack , Lars-Peter Clausen , Peter Meerwald-Stadler , Richard Purdie , Jacek Anaszewski , Pavel Machek , Jingoo Han , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-iio@vger.kernel.org, linux-leds@vger.kernel.org, Bjorn Andersson Subject: [PATCH v4 1/5] devicetree: mfd: Add binding for the TI LM3533 Date: Mon, 26 Dec 2016 10:11:49 -0800 Message-Id: <20161226181153.11271-1-bjorn.andersson@linaro.org> X-Mailer: git-send-email 2.11.0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Bjorn Andersson Add the binding for the Texas Instruments LM3533 lighting power solution. Signed-off-by: Bjorn Andersson Signed-off-by: Bjorn Andersson --- I had Acks from Jonathan and Rob on v3, but dropped these due to the added compatible properties. Changes since v3: - Added compatible to sub-nodes, per Lee's requested to treat them as separate pieces. Documentation/devicetree/bindings/mfd/lm3533.txt | 205 +++++++++++++++++++++++ 1 file changed, 205 insertions(+) create mode 100644 Documentation/devicetree/bindings/mfd/lm3533.txt -- 2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Acked-by: Pavel Machek diff --git a/Documentation/devicetree/bindings/mfd/lm3533.txt b/Documentation/devicetree/bindings/mfd/lm3533.txt new file mode 100644 index 000000000000..909281096ba2 --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/lm3533.txt @@ -0,0 +1,205 @@ +Texas Instruments LM3533 binding + +This binding describes the Texas Instruments LM3533, a lighting power solution +for smartphone handsets. The common properties are described directly in the +node, while each individual component are described in an optional subnode. + +- compatible: + Usage: required + Value type: + Definition: must be: + "ti,lm3533" + +- reg: + Usage: required + Value type: + Definition: i2c address of the LM3533 chip + +- als-supply: + Usage: optional + Value type: + Definition: reference to regulator powering the V_als input; as + specified in "../regulator/regulator.txt" + +- hwen-gpios: + Usage: required + Value type: + Definition: reference to gpio pin connected to the HWEN input; as + specified in "../gpio/gpio.txt" + +- ti,boost-freq-hz: + Usage: required + Value type: + Definition: switch-frequency of the boost converter, must be either: + 500000 or 1000000 + +- ti,boost-ovp-mv: + Usage: required + Value type: + Definition: over-voltage protection limit, in mV. Must be one of: + 16000, 24000, 32000 or 40000 + +- #address-cells: + Usage: required + Value type: + Definition: must be 1 + +- #size-cells: + Usage: required + Value type: + Definition: must be 0 + += ALS SUBNODE +The ambient light sensor subnode carrying the light sensor related properties. + +- compatible: + Usage: required + Value type: + Definition: must be: + "ti,lm3533-als" + +- ti,als-resistance-ohm: + Usage: required (unless ti,pwm-mode is specified) + Value type: + Definition: specifies the resistor value (R_als), in Ohm. Valid values + ranges from 200000 to 1574 Ohm. + +- ti,pwm-mode: + Usage: optional + Value type: + Definition: specifies, if present, that the als should operate in PWM + mode - rather than analog mode + += BACKLIGHT NODES +Backlight subnodes carrying the backlight related properties. + +- compatible: + Usage: required + Value type: + Definition: must be: + "ti,lm3533-backlight" + +- reg: + Usage: required + Value type: + Definition: specifies which of the two backlights this node corresponds + to + +- default-brightness: + Usage: optional + Value type: <32> + Definition: specifies the default brightness for the backlight, in + units of brightness [0-255] + +- label: + Usage: required + Value type: + Definition: specifies a name of this backlight + +- led-max-microamp: + Usage: required + Value type: + Definition: specifies the max current for this backlight, in uA, as + described in "../leds/common.txt" + +- ti,pwm-zones: + Usage: optional + Value type: + Definition: lists the ALS zones to be PWM controlled for this backlight, + the values in the list are in the range [0 - 4] + += LED NODES +LED subnodes carrying the LED related properties. + +- compatible: + Usage: required + Value type: + Definition: must be: + "ti,lm3533-led" + +- reg: + Usage: required + Value type: + Definition: specifies which of the four LEDs this node corresponds to + +- linux,default-trigger: + Usage: optional + Value type: + Definition: specifies the default trigger for the LED, as described in + "../leds/common.txt" + +- label: + Usage: required + Value type: + Definition: specifies a name of this LED, as described in + "../leds/common.txt" + +- led-max-microamp: + Usage: required + Value type: + Definition: specifies the max current for this LED, in uA, as described + in "../leds/common.txt" + +- ti,pwm-zones: + Usage: optional + Value type: + Definition: lists the ALS zones to be PWM controlled for this LED, the + values in the list are in the range [0 - 4] + += EXAMPLE + +i2c@12460000 { + compatible = "qcom,i2c-qup-v1.1.1"; + ... + + lm3533@36 { + compatible = "ti,lm3533"; + reg = <0x36>; + + als-supply = <&pm8921_l11>; + hwen-gpios = <&pm8921_gpio 26 GPIO_ACTIVE_HIGH>; + + ti,boost-freq-hz = <500000>; + ti,boost-ovp-mv = <24000>; + + #address-cells = <1>; + #size-cells = <0>; + + als { + compatible = "ti,lm3533-als"; + ti,als-resistance-ohm = <200000>; + }; + + backlight@0 { + compatible = "ti,lm3533-backlight"; + reg = <0>; + label = "backlight"; + + led-max-microamp = <20200>; + }; + + led@0 { + compatible = "ti,lm3533-led"; + reg = <0>; + label = "red"; + + led-max-microamp = <5000>; + }; + + led@1 { + compatible = "ti,lm3533-led"; + reg = <1>; + label = "green"; + + led-max-microamp = <5000>; + }; + + led@2 { + compatible = "ti,lm3533-led"; + reg = <2>; + label = "blue"; + + led-max-microamp = <5000>; + }; + }; +