Re: [PATCH] gpiolib: Introduce "linux,gpiochip-name" property for device tree of GPIO controller.

From: Szőke Benjamin
Date: Mon May 20 2024 - 12:50:46 EST


2024. 05. 19. 19:27 keltezéssel, Bartosz Golaszewski írta:
On Sun, May 19, 2024 at 4:49 PM <egyszeregy@xxxxxxxxxxx> wrote:

From: Benjamin Szőke <egyszeregy@xxxxxxxxxxx>

Optionally, a GPIO controller may have a "linux,gpiochip-name" property.

Oh, may it really?

$ git grep "linux,gpiochip-name" Documentation/devicetree/bindings/
$

Doesn't look like it.

This is a string which is defining a custom suffix name for gpiochip in
/dev/gpiochip-<name> format. It helps to improve software portability
between various SoCs and reduce complexities of hardware related codes
in SWs.

Signed-off-by: Benjamin Szőke <egyszeregy@xxxxxxxxxxx>
---
drivers/gpio/gpiolib.c | 12 +++++++++++-
1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/drivers/gpio/gpiolib.c b/drivers/gpio/gpiolib.c
index ce94e37bcbee..e24d8db1d054 100644
--- a/drivers/gpio/gpiolib.c
+++ b/drivers/gpio/gpiolib.c
@@ -860,6 +860,7 @@ int gpiochip_add_data_with_key(struct gpio_chip *gc, void *data,
struct lock_class_key *lock_key,
struct lock_class_key *request_key)
{
+ const char *name;
struct gpio_device *gdev;
unsigned int desc_index;
int base = 0;
@@ -896,7 +897,16 @@ int gpiochip_add_data_with_key(struct gpio_chip *gc, void *data,
goto err_free_gdev;
}

- ret = dev_set_name(&gdev->dev, GPIOCHIP_NAME "%d", gdev->id);
+ /*
+ * If "linux,gpiochip-name" is specified in device tree, use /dev/gpiochip-<name>
+ * in Linux userspace, otherwise use /dev/gpiochip<id>.
+ */
+ ret = device_property_read_string(gc->parent, "linux,gpiochip-name", &name);
+ if (ret < 0)
+ ret = dev_set_name(&gdev->dev, GPIOCHIP_NAME "%d", gdev->id);
+ else
+ ret = dev_set_name(&gdev->dev, GPIOCHIP_NAME "-%s", name);
+
if (ret)
goto err_free_ida;

--
2.39.3


NAK, this is udev's task in user-space if you need this.

Bart

Hi,

Goal of this patch is to introduce this new mode to assign a custom name from lowlevel device tree to a gpio bank.

It is more maintainable then use udev in userspace for it.
For example there are three different SoCs: i.MX7, i.MX9, ZynqMP.

In Yocto project, the Linux image's SW environment is nicely configurable independently from what is the target MACHNIE. But if i like to deploy a SW which uses peripheries like gpiobanks, i2c-dev, spidev these /dev/... name will be totally different on each SoCs, more over in ZynqMP and any other Adaptive SoC platform, the index number for the gpiobanks or other can be not deterministic if it probed in run-time. Goal is to easily make a Linux OS image which can support multiple SoCs and in SW point of view it is flexible.

So, in Yocto project point of view the best, if any Machine specific settings is stored in the device tree files of the target MACHNIEs in driver levels/config, because it will be deterministic in 100% sure and it will be nicely separated from the SW meta layers which may not contains any machine specific hacking with udev and so on for building image.

So this way to assign a custom name for a gpiobanks from device tree is more efficient and more maintainable in SW developing point of view in Yocto/buildroot world because i need to just define a name like linux,gpiochip-name = "expander"; then use it with a fixed name in my generic SW under /dev/gpiochip-expander name. And there are no need to care about what will be the index number of this banks randomly after boot and how need to make an ugly append layer for udev and make it for all of machine variants which are the target to use with the same SW.

My opinion udev is ugly to use for it and more complicated, and no longer beneficial for new Adaptive SoCs where they can be not deterministic what kind of index number they got in driver probing (you will not know what index need to mapping for what custom name). It is much better to assign this suffix/name explicitly from device tree.