1 /* SPDX-License-Identifier: GPL-2.0 */
3  * devres.c - managed gpio resources
47  * devm_gpiod_get - Resource-managed gpiod_get()
50  * @flags:	optional GPIO initialization flags
58 					      enum gpiod_flags flags)  in devm_gpiod_get()  argument
60 	return devm_gpiod_get_index(dev, con_id, 0, flags);  in devm_gpiod_get()
65  * devm_gpiod_get_optional - Resource-managed gpiod_get_optional()
68  * @flags: optional GPIO initialization flags
76 						       enum gpiod_flags flags)  in devm_gpiod_get_optional()  argument
78 	return devm_gpiod_get_index_optional(dev, con_id, 0, flags);  in devm_gpiod_get_optional()
83  * devm_gpiod_get_index - Resource-managed gpiod_get_index()
87  * @flags:	optional GPIO initialization flags
96 						    enum gpiod_flags flags)  in devm_gpiod_get_index()  argument
101 	desc = gpiod_get_index(dev, con_id, idx, flags);  in devm_gpiod_get_index()
106 	 * For non-exclusive GPIO descriptors, check if this descriptor is  in devm_gpiod_get_index()
109 	if (flags & GPIOD_FLAGS_BIT_NONEXCLUSIVE) {  in devm_gpiod_get_index()
122 		return ERR_PTR(-ENOMEM);  in devm_gpiod_get_index()
133  * devm_fwnode_gpiod_get_index - get a GPIO descriptor from a given node
138  * @flags:	GPIO initialization flags
145  * provided @flags.
150 					      enum gpiod_flags flags,  in devm_fwnode_gpiod_get_index()  argument
159 		return ERR_PTR(-ENOMEM);  in devm_fwnode_gpiod_get_index()
161 	desc = gpiod_find_and_request(dev, fwnode, con_id, index, flags, label, false);  in devm_fwnode_gpiod_get_index()
175  * devm_gpiod_get_index_optional - Resource-managed gpiod_get_index_optional()
179  * @flags: optional GPIO initialization flags
189 							     enum gpiod_flags flags)  in devm_gpiod_get_index_optional()  argument
193 	desc = devm_gpiod_get_index(dev, con_id, index, flags);  in devm_gpiod_get_index_optional()
202  * devm_gpiod_get_array - Resource-managed gpiod_get_array()
205  * @flags:	optional GPIO initialization flags
213 						     enum gpiod_flags flags)  in devm_gpiod_get_array()  argument
221 		return ERR_PTR(-ENOMEM);  in devm_gpiod_get_array()
223 	descs = gpiod_get_array(dev, con_id, flags);  in devm_gpiod_get_array()
237  * devm_gpiod_get_array_optional - Resource-managed gpiod_get_array_optional()
240  * @flags:	optional GPIO initialization flags
249 			      enum gpiod_flags flags)  in devm_gpiod_get_array_optional()  argument
253 	descs = devm_gpiod_get_array(dev, con_id, flags);  in devm_gpiod_get_array_optional()
262  * devm_gpiod_put - Resource-managed gpiod_put()
267  * devm_gpiod_get_index(). Normally this function will not be called as the GPIO
278  * devm_gpiod_unhinge - Remove resource management from a gpio descriptor
296 	 * If the GPIO descriptor is requested as nonexclusive, we  in devm_gpiod_unhinge()
298 	 * so it is OK if devres_destroy() returns -ENOENT.  in devm_gpiod_unhinge()
300 	if (ret == -ENOENT)  in devm_gpiod_unhinge()
308  * devm_gpiod_put_array - Resource-managed gpiod_put_array()
313  * Normally this function will not be called as the GPIOs will be disposed of
331  *      devm_gpio_request - request a GPIO for a managed device
337  *      same arguments and performs the same function as
348 		return -ENOMEM;  in devm_gpio_request()
364  *	devm_gpio_request_one - request a single GPIO with initial setup
367  *	@flags:	GPIO configuration as specified by GPIOF_*
371 			  unsigned long flags, const char *label)  in devm_gpio_request_one()  argument
378 		return -ENOMEM;  in devm_gpio_request_one()
380 	rc = gpio_request_one(gpio, flags, label);  in devm_gpio_request_one()
401  * devm_gpiochip_add_data_with_key() - Resource managed gpiochip_add_data_with_key()
404  * @data: driver-private data associated with this chip
413  * A negative errno if the chip can't be registered, such as because the
414  * gc->base is invalid or already associated with a different chip.
415  * Otherwise it returns zero as a success code.