From patchwork Wed Sep 30 23:46:32 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alexander Dahl X-Patchwork-Id: 11810529 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 5CD7A6CA for ; Wed, 30 Sep 2020 23:48:17 +0000 (UTC) Received: from merlin.infradead.org (merlin.infradead.org [205.233.59.134]) (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 2CE7720B1F for ; Wed, 30 Sep 2020 23:48:17 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="kf/eVUqc" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 2CE7720B1F Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=lespocky.de Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=merlin.20170209; h=Sender:Content-Transfer-Encoding: Content-Type:Cc:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:Message-Id:Date: Subject:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=FKUuPMlKX9u20OEO0G1NlNUIS16mT3XKMRoysEIx6Ts=; b=kf/eVUqcqoy3Zo5Es/d303Lqg /LUPg+/k03FlbjKKZir68EnnxnyEDJX5tciW3ovu1ScTHdrbHg7YiJpESAunW7wgd0HA+MEiPXi6x W+Wp3P9def4a1ENkd053gCQnG0RxBZQ1OxSt2rSx/Gvfvl+uxspk/apVrWcoOBWsDWZNuF8tQiwXX xBXMDM8l4HQ2rtzIiucd9HX2fwUgR7xDx4u9vYTarXizXxuCdcUiWGz5krUBD+fbVWnZB+w/ollvb sf3Q6Gi3AQYKGBLA/DFSG25okjjXhc0ZLMAzpM+BJm/FO3BH+LCxbmr1IeI/ixvmIjclY/sckQA2M 4cSvCqs2Q==; Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1kNlpJ-0000RG-2v; Wed, 30 Sep 2020 23:48:01 +0000 Received: from mout.kundenserver.de ([212.227.126.131]) by merlin.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1kNlp6-0000Mw-U1; Wed, 30 Sep 2020 23:47:50 +0000 Received: from methusalix.internal.home.lespocky.de ([92.117.51.117]) by mrelayeu.kundenserver.de (mreue010 [212.227.15.167]) with ESMTPSA (Nemesis) id 1Mwfn8-1kdu1f2EiA-00yCgd; Thu, 01 Oct 2020 01:47:33 +0200 Received: from lemmy.internal.home.lespocky.de ([192.168.243.176] helo=lemmy.home.lespocky.de) by methusalix.internal.home.lespocky.de with esmtpsa (TLS1.3) tls TLS_AES_256_GCM_SHA384 (Exim 4.94) (envelope-from ) id 1kNloo-0007ZJ-9x; Thu, 01 Oct 2020 01:47:31 +0200 Received: (nullmailer pid 7752 invoked by uid 2001); Wed, 30 Sep 2020 23:47:30 -0000 From: Alexander Dahl To: linux-leds@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-samsung-soc@vger.kernel.org, linux-omap@vger.kernel.org, linux-stm32@st-md-mailman.stormreply.com, linux-amlogic@lists.infradead.org, linux-mips@vger.kernel.org Subject: [PATCH v6 2/7] dt-bindings: leds: Convert pwm to yaml Date: Thu, 1 Oct 2020 01:46:32 +0200 Message-Id: <20200930234637.7573-3-post@lespocky.de> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20200930234637.7573-1-post@lespocky.de> References: <20200930234637.7573-1-post@lespocky.de> MIME-Version: 1.0 X-Scan-Signature: 3e58d80bea5cd590cac74c0f13974345 X-Spam-Score: -2.8 (--) X-Provags-ID: V03:K1:hfrLk1T8O692sf7nZscqnW4Dj6gvVbgjOMm7r0YveLSarxy1RFM lX2vRgrZ1ZnfGVX2N0J7nPfxdWZnjEg9G1Rvwvs4kD+1x77Mv19tpU+MosAML9JaEKv9boW SEvUA49l5lJSWvpybP7CocnT9WT703aXxjbHO8dNSe54qawO5DYZywTeoSVAg9st7Culvfe bVuUMi5aEcCmLMxUB6DwQ== X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:XTXFdxDXZEM=:eiF/IjUd7CfQR0dARIuICJ q9Dus1NJnVUgK/KGLuZwo+x39IZTOx0yMGf424RXRGyDkAcVfUnD3u/UffsvfQBzNXcI2Vtnc Du41VAdojZ5HkaoguhR1kZfeTsET6KbQ9/Qfy54jzISjuTFiwASJ5j6lCPCmrk519nFQycTCy 1v3kOtOJ0Cg8gNMFPQFCjpGYeENC1tXWQSSsTPpQn0njfNblARkTTNIOHkyL5BBWnurWI5ih3 tpH10pzJ3g76+iynDJXL0PkR/5mfRGtwDMdFyZg0AZR5zvaHODR+FApjMAcdyLUqn2/gPDLLN quL6vsZchd9SRaOmIkEu6YW21wt9H44r9W6mBSOFpMtYhEfGJVTS55beaxMzYaMn/PpEUw50o sr3HFdJg3jVFYcoRFArx3uVgGl2xk/1Qpl6CAtQVb2dhqiqF4YaA88GHu4soLc9ihISuX+Ea5 AVe13HFoKqssvMv5W3eA3/SpKY9qgw/cSncM8GIzv4CdTWY/tdK+ixwofvhAVtK1Wmu8hbQz+ ENGIUuLAIUnozCeJwCtSpDU2wLhDkwZGd6sC8S7tArzf86VCAYW3oQwWK1O8HFfzEm4jntyDj aqXpHWUSX60DXAPrp/vkKj3nR7HnwSBCitfET693nNE7NQNahXXIPj0SeWV3qSglN6XJpN8qo 15OeH8WgahMI1suYSwWhosnkT/e22Xd4qIy0gr4PruuznpvH+YhhXcjvAQ/dg7QADilgt2oPz cVMBN+IGXHCZKpf7v39UOtE4bg6RXMuDdan8DL1iRY5oXWsc4I15WfHJiCCUY7/sS9d6w17k7 DpPqFVI0Idfgei/qcbrDZxqyktzruSXiBg/FcaVJ+TAve8y8685jwwvK/waVp1W6/kWxglx X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20200930_194749_198005_1126E0B8 X-CRM114-Status: GOOD ( 19.49 ) X-Spam-Score: -0.4 (/) X-Spam-Report: SpamAssassin version 3.4.4 on merlin.infradead.org summary: Content analysis details: (-0.4 points) pts rule name description ---- ---------------------- -------------------------------------------------- -0.4 RCVD_IN_MSPIKE_H2 RBL: Average reputation (+2) [212.227.126.131 listed in wl.mailspike.net] -0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/, no trust [212.227.126.131 listed in list.dnswl.org] 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.0 SPF_NONE SPF: sender does not publish an SPF Record X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Alexander Dahl , Peter Ujfalusi , Rob Herring , Dan Murphy , Pavel Machek , Alexander Dahl , Jacek Anaszewski Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org The example was adapted in the following ways: - make use of the now supported 'function' and 'color' properties - remove pwm nodes, those are documented elsewhere - tweake node names to be matched by new dtschema rules License was discussed with the original author. Suggested-by: Jacek Anaszewski Signed-off-by: Alexander Dahl Cc: Peter Ujfalusi Reviewed-by: Krzysztof Kozlowski Reviewed-by: Rob Herring --- Notes: v5 -> v6: * removed pwm nodes from example (Rob) * renamed led-controller node in example (Rob) v4 -> v5: * updated based on feedback by Rob Herring * removed Acked-by v3 -> v4: * added Cc to original author of the binding v2 -> v3: * changed license identifier to recommended one * added Acked-by v2: * added this patch to series (Suggested-by: Jacek Anaszewski) .../devicetree/bindings/leds/leds-pwm.txt | 50 ------------- .../devicetree/bindings/leds/leds-pwm.yaml | 70 +++++++++++++++++++ 2 files changed, 70 insertions(+), 50 deletions(-) delete mode 100644 Documentation/devicetree/bindings/leds/leds-pwm.txt create mode 100644 Documentation/devicetree/bindings/leds/leds-pwm.yaml diff --git a/Documentation/devicetree/bindings/leds/leds-pwm.txt b/Documentation/devicetree/bindings/leds/leds-pwm.txt deleted file mode 100644 index 6c6583c35f2f..000000000000 --- a/Documentation/devicetree/bindings/leds/leds-pwm.txt +++ /dev/null @@ -1,50 +0,0 @@ -LED connected to PWM - -Required properties: -- compatible : should be "pwm-leds". - -Each LED is represented as a sub-node of the pwm-leds device. Each -node's name represents the name of the corresponding LED. - -LED sub-node properties: -- pwms : PWM property to point to the PWM device (phandle)/port (id) and to - specify the period time to be used: <&phandle id period_ns>; -- pwm-names : (optional) Name to be used by the PWM subsystem for the PWM device - For the pwms and pwm-names property please refer to: - Documentation/devicetree/bindings/pwm/pwm.txt -- max-brightness : Maximum brightness possible for the LED -- active-low : (optional) For PWMs where the LED is wired to supply - rather than ground. -- label : (optional) - see Documentation/devicetree/bindings/leds/common.txt -- linux,default-trigger : (optional) - see Documentation/devicetree/bindings/leds/common.txt - -Example: - -twl_pwm: pwm { - /* provides two PWMs (id 0, 1 for PWM1 and PWM2) */ - compatible = "ti,twl6030-pwm"; - #pwm-cells = <2>; -}; - -twl_pwmled: pwmled { - /* provides one PWM (id 0 for Charing indicator LED) */ - compatible = "ti,twl6030-pwmled"; - #pwm-cells = <2>; -}; - -pwmleds { - compatible = "pwm-leds"; - kpad { - label = "omap4::keypad"; - pwms = <&twl_pwm 0 7812500>; - max-brightness = <127>; - }; - - charging { - label = "omap4:green:chrg"; - pwms = <&twl_pwmled 0 7812500>; - max-brightness = <255>; - }; -}; diff --git a/Documentation/devicetree/bindings/leds/leds-pwm.yaml b/Documentation/devicetree/bindings/leds/leds-pwm.yaml new file mode 100644 index 000000000000..fe4d5fd25913 --- /dev/null +++ b/Documentation/devicetree/bindings/leds/leds-pwm.yaml @@ -0,0 +1,70 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/leds/leds-pwm.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: LEDs connected to PWM + +maintainers: + - Pavel Machek + +description: + Each LED is represented as a sub-node of the pwm-leds device. Each + node's name represents the name of the corresponding LED. + +properties: + compatible: + const: pwm-leds + +patternProperties: + "^led(-[0-9a-f]+)?$": + type: object + + $ref: common.yaml# + + properties: + pwms: + maxItems: 1 + + pwm-names: true + + max-brightness: + description: + Maximum brightness possible for the LED + $ref: /schemas/types.yaml#/definitions/uint32 + + active-low: + description: + For PWMs where the LED is wired to supply rather than ground. + type: boolean + + required: + - pwms + - max-brightness + +additionalProperties: false + +examples: + - | + + #include + + led-controller { + compatible = "pwm-leds"; + + led-1 { + label = "omap4::keypad"; + pwms = <&twl_pwm 0 7812500>; + max-brightness = <127>; + }; + + led-2 { + color = ; + function = LED_FUNCTION_CHARGING; + pwms = <&twl_pwmled 0 7812500>; + max-brightness = <255>; + }; + }; + +...