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;
143  * struct pre_voltage_change_data - Data sent with PRE_VOLTAGE_CHANGE event
158  * struct regulator_bulk_data - Data used for bulk regulator operations.
180 struct regulator *__must_check regulator_get(struct device *dev,
181 					     const char *id);
182 struct regulator *__must_check devm_regulator_get(struct device *dev,
183 					     const char *id);
184 struct regulator *__must_check regulator_get_exclusive(struct device *dev,
185 						       const char *id);
186 struct regulator *__must_check devm_regulator_get_exclusive(struct device *dev,
187 							const char *id);
188 struct regulator *__must_check regulator_get_optional(struct device *dev,
189 						      const char *id);
190 struct regulator *__must_check devm_regulator_get_optional(struct device *dev,
191 							   const char *id);
195 int regulator_register_supply_alias(struct device *dev, const char *id,
196 				    struct device *alias_dev,
198 void regulator_unregister_supply_alias(struct device *dev, const char *id);
200 int regulator_bulk_register_supply_alias(struct device *dev,
201 					 const char *const *id,
202 					 struct device *alias_dev,
205 void regulator_bulk_unregister_supply_alias(struct device *dev,
206 					    const char * const *id, int num_id);
208 int devm_regulator_register_supply_alias(struct device *dev, const char *id,
209 					 struct device *alias_dev,
211 void devm_regulator_unregister_supply_alias(struct device *dev,
212 					    const char *id);
214 int devm_regulator_bulk_register_supply_alias(struct device *dev,
215 					      const char *const *id,
216 					      struct device *alias_dev,
219 void devm_regulator_bulk_unregister_supply_alias(struct device *dev,
220 						 const char *const *id,
230 int __must_check regulator_bulk_get(struct device *dev, int num_consumers,
232 int __must_check devm_regulator_bulk_get(struct device *dev, int num_consumers,
290 /* driver data - core doesn't touch */
308 static inline struct regulator *__must_check regulator_get(struct device *dev,  in regulator_get()
309 	const char *id)  in regulator_get()  argument
323 devm_regulator_get(struct device *dev, const char *id)  in devm_regulator_get()  argument
329 regulator_get_exclusive(struct device *dev, const char *id)  in regulator_get_exclusive()  argument
331 	return ERR_PTR(-ENODEV);  in regulator_get_exclusive()
335 regulator_get_optional(struct device *dev, const char *id)  in regulator_get_optional()  argument
337 	return ERR_PTR(-ENODEV);  in regulator_get_optional()
342 devm_regulator_get_optional(struct device *dev, const char *id)  in devm_regulator_get_optional()  argument
344 	return ERR_PTR(-ENODEV);  in devm_regulator_get_optional()
355 static inline int regulator_register_supply_alias(struct device *dev,  in regulator_register_supply_alias()
356 						  const char *id,  in regulator_register_supply_alias()  argument
357 						  struct device *alias_dev,  in regulator_register_supply_alias()
363 static inline void regulator_unregister_supply_alias(struct device *dev,  in regulator_unregister_supply_alias()
364 						    const char *id)  in regulator_unregister_supply_alias()  argument
368 static inline int regulator_bulk_register_supply_alias(struct device *dev,  in regulator_bulk_register_supply_alias()
369 						const char *const *id,  in regulator_bulk_register_supply_alias()  argument
370 						struct device *alias_dev,  in regulator_bulk_register_supply_alias()
377 static inline void regulator_bulk_unregister_supply_alias(struct device *dev,  in regulator_bulk_unregister_supply_alias()
378 						const char * const *id,  in regulator_bulk_unregister_supply_alias()  argument
383 static inline int devm_regulator_register_supply_alias(struct device *dev,  in devm_regulator_register_supply_alias()
384 						       const char *id,  in devm_regulator_register_supply_alias()  argument
385 						       struct device *alias_dev,  in devm_regulator_register_supply_alias()
391 static inline void devm_regulator_unregister_supply_alias(struct device *dev,  in devm_regulator_unregister_supply_alias()
392 							  const char *id)  in devm_regulator_unregister_supply_alias()  argument
396 static inline int devm_regulator_bulk_register_supply_alias(struct device *dev,  in devm_regulator_bulk_register_supply_alias()
397 						const char *const *id,  in devm_regulator_bulk_register_supply_alias()  argument
398 						struct device *alias_dev,  in devm_regulator_bulk_register_supply_alias()
406 	struct device *dev, const char *const *id, int num_id)  in devm_regulator_bulk_unregister_supply_alias()  argument
436 static inline int regulator_bulk_get(struct device *dev,  in regulator_bulk_get()
443 static inline int devm_regulator_bulk_get(struct device *dev, int num_consumers,  in devm_regulator_bulk_get()
486 	return -EINVAL;  in regulator_get_voltage()
525 	return -EINVAL;  in regulator_get_error_flags()
541 	return ERR_PTR(-EOPNOTSUPP);  in regulator_get_regmap()
548 	return -EOPNOTSUPP;  in regulator_get_hardware_vsel_register()
554 	return -EOPNOTSUPP;  in regulator_list_hardware_vsel()
598 	return -EINVAL;  in regulator_list_voltage()
632 					     new_uV - tol_uV, new_uV + tol_uV);  in regulator_set_voltage_tol()
639 					      target_uV - tol_uV,  in regulator_is_supported_voltage_tol()