Loading...
1// SPDX-License-Identifier: GPL-2.0
2#include <linux/bitops.h>
3#include <linux/device.h>
4#include <linux/errno.h>
5#include <linux/export.h>
6#include <linux/gfp.h>
7
8#include <linux/gpio/consumer.h>
9#include <linux/gpio/driver.h>
10
11#include <linux/gpio.h>
12
13#include "gpiolib.h"
14
15/*
16 * **DEPRECATED** This function is deprecated and must not be used in new code.
17 */
18void gpio_free(unsigned gpio)
19{
20 gpiod_free(gpio_to_desc(gpio));
21}
22EXPORT_SYMBOL_GPL(gpio_free);
23
24/**
25 * gpio_request_one - request a single GPIO with initial configuration
26 * @gpio: the GPIO number
27 * @flags: GPIO configuration as specified by GPIOF_*
28 * @label: a literal description string of this GPIO
29 *
30 * **DEPRECATED** This function is deprecated and must not be used in new code.
31 *
32 * Returns:
33 * 0 on success, or negative errno on failure.
34 */
35int gpio_request_one(unsigned gpio, unsigned long flags, const char *label)
36{
37 struct gpio_desc *desc;
38 int err;
39
40 /* Compatibility: assume unavailable "valid" GPIOs will appear later */
41 desc = gpio_to_desc(gpio);
42 if (!desc)
43 return -EPROBE_DEFER;
44
45 err = gpiod_request(desc, label);
46 if (err)
47 return err;
48
49 if (flags & GPIOF_IN)
50 err = gpiod_direction_input(desc);
51 else
52 err = gpiod_direction_output_raw(desc, !!(flags & GPIOF_OUT_INIT_HIGH));
53
54 if (err)
55 goto free_gpio;
56
57 return 0;
58
59 free_gpio:
60 gpiod_free(desc);
61 return err;
62}
63EXPORT_SYMBOL_GPL(gpio_request_one);
64
65/*
66 * **DEPRECATED** This function is deprecated and must not be used in new code.
67 */
68int gpio_request(unsigned gpio, const char *label)
69{
70 struct gpio_desc *desc;
71
72 /* Compatibility: assume unavailable "valid" GPIOs will appear later */
73 desc = gpio_to_desc(gpio);
74 if (!desc)
75 return -EPROBE_DEFER;
76
77 return gpiod_request(desc, label);
78}
79EXPORT_SYMBOL_GPL(gpio_request);
80
81static void devm_gpio_release(struct device *dev, void *res)
82{
83 unsigned *gpio = res;
84
85 gpio_free(*gpio);
86}
87
88/**
89 * devm_gpio_request - request a GPIO for a managed device
90 * @dev: device to request the GPIO for
91 * @gpio: GPIO to allocate
92 * @label: the name of the requested GPIO
93 *
94 * Except for the extra @dev argument, this function takes the
95 * same arguments and performs the same function as gpio_request().
96 * GPIOs requested with this function will be automatically freed
97 * on driver detach.
98 *
99 * **DEPRECATED** This function is deprecated and must not be used in new code.
100 *
101 * Returns:
102 * 0 on success, or negative errno on failure.
103 */
104int devm_gpio_request(struct device *dev, unsigned gpio, const char *label)
105{
106 unsigned *dr;
107 int rc;
108
109 dr = devres_alloc(devm_gpio_release, sizeof(unsigned), GFP_KERNEL);
110 if (!dr)
111 return -ENOMEM;
112
113 rc = gpio_request(gpio, label);
114 if (rc) {
115 devres_free(dr);
116 return rc;
117 }
118
119 *dr = gpio;
120 devres_add(dev, dr);
121
122 return 0;
123}
124EXPORT_SYMBOL_GPL(devm_gpio_request);
125
126/**
127 * devm_gpio_request_one - request a single GPIO with initial setup
128 * @dev: device to request for
129 * @gpio: the GPIO number
130 * @flags: GPIO configuration as specified by GPIOF_*
131 * @label: a literal description string of this GPIO
132 *
133 * **DEPRECATED** This function is deprecated and must not be used in new code.
134 *
135 * Returns:
136 * 0 on success, or negative errno on failure.
137 */
138int devm_gpio_request_one(struct device *dev, unsigned gpio,
139 unsigned long flags, const char *label)
140{
141 unsigned *dr;
142 int rc;
143
144 dr = devres_alloc(devm_gpio_release, sizeof(unsigned), GFP_KERNEL);
145 if (!dr)
146 return -ENOMEM;
147
148 rc = gpio_request_one(gpio, flags, label);
149 if (rc) {
150 devres_free(dr);
151 return rc;
152 }
153
154 *dr = gpio;
155 devres_add(dev, dr);
156
157 return 0;
158}
159EXPORT_SYMBOL_GPL(devm_gpio_request_one);
1// SPDX-License-Identifier: GPL-2.0
2#include <linux/gpio/consumer.h>
3#include <linux/gpio/driver.h>
4
5#include <linux/gpio.h>
6
7#include "gpiolib.h"
8
9void gpio_free(unsigned gpio)
10{
11 gpiod_free(gpio_to_desc(gpio));
12}
13EXPORT_SYMBOL_GPL(gpio_free);
14
15/**
16 * gpio_request_one - request a single GPIO with initial configuration
17 * @gpio: the GPIO number
18 * @flags: GPIO configuration as specified by GPIOF_*
19 * @label: a literal description string of this GPIO
20 */
21int gpio_request_one(unsigned gpio, unsigned long flags, const char *label)
22{
23 struct gpio_desc *desc;
24 int err;
25
26 desc = gpio_to_desc(gpio);
27
28 /* Compatibility: assume unavailable "valid" GPIOs will appear later */
29 if (!desc && gpio_is_valid(gpio))
30 return -EPROBE_DEFER;
31
32 err = gpiod_request(desc, label);
33 if (err)
34 return err;
35
36 if (flags & GPIOF_OPEN_DRAIN)
37 set_bit(FLAG_OPEN_DRAIN, &desc->flags);
38
39 if (flags & GPIOF_OPEN_SOURCE)
40 set_bit(FLAG_OPEN_SOURCE, &desc->flags);
41
42 if (flags & GPIOF_ACTIVE_LOW)
43 set_bit(FLAG_ACTIVE_LOW, &desc->flags);
44
45 if (flags & GPIOF_DIR_IN)
46 err = gpiod_direction_input(desc);
47 else
48 err = gpiod_direction_output_raw(desc,
49 (flags & GPIOF_INIT_HIGH) ? 1 : 0);
50
51 if (err)
52 goto free_gpio;
53
54 if (flags & GPIOF_EXPORT) {
55 err = gpiod_export(desc, flags & GPIOF_EXPORT_CHANGEABLE);
56 if (err)
57 goto free_gpio;
58 }
59
60 return 0;
61
62 free_gpio:
63 gpiod_free(desc);
64 return err;
65}
66EXPORT_SYMBOL_GPL(gpio_request_one);
67
68int gpio_request(unsigned gpio, const char *label)
69{
70 struct gpio_desc *desc = gpio_to_desc(gpio);
71
72 /* Compatibility: assume unavailable "valid" GPIOs will appear later */
73 if (!desc && gpio_is_valid(gpio))
74 return -EPROBE_DEFER;
75
76 return gpiod_request(desc, label);
77}
78EXPORT_SYMBOL_GPL(gpio_request);
79
80/**
81 * gpio_request_array - request multiple GPIOs in a single call
82 * @array: array of the 'struct gpio'
83 * @num: how many GPIOs in the array
84 */
85int gpio_request_array(const struct gpio *array, size_t num)
86{
87 int i, err;
88
89 for (i = 0; i < num; i++, array++) {
90 err = gpio_request_one(array->gpio, array->flags, array->label);
91 if (err)
92 goto err_free;
93 }
94 return 0;
95
96err_free:
97 while (i--)
98 gpio_free((--array)->gpio);
99 return err;
100}
101EXPORT_SYMBOL_GPL(gpio_request_array);
102
103/**
104 * gpio_free_array - release multiple GPIOs in a single call
105 * @array: array of the 'struct gpio'
106 * @num: how many GPIOs in the array
107 */
108void gpio_free_array(const struct gpio *array, size_t num)
109{
110 while (num--)
111 gpio_free((array++)->gpio);
112}
113EXPORT_SYMBOL_GPL(gpio_free_array);