From patchwork Sat Jun 20 22:39:05 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?J=2E_Neusch=C3=A4fer?= X-Patchwork-Id: 11618383 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 B7AF590 for ; Mon, 22 Jun 2020 16:25:02 +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 8FC522073E for ; Mon, 22 Jun 2020 16:25:02 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="VW6K8gOJ"; dkim=fail reason="signature verification failed" (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="WY36hJoP"; dkim=fail reason="signature verification failed" (1024-bit key) header.d=gmx.net header.i=@gmx.net header.b="awKouNNw" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 8FC522073E Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=gmx.net 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=m4rpJit1al3pGD0S5PVpd3FmSs967yDe5Rn2ktqVFro=; b=VW6K8gOJGjrTlsUPeUn87FErB lgYlzx8l9KdiMLQ+iQ9+Areg1vyLpecVeqT2HtB4ivuUBzyOfY2k7anYhwN0ur/NZBnTSIkVgZRpu YzhktABmgkfvRuU5YmqM1xbeaI27eucw2DKb8lIPC8OgwqcdziXzeuUBkyCQiIIzBP9Kqnhwm39/E ysNBoIfkhOGk1rlFuzHpXRDiKhl6fhxz/WQVcsLho9OwnuCQ9tXA5dZeQPdaaAoYBD4BansLKROTB NykFFMWVHawZ2YApub6OcDAz187gO2eJb/aymlynqJjBDc8f8vZAwbEG5fj1JKidKiZXNH3vg/OAu D93HnruOw==; Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1jnPE0-0007KA-EM; Mon, 22 Jun 2020 16:23:12 +0000 Received: from casper.infradead.org ([2001:8b0:10b:1236::1]) by merlin.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1jnLlk-00072f-9c for linux-arm-kernel@merlin.infradead.org; Mon, 22 Jun 2020 12:41:49 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:Content-Type: MIME-Version:References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender :Reply-To:Content-ID:Content-Description; bh=5JI095oTz1tTUWoP5NuWnw/qOb1Bm9cTEg2t5n0N5kI=; b=WY36hJoPJU2kWG9Jg56n3BMPpL 8K+AvbEgESXzE5QTD/EF+0YjGMEgx2P9bjxwmL4Psgaz22aRR8Rt+Zy+brQnHiYx2hUhzHFiV5pFq Ik3CuNBj4tOeSlBA/mGwpABINRnkZYfcLmo70pRkCRCsMH0K5UAZxw7DvNyjEuA3nsYAb9GQdZqt7 kE1T8j6WSv4lmrhacbW6r8DRovShcaNk2pPDgx3w0TAAA9DNBz4rBiaGEgkIXXqh4nDUA/OqcDqqn Qi8298MsX9xE+X7eMpleYP6CszqJFvSQTlNjIOAK5olVAg8ae+jgrl66AT4cKyCqrz2VTd2KVp88u wo5UrZRQ==; Received: from mout.gmx.net ([212.227.15.15]) by casper.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1jmmAA-0008DM-JJ for linux-arm-kernel@lists.infradead.org; Sat, 20 Jun 2020 22:40:41 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1592692783; bh=NZlIIwqNdtz2a/BsgVin34fzBdteKCXfPTKpkZ94mWM=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=awKouNNwZMnHe+LNy5Fvm541bwzFIrAoC2hgnZRHv/nFQLCNiAdi0yLG0jsS3KAPk aB53eq2b2qyxnDUVNATlm92w2BI3lMLGm3KHSAm8xhuTHaO3ooIs/Pg1kIyFCUa5Sa B1FMipma3UFGm++S9ENNNb81EISkSizfJTPpv+u4= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Received: from longitude ([5.146.194.186]) by mail.gmx.com (mrgmx005 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MkYc0-1j0qCP0n3m-00m4hJ; Sun, 21 Jun 2020 00:39:43 +0200 From: =?utf-8?q?Jonathan_Neusch=C3=A4fer?= To: linux-kernel@vger.kernel.org Subject: [RFC PATCH 01/10] DT bindings in plain text format Date: Sun, 21 Jun 2020 00:39:05 +0200 Message-Id: <20200620223915.1311485-2-j.neuschaefer@gmx.net> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20200620223915.1311485-1-j.neuschaefer@gmx.net> References: <20200620223915.1311485-1-j.neuschaefer@gmx.net> MIME-Version: 1.0 X-Provags-ID: V03:K1:VxdfrjWO/u5MhkFEjp5KExUHat+e9KDgtmLJLE7SRngqgjYq/nQ XlCaZO+wvW9aA+9ez71mbfpUjzFYsLA9lmNlF0ivaZt7Kw4hU0gOLdIkC8vrsjk0V0tjKeL N+H6ek0QzT0wUo/mpzycW2uq+H6ea3gq1IxR2hMazCh4waMRq/8riIJ3oR5z/oTaCbMVs9k 1Il3/109DVkACWeH46L2A== X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:lUU5143vyWI=:+OoGUROgFSFjWmEqEhkIO6 uJ11onjQTWCwldpTO6uSpYgMMW7JxtuxzAWkf7NFKnJ29sfmf3S06CKvlVPEVmcimDlNGmqs/ rpLKJkqLHNkKzMaORiGyE0ygchcRQe+wLNIkrKUOaYNLxMcPoEEPJ31HHKFj6I2AyOhLpawWa ZXTWnqMQaQC1P4iJI2eGygAeh+Ro/1vkuouaGTuChHg2JpZNmmCD6YrZAbucBjJUDZ1BxPU2V ffFfFdogRmHKVNRueV1Qf0wMoL1kRalzF/fyHKtzqvkPS7pKAd08dU3Ml5vHxUq8j3h2kZmC7 dzgmG9ZVDXCp6Ob2tNph2INShQhSyf3OrfruYB/sfJRT+i9fqRyPieg01maiwdTI4dYOHdpnw 9RHaejksKs1v+rcn+4fgD9wt/Pw4oGmakCg4nbRzxqIOG5tRtx+VlJhdNaJBu5Jz+tWFgtvrM tlprNSREQSvLil/OeuJ+Bs0cgDW5TvOWUKTEZ1Fc599CpAEXa5aPMCn4G0PBuhIJFyfCid1o+ D7+lmktz5x201/iEJjk4NEYlNe6dcRKI6Vs3RWgqOxc/NmAf6K/p8YuVb95jFdZw6NWug9HJx zcQ8k4rqE7xvz13MdaRVU0wvZOkcpcbOlZRUi+9cvJnggzySlncTXJgsZN31ryL8ZVIzD9y7k eWLokiWVF2FJfXtEqKIy7hB2JcYiHW0ffp7cpHEBPlkgz+xAQBXvhaICoaPD73AOkFn6aV6vL R+qG8eGBuZdol6tjBqNBedJsqTC+hs/cpp/Xqom+rulP4yZhk9aUT2hqNKCSROwsGGcgPEoKF RJM1V8TauRypS5/1uRJIAp3Rz57wCacOI1YyNmlvaM7EhrdIFm+i8jIRef6UHm7w/A0WE77GS ILU952UhuKOwcW65DcSLvbQv9U98qHq/2a/lXcK1BfwX+qHoDnSR36CnZFf1pQ9ruPduBruhZ Y/IsjKR4FyPlJME3cKfB2AJM5cuxkQZIFvSQI2iOpttC89fH7Cs4pnBV/47KuWy0wcCg+LWKa 3JI6WltFNPxyzsMkDAQG9dGhqCcBBgEJIMV8ckhjeY7fS91G6d7CI8KhmwYbaf3mDctmGmnlp bnozlZRtbdNk9Ojd7vGvpzJtPf60nWhOjCDP2HHCyLBdgyz9wkRT3b+v54Kpxs5OTOVzBc+Xo BOCpg2QYPWjOIwo3Gd8vcKdxkzLfTTxPzzHn7R/SyBPmDKnTiYZpEDgwPZYWaVwZpVsIrDwJy nrNkjPs5LKdUJMSv9 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20200620_234038_804448_319ACA9F X-CRM114-Status: GOOD ( 13.86 ) X-Spam-Score: -2.8 (--) X-Spam-Report: SpamAssassin version 3.4.4 on casper.infradead.org summary: Content analysis details: (-2.8 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.7 RCVD_IN_DNSWL_LOW RBL: Sender listed at https://www.dnswl.org/, low trust [212.227.15.15 listed in list.dnswl.org] -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] 0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail provider [j.neuschaefer[at]gmx.net] -0.0 RCVD_IN_MSPIKE_H2 RBL: Average reputation (+2) [212.227.15.15 listed in wl.mailspike.net] 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record -0.0 SPF_PASS SPF: sender matches SPF record -0.1 DKIM_VALID_EF Message has a valid DKIM or DK signature from envelope-from domain 0.1 DKIM_SIGNED Message has a DKIM or DK signature, not necessarily valid -0.1 DKIM_VALID_AU Message has a valid DKIM or DK signature from author's domain -0.1 DKIM_VALID Message has at least one valid DKIM or DK signature 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: Alexandre Belloni , Heiko Stuebner , linux-pwm@vger.kernel.org, Linus Walleij , Thierry Reding , Fabio Estevam , linux-rtc@vger.kernel.org, Mauro Carvalho Chehab , Sam Ravnborg , Andreas Kemnade , NXP Linux Team , =?utf-8?q?Uwe_Kleine-K=C3=B6nig?= , devicetree@vger.kernel.org, Stephan Gerhold , allen , Sascha Hauer , =?utf-8?q?Jonathan_Neusch=C3=A4fer?= , Lubomir Rintel , Rob Herring , Lee Jones , linux-arm-kernel@lists.infradead.org, Alessandro Zummo , Mark Brown , Pengutronix Kernel Team , Heiko Stuebner , Josua Mayer , Shawn Guo , "David S. Miller" Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org For reference, here are the devicetree bindings in plaintext format. (Not for merge.) Signed-off-by: Jonathan Neuschäfer --- .../bindings/mfd/netronix,ntxec.txt | 58 +++++++++++++++++++ .../bindings/pwm/netronix,ntxec-pwm.txt | 27 +++++++++ .../bindings/rtc/netronix,ntxec-rtc.txt | 17 ++++++ 3 files changed, 102 insertions(+) create mode 100644 Documentation/devicetree/bindings/mfd/netronix,ntxec.txt create mode 100644 Documentation/devicetree/bindings/pwm/netronix,ntxec-pwm.txt create mode 100644 Documentation/devicetree/bindings/rtc/netronix,ntxec-rtc.txt -- 2.27.0 diff --git a/Documentation/devicetree/bindings/mfd/netronix,ntxec.txt b/Documentation/devicetree/bindings/mfd/netronix,ntxec.txt new file mode 100644 index 0000000000000..e303932657999 --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/netronix,ntxec.txt @@ -0,0 +1,58 @@ +Netronix Embedded Controller + +This EC is found in e-book readers of multiple brands (e.g. Kobo, Tolino), and +is typically implemented as a TI MSP430 microcontroller. + + +Required properties: +- compatible: should be "netronix,ntxec" +- reg: The I2C address of the EC + +Optional properties: +- system-power-controller: + See Documentation/devicetree/bindings/power/power-controller.txt +- interrupts or interrupts-extended +- interrupt-controller +- #interrupt-cells: Should be 1 + +Optional subnodes: + +Sub-nodes are identified by their compatible string. + + compatible string | description +--------------------------------|-------------------------------------- + netronix,ntxec-pwm | PWM (used for backlight) + netronix,ntxec-rtc | real time clock + + +Example: + +&i2c3 { + pinctrl-names = "default"; + pinctrl-0 = <&pinctrl_i2c3>; + status = "okay"; + + ec: embedded-controller@43 { + pinctrl-names = "default"; + pinctrl-0 = <&pinctrl_ntxec>; + + compatible = "netronix,ntxec"; + reg = <0x43>; + system-power-controller; + interrupt-parent = <&gpio4>; + interrupts = <11 IRQ_TYPE_EDGE_FALLING>; + interrupt-controller; + #interrupt-cells = <1>; + + pwm { + compatible = "netronix,ntxec-pwm"; + #pwm-cells = <1>; + }; + + rtc { + compatible = "netronix,ntxec-rtc"; + interrupts-extended = <&ec 15>; + interrupt-names = "alarm"; + }; + }; +}; diff --git a/Documentation/devicetree/bindings/pwm/netronix,ntxec-pwm.txt b/Documentation/devicetree/bindings/pwm/netronix,ntxec-pwm.txt new file mode 100644 index 0000000000000..50be27f82559e --- /dev/null +++ b/Documentation/devicetree/bindings/pwm/netronix,ntxec-pwm.txt @@ -0,0 +1,27 @@ +PWM functionality in Netronix Embedded Controller + +Required properties: +- compatible: should be "netronix,ntxec-pwm" +- #pwm-cells: should be 1. + +Available PWM channels: +- 0: The PWM channel controlled by registers 0xa1-0xa7 + +Example: + + embedded-controller@43 { + compatible = "netronix,ntxec"; + ... + + ec_pwm: pwm { + compatible = "netronix,ntxec-pwm"; + #pwm-cells = <1>; + }; + }; + + ... + + backlight { + compatible = "pwm-backlight"; + pwms = <&ec_pwm 0 50000>; + }; diff --git a/Documentation/devicetree/bindings/rtc/netronix,ntxec-rtc.txt b/Documentation/devicetree/bindings/rtc/netronix,ntxec-rtc.txt new file mode 100644 index 0000000000000..0ef9e791b6a36 --- /dev/null +++ b/Documentation/devicetree/bindings/rtc/netronix,ntxec-rtc.txt @@ -0,0 +1,17 @@ +Netronix embedded controller RTC + +Required properties: + +- compatible: should be "netronix,ntxec-rtc" + + +Example: + + embedded-controller@43 { + compatible = "netronix,ntxec"; + ... + + rtc { + compatible = "netronix,ntxec-rtc"; + }; + }