From patchwork Tue Dec 22 08:56:31 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marek Szyprowski X-Patchwork-Id: 346619 Delivered-To: patch@linaro.org Received: by 2002:a02:85a7:0:0:0:0:0 with SMTP id d36csp5151043jai; Tue, 22 Dec 2020 00:56:50 -0800 (PST) X-Google-Smtp-Source: ABdhPJzVt+/NA7eqlMuyXdUrEgRY2M2r/x7bau8NpgQTPcJ8pJwN4t2eq7IOla2+RGSAiS3sjAfq X-Received: by 2002:a50:eb97:: with SMTP id y23mr19494977edr.29.1608627410758; Tue, 22 Dec 2020 00:56:50 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1608627410; cv=none; d=google.com; s=arc-20160816; b=g8H2Ta1evAuEgCOydFJv3imL692k82EObDvpRA8M5JV/IwXpMVX6M+7OQ4bDhHwvZ2 FAFEhAzgl1JYE/1Yvb4mgJJqJtQPU2QJmqHkMWnKlfqrnrSobTAnDD2YGnRk+qRspEuP Lo6dMUEZj0VmaVAn2V+dHDJI7LYx0TGovSVG+vY2PHRo/GFnvY/mqjhc30D1Ojjb9JTR D8bhsEq63uKu4E7D4PGvBMQumpN51NFeFIjgCz7+8h4qzIpYQJjrwEvvY9OQlinqDj7A 78TOA/9AdsuuJpCD2gDUvy/4GD8Kw0rVeIxBLU5L/tapkaZsd4ZmqYjRfF/d6XBt3pWH MlbQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:references:cms-type:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature:dkim-filter; bh=o3oRQgy84pGZQHmcfx24s54l/T55xXFJm08YfQYT5x0=; b=WSwojRHQAoQihe6tOHRhn/r5nY7gxkcYw812ok1TkvOKr21TI7YxjCKQJKwXNw9CA4 lyultymWkTGOGi88w0RkLbGN4y9Otsqm7DphdL2U2lFIm0Unxdk60ZiEDEckGbcs6g7D KJmRu0ghPxVPiMNpeSPE0F1T8J7Sh5H5cuVs8zWffKtrRoyKeuwndTrLdP3PmlQl5rTv WAW8tUjxgLhERaxmhyaoczYoV3z3lVhpWVKkkZxrIDOtiiyXty/3frTyHIMoLY0lNTHG 6Zi3BbqnU8VZs3lOmiUk10z+qYjXiOMnCfRRaXIsohkcKypaQLfNkHXX1AHh2lc/tWo+ nn7w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@samsung.com header.s=mail20170921 header.b=XKEpKMPs; spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) smtp.mailfrom=u-boot-bounces@lists.denx.de; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=samsung.com Return-Path: Received: from phobos.denx.de (phobos.denx.de. [2a01:238:438b:c500:173d:9f52:ddab:ee01]) by mx.google.com with ESMTPS id x9si9742739eje.134.2020.12.22.00.56.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 22 Dec 2020 00:56:50 -0800 (PST) Received-SPF: pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) client-ip=2a01:238:438b:c500:173d:9f52:ddab:ee01; Authentication-Results: mx.google.com; dkim=pass header.i=@samsung.com header.s=mail20170921 header.b=XKEpKMPs; spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) smtp.mailfrom=u-boot-bounces@lists.denx.de; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=samsung.com Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 1358882A1F; Tue, 22 Dec 2020 09:56:47 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=samsung.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; unprotected) header.d=samsung.com header.i=@samsung.com header.b="XKEpKMPs"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id D42D082A2D; Tue, 22 Dec 2020 09:56:44 +0100 (CET) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de X-Spam-Level: X-Spam-Status: No, score=-7.0 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,RCVD_IN_DNSWL_HI, RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,SPF_HELO_PASS autolearn=ham autolearn_force=no version=3.4.2 Received: from mailout2.w1.samsung.com (mailout2.w1.samsung.com [210.118.77.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 03E3582A1F for ; Tue, 22 Dec 2020 09:56:41 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=samsung.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=m.szyprowski@samsung.com Received: from eucas1p1.samsung.com (unknown [182.198.249.206]) by mailout2.w1.samsung.com (KnoxPortal) with ESMTP id 20201222085639euoutp02179d5842b2ad2278d9435bc25d4b93a7~S-hjeK3xC0258702587euoutp02F for ; Tue, 22 Dec 2020 08:56:39 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 mailout2.w1.samsung.com 20201222085639euoutp02179d5842b2ad2278d9435bc25d4b93a7~S-hjeK3xC0258702587euoutp02F DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=samsung.com; s=mail20170921; t=1608627399; bh=o3oRQgy84pGZQHmcfx24s54l/T55xXFJm08YfQYT5x0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=XKEpKMPsaDsL2NOFv7phlcN0dReb3q+YvsYSBxF2vJA3GNmqAgMN+ySfvf38n1nsf 1mP48laUmBihpeia8s9PgPRUw2rjTHSmZ8hmrOdjm2CCQPW2kXuDxk2SbOGtLADtQ2 ONzwXitl//Dme2ImEjKaNIlMATffvBWnZ5BiFpsE= Received: from eusmges1new.samsung.com (unknown [203.254.199.242]) by eucas1p2.samsung.com (KnoxPortal) with ESMTP id 20201222085639eucas1p21f8ab98c6b6777d05ce8dde6978b79d0~S-hjH56xO2448524485eucas1p2C; Tue, 22 Dec 2020 08:56:39 +0000 (GMT) Received: from eucas1p2.samsung.com ( [182.198.249.207]) by eusmges1new.samsung.com (EUCPMTA) with SMTP id B9.03.27958.7C4B1EF5; Tue, 22 Dec 2020 08:56:39 +0000 (GMT) Received: from eusmtrp2.samsung.com (unknown [182.198.249.139]) by eucas1p1.samsung.com (KnoxPortal) with ESMTPA id 20201222085638eucas1p14d9d9da136593a12fea0140c403095c4~S-hit8TRB0034000340eucas1p1p; Tue, 22 Dec 2020 08:56:38 +0000 (GMT) Received: from eusmgms2.samsung.com (unknown [182.198.249.180]) by eusmtrp2.samsung.com (KnoxPortal) with ESMTP id 20201222085638eusmtrp2cfe03a9a68cce23944078f8f4fffb86b~S-hitTfyk3111631116eusmtrp2i; Tue, 22 Dec 2020 08:56:38 +0000 (GMT) X-AuditID: cbfec7f2-efdff70000006d36-5e-5fe1b4c7eac3 Received: from eusmtip1.samsung.com ( [203.254.199.221]) by eusmgms2.samsung.com (EUCPMTA) with SMTP id 0F.97.16282.6C4B1EF5; Tue, 22 Dec 2020 08:56:38 +0000 (GMT) Received: from AMDC2765.digital.local (unknown [106.120.51.73]) by eusmtip1.samsung.com (KnoxPortal) with ESMTPA id 20201222085638eusmtip1b00e6f4637a1671389dca58d29094c66~S-hiLL6jF2627626276eusmtip1A; Tue, 22 Dec 2020 08:56:38 +0000 (GMT) From: Marek Szyprowski To: u-boot@lists.denx.de, u-boot-amlogic@groups.io Cc: Marek Szyprowski , Neil Armstrong , Lukasz Majewski , Philippe Reynes , Simon Glass , Heinrich Schuchardt , Jaehoon Chung , Bartlomiej Zolnierkiewicz Subject: [PATCH v4 1/3] dt-bindings: input: adc-keys bindings documentation Date: Tue, 22 Dec 2020 09:56:31 +0100 Message-Id: <20201222085633.10194-2-m.szyprowski@samsung.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20201222085633.10194-1-m.szyprowski@samsung.com> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFupkleLIzCtJLcpLzFFi42LZduzned3jWx7GG8yZxm+xccZ6Vosbv9pY LZ6/u8xksfbIXXaLQ33RFh2HlS2+bdnGaDFpwi82i7d7O9ktDk/9wOjA5fH+Riu7x+yGiywe 82adYPH48DHOY37ndyaPs3d2MHr0bVnF6LFx2QHmAI4oLpuU1JzMstQifbsErozzbyewFNzn q3hzbx9rA2M/TxcjJ4eEgInEhebVTF2MXBxCAisYJT6f3cYEkhAS+MIosfmPCUTiM6PEm1u/ WLoYOcA6PrzihogvZ5T4vm4iC4QD1LCytYUNpJtNwFCi620XmC0iYCRxqWkHWBGzwB0mia7J DSwgCWEBb4mej7dYQaayCKhKvJ0VDRLmFbCVmPm5kR3iPHmJ1RsOMIPYnAJ2EhemvGKFiB/h kDj8VxrCdpF4cb+PEcIWlnh1fAtUr4zE/53zwV6TEGhmlHh4bi07hNPDKHG5aQZUh7XEnXO/ 2ECOYBbQlFi/Sx8i7CjRd/gMK8THfBI33gqChJmBzEnbpjNDhHklOtqEIKrVJGYdXwe39uCF S8wQtofE7gPtrJDwmcgosfFzI/MERvlZCMsWMDKuYhRPLS3OTU8tNsxLLdcrTswtLs1L10vO z93ECEwtp/8d/7SDce6rj3qHGJk4GA8xSnAwK4nwmkndjxfiTUmsrEotyo8vKs1JLT7EKM3B oiTOu2r2mnghgfTEktTs1NSC1CKYLBMHp1QDU3rax4XVE8oEzb3X2W86L7P6DceuKJ5ogXVm M7gDsnnW7Jji+ip1+Sw5FyO1Y2VzlqbvE/AtSjY/u2QRqyvr/BdPmO24XoseX8Wo964oOMTZ 9ZGP6JO+kyt0HsirR7T0npxx8K3k2wyH3w9ctI2F4hOvFGxwCA4QEA64f+ZatVOS1LKPp75F Si0sbep8cOpIb2m2QaZBhN/zmFaD43x9Tw9MEFOY9Gv+pe6linZLQvnk7PRmGRVk7dJZkym3 +v5OO+E9ifXrLQziPW4obDIVVfHx+W3iPM2qWeC6z1fJG/xJoS+nS/CtmxZ+XGuZyFeetxsD CgovF+3le/WiIZHZZY/X54QXzTM/2RzaxPFbiaU4I9FQi7moOBEAf8WHCpwDAAA= X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrNLMWRmVeSWpSXmKPExsVy+t/xu7rHtjyMN1g3Wddi44z1rBY3frWx Wjx/d5nJYu2Ru+wWh/qiLToOK1t827KN0WLShF9sFm/3drJbHJ76gdGBy+P9jVZ2j9kNF1k8 5s06weLx4WOcx/zO70weZ+/sYPTo27KK0WPjsgPMARxRejZF+aUlqQoZ+cUltkrRhhZGeoaW FnpGJpZ6hsbmsVZGpkr6djYpqTmZZalF+nYJehnn305gKbjPV/Hm3j7WBsZ+ni5GDg4JAROJ D6+4uxi5OIQEljJK/HjUxNrFyAkUl5E4Oa0ByhaW+HOtiw2i6BOjxNp/p5hBEmwChhJdb0ES nBwiQINOdl1iBSliFnjEJPG0q5kdJCEs4C3R8/EWK8g2FgFVibezokHCvAK2EjM/N7JDLJCX WL3hANhMTgE7iQtTXoEtFgKqufd2C9sERr4FjAyrGEVSS4tz03OLjfSKE3OLS/PS9ZLzczcx AkN927GfW3Ywrnz1Ue8QIxMH4yFGCQ5mJRFeM6n78UK8KYmVValF+fFFpTmpxYcYTYHOmMgs JZqcD4y2vJJ4QzMDU0MTM0sDU0szYyVxXpMja+KFBNITS1KzU1MLUotg+pg4OKUamLLk3scm cuwvmuBWUSWn6VlR+sbk85Hbr55s4uqOvGa0g3+PZGYYe8qltwfF1f7rzmiefPOuwsnSxJff ZSTStep/TNE4/tCoXjZmV9lV21fV/06uMSkw4XnjouBUyfr/58USaY7Db3l/LhD73erZIl01 2W4pS1AjF+cDN/mpjGpxrF5rz2i6bjy9jmXxpez3nJIXniy8O+nioV41g9TAS0eZNXp5Pnp4 d9yQ0Zw0be2tkukv3h8u9ZSKEPPdXl4mfdfJxHMiT+mp6O1yNS+miexJe5/fprXPnL/fxLWh cZHQAyfes4u9uKcH3wioXusRmhwdUyCS1jRplodpCp8c97nePrH3f6yOfeXom+uoxFKckWio xVxUnAgAlZ7hSv4CAAA= X-CMS-MailID: 20201222085638eucas1p14d9d9da136593a12fea0140c403095c4 X-Msg-Generator: CA X-RootMTR: 20201222085638eucas1p14d9d9da136593a12fea0140c403095c4 X-EPHeader: CA CMS-TYPE: 201P X-CMS-RootMailID: 20201222085638eucas1p14d9d9da136593a12fea0140c403095c4 References: <20201222085633.10194-1-m.szyprowski@samsung.com> X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.34 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.102.3 at phobos.denx.de X-Virus-Status: Clean Dump adc-keys bindings documentation from Linux kernel source tree v5.10. Signed-off-by: Marek Szyprowski --- doc/device-tree-bindings/input/adc-keys.txt | 49 +++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 doc/device-tree-bindings/input/adc-keys.txt -- 2.17.1 diff --git a/doc/device-tree-bindings/input/adc-keys.txt b/doc/device-tree-bindings/input/adc-keys.txt new file mode 100644 index 0000000000..e551814629 --- /dev/null +++ b/doc/device-tree-bindings/input/adc-keys.txt @@ -0,0 +1,49 @@ +ADC attached resistor ladder buttons +------------------------------------ + +Required properties: + - compatible: "adc-keys" + - io-channels: Phandle to an ADC channel + - io-channel-names = "buttons"; + - keyup-threshold-microvolt: Voltage at which all the keys are considered up. + +Optional properties: + - poll-interval: Poll interval time in milliseconds + - autorepeat: Boolean, Enable auto repeat feature of Linux input + subsystem. + +Each button (key) is represented as a sub-node of "adc-keys": + +Required subnode-properties: + - label: Descriptive name of the key. + - linux,code: Keycode to emit. + - press-threshold-microvolt: Voltage ADC input when this key is pressed. + +Example: + +#include + + adc-keys { + compatible = "adc-keys"; + io-channels = <&lradc 0>; + io-channel-names = "buttons"; + keyup-threshold-microvolt = <2000000>; + + button-up { + label = "Volume Up"; + linux,code = ; + press-threshold-microvolt = <1500000>; + }; + + button-down { + label = "Volume Down"; + linux,code = ; + press-threshold-microvolt = <1000000>; + }; + + button-enter { + label = "Enter"; + linux,code = ; + press-threshold-microvolt = <500000>; + }; + };