1 /* SPDX-License-Identifier: GPL-2.0 */
3  * devres.c - managed gpio resources
51  * devm_gpiod_get - Resource-managed gpiod_get()
54  * @flags:	optional GPIO initialization flags
62  * dev, %-ENOENT if no GPIO has been assigned to the requested function, or
67 					      enum gpiod_flags flags)  in devm_gpiod_get()  argument
69 	return devm_gpiod_get_index(dev, con_id, 0, flags);  in devm_gpiod_get()
74  * devm_gpiod_get_optional - Resource-managed gpiod_get_optional()
77  * @flags: optional GPIO initialization flags
90 						       enum gpiod_flags flags)  in devm_gpiod_get_optional()  argument
92 	return devm_gpiod_get_index_optional(dev, con_id, 0, flags);  in devm_gpiod_get_optional()
97  * devm_gpiod_get_index - Resource-managed gpiod_get_index()
101  * @flags:	optional GPIO initialization flags
109  * dev, %-ENOENT if no GPIO has been assigned to the requested function, or
115 						    enum gpiod_flags flags)  in devm_gpiod_get_index()  argument
120 	desc = gpiod_get_index(dev, con_id, idx, flags);  in devm_gpiod_get_index()
125 	 * For non-exclusive GPIO descriptors, check if this descriptor is  in devm_gpiod_get_index()
128 	if (flags & GPIOD_FLAGS_BIT_NONEXCLUSIVE) {  in devm_gpiod_get_index()
141 		return ERR_PTR(-ENOMEM);  in devm_gpiod_get_index()
152  * devm_fwnode_gpiod_get_index - get a GPIO descriptor from a given node
157  * @flags:	GPIO initialization flags
165  * dev, %-ENOENT if no GPIO has been assigned to the requested function, or
171 					      enum gpiod_flags flags,  in devm_fwnode_gpiod_get_index()  argument
180 		return ERR_PTR(-ENOMEM);  in devm_fwnode_gpiod_get_index()
182 	desc = gpiod_find_and_request(dev, fwnode, con_id, index, flags, label, false);  in devm_fwnode_gpiod_get_index()
196  * devm_gpiod_get_index_optional - Resource-managed gpiod_get_index_optional()
200  * @flags: optional GPIO initialization flags
215 							     enum gpiod_flags flags)  in devm_gpiod_get_index_optional()  argument
219 	desc = devm_gpiod_get_index(dev, con_id, index, flags);  in devm_gpiod_get_index_optional()
228  * devm_gpiod_get_array - Resource-managed gpiod_get_array()
231  * @flags:	optional GPIO initialization flags
239  * dev, %-ENOENT if no GPIO has been assigned to the requested function,
245 						     enum gpiod_flags flags)  in devm_gpiod_get_array()  argument
253 		return ERR_PTR(-ENOMEM);  in devm_gpiod_get_array()
255 	descs = gpiod_get_array(dev, con_id, flags);  in devm_gpiod_get_array()
269  * devm_gpiod_get_array_optional - Resource-managed gpiod_get_array_optional()
272  * @flags:	optional GPIO initialization flags
287 			      enum gpiod_flags flags)  in devm_gpiod_get_array_optional()  argument
291 	descs = devm_gpiod_get_array(dev, con_id, flags);  in devm_gpiod_get_array_optional()
300  * devm_gpiod_put - Resource-managed gpiod_put()
305  * devm_gpiod_get_index(). Normally this function will not be called as the GPIO
316  * devm_gpiod_unhinge - Remove resource management from a gpio descriptor
334 	 * If the GPIO descriptor is requested as nonexclusive, we  in devm_gpiod_unhinge()
336 	 * so it is OK if devres_destroy() returns -ENOENT.  in devm_gpiod_unhinge()
338 	if (ret == -ENOENT)  in devm_gpiod_unhinge()
346  * devm_gpiod_put_array - Resource-managed gpiod_put_array()
351  * Normally this function will not be called as the GPIOs will be disposed of
369  * devm_gpiochip_add_data_with_key() - Resource managed gpiochip_add_data_with_key()
372  * @data: driver-private data associated with this chip
381  * A negative errno if the chip can't be registered, such as because the
382  * gc->base is invalid or already associated with a different chip.
383  * Otherwise it returns zero as a success code.