From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-3.6 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE, SPF_PASS autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id BC63BC10F25 for ; Wed, 11 Mar 2020 07:01:03 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 79A9020873 for ; Wed, 11 Mar 2020 07:01:03 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=mg.codeaurora.org header.i=@mg.codeaurora.org header.b="c1eKY2me" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728237AbgCKHBD (ORCPT ); Wed, 11 Mar 2020 03:01:03 -0400 Received: from mail27.static.mailgun.info ([104.130.122.27]:46550 "EHLO mail27.static.mailgun.info" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728269AbgCKHBC (ORCPT ); Wed, 11 Mar 2020 03:01:02 -0400 DKIM-Signature: a=rsa-sha256; v=1; c=relaxed/relaxed; d=mg.codeaurora.org; q=dns/txt; s=smtp; t=1583910062; h=Message-ID: References: In-Reply-To: Subject: Cc: To: From: Date: Content-Transfer-Encoding: Content-Type: MIME-Version: Sender; bh=ovrEBVI/snmL/1EGRztMsqFqChFnRj0NxXz/0Kzy5Mo=; b=c1eKY2mebF65R/xojz5Mes0UvvaYvHqg4uYqEErO0KfQ4p9aoEUdIdmAzhtPvkhCxVI0XqtZ 47Xc+VAw/xphB7MXroraowAbEDcO/XiqjKV3+pG4VM2Qop9FHP7LEpP2jV4gNI3cQ6jMAJ2g rniYM+DYBfsDLDzntl+tsmHTlCQ= X-Mailgun-Sending-Ip: 104.130.122.27 X-Mailgun-Sid: WyJkODczOCIsICJsaW51eC1sZWRzQHZnZXIua2VybmVsLm9yZyIsICJiZTllNGEiXQ== Received: from smtp.codeaurora.org (ec2-35-166-182-171.us-west-2.compute.amazonaws.com [35.166.182.171]) by mxa.mailgun.org with ESMTP id 5e688c94.7f3e75467e30-smtp-out-n01; Wed, 11 Mar 2020 07:00:36 -0000 (UTC) Received: by smtp.codeaurora.org (Postfix, from userid 1001) id 4CFF6C43636; Wed, 11 Mar 2020 07:00:34 +0000 (UTC) Received: from mail.codeaurora.org (localhost.localdomain [127.0.0.1]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) (Authenticated sender: kgunda) by smtp.codeaurora.org (Postfix) with ESMTPSA id E3623C433CB; Wed, 11 Mar 2020 07:00:32 +0000 (UTC) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII; format=flowed Content-Transfer-Encoding: 7bit Date: Wed, 11 Mar 2020 12:30:32 +0530 From: kgunda@codeaurora.org To: Daniel Thompson Cc: bjorn.andersson@linaro.org, jingoohan1@gmail.com, lee.jones@linaro.org, b.zolnierkie@samsung.com, dri-devel@lists.freedesktop.org, jacek.anaszewski@gmail.com, pavel@ucw.cz, robh+dt@kernel.org, mark.rutland@arm.com, linux-leds@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Dan Murphy , linux-arm-msm@vger.kernel.org, linux-arm-msm-owner@vger.kernel.org Subject: Re: [PATCH V3 1/4] backlight: qcom-wled: convert the wled bindings to .yaml format In-Reply-To: <20200310150159.vg2k44zn57me6wzk@holly.lan> References: <1583760362-26978-1-git-send-email-kgunda@codeaurora.org> <1583760362-26978-2-git-send-email-kgunda@codeaurora.org> <20200310150159.vg2k44zn57me6wzk@holly.lan> Message-ID: <55900202eaba0e1a42944ef2c4917838@codeaurora.org> X-Sender: kgunda@codeaurora.org User-Agent: Roundcube Webmail/1.3.9 Sender: linux-leds-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-leds@vger.kernel.org On 2020-03-10 20:31, Daniel Thompson wrote: > On Mon, Mar 09, 2020 at 06:55:59PM +0530, Kiran Gunda wrote: >> Convert the qcom-wled bindings from .txt to .yaml format. >> >> Signed-off-by: Kiran Gunda > > Acked-by: Daniel Thompson > Thanks. > >> --- >> .../bindings/leds/backlight/qcom-wled.txt | 154 >> ----------------- >> .../bindings/leds/backlight/qcom-wled.yaml | 184 >> +++++++++++++++++++++ >> 2 files changed, 184 insertions(+), 154 deletions(-) >> delete mode 100644 >> Documentation/devicetree/bindings/leds/backlight/qcom-wled.txt >> create mode 100644 >> Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml >> >> diff --git >> a/Documentation/devicetree/bindings/leds/backlight/qcom-wled.txt >> b/Documentation/devicetree/bindings/leds/backlight/qcom-wled.txt >> deleted file mode 100644 >> index c06863b..0000000 >> --- a/Documentation/devicetree/bindings/leds/backlight/qcom-wled.txt >> +++ /dev/null >> @@ -1,154 +0,0 @@ >> -Binding for Qualcomm Technologies, Inc. WLED driver >> - >> -WLED (White Light Emitting Diode) driver is used for controlling >> display >> -backlight that is part of PMIC on Qualcomm Technologies, Inc. >> reference >> -platforms. The PMIC is connected to the host processor via SPMI bus. >> - >> -- compatible >> - Usage: required >> - Value type: >> - Definition: should be one of: >> - "qcom,pm8941-wled" >> - "qcom,pmi8998-wled" >> - "qcom,pm660l-wled" >> - >> -- reg >> - Usage: required >> - Value type: >> - Definition: Base address of the WLED modules. >> - >> -- default-brightness >> - Usage: optional >> - Value type: >> - Definition: brightness value on boot, value from: 0-4095. >> - Default: 2048 >> - >> -- label >> - Usage: required >> - Value type: >> - Definition: The name of the backlight device >> - >> -- qcom,cs-out >> - Usage: optional >> - Value type: >> - Definition: enable current sink output. >> - This property is supported only for PM8941. >> - >> -- qcom,cabc >> - Usage: optional >> - Value type: >> - Definition: enable content adaptive backlight control. >> - >> -- qcom,ext-gen >> - Usage: optional >> - Value type: >> - Definition: use externally generated modulator signal to dim. >> - This property is supported only for PM8941. >> - >> -- qcom,current-limit >> - Usage: optional >> - Value type: >> - Definition: mA; per-string current limit; value from 0 to 25 with >> - 1 mA step. Default 20 mA. >> - This property is supported only for pm8941. >> - >> -- qcom,current-limit-microamp >> - Usage: optional >> - Value type: >> - Definition: uA; per-string current limit; value from 0 to 30000 >> with >> - 2500 uA step. Default 25 mA. >> - >> -- qcom,current-boost-limit >> - Usage: optional >> - Value type: >> - Definition: mA; boost current limit. >> - For pm8941: one of: 105, 385, 525, 805, 980, 1260, 1400, >> - 1680. Default: 805 mA. >> - For pmi8998: one of: 105, 280, 450, 620, 970, 1150, 1300, >> - 1500. Default: 970 mA. >> - >> -- qcom,switching-freq >> - Usage: optional >> - Value type: >> - Definition: kHz; switching frequency; one of: 600, 640, 685, 738, >> - 800, 872, 960, 1066, 1200, 1371, 1600, 1920, 2400, 3200, >> - 4800, 9600. >> - Default: for pm8941: 1600 kHz >> - for pmi8998: 800 kHz >> - >> -- qcom,ovp >> - Usage: optional >> - Value type: >> - Definition: V; Over-voltage protection limit; one of: >> - 27, 29, 32, 35. Default: 29V >> - This property is supported only for PM8941. >> - >> -- qcom,ovp-millivolt >> - Usage: optional >> - Value type: >> - Definition: mV; Over-voltage protection limit; >> - For pmi8998: one of 18100, 19600, 29600, 31100. >> - Default 29600 mV. >> - If this property is not specified for PM8941, it >> - falls back to "qcom,ovp" property. >> - >> -- qcom,num-strings >> - Usage: optional >> - Value type: >> - Definition: #; number of led strings attached; >> - value: For PM8941 from 1 to 3. Default: 2 >> - For PMI8998 from 1 to 4. >> - >> -- interrupts >> - Usage: optional >> - Value type: >> - Definition: Interrupts associated with WLED. This should be >> - "short" and "ovp" interrupts. Interrupts can be >> - specified as per the encoding listed under >> - Documentation/devicetree/bindings/spmi/ >> - qcom,spmi-pmic-arb.txt. >> - >> -- interrupt-names >> - Usage: optional >> - Value type: >> - Definition: Interrupt names associated with the interrupts. >> - Must be "short" and "ovp". The short circuit detection >> - is not supported for PM8941. >> - >> -- qcom,enabled-strings >> - Usage: optional >> - Value tyoe: >> - Definition: Array of the WLED strings numbered from 0 to 3. Each >> - string of leds are operated individually. Specify the >> - list of strings used by the device. Any combination of >> - led strings can be used. >> - >> -- qcom,external-pfet >> - Usage: optional >> - Value type: >> - Definition: Specify if external PFET control for short circuit >> - protection is used. This property is supported only >> - for PMI8998. >> - >> -- qcom,auto-string-detection >> - Usage: optional >> - Value type: >> - Definition: Enables auto-detection of the WLED string >> configuration. >> - This feature is not supported for PM8941. >> - >> - >> -Example: >> - >> -pm8941-wled@d800 { >> - compatible = "qcom,pm8941-wled"; >> - reg = <0xd800>; >> - label = "backlight"; >> - >> - qcom,cs-out; >> - qcom,current-limit = <20>; >> - qcom,current-boost-limit = <805>; >> - qcom,switching-freq = <1600>; >> - qcom,ovp = <29>; >> - qcom,num-strings = <2>; >> - qcom,enabled-strings = <0 1>; >> -}; >> diff --git >> a/Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml >> b/Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml >> new file mode 100644 >> index 0000000..d334f81 >> --- /dev/null >> +++ b/Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml >> @@ -0,0 +1,184 @@ >> +# SPDX-License-Identifier: GPL-2.0-only >> +%YAML 1.2 >> +--- >> +$id: >> http://devicetree.org/schemas/bindings/leds/backlight/qcom-wled.yaml# >> +$schema: http://devicetree.org/meta-schemas/core.yaml# >> + >> +title: Binding for Qualcomm Technologies, Inc. WLED driver >> + >> +maintainers: >> + - Lee Jones >> + >> +description: | >> + WLED (White Light Emitting Diode) driver is used for controlling >> display >> + backlight that is part of PMIC on Qualcomm Technologies, Inc. >> reference >> + platforms. The PMIC is connected to the host processor via SPMI >> bus. >> + >> +properties: >> + compatible : >> + enum: >> + - qcom,pm8941-wled >> + - qcom,pmi8998-wled >> + - qcom,pm660l-wled >> + >> + reg: >> + maxItems: 1 >> + >> + default-brightness: >> + maxItems: 1 >> + description: >> + brightness value on boot, value from 0-4095. >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + default: 2048 >> + >> + label: >> + maxItems: 1 >> + description: >> + The name of the backlight device. >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/string >> + >> + qcom,cs-out: >> + description: >> + enable current sink output. >> + This property is supported only for PM8941. >> + type: boolean >> + >> + qcom,cabc: >> + description: >> + enable content adaptive backlight control. >> + type: boolean >> + >> + qcom,ext-gen: >> + description: >> + use externally generated modulator signal to dim. >> + This property is supported only for PM8941. >> + type: boolean >> + >> + qcom,current-limit: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + mA; per-string current limit; value from 0 to 25 with >> + 1 mA step. This property is supported only for pm8941. >> + default: 20 >> + >> + qcom,current-limit-microamp: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + uA; per-string current limit; value from 0 to 30000 with >> + 2500 uA step. >> + default: 25 >> + >> + qcom,current-boost-limit: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + mA; boost current limit. >> + For pm8941 one of 105, 385, 525, 805, 980, 1260, 1400, 1680. >> + Default, 805 mA. >> + For pmi8998 one of 105, 280, 450, 620, 970, 1150, 1300, >> + 1500. Default 970 mA. >> + >> + qcom,switching-freq: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + kHz; switching frequency; one of 600, 640, 685, 738, >> + 800, 872, 960, 1066, 1200, 1371, 1600, 1920, 2400, 3200, >> + 4800, 9600. >> + Default for pm8941 1600 kHz >> + for pmi8998 800 kHz >> + >> + qcom,ovp: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + V; Over-voltage protection limit; one of 27, 29, 32, 35. >> Default 29V >> + This property is supported only for PM8941. >> + >> + qcom,ovp-millivolt: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + mV; Over-voltage protection limit; >> + For pmi8998 one of 18100, 19600, 29600, 31100. >> + Default 29600 mV. >> + If this property is not specified for PM8941, it >> + falls back to "qcom,ovp" property. >> + >> + qcom,num-strings: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + number of led strings attached; >> + value for PM8941 from 1 to 3. Default 2 >> + For PMI8998 from 1 to 4. >> + >> + interrupts: >> + maxItems: 2 >> + description: >> + Interrupts associated with WLED. This should be >> + "short" and "ovp" interrupts. Interrupts can be >> + specified as per the encoding listed under >> + Documentation/devicetree/bindings/spmi/ >> + qcom,spmi-pmic-arb.txt. >> + >> + interrupt-names: >> + description: >> + Interrupt names associated with the interrupts. >> + Must be "short" and "ovp". The short circuit detection >> + is not supported for PM8941. >> + >> + qcom,enabled-strings: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32-array >> + description: >> + Array of the WLED strings numbered from 0 to 3. Each >> + string of leds are operated individually. Specify the >> + list of strings used by the device. Any combination of >> + led strings can be used. >> + >> + qcom,external-pfet: >> + description: >> + Specify if external PFET control for short circuit >> + protection is used. This property is supported only >> + for PMI8998. >> + type: boolean >> + >> + qcom,auto-string-detection: >> + description: >> + Enables auto-detection of the WLED string configuration. >> + This feature is not supported for PM8941. >> + type: boolean >> + >> +required: >> + - compatible >> + - reg >> + - label >> + >> +examples: >> + - | >> + pm8941-wled@d800 { >> + compatible = "qcom,pm8941-wled"; >> + reg = <0xd800 0x100>; >> + label = "backlight"; >> + >> + qcom,cs-out; >> + qcom,current-limit = <20>; >> + qcom,current-boost-limit = <805>; >> + qcom,switching-freq = <1600>; >> + qcom,ovp = <29>; >> + qcom,num-strings = <2>; >> + qcom,enabled-strings = <0 1>; >> + }; >> -- >> The Qualcomm Innovation Center, Inc. is a member of the Code Aurora >> Forum, >> a Linux Foundation Collaborative Project From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-3.6 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE, SPF_PASS autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id B64BDC10F27 for ; Wed, 11 Mar 2020 08:32:48 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 8670420848 for ; Wed, 11 Mar 2020 08:32:48 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=mg.codeaurora.org header.i=@mg.codeaurora.org header.b="iYuCj31j" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 8670420848 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=codeaurora.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 094A16E928; Wed, 11 Mar 2020 08:32:42 +0000 (UTC) Received: from mail26.static.mailgun.info (mail26.static.mailgun.info [104.130.122.26]) by gabe.freedesktop.org (Postfix) with ESMTPS id 6A27689C89 for ; Wed, 11 Mar 2020 07:00:56 +0000 (UTC) DKIM-Signature: a=rsa-sha256; v=1; c=relaxed/relaxed; d=mg.codeaurora.org; q=dns/txt; s=smtp; t=1583910059; h=Message-ID: References: In-Reply-To: Subject: Cc: To: From: Date: Content-Transfer-Encoding: Content-Type: MIME-Version: Sender; bh=ovrEBVI/snmL/1EGRztMsqFqChFnRj0NxXz/0Kzy5Mo=; b=iYuCj31jpuhqJfXmV9EqdchHXxlzSha7KuNVjZQ5Qvqw/hV/R9yo01hCO22ODvwBEqXRrYFC Zpl4Xff3VHbCcLfV6t4wPqAF0jVhLee+31d1u2YRYhvxwrmsEqk+Hdb3jA0aGKH7+G2IydVv afGneE/JlWUeBjMAL1d9hbFqHRI= X-Mailgun-Sending-Ip: 104.130.122.26 X-Mailgun-Sid: WyJkOTU5ZSIsICJkcmktZGV2ZWxAbGlzdHMuZnJlZWRlc2t0b3Aub3JnIiwgImJlOWU0YSJd Received: from smtp.codeaurora.org (ec2-35-166-182-171.us-west-2.compute.amazonaws.com [35.166.182.171]) by mxa.mailgun.org with ESMTP id 5e688c93.7f2df4ffadc0-smtp-out-n05; Wed, 11 Mar 2020 07:00:35 -0000 (UTC) Received: by smtp.codeaurora.org (Postfix, from userid 1001) id D1F1DC44788; Wed, 11 Mar 2020 07:00:34 +0000 (UTC) Received: from mail.codeaurora.org (localhost.localdomain [127.0.0.1]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) (Authenticated sender: kgunda) by smtp.codeaurora.org (Postfix) with ESMTPSA id E3623C433CB; Wed, 11 Mar 2020 07:00:32 +0000 (UTC) MIME-Version: 1.0 Date: Wed, 11 Mar 2020 12:30:32 +0530 From: kgunda@codeaurora.org To: Daniel Thompson Subject: Re: [PATCH V3 1/4] backlight: qcom-wled: convert the wled bindings to .yaml format In-Reply-To: <20200310150159.vg2k44zn57me6wzk@holly.lan> References: <1583760362-26978-1-git-send-email-kgunda@codeaurora.org> <1583760362-26978-2-git-send-email-kgunda@codeaurora.org> <20200310150159.vg2k44zn57me6wzk@holly.lan> Message-ID: <55900202eaba0e1a42944ef2c4917838@codeaurora.org> X-Sender: kgunda@codeaurora.org User-Agent: Roundcube Webmail/1.3.9 X-Mailman-Approved-At: Wed, 11 Mar 2020 08:32:41 +0000 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: mark.rutland@arm.com, devicetree@vger.kernel.org, b.zolnierkie@samsung.com, jingoohan1@gmail.com, linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, bjorn.andersson@linaro.org, robh+dt@kernel.org, jacek.anaszewski@gmail.com, pavel@ucw.cz, linux-arm-msm@vger.kernel.org, lee.jones@linaro.org, linux-arm-msm-owner@vger.kernel.org, linux-leds@vger.kernel.org, Dan Murphy Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="us-ascii"; Format="flowed" Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" On 2020-03-10 20:31, Daniel Thompson wrote: > On Mon, Mar 09, 2020 at 06:55:59PM +0530, Kiran Gunda wrote: >> Convert the qcom-wled bindings from .txt to .yaml format. >> >> Signed-off-by: Kiran Gunda > > Acked-by: Daniel Thompson > Thanks. > >> --- >> .../bindings/leds/backlight/qcom-wled.txt | 154 >> ----------------- >> .../bindings/leds/backlight/qcom-wled.yaml | 184 >> +++++++++++++++++++++ >> 2 files changed, 184 insertions(+), 154 deletions(-) >> delete mode 100644 >> Documentation/devicetree/bindings/leds/backlight/qcom-wled.txt >> create mode 100644 >> Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml >> >> diff --git >> a/Documentation/devicetree/bindings/leds/backlight/qcom-wled.txt >> b/Documentation/devicetree/bindings/leds/backlight/qcom-wled.txt >> deleted file mode 100644 >> index c06863b..0000000 >> --- a/Documentation/devicetree/bindings/leds/backlight/qcom-wled.txt >> +++ /dev/null >> @@ -1,154 +0,0 @@ >> -Binding for Qualcomm Technologies, Inc. WLED driver >> - >> -WLED (White Light Emitting Diode) driver is used for controlling >> display >> -backlight that is part of PMIC on Qualcomm Technologies, Inc. >> reference >> -platforms. The PMIC is connected to the host processor via SPMI bus. >> - >> -- compatible >> - Usage: required >> - Value type: >> - Definition: should be one of: >> - "qcom,pm8941-wled" >> - "qcom,pmi8998-wled" >> - "qcom,pm660l-wled" >> - >> -- reg >> - Usage: required >> - Value type: >> - Definition: Base address of the WLED modules. >> - >> -- default-brightness >> - Usage: optional >> - Value type: >> - Definition: brightness value on boot, value from: 0-4095. >> - Default: 2048 >> - >> -- label >> - Usage: required >> - Value type: >> - Definition: The name of the backlight device >> - >> -- qcom,cs-out >> - Usage: optional >> - Value type: >> - Definition: enable current sink output. >> - This property is supported only for PM8941. >> - >> -- qcom,cabc >> - Usage: optional >> - Value type: >> - Definition: enable content adaptive backlight control. >> - >> -- qcom,ext-gen >> - Usage: optional >> - Value type: >> - Definition: use externally generated modulator signal to dim. >> - This property is supported only for PM8941. >> - >> -- qcom,current-limit >> - Usage: optional >> - Value type: >> - Definition: mA; per-string current limit; value from 0 to 25 with >> - 1 mA step. Default 20 mA. >> - This property is supported only for pm8941. >> - >> -- qcom,current-limit-microamp >> - Usage: optional >> - Value type: >> - Definition: uA; per-string current limit; value from 0 to 30000 >> with >> - 2500 uA step. Default 25 mA. >> - >> -- qcom,current-boost-limit >> - Usage: optional >> - Value type: >> - Definition: mA; boost current limit. >> - For pm8941: one of: 105, 385, 525, 805, 980, 1260, 1400, >> - 1680. Default: 805 mA. >> - For pmi8998: one of: 105, 280, 450, 620, 970, 1150, 1300, >> - 1500. Default: 970 mA. >> - >> -- qcom,switching-freq >> - Usage: optional >> - Value type: >> - Definition: kHz; switching frequency; one of: 600, 640, 685, 738, >> - 800, 872, 960, 1066, 1200, 1371, 1600, 1920, 2400, 3200, >> - 4800, 9600. >> - Default: for pm8941: 1600 kHz >> - for pmi8998: 800 kHz >> - >> -- qcom,ovp >> - Usage: optional >> - Value type: >> - Definition: V; Over-voltage protection limit; one of: >> - 27, 29, 32, 35. Default: 29V >> - This property is supported only for PM8941. >> - >> -- qcom,ovp-millivolt >> - Usage: optional >> - Value type: >> - Definition: mV; Over-voltage protection limit; >> - For pmi8998: one of 18100, 19600, 29600, 31100. >> - Default 29600 mV. >> - If this property is not specified for PM8941, it >> - falls back to "qcom,ovp" property. >> - >> -- qcom,num-strings >> - Usage: optional >> - Value type: >> - Definition: #; number of led strings attached; >> - value: For PM8941 from 1 to 3. Default: 2 >> - For PMI8998 from 1 to 4. >> - >> -- interrupts >> - Usage: optional >> - Value type: >> - Definition: Interrupts associated with WLED. This should be >> - "short" and "ovp" interrupts. Interrupts can be >> - specified as per the encoding listed under >> - Documentation/devicetree/bindings/spmi/ >> - qcom,spmi-pmic-arb.txt. >> - >> -- interrupt-names >> - Usage: optional >> - Value type: >> - Definition: Interrupt names associated with the interrupts. >> - Must be "short" and "ovp". The short circuit detection >> - is not supported for PM8941. >> - >> -- qcom,enabled-strings >> - Usage: optional >> - Value tyoe: >> - Definition: Array of the WLED strings numbered from 0 to 3. Each >> - string of leds are operated individually. Specify the >> - list of strings used by the device. Any combination of >> - led strings can be used. >> - >> -- qcom,external-pfet >> - Usage: optional >> - Value type: >> - Definition: Specify if external PFET control for short circuit >> - protection is used. This property is supported only >> - for PMI8998. >> - >> -- qcom,auto-string-detection >> - Usage: optional >> - Value type: >> - Definition: Enables auto-detection of the WLED string >> configuration. >> - This feature is not supported for PM8941. >> - >> - >> -Example: >> - >> -pm8941-wled@d800 { >> - compatible = "qcom,pm8941-wled"; >> - reg = <0xd800>; >> - label = "backlight"; >> - >> - qcom,cs-out; >> - qcom,current-limit = <20>; >> - qcom,current-boost-limit = <805>; >> - qcom,switching-freq = <1600>; >> - qcom,ovp = <29>; >> - qcom,num-strings = <2>; >> - qcom,enabled-strings = <0 1>; >> -}; >> diff --git >> a/Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml >> b/Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml >> new file mode 100644 >> index 0000000..d334f81 >> --- /dev/null >> +++ b/Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml >> @@ -0,0 +1,184 @@ >> +# SPDX-License-Identifier: GPL-2.0-only >> +%YAML 1.2 >> +--- >> +$id: >> http://devicetree.org/schemas/bindings/leds/backlight/qcom-wled.yaml# >> +$schema: http://devicetree.org/meta-schemas/core.yaml# >> + >> +title: Binding for Qualcomm Technologies, Inc. WLED driver >> + >> +maintainers: >> + - Lee Jones >> + >> +description: | >> + WLED (White Light Emitting Diode) driver is used for controlling >> display >> + backlight that is part of PMIC on Qualcomm Technologies, Inc. >> reference >> + platforms. The PMIC is connected to the host processor via SPMI >> bus. >> + >> +properties: >> + compatible : >> + enum: >> + - qcom,pm8941-wled >> + - qcom,pmi8998-wled >> + - qcom,pm660l-wled >> + >> + reg: >> + maxItems: 1 >> + >> + default-brightness: >> + maxItems: 1 >> + description: >> + brightness value on boot, value from 0-4095. >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + default: 2048 >> + >> + label: >> + maxItems: 1 >> + description: >> + The name of the backlight device. >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/string >> + >> + qcom,cs-out: >> + description: >> + enable current sink output. >> + This property is supported only for PM8941. >> + type: boolean >> + >> + qcom,cabc: >> + description: >> + enable content adaptive backlight control. >> + type: boolean >> + >> + qcom,ext-gen: >> + description: >> + use externally generated modulator signal to dim. >> + This property is supported only for PM8941. >> + type: boolean >> + >> + qcom,current-limit: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + mA; per-string current limit; value from 0 to 25 with >> + 1 mA step. This property is supported only for pm8941. >> + default: 20 >> + >> + qcom,current-limit-microamp: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + uA; per-string current limit; value from 0 to 30000 with >> + 2500 uA step. >> + default: 25 >> + >> + qcom,current-boost-limit: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + mA; boost current limit. >> + For pm8941 one of 105, 385, 525, 805, 980, 1260, 1400, 1680. >> + Default, 805 mA. >> + For pmi8998 one of 105, 280, 450, 620, 970, 1150, 1300, >> + 1500. Default 970 mA. >> + >> + qcom,switching-freq: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + kHz; switching frequency; one of 600, 640, 685, 738, >> + 800, 872, 960, 1066, 1200, 1371, 1600, 1920, 2400, 3200, >> + 4800, 9600. >> + Default for pm8941 1600 kHz >> + for pmi8998 800 kHz >> + >> + qcom,ovp: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + V; Over-voltage protection limit; one of 27, 29, 32, 35. >> Default 29V >> + This property is supported only for PM8941. >> + >> + qcom,ovp-millivolt: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + mV; Over-voltage protection limit; >> + For pmi8998 one of 18100, 19600, 29600, 31100. >> + Default 29600 mV. >> + If this property is not specified for PM8941, it >> + falls back to "qcom,ovp" property. >> + >> + qcom,num-strings: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32 >> + description: >> + number of led strings attached; >> + value for PM8941 from 1 to 3. Default 2 >> + For PMI8998 from 1 to 4. >> + >> + interrupts: >> + maxItems: 2 >> + description: >> + Interrupts associated with WLED. This should be >> + "short" and "ovp" interrupts. Interrupts can be >> + specified as per the encoding listed under >> + Documentation/devicetree/bindings/spmi/ >> + qcom,spmi-pmic-arb.txt. >> + >> + interrupt-names: >> + description: >> + Interrupt names associated with the interrupts. >> + Must be "short" and "ovp". The short circuit detection >> + is not supported for PM8941. >> + >> + qcom,enabled-strings: >> + maxItems: 1 >> + allOf: >> + - $ref: /schemas/types.yaml#/definitions/uint32-array >> + description: >> + Array of the WLED strings numbered from 0 to 3. Each >> + string of leds are operated individually. Specify the >> + list of strings used by the device. Any combination of >> + led strings can be used. >> + >> + qcom,external-pfet: >> + description: >> + Specify if external PFET control for short circuit >> + protection is used. This property is supported only >> + for PMI8998. >> + type: boolean >> + >> + qcom,auto-string-detection: >> + description: >> + Enables auto-detection of the WLED string configuration. >> + This feature is not supported for PM8941. >> + type: boolean >> + >> +required: >> + - compatible >> + - reg >> + - label >> + >> +examples: >> + - | >> + pm8941-wled@d800 { >> + compatible = "qcom,pm8941-wled"; >> + reg = <0xd800 0x100>; >> + label = "backlight"; >> + >> + qcom,cs-out; >> + qcom,current-limit = <20>; >> + qcom,current-boost-limit = <805>; >> + qcom,switching-freq = <1600>; >> + qcom,ovp = <29>; >> + qcom,num-strings = <2>; >> + qcom,enabled-strings = <0 1>; >> + }; >> -- >> The Qualcomm Innovation Center, Inc. is a member of the Code Aurora >> Forum, >> a Linux Foundation Collaborative Project _______________________________________________ dri-devel mailing list dri-devel@lists.freedesktop.org https://lists.freedesktop.org/mailman/listinfo/dri-devel