From patchwork Mon Jan 30 21:17:15 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bjorn Andersson X-Patchwork-Id: 92936 Delivered-To: patch@linaro.org Received: by 10.140.20.99 with SMTP id 90csp1770034qgi; Mon, 30 Jan 2017 21:18:11 -0800 (PST) X-Received: by 10.98.36.134 with SMTP id k6mr26836407pfk.41.1485839891410; Mon, 30 Jan 2017 21:18:11 -0800 (PST) Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id 22si14791815pfr.164.2017.01.30.21.18.11; Mon, 30 Jan 2017 21:18:11 -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 sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752216AbdAaFRa (ORCPT + 25 others); Tue, 31 Jan 2017 00:17:30 -0500 Received: from mail-pf0-f172.google.com ([209.85.192.172]:35580 "EHLO mail-pf0-f172.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750994AbdAaFQk (ORCPT ); Tue, 31 Jan 2017 00:16:40 -0500 Received: by mail-pf0-f172.google.com with SMTP id f144so99467250pfa.2 for ; Mon, 30 Jan 2017 21:16:11 -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=SMo7yR6kZ9JqyQnjfB97Il7pajYcqj2hSR4J7Fsd06Q=; b=UV8MFIHhywG3hzh0dCbrQ1yPm1AWMnRaF7bqqW9ALKQ+rAQ4RNC2dDseZ64KB2pYNb 6nQBCiOlg6y+OaBU44FXmjMjL8FeRzNYcRpB04dhHlGdwJ5Ie1lDyrX640qv9C+ZFH8g ZCiruNK0fC8ObcYTlkirGIk+InKJki/pDxDu0= 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=SMo7yR6kZ9JqyQnjfB97Il7pajYcqj2hSR4J7Fsd06Q=; b=Yo9234e5pKiJZELeD+yzLjZKfl/fheDe2QU1F9UGvxCipSwIyLXtQgS8Dx6VarN/GX fd51MgtmTZGFX2rRROlt7NADfdRD+tjwKRVifx2ut/IegYQk1K1ytPQbjKgqnkJQmCmC 8aKuRhbrylW5UgHeMiFkg/+AJH3SixpAgxz9S6Vo1Lb71rdAb92tzRhvhlsdzcIg/X5V 8MwJmueaQaBksSvKy1zIMwmSaF2vxu9PgvDghhUNHIGU0mQxg3h//zjGwpBAE2+FUYiE znq2HgPPS0QwJGHpChj+2wpW2GZhW2Uni9fkSV1PsY6QwawHmsUasiJj1qnDmYHL+9Np KROw== X-Gm-Message-State: AIkVDXIn7m8ajy4mm1EKbacdKLFJkG4CwP6UFRCNBAIN8LvG5LNQoabULYiKcLbe5W42nXtP X-Received: by 10.99.115.71 with SMTP id d7mr28182104pgn.56.1485839771124; Mon, 30 Jan 2017 21:16:11 -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 p66sm36539437pfb.88.2017.01.30.21.16.07 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 30 Jan 2017 21:16:09 -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 v6 1/5] devicetree: mfd: Add binding for the TI LM3533 Date: Mon, 30 Jan 2017 13:17:15 -0800 Message-Id: <20170130211719.31017-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 v5: - None 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>; + }; + }; +