linux-toradex.git/include/linux/gpio/driver.h, branch v6.7-rc1

gpiolib: remove gpiochip_find()

2023-11-04T09:22:52+00:00

With all users of gpiochip_find() converted to using gpio_device_find(),
we can now remove this function from the kernel.

Signed-off-by: Bartosz Golaszewski 
Reviewed-by: Andy Shevchenko 
Reviewed-by: Linus Walleij

gpiolib: provide gpio_device_get_base()

2023-10-13T07:05:57+00:00

Let's start adding getters for the opaque struct gpio_device. Start with
a function allowing to retrieve the base GPIO number.

Signed-off-by: Bartosz Golaszewski 
Acked-by: Linus Walleij

gpiolib: provide gpiod_to_gpio_device()

2023-10-13T06:50:04+00:00

Accessing struct gpio_chip backing a GPIO device is only allowed for the
actual providers of that chip.

Similarly to how we introduced gpio_device_find() in order to replace
the abused gpiochip_find(), let's introduce a counterpart to
gpiod_to_chip() that returns a reference to the GPIO device owning the
descriptor. This is done in order to later remove gpiod_to_chip()
entirely.

Signed-off-by: Bartosz Golaszewski 
Reviewed-by: Peter Rosin 
Acked-by: Linus Walleij

gpiolib: provide gpio_device_to_device()

2023-10-13T06:50:01+00:00

There are users in the kernel who need to retrieve the address of the
struct device backing the GPIO device. Currently they needlessly poke in
the internals of GPIOLIB. Add a dedicated getter function.

Signed-off-by: Bartosz Golaszewski 
Reviewed-by: Peter Rosin 
Reviewed-by: Andy Shevchenko 
Acked-by: Linus Walleij

gpiolib: provide gpio_device_find_by_fwnode()

2023-10-12T08:36:39+00:00

One of the ways of looking up GPIO devices is using their fwnode.
Provide a helper for that to avoid every user implementing their
own matching function.

Reviewed-by: Dipen Patel 
Tested-by: Dipen Patel 
Reviewed-by: Linus Walleij 
Link: https://lore.kernel.org/r/20231010151709.4104747-2-andriy.shevchenko@linux.intel.com
Signed-off-by: Andy Shevchenko 
Signed-off-by: Bartosz Golaszewski

gpiolib: reluctantly provide gpio_device_get_chip()

2023-10-04T11:30:15+00:00

The process of converting all unauthorized users of struct gpio_chip to
using dedicated struct gpio_device function will be long so in the
meantime we must provide a way of retrieving the pointer to struct
gpio_chip from a GPIO device.

Signed-off-by: Bartosz Golaszewski 
Reviewed-by: Linus Walleij

gpiolib: provide gpio_device_get_desc()

2023-10-04T11:29:56+00:00

Getting the GPIO descriptor directly from the gpio_chip struct is
dangerous as we don't take the reference to the underlying GPIO device.
In order to start working towards removing gpiochip_get_desc(), let's
provide a safer variant that works with an existing reference to struct
gpio_device.

Signed-off-by: Bartosz Golaszewski 
Reviewed-by: Linus Walleij

gpiolib: provide gpio_device_find_by_label()

2023-10-04T11:29:45+00:00

By far the most common way of looking up GPIO devices is using their
label. Provide a helpers for that to avoid every user implementing their
own matching function.

Signed-off-by: Bartosz Golaszewski 
Reviewed-by: Linus Walleij

gpiolib: provide gpio_device_find()

2023-10-04T11:29:31+00:00

gpiochip_find() is wrong and its kernel doc is misleading as the
function doesn't return a reference to the gpio_chip but just a raw
pointer. The chip itself is not guaranteed to stay alive, in fact it can
be deleted at any point. Also: other than GPIO drivers themselves,
nobody else has any business accessing gpio_chip structs.

Provide a new gpio_device_find() function that returns a real reference
to the opaque gpio_device structure that is guaranteed to stay alive for
as long as there are active users of it.

Signed-off-by: Bartosz Golaszewski 
Reviewed-by: Linus Walleij

gpiolib: add support for scope-based management to gpio_device

2023-10-04T11:29:16+00:00

As the few users that need to get the reference to the GPIO device often
release it right after inspecting its properties, let's add support for
the automatic reference release to struct gpio_device.

Signed-off-by: Bartosz Golaszewski 
Reviewed-by: Linus Walleij 
Reviewed-by: Andy Shevchenko