1 /* SPDX-License-Identifier: GPL-2.0-only */
3  * consumer.h -- SoC Regulator consumer support.
12  * Features:-
19  *   Dynamic Regulator operating Mode Switching (DRMS) - allows regulators
23  *   e.g. Devices x,y,z share regulator r. Device x and y draw 20mA each during
24  *   IO and 1mA at idle. Device z draws 100mA when under load and 5mA when
37 struct device;
157  * struct pre_voltage_change_data - Data sent with PRE_VOLTAGE_CHANGE event
172  * struct regulator_bulk_data - Data used for bulk regulator operations.
198 struct regulator *__must_check regulator_get(struct device *dev,
199 					     const char *id);
200 struct regulator *__must_check devm_regulator_get(struct device *dev,
201 					     const char *id);
202 struct regulator *__must_check regulator_get_exclusive(struct device *dev,
203 						       const char *id);
204 struct regulator *__must_check devm_regulator_get_exclusive(struct device *dev,
205 							const char *id);
206 struct regulator *__must_check regulator_get_optional(struct device *dev,
207 						      const char *id);
208 struct regulator *__must_check devm_regulator_get_optional(struct device *dev,
209 							   const char *id);
210 int devm_regulator_get_enable(struct device *dev, const char *id);
211 int devm_regulator_get_enable_optional(struct device *dev, const char *id);
215 int regulator_register_supply_alias(struct device *dev, const char *id,
216 				    struct device *alias_dev,
218 void regulator_unregister_supply_alias(struct device *dev, const char *id);
220 int regulator_bulk_register_supply_alias(struct device *dev,
221 					 const char *const *id,
222 					 struct device *alias_dev,
225 void regulator_bulk_unregister_supply_alias(struct device *dev,
226 					    const char * const *id, int num_id);
228 int devm_regulator_register_supply_alias(struct device *dev, const char *id,
229 					 struct device *alias_dev,
232 int devm_regulator_bulk_register_supply_alias(struct device *dev,
233 					      const char *const *id,
234 					      struct device *alias_dev,
245 int __must_check regulator_bulk_get(struct device *dev, int num_consumers,
247 int __must_check of_regulator_bulk_get_all(struct device *dev, struct device_node *np,
249 int __must_check devm_regulator_bulk_get(struct device *dev, int num_consumers,
252 int __must_check devm_regulator_bulk_get_exclusive(struct device *dev, int num_consumers,
255 	struct device *dev, int num_consumers,
260 int devm_regulator_bulk_get_enable(struct device *dev, int num_consumers,
261 				   const char * const *id);
316 /* driver data - core doesn't touch */
334 static inline struct regulator *__must_check regulator_get(struct device *dev,  in regulator_get()
335 	const char *id)  in regulator_get()  argument
349 devm_regulator_get(struct device *dev, const char *id)  in devm_regulator_get()  argument
355 regulator_get_exclusive(struct device *dev, const char *id)  in regulator_get_exclusive()  argument
357 	return ERR_PTR(-ENODEV);  in regulator_get_exclusive()
361 devm_regulator_get_exclusive(struct device *dev, const char *id)  in devm_regulator_get_exclusive()  argument
363 	return ERR_PTR(-ENODEV);  in devm_regulator_get_exclusive()
366 static inline int devm_regulator_get_enable(struct device *dev, const char *id)  in devm_regulator_get_enable()  argument
368 	return -ENODEV;  in devm_regulator_get_enable()
371 static inline int devm_regulator_get_enable_optional(struct device *dev,  in devm_regulator_get_enable_optional()
372 						     const char *id)  in devm_regulator_get_enable_optional()  argument
374 	return -ENODEV;  in devm_regulator_get_enable_optional()
378 regulator_get_optional(struct device *dev, const char *id)  in regulator_get_optional()  argument
380 	return ERR_PTR(-ENODEV);  in regulator_get_optional()
385 devm_regulator_get_optional(struct device *dev, const char *id)  in devm_regulator_get_optional()  argument
387 	return ERR_PTR(-ENODEV);  in devm_regulator_get_optional()
402 static inline int regulator_register_supply_alias(struct device *dev,  in regulator_register_supply_alias()
403 						  const char *id,  in regulator_register_supply_alias()  argument
404 						  struct device *alias_dev,  in regulator_register_supply_alias()
410 static inline void regulator_unregister_supply_alias(struct device *dev,  in regulator_unregister_supply_alias()
411 						    const char *id)  in regulator_unregister_supply_alias()  argument
415 static inline int regulator_bulk_register_supply_alias(struct device *dev,  in regulator_bulk_register_supply_alias()
416 						const char *const *id,  in regulator_bulk_register_supply_alias()  argument
417 						struct device *alias_dev,  in regulator_bulk_register_supply_alias()
424 static inline void regulator_bulk_unregister_supply_alias(struct device *dev,  in regulator_bulk_unregister_supply_alias()
425 						const char * const *id,  in regulator_bulk_unregister_supply_alias()  argument
430 static inline int devm_regulator_register_supply_alias(struct device *dev,  in devm_regulator_register_supply_alias()
431 						       const char *id,  in devm_regulator_register_supply_alias()  argument
432 						       struct device *alias_dev,  in devm_regulator_register_supply_alias()
438 static inline int devm_regulator_bulk_register_supply_alias(struct device *dev,  in devm_regulator_bulk_register_supply_alias()
439 						const char *const *id,  in devm_regulator_bulk_register_supply_alias()  argument
440 						struct device *alias_dev,  in devm_regulator_bulk_register_supply_alias()
473 static inline int regulator_bulk_get(struct device *dev,  in regulator_bulk_get()
480 static inline int devm_regulator_bulk_get(struct device *dev, int num_consumers,  in devm_regulator_bulk_get()
486 static inline int of_regulator_bulk_get_all(struct device *dev, struct device_node *np,  in of_regulator_bulk_get_all()
498 static inline int devm_regulator_bulk_get_enable(struct device *dev,  in devm_regulator_bulk_get_enable()
500 						 const char * const *id)  in devm_regulator_bulk_get_enable()  argument
536 	return -EINVAL;  in regulator_get_voltage()
541 	return -EINVAL;  in regulator_sync_voltage()
580 	return -EINVAL;  in regulator_get_error_flags()
596 	return ERR_PTR(-EOPNOTSUPP);  in regulator_get_regmap()
603 	return -EOPNOTSUPP;  in regulator_get_hardware_vsel_register()
609 	return -EOPNOTSUPP;  in regulator_list_hardware_vsel()
639 	return -EINVAL;  in regulator_suspend_enable()
645 	return -EINVAL;  in regulator_suspend_disable()
652 	return -EINVAL;  in regulator_set_suspend_voltage()
672 	return -EINVAL;  in regulator_list_voltage()
706 					     new_uV - tol_uV, new_uV + tol_uV);  in regulator_set_voltage_tol()
713 					      target_uV - tol_uV,  in regulator_is_supported_voltage_tol()