From patchwork Wed Nov 15 07:13:45 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bjorn Andersson X-Patchwork-Id: 838107 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=linaro.org header.i=@linaro.org header.b="DNv9SxLk"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3ycFxY51Jrz9t2c for ; Wed, 15 Nov 2017 18:14:41 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756202AbdKOHOP (ORCPT ); Wed, 15 Nov 2017 02:14:15 -0500 Received: from mail-pf0-f193.google.com ([209.85.192.193]:44556 "EHLO mail-pf0-f193.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755874AbdKOHNz (ORCPT ); Wed, 15 Nov 2017 02:13:55 -0500 Received: by mail-pf0-f193.google.com with SMTP id x7so16397322pfa.1 for ; Tue, 14 Nov 2017 23:13:55 -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:in-reply-to:references; bh=4//nlNp7llcCjF7Kwazsa8oOVBgHZsjUUruBKCwtigA=; b=DNv9SxLk56/N/ukNCFnSA+P/Tc57bsclQ9f4ae99URUkghQUg35ppgWQGcVXclE7mt 4nwuSCne6DhJxjbfLLgB2Verj1VIL7uXca8WcvJOnqRCLwgnUqYOOQtsD6QF1Q0uMa3w q1C3AhPYT8wos0D/5UscemO6d+oaH/0fKscas= 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:in-reply-to :references; bh=4//nlNp7llcCjF7Kwazsa8oOVBgHZsjUUruBKCwtigA=; b=DBLQjfe3lZJ58ggsfGFTLWwJjZY+2JzQ3wdUbusaqq6xzhpwOPe7BNc6HAJe8ZX8YD BGsisuNHfNPxvix/OsWRYWsiuscKfgZP64WLzsI+oS52dPa9Na/51c+2kE8EbHduZgK9 +pEW/3kAlaP/Z8VmXsjuJa/CisRffICDErD7/P8kWdwgWy8UjyzZHMLfg9ijzIzRw35R vTE0wsyWDFcV1H/IplpTKc7S9uJAsnftx4SbOeeaE+Y5sa4IdJos/MjILms/XOBBp12+ Wkftvei0rftykjL2qoVfywF4/apwAnv1Mxo4+7lOTXvb0XRssKhOTe9jTbyUJW3WNbyB WgVQ== X-Gm-Message-State: AJaThX4LVnu0JtvCtZm3Sa7argyxBh4uYgnN7QJdimj/RuXImNd/oC9i JTt2zMAN9Tkt04xUBjjW+uFYQQ== X-Google-Smtp-Source: AGs4zMYluwDxAOZQRDmordBkbMj7ttSTt8Fte+RrO1kpdbdGg40yhjcssQ6i0xce835Qg+gIj9iisw== X-Received: by 10.84.218.10 with SMTP id q10mr8465030pli.111.1510730034248; Tue, 14 Nov 2017 23:13:54 -0800 (PST) Received: from localhost.localdomain (ip68-111-217-79.sd.sd.cox.net. [68.111.217.79]) by smtp.gmail.com with ESMTPSA id m6sm22357369pfm.121.2017.11.14.23.13.52 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 14 Nov 2017 23:13:53 -0800 (PST) From: Bjorn Andersson To: Richard Purdie , Jacek Anaszewski , Pavel Machek , Rob Herring , Mark Rutland Cc: linux-kernel@vger.kernel.org, linux-leds@vger.kernel.org, linux-arm-msm@vger.kernel.org, devicetree@vger.kernel.org, Fenglin Wu Subject: [PATCH v3 3/3] DT: leds: Add Qualcomm Light Pulse Generator binding Date: Tue, 14 Nov 2017 23:13:45 -0800 Message-Id: <20171115071345.24331-4-bjorn.andersson@linaro.org> X-Mailer: git-send-email 2.15.0 In-Reply-To: <20171115071345.24331-1-bjorn.andersson@linaro.org> References: <20171115071345.24331-1-bjorn.andersson@linaro.org> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org This adds the binding document describing the three hardware blocks related to the Light Pulse Generator found in a wide range of Qualcomm PMICs. Signed-off-by: Bjorn Andersson Acked-by: Rob Herring --- Changes since v2: - Squashed all things into one node - Removed quirks from the binding, compatible implies number of channels, their configuration etc. - Binding describes LEDs connected as child nodes - Support describing multi-channel LEDs - Change style of the binding document, to match other LED bindings Changes since v1: - Dropped custom pattern properties - Renamed cell-index to qcom,lpg-channel to clarify its purpose .../devicetree/bindings/leds/leds-qcom-lpg.txt | 66 ++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 Documentation/devicetree/bindings/leds/leds-qcom-lpg.txt diff --git a/Documentation/devicetree/bindings/leds/leds-qcom-lpg.txt b/Documentation/devicetree/bindings/leds/leds-qcom-lpg.txt new file mode 100644 index 000000000000..9cee6f9f543c --- /dev/null +++ b/Documentation/devicetree/bindings/leds/leds-qcom-lpg.txt @@ -0,0 +1,66 @@ +Binding for Qualcomm Light Pulse Generator + +The Qualcomm Light Pulse Generator consists of three different hardware blocks; +a ramp generator with lookup table, the light pulse generator and a three +channel current sink. These blocks are found in a wide range of Qualcomm PMICs. + +Required properties: +- compatible: one of: + "qcom,pm8916-pwm", + "qcom,pm8941-lpg", + "qcom,pm8994-lpg", + "qcom,pmi8994-lpg", + "qcom,pmi8998-lpg", + +Optional properties: +- qcom,power-source: power-source used to drive the output, as defined in the + datasheet. Should be specified if the TRILED block is + present +- qcom,dtest: configures the output into an internal test line of the + pmic. Specified by a list of u32 pairs, one pair per channel, + where each pair denotes the test line to drive and the second + configures how the value should be outputed, as defined in the + datasheet +- #pwm-cells: should be 2, see ../pwm/pwm.txt + +LED subnodes: +A set of subnodes can be used to specify LEDs connected to the LPG. Channels +not associated with a LED are available as pwm channels, see ../pwm/pwm.txt. + +Required properties: +- led-sources: list of channels associated with this LED, starting at 1 for the + first LPG channel + +Optional properties: +- label: see Documentation/devicetree/bindings/leds/common.txt +- default-state: see Documentation/devicetree/bindings/leds/common.txt +- linux,default-trigger: see Documentation/devicetree/bindings/leds/common.txt + +Example: +The following example defines a RGB LED attached to the PM8941. + +&spmi_bus { + pm8941@1 { + lpg { + compatible = "qcom,pm8941-lpg"; + qcom,power-source = <1>; + + rgb { + led-sources = <7 6 5>; + }; + }; + }; +}; + +The following example defines the single PWM channel of the PM8916, which can +be muxed by the MPP4 as a current sink. + +&spmi_bus { + pm8916@1 { + pm8916_pwm: pwm { + compatible = "qcom,pm8916-pwm"; + + #pwm-cells = <2>; + }; + }; +};