From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753255AbdJ3XHF (ORCPT ); Mon, 30 Oct 2017 19:07:05 -0400 Received: from mail-io0-f195.google.com ([209.85.223.195]:43134 "EHLO mail-io0-f195.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753131AbdJ3XHB (ORCPT ); Mon, 30 Oct 2017 19:07:01 -0400 X-Google-Smtp-Source: ABhQp+RT8LD2mILdYqbgdjdUYFTnaI2Iq2NjuoM4Z+CeqtowhtiFTNk8kUvgjHM6ozjW3tKWZ9SB7Q== Date: Mon, 30 Oct 2017 16:06:58 -0700 From: Dmitry Torokhov To: Ludovic Desroches Cc: linux-input@vger.kernel.org, linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org, nicolas.ferre@microchip.com, alexandre.belloni@free-electrons.com, linux-kernel@vger.kernel.org Subject: Re: [PATCH v3 1/5] dt-bindings: input: Add Atmel PTC subsystem bindings Message-ID: <20171030230658.csl2sxfrmdcdx3lj@dtor-ws> References: <20171020133121.7992-1-ludovic.desroches@microchip.com> <20171020133121.7992-2-ludovic.desroches@microchip.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20171020133121.7992-2-ludovic.desroches@microchip.com> User-Agent: NeoMutt/20170609 (1.8.3) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi Ludovic, On Fri, Oct 20, 2017 at 03:31:17PM +0200, Ludovic Desroches wrote: > Add description of the Atmel PTC subsystem bindings. > > Signed-off-by: Ludovic Desroches > Acked-by: Rob Herring > --- > .../devicetree/bindings/input/atmel,ptc.txt | 67 ++++++++++++++++++++++ > 1 file changed, 67 insertions(+) > create mode 100644 Documentation/devicetree/bindings/input/atmel,ptc.txt > > diff --git a/Documentation/devicetree/bindings/input/atmel,ptc.txt b/Documentation/devicetree/bindings/input/atmel,ptc.txt > new file mode 100644 > index 000000000000..a183fd511e04 > --- /dev/null > +++ b/Documentation/devicetree/bindings/input/atmel,ptc.txt > @@ -0,0 +1,67 @@ > +Atmel PTC Subsystem > + > +The Atmel Peripheral Touch Controller subsystem offers built-in hardware > +for capacitive touch measurement on sensors that function as buttons, sliders > +and wheels. > + > +1) PTC Subsystem node > + > +Required properties: > +- compatible: Must be "atmel,sama5d2-ptc" > +- reg: Address, length of the shared memory and ppp registers location > + and length. > +- clocks: Phandlers to the clocks. > +- clock-names: Must be "ptc_clk", "ptc_int_osc", "slow_clk". > +- #address-cells: Must be one. The cell is the button or scroller id. > +- #size-cells: Must be zero. > + > +Example: > + ptc@fc060000 { > + compatible = "atmel,sama5d2-ptc"; > + reg = <0x00800000 0x10000 > + 0xfc060000 0xcf>; > + interrupts = <58 IRQ_TYPE_LEVEL_HIGH 7>; > + clocks = <&ptc_clk>, <&main>, <&clk32k>; > + clock-names = "ptc_clk", "ptc_int_osc", "slow_clk"; > + #address-cells = <1>; > + #size-cells = <0>; > + > + [ child node definitions... ] > + }; > + > +2) Scroller / buttons subnodes > + > +Subnodes describe the kind of sensors the customer want to use. They have to be > +named according to their function: button, slider or wheel. I wonder do we really need this? Or we can have a generic: slider@0 { reg = <0>; linux,type = ; linux,code = ; }, vertical-slider@1 { reg = <1>; linux,type = ; linux,code = ; }, wheel@2 { reg = <2>; linux,type = ; linux,code = ; }, button@3 { reg = <3>; linux,type = ; linux,code = ; }, ... I.e. you specify type/code in a generic way. Thanks. -- Dmitry