1 /* SPDX-License-Identifier: GPL-2.0 */
11 #include <linux/gpio/driver.h>
12 #include <linux/gpio/consumer.h>
14 /* Platforms may implement their GPIO interface with library code,
15  * at a small performance cost for non-inlined operations and some
16  * extra memory (for code and for per-GPIO table entries).
18  * While the GPIO programming interface defines valid GPIO numbers
20  * smaller range 0..ARCH_NR_GPIOS-1.
23  * builtin/SoC GPIOs plus a number of GPIOs on expanders; the latter is
24  * actually an estimate of a board-specific value.
36  * "valid" GPIO numbers are nonnegative and may be passed to
40  * Invalid GPIO numbers are useful for indicating no-such-GPIO in
50 struct gpio;
56 /* caller holds gpio_lock *OR* gpio is marked as requested */
57 static inline struct gpio_chip *gpio_to_chip(unsigned gpio)  in gpio_to_chip()  argument
59 	return gpiod_to_chip(gpio_to_desc(gpio));  in gpio_to_chip()
62 /* Always use the library code for GPIO management calls,
65 extern int gpio_request(unsigned gpio, const char *label);
66 extern void gpio_free(unsigned gpio);
68 static inline int gpio_direction_input(unsigned gpio)  in gpio_direction_input()  argument
70 	return gpiod_direction_input(gpio_to_desc(gpio));  in gpio_direction_input()
72 static inline int gpio_direction_output(unsigned gpio, int value)  in gpio_direction_output()  argument
74 	return gpiod_direction_output_raw(gpio_to_desc(gpio), value);  in gpio_direction_output()
77 static inline int gpio_set_debounce(unsigned gpio, unsigned debounce)  in gpio_set_debounce()  argument
79 	return gpiod_set_debounce(gpio_to_desc(gpio), debounce);  in gpio_set_debounce()
82 static inline int gpio_get_value_cansleep(unsigned gpio)  in gpio_get_value_cansleep()  argument
84 	return gpiod_get_raw_value_cansleep(gpio_to_desc(gpio));  in gpio_get_value_cansleep()
86 static inline void gpio_set_value_cansleep(unsigned gpio, int value)  in gpio_set_value_cansleep()  argument
88 	return gpiod_set_raw_value_cansleep(gpio_to_desc(gpio), value);  in gpio_set_value_cansleep()
92 /* A platform's <asm/gpio.h> code may want to inline the I/O calls when
93  * the GPIO is constant and refers to some always-present controller,
96 static inline int __gpio_get_value(unsigned gpio)  in __gpio_get_value()  argument
98 	return gpiod_get_raw_value(gpio_to_desc(gpio));  in __gpio_get_value()
100 static inline void __gpio_set_value(unsigned gpio, int value)  in __gpio_set_value()  argument
102 	return gpiod_set_raw_value(gpio_to_desc(gpio), value);  in __gpio_set_value()
105 static inline int __gpio_cansleep(unsigned gpio)  in __gpio_cansleep()  argument
107 	return gpiod_cansleep(gpio_to_desc(gpio));  in __gpio_cansleep()
110 static inline int __gpio_to_irq(unsigned gpio)  in __gpio_to_irq()  argument
112 	return gpiod_to_irq(gpio_to_desc(gpio));  in __gpio_to_irq()
115 extern int gpio_request_one(unsigned gpio, unsigned long flags, const char *label);
116 extern int gpio_request_array(const struct gpio *array, size_t num);
117 extern void gpio_free_array(const struct gpio *array, size_t num);
120  * A sysfs interface can be exported by individual drivers if they want,
123 static inline int gpio_export(unsigned gpio, bool direction_may_change)  in gpio_export()  argument
125 	return gpiod_export(gpio_to_desc(gpio), direction_may_change);  in gpio_export()
129 				   unsigned gpio)  in gpio_export_link()  argument
131 	return gpiod_export_link(dev, name, gpio_to_desc(gpio));  in gpio_export_link()
134 static inline void gpio_unexport(unsigned gpio)  in gpio_unexport()  argument
136 	gpiod_unexport(gpio_to_desc(gpio));  in gpio_unexport()
145 	/* only non-negative numbers are valid */  in gpio_is_valid()
153 static inline int gpio_cansleep(unsigned gpio)  in gpio_cansleep()  argument
158 static inline int gpio_get_value_cansleep(unsigned gpio)  in gpio_get_value_cansleep()  argument
161 	return __gpio_get_value(gpio);  in gpio_get_value_cansleep()
164 static inline void gpio_set_value_cansleep(unsigned gpio, int value)  in gpio_set_value_cansleep()  argument
167 	__gpio_set_value(gpio, value);  in gpio_set_value_cansleep()