Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7;
Date:   Mon, 23 Oct 2023 13:53:26 -0500
From:   Jeff LaBundy <jeff@labundy.com>
To:     Anshul Dalal <anshulusr@gmail.com>
Cc:     linux-input@vger.kernel.org, devicetree@vger.kernel.org,
        Dmitry Torokhov <dmitry.torokhov@gmail.com>,
        Rob Herring <robh+dt@kernel.org>,
        Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
        Conor Dooley <conor+dt@kernel.org>,
        Thomas =?iso-8859-1?Q?Wei=DFschuh?= <linux@weissschuh.net>,
        Shuah Khan <skhan@linuxfoundation.org>,
        linux-kernel-mentees@lists.linuxfoundation.org,
        linux-kernel@vger.kernel.org,
        Conor Dooley <conor.dooley@microchip.com>,
        Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Subject: Re: [PATCH v5 1/2] dt-bindings: input: bindings for Adafruit Seesaw
 Gamepad
Message-ID: <ZTbBJnwI5FWYfnFd@nixie71>
References: <20231017034356.1436677-1-anshulusr@gmail.com>
 <ZTW0p2WG3/m1Tx+Z@nixie71>
 <7ef752b4-915b-4f9d-8425-79df8195656b@gmail.com>
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <7ef752b4-915b-4f9d-8425-79df8195656b@gmail.com>
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?gyZCP0N8Vr+3iRXvBNqK5x9MEqWKR4TGiBy5RneGKkBd5e8YoQofLtlsK8pH?=
 =?us-ascii?Q?IDDh9f/63JjnT/COrTfRG6ZolMcfSYpbdkUCA5KJlX7TLMqZWZYAV/8mvA2g?=
 =?us-ascii?Q?nygRav6/jzWlvErC0vQvhDSIy7bMtm7DoV4ASoh/RMZnbMERHYwn4ZcTu2Is?=
 =?us-ascii?Q?DH7oL4T+t2sdSOgyGhwB4gjL9hoogCqyWzfQY66ZBhiCYCV9mGZETUQ0ex8G?=
 =?us-ascii?Q?o7raiP6kUqR9CiJ67DADrTmk/nbpKJN0e6LzHbMkYAp558/LpPWf1gxsz/7c?=
 =?us-ascii?Q?29nnt2xZsZkict5VcmPE5C9CXcdAo+mYCfpwGas4FmMx+t9xJPA4fBlAztqm?=
 =?us-ascii?Q?nwIiZAszExXb7l1RBUv+TDjcSbiEJjn+PRpp4L/aZ3llDHG1UIDEIRh8hT43?=
 =?us-ascii?Q?eTH4Z11MC9QqkGc4iT4IKdGUTA1dooWMMb9mI7QvGrwW95jXhX1R0/PNkYk3?=
 =?us-ascii?Q?kHCA21Iuier/r+9cMgVHVzWsmNtp5wl45WoUn0wKakA6fX4WgtrHd0R7JGL1?=
 =?us-ascii?Q?x/hLRHsUIfUmn6lwEzubNau61R+BAxqTLRhipg/7oDeHu0fOUA+Ag9b5SzTj?=
 =?us-ascii?Q?jPnd4XllMn2zJp0ARitpOrZgd0Gt48ZrGO9cIagykredngmVDY4F8dQvphaU?=
 =?us-ascii?Q?0ql+QyA3M6kUlyCGPpz+JkjeulvYYEg2NBg+spN6c3aDhE2cu5hFmGWW/SpR?=
 =?us-ascii?Q?XTcNpsPApNKC+I4NjQZTEpQ5Vmy9euw6hL19PmtjJQGELuoUR4J66ILuiV3o?=
 =?us-ascii?Q?I0o6paShSmmksPiUa4RTqtNcRLyAlouz1pLOgeVliZ+R7VmEhh0e3whAFHUD?=
 =?us-ascii?Q?BhYSY1+Lkts+IBoWoegKX9lCyk1+lTljpCDhwIsI2NeqLk/ajgS/NFVGoD4w?=
 =?us-ascii?Q?TDI6ZyKOA9nzr+3SLe95xz6ed6x5y+mds01h9FWZeZAbFghcaBFVW1p93zr1?=
 =?us-ascii?Q?RbhNzKRRk48jlsQaSk16qj5rDPah0Z5b71qTNSe2oyX7HAT8HUgOgTgaOh8n?=
 =?us-ascii?Q?u9bSCTjhqna5EihRKfljORRh9W7UdSYZmBAarpqcnoVOX0W2H7TjJ571jFm5?=
 =?us-ascii?Q?pOK5qWKQDLfdp3Z5jnFT9ZvfIv4QBfrstlOuW98Bt4RDvmEnl1dcqJ8kR4sb?=
 =?us-ascii?Q?Pz7zIi2yHTLS3HpsjfCqjFRwHrUAEUY3bUDT0h0O7VeJMfne6j2+Dny1bd6Q?=
 =?us-ascii?Q?mDWxULIjPs0/FZreU8n8nBSGMs4mLcspzkTVqMEFOLsUCSkXQd4SFKDQsnlE?=
 =?us-ascii?Q?Ck1am/8gSfFRe0x8WXggaAun39m6HS5ksxONrt8dD10qxMsdbHO12jKla35/?=
 =?us-ascii?Q?X2V2/UNJ+0c1Md9ttbo1BsRF1dZjziZ8tdImAZdwkFBetR2m/QFnVF6e0eum?=
 =?us-ascii?Q?4SK58gFuci9m8EABgh28UuuLTPc/qs3uyfCr1hNunE7oqcdvuuaRVFqPVsVc?=
 =?us-ascii?Q?usLn+TgOm9iepK/NZOw6e08HDVlpQOrbskt/vLRBE5wLlLavsJItcKaeACP5?=
 =?us-ascii?Q?btTQFLYKaqrWrauW/R/+J+W2VIrHq2533yfI9NJa2tcxUSc5aiPS7RHZ2med?=
 =?us-ascii?Q?LUwHxXgVn5TvTU+yD8S36tGXmhnpTJlorDUoSbQS?=
X-OriginatorOrg: labundy.com
X-MS-Exchange-CrossTenant-Network-Message-Id: b413e3d1-07be-4de8-da2a-08dbd3f95bbb
X-MS-Exchange-CrossTenant-AuthSource: SN4PR0801MB3774.namprd08.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Oct 2023 18:53:34.6584
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 00b69d09-acab-4585-aca7-8fb7c6323e6f
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: R864CUiqm4qz8RyYkYMsQHrzHSIo3SYHjeI/6Bh4SU4kQk59wony3AwLYaa16jXhzfCWZA70Yo/m/JAt96z0bQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH3PR08MB9685
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS
        autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Mon, 23 Oct 2023 11:53:48 -0700 (PDT)

Hi Anshul,

Thank you for this additional information.

On Mon, Oct 23, 2023 at 05:28:10PM +0530, Anshul Dalal wrote:
> Hello Jeff,
> 
> On 10/23/23 05:17, Jeff LaBundy wrote:
> > Hi Anshul,
> > 
> > On Tue, Oct 17, 2023 at 09:13:44AM +0530, Anshul Dalal wrote:
> >> Adds bindings for the Adafruit Seesaw Gamepad.
> >>
> >> The gamepad functions as an i2c device with the default address of 0x50
> >> and has an IRQ pin that can be enabled in the driver to allow for a rising
> >> edge trigger on each button press or joystick movement.
> >>
> >> Product page:
> >>   https://www.adafruit.com/product/5743
> >> Arduino driver:
> >>   https://github.com/adafruit/Adafruit_Seesaw
> >>
> >> Reviewed-by: Conor Dooley <conor.dooley@microchip.com>
> >> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> >> Signed-off-by: Anshul Dalal <anshulusr@gmail.com>
> > 
> > Perhaps this ship has sailed, but is there any reason this simple device
> > cannot be added to Documentation/devicetree/bindings/trivial-devices.yaml
> > as opposed to having its own binding?
> > 
> > It has no vendor-specific properties, and the only properties are the
> > standard properties already understood by the I2C core. In case I have
> > misunderstood, please let me know.
> > 
> 
> The driver currently implements only a subset of the functionality in
> the Adafruit Seesaw specification. I eventually plan on adding adding
> full support for the Seesaw framework in the form of a driver for the
> atsamd09 seesaw breakout board:
> https://learn.adafruit.com/adafruit-seesaw-atsamd09-breakout
> 
> Then I think it would be better for this driver to use the newly exposed
> seesaw APIs by the atsamd09 driver instead of relying on kernel's i2c APIs.

The underlying functions used to implement I2C communication are orthogonal
to the binding. Whether you use the kernel's core I2C support, regmap, or
your own wrappers built on top of either have no bearing on whether or not
a binding is necessary.

The binding is used to define device tree properties that describe the
hardware and its constraints. Classic examples are things such as clock
frequency, regulator voltage, etc. Drivers often translate device tree
properties into register settings.

In the case of this device, the only thing the driver needs to know about
the hardware are its compatible string and I2C client address, both of
which are already supported in the common trivial devices binding [1].

> I would also like to add support for the provided interrupt pin later
> down the line which is documented in the binding along with description
> of the non-standard action button layout.

The trivial devices binding includes interrupts as well; please see [1].
My opinion is that the device's own documentation is responsible for
describing the product and anything unique about its physical layout.

> Above were my reasons for going for a standalone binding, please let me
> know if you disagree.

I don't see any need for a binding for this device because it has no vendor-
specific properties, and the only properties it does have are covered by
existing infrastructure.

My feedback is that this patch can be replaced with at most a two-line patch
to [1]. This is just my $.02; it is ultimately up to the maintainers. The
existing binding, albeit unnecessary, is nicely written either way :)

Kind regards,
Jeff LaBundy

[1] Documentation/devicetree/bindings/trivial-devices.yaml