Proposed deprecation of device-tree-gpio-naming.md

[Andrew Geissler]

On Tue, Aug 5, 2025 at 6:54 PM Andrew Jeffery
<andrew at codeconstruct.com.au> wrote:
>
> Hello,
>
> In the comment thread at [1] I've proposed deprecating the directions
> in device-tree-gpio-naming.md[2] for the purpose of describing GPIOs in
> devicetrees. Devicetrees represent the hardware, and from experience
> over time I think it's best that they reflect the information from the
> schematics without influence from software implementation choices.

Yeah agree, it seemed like a good idea at the time but there has been a
lot of friction with this design over time. I know some reviews have simply
been abandoned due to the frustrations of coming up with an agreed to
gpio name. And other reviews have taken an excessive amount of time
to get through.

> However, perhaps it's still a reasonable set of suggestions for
> consumption of pins with the translation from net names done by the
> applications themselves?

If we all agree, I could do one final update to the doc stating it's
been deprecated but feel free to use the existing recommendations
when creating a new system if it makes sense. And another note
indicating some OpenBMC repos may require some work to support
a new GPIO name.