From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-3.6 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE, SPF_PASS,URIBL_BLOCKED autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2616CC43331 for ; Fri, 3 Apr 2020 16:19:06 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id EDE5E20721 for ; Fri, 3 Apr 2020 16:19:05 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="DdFDFz2q" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2403848AbgDCQTF (ORCPT ); Fri, 3 Apr 2020 12:19:05 -0400 Received: from mail-oi1-f193.google.com ([209.85.167.193]:41323 "EHLO mail-oi1-f193.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2403834AbgDCQTF (ORCPT ); Fri, 3 Apr 2020 12:19:05 -0400 Received: by mail-oi1-f193.google.com with SMTP id k9so6562408oia.8; Fri, 03 Apr 2020 09:19:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=vfUcEFpIecfa5phk+Cj5BK1agH676+gFMqNkyPySnNU=; b=DdFDFz2q+lRpwrK421yRNEfez1sLOWU8raR7jvvY4t65RJ615jwCRUugHdjp3QECXD 9DA4Q0scR3LkOWuReNJy0sSDlq9CWoI18F15XqJHgA70pA1+vTdRwywrhjpQRrvnTi0W IsQZLbSGEOkB3r/mu/JNCjQJwqxdRjSP3UmWlPvEsjpKiZNL4QZVA/QzaCYZlzKMoqQj 4/O4fPQ/pFvR9y6uWk5Fj92HR/5uCnjXe1t/LJkam4NgoHlgStWB5nFZNvr1zb3oBQHD 3GMW3cwIyHjpFgV3PIVkl2+JjMM+p0s5BnOQtUVxsUYiruJU44hwkraKGaiurzcYL47T ljsw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=vfUcEFpIecfa5phk+Cj5BK1agH676+gFMqNkyPySnNU=; b=jsf2v5dBqz/zHoHC+eD4c6snEPVXGzi0YDanhI/0u91tsFHOZC0ODANjPZWl0GlBni L8h+jt6/z8Sd6dohK/kDxiMFloS96/F8YemS1sEaYma0D8eStaOMBc/ev20V/sRTJZKn +Dj33N97LpbchqFcbrxgKgFFY41WHnda5CLK7XBn14rM4ZxFLLL/oNooOoXEYtg6+LSM GsRS2wD8e4wBx2MV8QvhPTiER6lzpwHLFkItr7xwM1Ege6Bfl7LWfBbcGB1ge1USXsG6 xwGdwyNlv00HmV/2uZARMILpwpPvBw+MhBAXTEYhXMtMYMzMA+xpEBjlKh7PXNy40+CH RSJw== X-Gm-Message-State: AGi0PuZZf5fAjNec5CjxPlh+oa/t/m2E7Z8Mg55GAChR5AUW3vZqegUT wVWsiPRGWofWBELPjts/bm4= X-Google-Smtp-Source: APiQypLdIe/bnR5Sgh9v1UByIaBo9hKSJA7hdJa7okRoa7dJKQmZWyXte4DCMLxfGDR33+o59+3cYw== X-Received: by 2002:aca:acc2:: with SMTP id v185mr3748001oie.27.1585930744166; Fri, 03 Apr 2020 09:19:04 -0700 (PDT) Received: from andrews-mbp-2.attlocal.net ([2600:1700:19e0:3310:4ee:b6ec:777a:fdfb]) by smtp.gmail.com with ESMTPSA id i17sm2193668otc.16.2020.04.03.09.19.03 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 03 Apr 2020 09:19:03 -0700 (PDT) Content-Type: text/plain; charset=utf-8 Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.80.23.2.2\)) Subject: Re: [PATCH 2/2] ARM: dts: aspeed: zaius: Add gpio line names From: Andrew Geissler In-Reply-To: <48c9bd0e-3b5c-4f76-830f-4b0bd962148b@www.fastmail.com> Date: Fri, 3 Apr 2020 11:19:02 -0500 Cc: Joel Stanley , devicetree , Linux ARM , linux-aspeed , Linux Kernel Mailing List , "open list:GPIO SUBSYSTEM" , OpenBMC Maillist Content-Transfer-Encoding: quoted-printable Message-Id: <270714A1-2910-4B84-86B6-46177F439A52@gmail.com> References: <20200306170218.79698-1-geissonator@yahoo.com> <20200306170218.79698-2-geissonator@yahoo.com> <294a52cd-2f60-41e5-a58f-a74151a83b08@www.fastmail.com> <9360D2B2-8242-4BA1-BF06-8916E87EDE67@gmail.com> <48c9bd0e-3b5c-4f76-830f-4b0bd962148b@www.fastmail.com> To: Andrew Jeffery X-Mailer: Apple Mail (2.3608.80.23.2.2) Sender: linux-gpio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-gpio@vger.kernel.org > On Apr 2, 2020, at 7:51 PM, Andrew Jeffery wrote: >=20 >=20 >=20 > On Tue, 31 Mar 2020, at 04:46, Andrew Geissler wrote: >>=20 >>=20 >>> On Mar 26, 2020, at 6:20 PM, Andrew Jeffery wrote: >>>=20 >>>=20 >>>=20 >>> On Sat, 7 Mar 2020, at 03:32, Andrew Geissler wrote: >>>> Name the GPIOs to help userspace work with them. The names describe = the >>>> functionality the lines provide, not the net or ball name. This = makes it >>>> easier to share userspace code across different systems and makes = the >>>> use of the lines more obvious. >>>>=20 >>>> Signed-off-by: Andrew Geissler >>>=20 >>> So we're creating a bit of an ad-hoc ABI here between the DT and = userspace. >>>=20 >>> Where are we documenting it? >>=20 >> Yeah, so far it=E2=80=99s basically design by precedent. If you want = your OpenBMC >> function to work then follow the standards we're setting in other = dts=E2=80=99s. >>=20 >> Is there a good place to document this? I could create a OpenBMC = design >> doc but that would not address non-OpenBMC areas. >=20 > Don't let perfect be the enemy of good enough :) Lets document it in = OpenBMC > and then look at alternatives if we find it's necessary. I don't think = we will given > that the contract is between the kernel and OpenBMC userspace. Ok, I put a doc up for review here: https://gerrit.openbmc-project.xyz/c/openbmc/docs/+/30988 >=20 > Andrew