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
38 struct device;
112  * struct pre_voltage_change_data - Data sent with PRE_VOLTAGE_CHANGE event
127  * struct regulator_bulk_data - Data used for bulk regulator operations.
153 struct regulator *__must_check regulator_get(struct device *dev,
154 					     const char *id);
155 struct regulator *__must_check devm_regulator_get(struct device *dev,
156 					     const char *id);
157 struct regulator *__must_check regulator_get_exclusive(struct device *dev,
158 						       const char *id);
159 struct regulator *__must_check devm_regulator_get_exclusive(struct device *dev,
160 							const char *id);
161 struct regulator *__must_check regulator_get_optional(struct device *dev,
162 						      const char *id);
163 struct regulator *__must_check devm_regulator_get_optional(struct device *dev,
164 							   const char *id);
165 int devm_regulator_get_enable(struct device *dev, const char *id);
166 int devm_regulator_get_enable_optional(struct device *dev, const char *id);
170 int regulator_register_supply_alias(struct device *dev, const char *id,
171 				    struct device *alias_dev,
173 void regulator_unregister_supply_alias(struct device *dev, const char *id);
175 int regulator_bulk_register_supply_alias(struct device *dev,
176 					 const char *const *id,
177 					 struct device *alias_dev,
180 void regulator_bulk_unregister_supply_alias(struct device *dev,
181 					    const char * const *id, int num_id);
183 int devm_regulator_register_supply_alias(struct device *dev, const char *id,
184 					 struct device *alias_dev,
187 int devm_regulator_bulk_register_supply_alias(struct device *dev,
188 					      const char *const *id,
189 					      struct device *alias_dev,
200 int __must_check regulator_bulk_get(struct device *dev, int num_consumers,
202 int __must_check of_regulator_bulk_get_all(struct device *dev, struct device_node *np,
204 int __must_check devm_regulator_bulk_get(struct device *dev, int num_consumers,
207 int __must_check devm_regulator_bulk_get_exclusive(struct device *dev, int num_consumers,
210 	struct device *dev, int num_consumers,
215 int devm_regulator_bulk_get_enable(struct device *dev, int num_consumers,
216 				   const char * const *id);
271 /* driver data - core doesn't touch */
289 static inline struct regulator *__must_check regulator_get(struct device *dev,  in regulator_get()
290 	const char *id)  in regulator_get()  argument
304 devm_regulator_get(struct device *dev, const char *id)  in devm_regulator_get()  argument
310 regulator_get_exclusive(struct device *dev, const char *id)  in regulator_get_exclusive()  argument
312 	return ERR_PTR(-ENODEV);  in regulator_get_exclusive()
316 devm_regulator_get_exclusive(struct device *dev, const char *id)  in devm_regulator_get_exclusive()  argument
318 	return ERR_PTR(-ENODEV);  in devm_regulator_get_exclusive()
321 static inline int devm_regulator_get_enable(struct device *dev, const char *id)  in devm_regulator_get_enable()  argument
323 	return -ENODEV;  in devm_regulator_get_enable()
326 static inline int devm_regulator_get_enable_optional(struct device *dev,  in devm_regulator_get_enable_optional()
327 						     const char *id)  in devm_regulator_get_enable_optional()  argument
329 	return -ENODEV;  in devm_regulator_get_enable_optional()
333 regulator_get_optional(struct device *dev, const char *id)  in regulator_get_optional()  argument
335 	return ERR_PTR(-ENODEV);  in regulator_get_optional()
340 devm_regulator_get_optional(struct device *dev, const char *id)  in devm_regulator_get_optional()  argument
342 	return ERR_PTR(-ENODEV);  in devm_regulator_get_optional()
357 static inline int regulator_register_supply_alias(struct device *dev,  in regulator_register_supply_alias()
358 						  const char *id,  in regulator_register_supply_alias()  argument
359 						  struct device *alias_dev,  in regulator_register_supply_alias()
365 static inline void regulator_unregister_supply_alias(struct device *dev,  in regulator_unregister_supply_alias()
366 						    const char *id)  in regulator_unregister_supply_alias()  argument
370 static inline int regulator_bulk_register_supply_alias(struct device *dev,  in regulator_bulk_register_supply_alias()
371 						const char *const *id,  in regulator_bulk_register_supply_alias()  argument
372 						struct device *alias_dev,  in regulator_bulk_register_supply_alias()
379 static inline void regulator_bulk_unregister_supply_alias(struct device *dev,  in regulator_bulk_unregister_supply_alias()
380 						const char * const *id,  in regulator_bulk_unregister_supply_alias()  argument
385 static inline int devm_regulator_register_supply_alias(struct device *dev,  in devm_regulator_register_supply_alias()
386 						       const char *id,  in devm_regulator_register_supply_alias()  argument
387 						       struct device *alias_dev,  in devm_regulator_register_supply_alias()
393 static inline int devm_regulator_bulk_register_supply_alias(struct device *dev,  in devm_regulator_bulk_register_supply_alias()
394 						const char *const *id,  in devm_regulator_bulk_register_supply_alias()  argument
395 						struct device *alias_dev,  in devm_regulator_bulk_register_supply_alias()
428 static inline int regulator_bulk_get(struct device *dev,  in regulator_bulk_get()
435 static inline int devm_regulator_bulk_get(struct device *dev, int num_consumers,  in devm_regulator_bulk_get()
441 static inline int of_regulator_bulk_get_all(struct device *dev, struct device_node *np,  in of_regulator_bulk_get_all()
453 static inline int devm_regulator_bulk_get_enable(struct device *dev,  in devm_regulator_bulk_get_enable()
455 						 const char * const *id)  in devm_regulator_bulk_get_enable()  argument
491 	return -EINVAL;  in regulator_get_voltage()
496 	return -EINVAL;  in regulator_sync_voltage()
535 	return -EINVAL;  in regulator_get_error_flags()
551 	return ERR_PTR(-EOPNOTSUPP);  in regulator_get_regmap()
558 	return -EOPNOTSUPP;  in regulator_get_hardware_vsel_register()
564 	return -EOPNOTSUPP;  in regulator_list_hardware_vsel()
594 	return -EINVAL;  in regulator_suspend_enable()
600 	return -EINVAL;  in regulator_suspend_disable()
607 	return -EINVAL;  in regulator_set_suspend_voltage()
627 	return -EINVAL;  in regulator_list_voltage()
661 					     new_uV - tol_uV, new_uV + tol_uV);  in regulator_set_voltage_tol()
668 					      target_uV - tol_uV,  in regulator_is_supported_voltage_tol()