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
9/*
10 * **DEPRECATED** This function is deprecated and must not be used in new code.
11 */
12void gpio_free(unsigned gpio)
13{
14	gpiod_free(gpio_to_desc(gpio));
15}
16EXPORT_SYMBOL_GPL(gpio_free);
17
18/**
19 * gpio_request_one - request a single GPIO with initial configuration
20 * @gpio:	the GPIO number
21 * @flags:	GPIO configuration as specified by GPIOF_*
22 * @label:	a literal description string of this GPIO
23 *
24 * **DEPRECATED** This function is deprecated and must not be used in new code.
25 */
26int gpio_request_one(unsigned gpio, unsigned long flags, const char *label)
27{
28	struct gpio_desc *desc;
29	int err;
30
31	desc = gpio_to_desc(gpio);
32
33	/* Compatibility: assume unavailable "valid" GPIOs will appear later */
34	if (!desc && gpio_is_valid(gpio))
35		return -EPROBE_DEFER;
36
37	err = gpiod_request(desc, label);
38	if (err)
39		return err;
40
41	if (flags & GPIOF_ACTIVE_LOW)
42		set_bit(FLAG_ACTIVE_LOW, &desc->flags);
43
44	if (flags & GPIOF_DIR_IN)
45		err = gpiod_direction_input(desc);
46	else
47		err = gpiod_direction_output_raw(desc,
48				(flags & GPIOF_INIT_HIGH) ? 1 : 0);
49
50	if (err)
51		goto free_gpio;
52
53	return 0;
54
55 free_gpio:
56	gpiod_free(desc);
57	return err;
58}
59EXPORT_SYMBOL_GPL(gpio_request_one);
60
61/*
62 * **DEPRECATED** This function is deprecated and must not be used in new code.
63 */
64int gpio_request(unsigned gpio, const char *label)
65{
66	struct gpio_desc *desc = gpio_to_desc(gpio);
67
68	/* Compatibility: assume unavailable "valid" GPIOs will appear later */
69	if (!desc && gpio_is_valid(gpio))
70		return -EPROBE_DEFER;
71
72	return gpiod_request(desc, label);
73}
74EXPORT_SYMBOL_GPL(gpio_request);
75
76/**
77 * gpio_request_array - request multiple GPIOs in a single call
78 * @array:	array of the 'struct gpio'
79 * @num:	how many GPIOs in the array
80 *
81 * **DEPRECATED** This function is deprecated and must not be used in new code.
82 */
83int gpio_request_array(const struct gpio *array, size_t num)
84{
85	int i, err;
86
87	for (i = 0; i < num; i++, array++) {
88		err = gpio_request_one(array->gpio, array->flags, array->label);
89		if (err)
90			goto err_free;
91	}
92	return 0;
93
94err_free:
95	while (i--)
96		gpio_free((--array)->gpio);
97	return err;
98}
99EXPORT_SYMBOL_GPL(gpio_request_array);
100
101/**
102 * gpio_free_array - release multiple GPIOs in a single call
103 * @array:	array of the 'struct gpio'
104 * @num:	how many GPIOs in the array
105 *
106 * **DEPRECATED** This function is deprecated and must not be used in new code.
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);
114