From patchwork Wed Jan 4 11:50:46 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bjorn Andersson X-Patchwork-Id: 89903 Delivered-To: patch@linaro.org Received: by 10.140.20.101 with SMTP id 92csp8647727qgi; Wed, 4 Jan 2017 11:51:44 -0800 (PST) X-Received: by 10.84.216.70 with SMTP id f6mr132141869plj.10.1483559504307; Wed, 04 Jan 2017 11:51:44 -0800 (PST) Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id p61si73452845plb.150.2017.01.04.11.51.44; Wed, 04 Jan 2017 11:51:44 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-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=@linaro.org; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1762071AbdADTvb (ORCPT + 25 others); Wed, 4 Jan 2017 14:51:31 -0500 Received: from mail-pf0-f178.google.com ([209.85.192.178]:36337 "EHLO mail-pf0-f178.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754417AbdADTu2 (ORCPT ); Wed, 4 Jan 2017 14:50:28 -0500 Received: by mail-pf0-f178.google.com with SMTP id 189so83682498pfz.3 for ; Wed, 04 Jan 2017 11:50:27 -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=j/UFJYMdPL2+fgezTt/5e8f3ZTvgUEyG6KIEA0OI640=; b=PcdDmXYzw5ZnoFPBdrCHJ5jFMT8iAlsTds31rl1YB+bhdeuDOkp/UQzHaqjafGNlcq EAUXCK1nZI4KwT+9PnCTLnlXmerNnTTa7g8emJ3jgv8/SwnwvGz959JI9qR4zHILP3tu tKqLa8CvAKf5U+k0+MVRClmdJnRMHZM9M0f/8= 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=j/UFJYMdPL2+fgezTt/5e8f3ZTvgUEyG6KIEA0OI640=; b=EHPxr0oLhi+q0A62C8uJlZnEjvfHIEh7zPPahwTh/ev8mjJFfOduFVqfvrP4Hp450b eLARmoRb7FBN5SN8Pek0CWGDP3VXElNLiAaJg7QgmsznSCLv6+ALtL+jDTGIglk9LmUQ i5aOQBcUCgj2HxocfkHtVcGK+Jl8RcdjK1Y3qc0wlLXs9XGgUFKLtsBNmjCM7qvtD5UG 72QUblsEIy6i03P8oqGsBPi/ZCGyg2lITHqh/L0NmUfIlp27h0s3VXzLrtTtWCJ+Ey/t 2v8jmIt4qdZADHf7UUQ76UZQC1ovv2PatUfVxACJPHoX/zxF3+K39b+YJOsyrccJh4Pu W0Dw== X-Gm-Message-State: AIkVDXJmroE1LbWMF3vohXEEuGH6m7/RRCeIu5vWOc9pZd11kqlia4o2jV1+0RiQelSr/RcY X-Received: by 10.98.99.197 with SMTP id x188mr62815782pfb.179.1483559427281; Wed, 04 Jan 2017 11:50:27 -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 u64sm142701623pgc.39.2017.01.04.11.50.24 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 04 Jan 2017 11:50:26 -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 , Pavel Machek , Jingoo Han , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-iio@vger.kernel.org, linux-leds@vger.kernel.org Subject: [PATCH v5 1/5] devicetree: mfd: Add binding for the TI LM3533 Date: Wed, 4 Jan 2017 03:50:46 -0800 Message-Id: <20170104115050.24770-1-bjorn.andersson@linaro.org> X-Mailer: git-send-email 2.11.0 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Bjorn Andersson Add the binding for the Texas Instruments LM3533 lighting power solution. Acked-by: Jonathan Cameron Acked-by: Rob Herring Acked-for-MFD-by: Lee Jones Signed-off-by: Bjorn Andersson Signed-off-by: Bjorn Andersson --- Changes since v4: - Acks from Jonathan, Lee and Rob 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 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>; + }; + }; +