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 devm_regulator_bulk_get(struct device *dev, int num_consumers,
251 	struct device *dev, int num_consumers,
256 int devm_regulator_bulk_get_enable(struct device *dev, int num_consumers,
257 				   const char * const *id);
312 /* driver data - core doesn't touch */
330 static inline struct regulator *__must_check regulator_get(struct device *dev,  in regulator_get()
331 	const char *id)  in regulator_get()  argument
345 devm_regulator_get(struct device *dev, const char *id)  in devm_regulator_get()  argument
351 regulator_get_exclusive(struct device *dev, const char *id)  in regulator_get_exclusive()  argument
353 	return ERR_PTR(-ENODEV);  in regulator_get_exclusive()
357 devm_regulator_get_exclusive(struct device *dev, const char *id)  in devm_regulator_get_exclusive()  argument
359 	return ERR_PTR(-ENODEV);  in devm_regulator_get_exclusive()
362 static inline int devm_regulator_get_enable(struct device *dev, const char *id)  in devm_regulator_get_enable()  argument
364 	return -ENODEV;  in devm_regulator_get_enable()
367 static inline int devm_regulator_get_enable_optional(struct device *dev,  in devm_regulator_get_enable_optional()
368 						     const char *id)  in devm_regulator_get_enable_optional()  argument
370 	return -ENODEV;  in devm_regulator_get_enable_optional()
374 regulator_get_optional(struct device *dev, const char *id)  in regulator_get_optional()  argument
376 	return ERR_PTR(-ENODEV);  in regulator_get_optional()
381 devm_regulator_get_optional(struct device *dev, const char *id)  in devm_regulator_get_optional()  argument
383 	return ERR_PTR(-ENODEV);  in devm_regulator_get_optional()
398 static inline int regulator_register_supply_alias(struct device *dev,  in regulator_register_supply_alias()
399 						  const char *id,  in regulator_register_supply_alias()  argument
400 						  struct device *alias_dev,  in regulator_register_supply_alias()
406 static inline void regulator_unregister_supply_alias(struct device *dev,  in regulator_unregister_supply_alias()
407 						    const char *id)  in regulator_unregister_supply_alias()  argument
411 static inline int regulator_bulk_register_supply_alias(struct device *dev,  in regulator_bulk_register_supply_alias()
412 						const char *const *id,  in regulator_bulk_register_supply_alias()  argument
413 						struct device *alias_dev,  in regulator_bulk_register_supply_alias()
420 static inline void regulator_bulk_unregister_supply_alias(struct device *dev,  in regulator_bulk_unregister_supply_alias()
421 						const char * const *id,  in regulator_bulk_unregister_supply_alias()  argument
426 static inline int devm_regulator_register_supply_alias(struct device *dev,  in devm_regulator_register_supply_alias()
427 						       const char *id,  in devm_regulator_register_supply_alias()  argument
428 						       struct device *alias_dev,  in devm_regulator_register_supply_alias()
434 static inline int devm_regulator_bulk_register_supply_alias(struct device *dev,  in devm_regulator_bulk_register_supply_alias()
435 						const char *const *id,  in devm_regulator_bulk_register_supply_alias()  argument
436 						struct device *alias_dev,  in devm_regulator_bulk_register_supply_alias()
469 static inline int regulator_bulk_get(struct device *dev,  in regulator_bulk_get()
476 static inline int devm_regulator_bulk_get(struct device *dev, int num_consumers,  in devm_regulator_bulk_get()
488 static inline int devm_regulator_bulk_get_enable(struct device *dev,  in devm_regulator_bulk_get_enable()
490 						 const char * const *id)  in devm_regulator_bulk_get_enable()  argument
526 	return -EINVAL;  in regulator_get_voltage()
531 	return -EINVAL;  in regulator_sync_voltage()
570 	return -EINVAL;  in regulator_get_error_flags()
586 	return ERR_PTR(-EOPNOTSUPP);  in regulator_get_regmap()
593 	return -EOPNOTSUPP;  in regulator_get_hardware_vsel_register()
599 	return -EOPNOTSUPP;  in regulator_list_hardware_vsel()
629 	return -EINVAL;  in regulator_suspend_enable()
635 	return -EINVAL;  in regulator_suspend_disable()
642 	return -EINVAL;  in regulator_set_suspend_voltage()
662 	return -EINVAL;  in regulator_list_voltage()
696 					     new_uV - tol_uV, new_uV + tol_uV);  in regulator_set_voltage_tol()
703 					      target_uV - tol_uV,  in regulator_is_supported_voltage_tol()