[PATCH v2 7/9] gpio: sysfs: export the GPIO directory locally in the gpiochip<id> directory

From: Bartosz Golaszewski
Date: Mon Jun 23 2025 - 05:01:49 EST


From: Bartosz Golaszewski <bartosz.golaszewski@xxxxxxxxxx>

As a way to allow the user-space to stop referring to GPIOs by their
global numbers, introduce a parallel group of line attributes for
exported GPIO that live inside the GPIO chip class device and are
referred to by their HW offset within their parent chip.

Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@xxxxxxxxxx>
---
Documentation/ABI/obsolete/sysfs-gpio | 5 +++++
drivers/gpio/gpiolib-sysfs.c | 40 ++++++++++++++++++++++++++++++++++-
2 files changed, 44 insertions(+), 1 deletion(-)

diff --git a/Documentation/ABI/obsolete/sysfs-gpio b/Documentation/ABI/obsolete/sysfs-gpio
index ff694708a3bef787afa42dedf94faf209c44dbf0..c0bb51412a912cefe032c4e84288f99754acb1b5 100644
--- a/Documentation/ABI/obsolete/sysfs-gpio
+++ b/Documentation/ABI/obsolete/sysfs-gpio
@@ -27,6 +27,11 @@ Description:
/base ... (r/o) same as N
/label ... (r/o) descriptive chip name
/ngpio ... (r/o) number of GPIOs; numbered N to N + (ngpio - 1)
+ /gpio<OFFSET>
+ /value ... always readable, writes fail for input GPIOs
+ /direction ... r/w as: in, out (default low); write: high, low
+ /edge ... r/w as: none, falling, rising, both
+ /active-low ... r/w as: 0, 1
/chipX ... for each gpiochip; #X is the gpio device ID
/export ... asks the kernel to export a GPIO at HW offset X to userspace
/unexport ... to return a GPIO at HW offset X to the kernel
diff --git a/drivers/gpio/gpiolib-sysfs.c b/drivers/gpio/gpiolib-sysfs.c
index adf030f74eb163f5d8b1092d00418b84354f923f..37d58009a51333f7d6a8d600dbeaeb333df27ac3 100644
--- a/drivers/gpio/gpiolib-sysfs.c
+++ b/drivers/gpio/gpiolib-sysfs.c
@@ -47,11 +47,13 @@ struct gpiod_data {

struct mutex mutex;
struct kernfs_node *value_class_node;
+ struct kernfs_node *value_chip_node;
int irq;
unsigned char irq_flags;

bool direction_can_change;

+ struct kobject *parent;
struct device_attribute dir_attr;
struct device_attribute val_attr;
struct device_attribute edge_attr;
@@ -180,6 +182,7 @@ static irqreturn_t gpio_sysfs_irq(int irq, void *priv)
struct gpiod_data *data = priv;

sysfs_notify_dirent(data->value_class_node);
+ kernfs_notify(data->value_chip_node);

return IRQ_HANDLED;
}
@@ -780,13 +783,46 @@ int gpiod_export(struct gpio_desc *desc, bool direction_may_change)
gdev_data = gdev_get_data(gdev);
if (!gdev_data) {
status = -ENODEV;
- goto err_unregister_device;
+ goto err_put_dirent;
}

list_add(&desc_data->list, &gdev_data->exported_lines);

+ desc_data->attr_group.name = kasprintf(GFP_KERNEL, "gpio%u",
+ gpio_chip_hwgpio(desc));
+ if (!desc_data->attr_group.name) {
+ status = -ENOMEM;
+ goto err_put_dirent;
+ }
+
+ desc_data->parent = &gdev_data->cdev_id->kobj;
+ status = sysfs_create_groups(desc_data->parent,
+ desc_data->attr_groups);
+ if (status)
+ goto err_free_name;
+
+ char *path __free(kfree) = kasprintf(GFP_KERNEL, "gpio%u/value",
+ gpio_chip_hwgpio(desc));
+ if (!path) {
+ status = -ENOMEM;
+ goto err_remove_groups;
+ }
+
+ desc_data->value_chip_node = kernfs_walk_and_get(desc_data->parent->sd,
+ path);
+ if (!desc_data->value_chip_node) {
+ status = -ENODEV;
+ goto err_remove_groups;
+ }
+
return 0;

+err_remove_groups:
+ sysfs_remove_groups(desc_data->parent, desc_data->attr_groups);
+err_free_name:
+ kfree(desc_data->attr_group.name);
+err_put_dirent:
+ sysfs_put(desc_data->value_class_node);
err_unregister_device:
device_unregister(desc_data->dev);
err_free_data:
@@ -876,6 +912,8 @@ void gpiod_unexport(struct gpio_desc *desc)
clear_bit(FLAG_EXPORT, &desc->flags);
sysfs_put(desc_data->value_class_node);
device_unregister(desc_data->dev);
+ sysfs_remove_groups(desc_data->parent, desc_data->attr_groups);
+ kernfs_put(desc_data->value_chip_node);

/*
* Release irq after deregistration to prevent race with

--
2.48.1