xref: /openbmc/linux/include/linux/gpio.h (revision 403c1d0b)
17560fa60SDavid Brownell #ifndef __LINUX_GPIO_H
27560fa60SDavid Brownell #define __LINUX_GPIO_H
37560fa60SDavid Brownell 
47563bbf8SMark Brown #include <linux/errno.h>
57563bbf8SMark Brown 
67560fa60SDavid Brownell /* see Documentation/gpio.txt */
77560fa60SDavid Brownell 
8c001fb72SRandy Dunlap /* make these flag values available regardless of GPIO kconfig options */
9c001fb72SRandy Dunlap #define GPIOF_DIR_OUT	(0 << 0)
10c001fb72SRandy Dunlap #define GPIOF_DIR_IN	(1 << 0)
11c001fb72SRandy Dunlap 
12c001fb72SRandy Dunlap #define GPIOF_INIT_LOW	(0 << 1)
13c001fb72SRandy Dunlap #define GPIOF_INIT_HIGH	(1 << 1)
14c001fb72SRandy Dunlap 
15c001fb72SRandy Dunlap #define GPIOF_IN		(GPIOF_DIR_IN)
16c001fb72SRandy Dunlap #define GPIOF_OUT_INIT_LOW	(GPIOF_DIR_OUT | GPIOF_INIT_LOW)
17c001fb72SRandy Dunlap #define GPIOF_OUT_INIT_HIGH	(GPIOF_DIR_OUT | GPIOF_INIT_HIGH)
18c001fb72SRandy Dunlap 
1979a9becdSAlexandre Courbot /* Gpio pin is active-low */
2079a9becdSAlexandre Courbot #define GPIOF_ACTIVE_LOW        (1 << 2)
2179a9becdSAlexandre Courbot 
22aca5ce14SLaxman Dewangan /* Gpio pin is open drain */
2379a9becdSAlexandre Courbot #define GPIOF_OPEN_DRAIN	(1 << 3)
24aca5ce14SLaxman Dewangan 
2525553ff0SLaxman Dewangan /* Gpio pin is open source */
2679a9becdSAlexandre Courbot #define GPIOF_OPEN_SOURCE	(1 << 4)
2725553ff0SLaxman Dewangan 
2879a9becdSAlexandre Courbot #define GPIOF_EXPORT		(1 << 5)
2979a9becdSAlexandre Courbot #define GPIOF_EXPORT_CHANGEABLE	(1 << 6)
30fc3a1f04SWolfram Sang #define GPIOF_EXPORT_DIR_FIXED	(GPIOF_EXPORT)
31fc3a1f04SWolfram Sang #define GPIOF_EXPORT_DIR_CHANGEABLE (GPIOF_EXPORT | GPIOF_EXPORT_CHANGEABLE)
32fc3a1f04SWolfram Sang 
33feb83699SMark Brown /**
34feb83699SMark Brown  * struct gpio - a structure describing a GPIO with configuration
35feb83699SMark Brown  * @gpio:	the GPIO number
36feb83699SMark Brown  * @flags:	GPIO configuration as specified by GPIOF_*
37feb83699SMark Brown  * @label:	a literal description string of this GPIO
38feb83699SMark Brown  */
39feb83699SMark Brown struct gpio {
40feb83699SMark Brown 	unsigned	gpio;
41feb83699SMark Brown 	unsigned long	flags;
42feb83699SMark Brown 	const char	*label;
43feb83699SMark Brown };
44feb83699SMark Brown 
4576ec9d18SAlexandre Courbot #ifdef CONFIG_GPIOLIB
467563bbf8SMark Brown 
477563bbf8SMark Brown #ifdef CONFIG_ARCH_HAVE_CUSTOM_GPIO_H
487560fa60SDavid Brownell #include <asm/gpio.h>
497563bbf8SMark Brown #else
507563bbf8SMark Brown 
517563bbf8SMark Brown #include <asm-generic/gpio.h>
527563bbf8SMark Brown 
537563bbf8SMark Brown static inline int gpio_get_value(unsigned int gpio)
547563bbf8SMark Brown {
557563bbf8SMark Brown 	return __gpio_get_value(gpio);
567563bbf8SMark Brown }
577563bbf8SMark Brown 
587563bbf8SMark Brown static inline void gpio_set_value(unsigned int gpio, int value)
597563bbf8SMark Brown {
607563bbf8SMark Brown 	__gpio_set_value(gpio, value);
617563bbf8SMark Brown }
627563bbf8SMark Brown 
637563bbf8SMark Brown static inline int gpio_cansleep(unsigned int gpio)
647563bbf8SMark Brown {
657563bbf8SMark Brown 	return __gpio_cansleep(gpio);
667563bbf8SMark Brown }
677563bbf8SMark Brown 
687563bbf8SMark Brown static inline int gpio_to_irq(unsigned int gpio)
697563bbf8SMark Brown {
707563bbf8SMark Brown 	return __gpio_to_irq(gpio);
717563bbf8SMark Brown }
727563bbf8SMark Brown 
737563bbf8SMark Brown static inline int irq_to_gpio(unsigned int irq)
747563bbf8SMark Brown {
757563bbf8SMark Brown 	return -EINVAL;
767563bbf8SMark Brown }
777563bbf8SMark Brown 
78165adc9cSLinus Walleij #endif /* ! CONFIG_ARCH_HAVE_CUSTOM_GPIO_H */
797560fa60SDavid Brownell 
80403c1d0bSLinus Walleij /* CONFIG_GPIOLIB: bindings for managed devices that want to request gpios */
81403c1d0bSLinus Walleij 
82403c1d0bSLinus Walleij struct device;
83403c1d0bSLinus Walleij 
84403c1d0bSLinus Walleij int devm_gpio_request(struct device *dev, unsigned gpio, const char *label);
85403c1d0bSLinus Walleij int devm_gpio_request_one(struct device *dev, unsigned gpio,
86403c1d0bSLinus Walleij 			  unsigned long flags, const char *label);
87403c1d0bSLinus Walleij void devm_gpio_free(struct device *dev, unsigned int gpio);
88403c1d0bSLinus Walleij 
8976ec9d18SAlexandre Courbot #else /* ! CONFIG_GPIOLIB */
907560fa60SDavid Brownell 
913d599d1cSUwe Kleine-König #include <linux/kernel.h>
926ea0205bSDavid Brownell #include <linux/types.h>
936ea0205bSDavid Brownell #include <linux/errno.h>
94187f1882SPaul Gortmaker #include <linux/bug.h>
956ea0205bSDavid Brownell 
96a4177ee7SJani Nikula struct device;
974e4438b8SAnton Vorontsov struct gpio_chip;
98a4177ee7SJani Nikula 
993474cb3cSJoe Perches static inline bool gpio_is_valid(int number)
1007560fa60SDavid Brownell {
1013474cb3cSJoe Perches 	return false;
1027560fa60SDavid Brownell }
1037560fa60SDavid Brownell 
104d8a3515eSLinus Torvalds static inline int gpio_request(unsigned gpio, const char *label)
1057560fa60SDavid Brownell {
1067560fa60SDavid Brownell 	return -ENOSYS;
1077560fa60SDavid Brownell }
1087560fa60SDavid Brownell 
109323b7fe8SWolfram Sang static inline int gpio_request_one(unsigned gpio,
1105f829e40SWolfram Sang 					unsigned long flags, const char *label)
1115f829e40SWolfram Sang {
1125f829e40SWolfram Sang 	return -ENOSYS;
1135f829e40SWolfram Sang }
1145f829e40SWolfram Sang 
1157c295975SLars-Peter Clausen static inline int gpio_request_array(const struct gpio *array, size_t num)
1165f829e40SWolfram Sang {
1175f829e40SWolfram Sang 	return -ENOSYS;
1185f829e40SWolfram Sang }
1195f829e40SWolfram Sang 
1207560fa60SDavid Brownell static inline void gpio_free(unsigned gpio)
1217560fa60SDavid Brownell {
1223d599d1cSUwe Kleine-König 	might_sleep();
1233d599d1cSUwe Kleine-König 
1247560fa60SDavid Brownell 	/* GPIO can never have been requested */
1257560fa60SDavid Brownell 	WARN_ON(1);
1267560fa60SDavid Brownell }
1277560fa60SDavid Brownell 
1287c295975SLars-Peter Clausen static inline void gpio_free_array(const struct gpio *array, size_t num)
1295f829e40SWolfram Sang {
1305f829e40SWolfram Sang 	might_sleep();
1315f829e40SWolfram Sang 
1325f829e40SWolfram Sang 	/* GPIO can never have been requested */
1335f829e40SWolfram Sang 	WARN_ON(1);
1345f829e40SWolfram Sang }
1355f829e40SWolfram Sang 
136d8a3515eSLinus Torvalds static inline int gpio_direction_input(unsigned gpio)
1377560fa60SDavid Brownell {
1387560fa60SDavid Brownell 	return -ENOSYS;
1397560fa60SDavid Brownell }
1407560fa60SDavid Brownell 
141d8a3515eSLinus Torvalds static inline int gpio_direction_output(unsigned gpio, int value)
1427560fa60SDavid Brownell {
1437560fa60SDavid Brownell 	return -ENOSYS;
1447560fa60SDavid Brownell }
1457560fa60SDavid Brownell 
146c4b5be98SFelipe Balbi static inline int gpio_set_debounce(unsigned gpio, unsigned debounce)
147c4b5be98SFelipe Balbi {
148c4b5be98SFelipe Balbi 	return -ENOSYS;
149c4b5be98SFelipe Balbi }
150c4b5be98SFelipe Balbi 
1517560fa60SDavid Brownell static inline int gpio_get_value(unsigned gpio)
1527560fa60SDavid Brownell {
1537560fa60SDavid Brownell 	/* GPIO can never have been requested or set as {in,out}put */
1547560fa60SDavid Brownell 	WARN_ON(1);
1557560fa60SDavid Brownell 	return 0;
1567560fa60SDavid Brownell }
1577560fa60SDavid Brownell 
1587560fa60SDavid Brownell static inline void gpio_set_value(unsigned gpio, int value)
1597560fa60SDavid Brownell {
1607560fa60SDavid Brownell 	/* GPIO can never have been requested or set as output */
1617560fa60SDavid Brownell 	WARN_ON(1);
1627560fa60SDavid Brownell }
1637560fa60SDavid Brownell 
1647560fa60SDavid Brownell static inline int gpio_cansleep(unsigned gpio)
1657560fa60SDavid Brownell {
1667560fa60SDavid Brownell 	/* GPIO can never have been requested or set as {in,out}put */
1677560fa60SDavid Brownell 	WARN_ON(1);
1687560fa60SDavid Brownell 	return 0;
1697560fa60SDavid Brownell }
1707560fa60SDavid Brownell 
1717560fa60SDavid Brownell static inline int gpio_get_value_cansleep(unsigned gpio)
1727560fa60SDavid Brownell {
1737560fa60SDavid Brownell 	/* GPIO can never have been requested or set as {in,out}put */
1747560fa60SDavid Brownell 	WARN_ON(1);
1757560fa60SDavid Brownell 	return 0;
1767560fa60SDavid Brownell }
1777560fa60SDavid Brownell 
1787560fa60SDavid Brownell static inline void gpio_set_value_cansleep(unsigned gpio, int value)
1797560fa60SDavid Brownell {
1807560fa60SDavid Brownell 	/* GPIO can never have been requested or set as output */
1817560fa60SDavid Brownell 	WARN_ON(1);
1827560fa60SDavid Brownell }
1837560fa60SDavid Brownell 
184d8f388d8SDavid Brownell static inline int gpio_export(unsigned gpio, bool direction_may_change)
185d8f388d8SDavid Brownell {
186d8f388d8SDavid Brownell 	/* GPIO can never have been requested or set as {in,out}put */
187d8f388d8SDavid Brownell 	WARN_ON(1);
188d8f388d8SDavid Brownell 	return -EINVAL;
189d8f388d8SDavid Brownell }
190d8f388d8SDavid Brownell 
191a4177ee7SJani Nikula static inline int gpio_export_link(struct device *dev, const char *name,
192a4177ee7SJani Nikula 				unsigned gpio)
193a4177ee7SJani Nikula {
194a4177ee7SJani Nikula 	/* GPIO can never have been exported */
195a4177ee7SJani Nikula 	WARN_ON(1);
196a4177ee7SJani Nikula 	return -EINVAL;
197a4177ee7SJani Nikula }
198a4177ee7SJani Nikula 
19907697461SJani Nikula static inline int gpio_sysfs_set_active_low(unsigned gpio, int value)
20007697461SJani Nikula {
20107697461SJani Nikula 	/* GPIO can never have been requested */
20207697461SJani Nikula 	WARN_ON(1);
20307697461SJani Nikula 	return -EINVAL;
20407697461SJani Nikula }
205a4177ee7SJani Nikula 
206d8f388d8SDavid Brownell static inline void gpio_unexport(unsigned gpio)
207d8f388d8SDavid Brownell {
208d8f388d8SDavid Brownell 	/* GPIO can never have been exported */
209d8f388d8SDavid Brownell 	WARN_ON(1);
210d8f388d8SDavid Brownell }
211d8f388d8SDavid Brownell 
2127560fa60SDavid Brownell static inline int gpio_to_irq(unsigned gpio)
2137560fa60SDavid Brownell {
2147560fa60SDavid Brownell 	/* GPIO can never have been requested or set as input */
2157560fa60SDavid Brownell 	WARN_ON(1);
2167560fa60SDavid Brownell 	return -EINVAL;
2177560fa60SDavid Brownell }
2187560fa60SDavid Brownell 
219d468bf9eSLinus Walleij static inline int gpio_lock_as_irq(struct gpio_chip *chip, unsigned int offset)
220d468bf9eSLinus Walleij {
221d468bf9eSLinus Walleij 	WARN_ON(1);
222d468bf9eSLinus Walleij 	return -EINVAL;
223d468bf9eSLinus Walleij }
224d468bf9eSLinus Walleij 
225d468bf9eSLinus Walleij static inline void gpio_unlock_as_irq(struct gpio_chip *chip,
226d468bf9eSLinus Walleij 				      unsigned int offset)
227d468bf9eSLinus Walleij {
228d468bf9eSLinus Walleij 	WARN_ON(1);
229d468bf9eSLinus Walleij }
230d468bf9eSLinus Walleij 
2317560fa60SDavid Brownell static inline int irq_to_gpio(unsigned irq)
2327560fa60SDavid Brownell {
2337560fa60SDavid Brownell 	/* irq can never have been returned from gpio_to_irq() */
2347560fa60SDavid Brownell 	WARN_ON(1);
2357560fa60SDavid Brownell 	return -EINVAL;
2367560fa60SDavid Brownell }
2377560fa60SDavid Brownell 
2381e63d7b9SLinus Walleij static inline int
239165adc9cSLinus Walleij gpiochip_add_pin_range(struct gpio_chip *chip, const char *pinctl_name,
240316511c0SLinus Walleij 		       unsigned int gpio_offset, unsigned int pin_offset,
2413f0f8670SLinus Walleij 		       unsigned int npins)
242165adc9cSLinus Walleij {
24350309a9cSLinus Walleij 	WARN_ON(1);
24450309a9cSLinus Walleij 	return -EINVAL;
245165adc9cSLinus Walleij }
246165adc9cSLinus Walleij 
247165adc9cSLinus Walleij static inline void
248165adc9cSLinus Walleij gpiochip_remove_pin_ranges(struct gpio_chip *chip)
249165adc9cSLinus Walleij {
25050309a9cSLinus Walleij 	WARN_ON(1);
251165adc9cSLinus Walleij }
252165adc9cSLinus Walleij 
253403c1d0bSLinus Walleij static inline int devm_gpio_request(struct device *dev, unsigned gpio,
254403c1d0bSLinus Walleij 				    const char *label)
255403c1d0bSLinus Walleij {
256403c1d0bSLinus Walleij 	WARN_ON(1);
257403c1d0bSLinus Walleij 	return -EINVAL;
258403c1d0bSLinus Walleij }
259403c1d0bSLinus Walleij 
260403c1d0bSLinus Walleij static inline int devm_gpio_request_one(struct device *dev, unsigned gpio,
261403c1d0bSLinus Walleij 					unsigned long flags, const char *label)
262403c1d0bSLinus Walleij {
263403c1d0bSLinus Walleij 	WARN_ON(1);
264403c1d0bSLinus Walleij 	return -EINVAL;
265403c1d0bSLinus Walleij }
266403c1d0bSLinus Walleij 
267403c1d0bSLinus Walleij static inline void devm_gpio_free(struct device *dev, unsigned int gpio)
268403c1d0bSLinus Walleij {
269403c1d0bSLinus Walleij 	WARN_ON(1);
270403c1d0bSLinus Walleij }
271403c1d0bSLinus Walleij 
27276ec9d18SAlexandre Courbot #endif /* ! CONFIG_GPIOLIB */
2737560fa60SDavid Brownell 
2747560fa60SDavid Brownell #endif /* __LINUX_GPIO_H */
275